Claiming

Toit devices must be claimed in order to be visible in the Devices list in the Toit console.

When a device has been claimed, it belongs to a Toit project. Only users that have access to the given Toit project can communicate with the device via the Toit cloud.

Usually, devices are claimed automatically as part of the initial provisioning step. If the device wasn't able to connect via WiFi to the Toit cloud during provisioning, then the device needs to be claimed manually when the device can go online via WiFi.

Get the hardware ID

Connect the ESP32 to a computer with a USB cable. It requires 3.3V voltage.

Open the serial page in the Toit console, and click the button to connect the ESP32 via the web serial interface.

If the ESP32 has been provisioned, the hardware ID is printed at the top of the page.

Get ESP32 online

The ESP32 must be connected to the internet via WiFi before you can claim it into your project. Start by ensuring that the correct WiFi credentials were provided during provisioning.

You can use the Monitor button in the serial page to verify whether the ESP32 tries to connect to the Toit console via WiFi.

If connection fails, add the correct WiFi credentials again using the Reinstall button.

Also, if the WiFi connection is unstable, the claim step might fail, so try to use another WiFi, if possible.

Claim device

Manually claim the ESP32 into your Toit project by navigating to the Toit console and click the "Add device" button in the upper right corner. Choose "Claim existing" in the view. Enter the hardware ID of the ESP32.

An optional device name can be provided. If left blank, a random name will be assigned to your ESP32. Click Claim. The device is assigned a device ID.

The device can now be viewed in the list of devices.