Register a Device

Overview

Registering a device adds a hardware board to the dashboard so an assistant can recognize and use it. After registration, the platform knows which workspace the device belongs to, which board and firmware it runs, which assistant it is connected to, and whether it can receive configuration, voice sessions, themes, or hardware commands.

For ESP32 devices, the recommended path is the 6-digit activation code. This code is created during the OTA handshake when the device is online but not bound yet.

Before You Start

• The device has compatible firmware installed.
• The device is connected to Wi-Fi and can fetch platform configuration.
• You have permission to manage assistants or devices in the dashboard.
• For manual registration, you know the MAC address and board model.

Register a Device

Method 1: Activation Code (Recommended)

1. Power on the ESP32 device
2. Wait for it to connect to Wi-Fi and display a 6-digit activation code
3. In the dashboard, go to Devices
4. Click Add Device → Enter Code
5. Type the activation code
6. Select the assistant to connect it to
7. Click Bind

After connecting, the device receives assistant configuration on its next OTA check and can start voice sessions.

Method 2: Manual Registration

Manual registration is useful for headless devices, devices that cannot display an activation code, or when you want to prepare a device record before the hardware comes online.

1. Go to Devices
2. Click Add Device → Manual
3. Fill in:
   • MAC Address — Device hardware address
   • Alias — Friendly name (e.g., "Kitchen Speaker")
   • Board — Hardware model
4. Select the assistant to connect
5. Click Register

Device Info

Each device shows:

Move a Device to Another Assistant

To move a device to a different assistant:

1. Go to Devices
2. Click on the device
3. Click Change assistant
4. Select the new assistant
5. Click Save