operations

Device Onboarding

Provisioning flow for registering hardware into an organization's project.

Device Onboarding

Prerequisites

  • Active Twinise organization and project
  • Device QR label accessible (encodes the factory-assigned hardware ID)
  • Wi-Fi credentials for the deployment site

Onboarding Workflow

  1. Scan the device's QR label with the Twinise mobile app.
  2. Provision Wi-Fi credentials and the device access token over BLE.
  3. The device joins Wi-Fi and publishes a connected event.
  4. The device shows connected once it authenticates to the broker, and active once its first telemetry lands.

Validation

Onboarding is confirmed by:

  • The device's BLE status characteristic reporting success
  • Its first published telemetry frame arriving in Twinise Cloud

If provisioning fails, the app rolls back the device record it created, so a retry starts clean.