Your Local Firmware Guide

​

Hardware Setup

​

What you’ll need

1. ESP32-S3 (by Espressif / Arduino)
2. Cables
3. INMP441 (I2S mic)
4. MAX98357A (I2S amp)
5. Speaker
6. LED
7. Button / Touchpad
8. USB cable (power)

​

Pin Connections

​

Config Settings

// ---------- CHOOSE YOUR MODE ----------
// Pick one of the following (DEV_MODE, PROD_MODE, ELATO_MODE) , comment the rest
// For ELATO_MODE, you will need to register your DIY Hardware on the Elato website

#define DEV_MODE
// #define PROD_MODE
// #define ELATO_MODE


// ---------- Touch mode ----------
// If you want to use the touch sensor to wake up the device, uncomment the following line
// If you want to use the button to wake up the device, comment the following line
#define TOUCH_MODE

​

Server settings (src/Config.cpp)

4. Edit src/Config.cpp with your server details:
   • If using locally: Set your computer’s IP address in ws_server and backend_server
   • If using production: Ensure you have proper certificates set

​

What’s my IP address?

1. View your Wifi IP when you click on Wifi Settings > Your Wifi Network > Details, OR
2. On macOS/Linux: Open Terminal and run ifconfig
3. On Windows: Open Command Prompt and run ipconfig
4. Look for your active network interface (WiFi: en0 on Mac, wlan0 on Linux, Wireless LAN adapter Wi-Fi on Windows)
5. Note the IP address (e.g., 192.168.1.100)
6. Update the ws server and backend server IP to your local IP address

​

Ready to Flash your ESP32? ⚡️

PlatformIO (recommended)

Arduino IDE

​

FAQs

​

What’s NVS Storage?

1. Auth token: The supabase auth token that is used to authenticate the device with the backend server.
2. Factory reset: Whether the device has been factory reset.
3. Wifi credentials: The wifi credentials of the device.

​

How do I connect my ESP32 to Wifi?

1. Power on your ESP32
2. You should see a WiFi network named ELATO-DEVICE appear in your phone / laptop’s WiFi network list
3. Connect to this network
4. Navigate to 192.168.4.1 in the same phone / laptop’s browser
5. Enter your home WiFi credentials
6. Power the device ON and OFF
7. Your ESP32 will now connect to the locally hosted NextJS web-app and Deno server on the same network!

​

What do the lights mean? 🤔

​

Troubleshooting

• If connection fails, check your WiFi signal and that the local server is connected to the same network as the ESP32.
• Make sure an auth_token has been generated by calling the generate_auth_token endpoint on the NextJS web-app.
• Monitor serial output at 115200 baud for detailed logs.