Your ESP32 must be initially installed with the Toit firmware, before you can benefit from the Toit platform and all the features available. The initial installation is done with a cabled connection to the ESP32, usually USB.

Provisioning means that the Toit firmware will be installed on the ESP32, along with WiFi credentials allowing it to go online, connect to the Toit cloud, and receive configuration updates, firmware updates, and app installations. In addition, the ESP32 is being granted a unique hardware identity used for the remaining of its lifecycle.

Additional connection settings can be added later on from the Configuration tab in the console.

Once the ESP32 is provisioned it will immediately go online and all subsequent communication with the ESP32 will be over-the-air.

Note that your computer does not need to be on the same WiFi network as your ESP32 in order for it to go online during initial provisioning. During provisioning you simply supply your preferred WiFi credentials to the device, and it will subsequently use that WiFi to go online.

The ESP32 cannot connect to 5GHz WiFi networks. Use a 2.4GHz WiFi network instead when connecting.

Provisioning steps

Install USB driver

If you are using macOS or Windows, you might need to install or update the USB driver, if you have problems with the serial connection.

Follow the link to the USB driver here.

If you still have trouble connecting your ESP32 via a serial port to your computer, please visit the troubleshoot section.

Provision your ESP32 using the Web Serial interface and follow the steps in the guide.

The serial connection is useful for debugging and reconfiguring the device if WiFi connection is lost.