Arduino

Provisioning gives a device its Wi-Fi credentials and identity (device ID and user). The library persists these in Preferences, so it only happens once; on later boots the device connects automatically.

What `begin()` does

When you call device.begin(), the library:

Tries to connect with saved Wi-Fi credentials
Starts AP-mode if nothing is configured
Sets up DNS + an HTTP provisioning page
Initializes the realtime connection
Loads deviceid, ssid, email, productid, and versionid from storage
Registers default and user-provided command handlers

#include <hyperwisor-iot.h>
HyperwisorIOT device;

void setup() {
  Serial.begin(115200);
  device.begin();
}

void loop() {
  device.loop();
}

AP-mode provisioning (first boot)

If the device has no saved credentials, it starts its own Wi-Fi access point and serves a setup page:


AP SSID	`NIKOLAINDUSTRY_Setup`
AP password	`0123456789`

Connect to that network, open the provisioning page, and enter Wi-Fi + device details. The device saves them and restarts, connecting automatically from then on.

Manual provisioning

To set credentials from code instead of the AP page:

// Wi-Fi + identity in one call (userId optional)
device.setCredentials("MySSID", "MyPassword", "my-device-id", "my-user-id");

// Or individually
device.setWiFiCredentials("MySSID", "MyPassword");
device.setDeviceId("my-device-id");
device.setUserId("my-user-id");

Helpers to inspect and reset stored credentials:

if (device.hasCredentials()) { /* already provisioned */ }
device.clearCredentials();     // wipe and re-provision

Reading identity at runtime

String id   = device.getDeviceId();
String user = device.getUserId();

Next: API reference

Every method you can call on the device.

Overview

ESP-IDF

Arduino — Provisioning

What `begin()` does

AP-mode provisioning (first boot)

Manual provisioning

Reading identity at runtime

Next: API reference

​What begin() does

​AP-mode provisioning (first boot)

​Manual provisioning

​Reading identity at runtime

Next: API reference

What `begin()` does

AP-mode provisioning (first boot)

Manual provisioning

Reading identity at runtime