Skip to main content
This client uses the light server.

​
Video Guide

To set up the ESP32 for use with 01, follow this guide to install the firmware:
1

Download Arduino IDE

Download Arduino IDE

Get the Arduino IDE
2

Get the firmware

Get the firmware by copying the contents of client.ino from the 01 repository.

View client.ino

View the ESP32 firmware source code
Copy client.ino contents
3

Paste firmware into Arduino IDE

Open Arduino IDE and paste the client.ino contents.Paste client.ino contentsPasted client.ino contents
4

(Optional) Hardcode credentials

Hardcode your WiFi SSID, WiFi password, and server URL into the top of the client.ino file.Hardcode WiFi SSID and passwordHardcoding is recommended for a more streamlined setup and development environment. However, if you don’t hardcode these values or if the ESP32 can’t connect using the provided information, it will automatically default to a captive portal for configuration.
5

Install ESP32 boards

Go to Tools -> Board -> Boards Manager, search “esp32”, then install the boards by Arduino and Espressif.Install ESP32 boards
6

Install required libraries

Go to Tools -> Manage Libraries, then install the following:Install M5Atom libraryInstall all M5Atom dependenciesInstall WebSockets libraryInstall AsyncTCP libraryInstall ESPAsyncWebServer libraryInstall all ESPAsyncWebServer dependencies
7

Connect the board

To flash the .ino to the board, connect the board to the USB port.Connect USB
8

Select board and port

Select the port from the dropdown on the IDE, then select the M5Atom board (or M5Stack-ATOM if you have that).Select Board and Port
9

Upload firmware

Click on upload to flash the board.Upload firmware
10

Start the 01 server

Start the 01 server on your computer:
poetry run 01 --server light
This command starts the server and generates a URL.For remote connections, use:
poetry run 01 --server light --expose
This generates a public URL accessible from anywhere.
11

Connect ESP32 to the server

Connect your 01 device to the server using one of these methods:a) Hardcode credentials:
  • Modify the Wi-Fi and server credentials at the top of the client.ino file.
  • Flash the modified file to the ESP32.
  • This method is quick but less flexible for changing details later.
b) Use the captive portal:
  • Power on your 01 device.
  • Connect to the ‘01-light’ Wi-Fi network from your computer or smartphone.
  • A captive portal page should open automatically. If not, open a web browser.
  • Enter your Wi-Fi details and the server URL from step 1.
  • Click ‘Connect’ to save settings and connect your device.
After successful connection, your ESP32 will be ready to communicate with the server.