Connect a MicroPython Device

Register a device and generate credentials

From the dashboard: Devices → Register Device, then open the new device's Credentials tab and click Generate Credentials. This is the same step Register Your First Device covers in more detail if you haven't done it before.

Copy the MicroPython config block

On the Credentials tab, switch to the MicroPython (Python) toggle. It generates a config.py with this device's real host, port, username, and password already filled in - copy it as-is:

NXW_DEVICE_ID = "dev_a1b2c3"
NXW_MQTT_HOST = "mqtt.nexalware.com"
NXW_MQTT_PORT = 1883
NXW_MQTT_USER = "d_a1b2c3d4"
NXW_MQTT_PASS = "••••••••••••••••"
NXW_TOPIC_CMD = "nexalware/devices/dev_a1b2c3/command"
NXW_TOPIC_STATUS = "nexalware/devices/dev_a1b2c3/status"

Save it as config.py on your device's filesystem, alongside main.py. The password is only ever shown once - if you lose it, generate new credentials rather than trying to recover it.

Run the reference firmware

MicroPython Reference has the full, annotated code - connect, subscribe to the command topic, dispatch on cmd, publish status. Copy it to main.py next to your config.py and run it (over the REPL with mpremote, ampy, or Thonny, or however you normally deploy to this board).

Confirm it's live

Back on the dashboard, the device card flips to online and lastSeen starts updating - that's the status message your firmware just published arriving over the same bridge the API and WebSocket feed read from. Send a command from the dashboard (or curl, using Send a Command with an API Key) and confirm your firmware's on_message callback fires.