Hyperwisor-IOT Arduino Library

Hyperwisor IOT is a powerful abstraction layer for ESP32-based IoT devices. It handles Wi-Fi provisioning, real-time communication, OTA updates, and GPIO management out of the box. Built on top of the nikolaindustry-realtime protocol, it helps developers build smart, connected devices with minimal code.

Hyperwisor IOT is a robust abstraction layer for ESP32-based IoT devices, enabling:

• Seamless Wi-Fi provisioning
• Real-time communication
• OTA firmware updates
• GPIO & task management
• Persistent configuration
• Fully structured JSON command execution

Built on the powerful nikolaindustry-realtime protocol.

📦 Features

• 🚀 Automatic Wi-Fi connection using stored credentials
• 📶 AP-mode fallback + web-based provisioning page
• 🌐 Real-time communication using nikolaindustry-realtime
• 📩 Built-in JSON command parser with custom extensibility
• 🛠️ GPIO control via commands (pinMode, digitalWrite)
• 🔁 Continuous background loop with nikolaindustry-realtime + HTTP handling
• 🔧 User command handler support via lambda functions
• 🌍 Built-in DNS redirection when in AP mode
• 🔄 OTA firmware update with version tracking
• 🧠 Smart command routing via from → sendTo() pairing
• ✅ Command response feedback through real-time socket
• 🔐 Preferences-based persistent storage

---

🔧 Installation

1. Clone or download this repository.

2. Place the folder into your Arduino libraries/ directory.

3. Include the library in your sketch:

   #include <hyperwisor-iot.h>

🌐 Command Structure

Supports rich JSON messages from the server:

{
  "from": "controller-xyz",
  "payload": {
    "commands": [
      {
        "command": "GPIO_MANAGEMENT",
        "actions": [
          {
            "action": "ON",
            "params": {
              "gpio": 12,
              "pinmode": "OUTPUT",
              "status": "HIGH"
            }
          }
        ]
      }
    ]
  }
}

🧠 Internals

On hyper.begin():

1. Tries to connect to saved Wi-Fi
2. Starts AP-mode if not configured
3. Sets up DNS and HTTP provisioning
4. Initializes nikolaindustry-realtime connection
5. Loads deviceid, ssid, email, productid, and versionid from Preferences
6. Registers default and user-provided command handlers

---

📚 Dependencies

• hyperwisor.com
• WiFi.h
• ArduinoJson
• nikolaindustry-realtime
• Preferences
• Update
• DNSServer

Install all via Arduino Library Manager.

🧾 License

Hyperwisor IoT Arduino Library License

Copyright (c) 2025 NIKOLAINDUSTRY

License Type: Proprietary - All Rights Reserved

This software and associated files (the "Library") are the exclusive property of NIKOLAINDUSTRY. You are NOT permitted to copy, modify, distribute, sublicense, or reverse engineer any part of this code without express written permission from NIKOLAINDUSTRY.

You MAY:

• Use this Library exclusively with NIKOLAINDUSTRY hardware or software platforms.
• Integrate the Library into closed-source commercial or industrial applications developed in partnership with NIKOLAINDUSTRY.
• Contact NIKOLAINDUSTRY for licensing terms to enable distribution or broader use.

You MAY NOT:

• Redistribute, sell, sublicense, or disclose this Library or any derivative works.
• Modify or decompile the source code for any purpose other than evaluation or integration with authorized systems.
• Use this Library in any open-source project, public-facing repository, or third-party product without prior written approval.

Disclaimers

• NO WARRANTY: This software is provided "as is" without any warranties of any kind, whether express or implied, including but not limited to warranties of merchantability or fitness for a particular purpose.

• NO LIABILITY: In no event shall NIKOLAINDUSTRY, its employees, or its affiliates be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including hardware damage, data loss, or system failure) arising in any way from the use or inability to use this Library.

• NOT FOR CRITICAL SYSTEMS: This Library is not certified for use in life-support, nuclear, military, or other safety-critical systems. Use in such environments is strictly prohibited.

Enforcement

Unauthorized use, duplication, or distribution of this Library may result in civil and criminal penalties and will be prosecuted to the maximum extent possible under law.

---

For commercial licensing, OEM partnerships, or distribution rights, contact:

NIKOLAINDUSTRY
Email: support@nikolaindustry.com
Website: https://nikolaindustry.com

🤝 Contribute

Suggestions, bug fixes, and pull requests are welcome. Help evolve the library to support more protocols and automation use-cases!

---