Documentation

SaaS Device Onboarding Guide

Industry-grade setup instructions, MQTT topics, and platform features.

MQTT Credentials

How devices authenticate

After pairing a device and creating appliances, open the device page to generate a secure token. Store the token on the microcontroller and use it only for MQTT authentication.

Username

deviceId

Password

Secure token

Broker

SaaS MQTT URL

Transport

TLS on port 1883

MQTT Topics

Publish telemetry and listen for commands

Telemetry Publish Topic

`energy/device_id/appliance_label/telemetry`

Telemetry Payload

json

{
  "power": 120.5,
  "voltage": 228.0,
  "temperature": 36.2,
  "current": 0.53
}

Control Subscribe Topic

`cmnd/device_id/+/state`

Control Payload

json

{
  "pattern": "cmnd/device_id/appliance_label/state",
  "data": {
    "state": "ON"
  }
}