TOMMY Flasher

TOMMY includes a built-in web-based flasher that allows you to flash ESP32 devices from your browser.

Requirements

Connect your device to your computer via USB or UART
Click "Connect device" in the flasher interface
Select the appropriate serial port from the browser dialog
The flasher will automatically detect your device and display:
- Variant: Device model
- Board ID: Unique chip identifier
- MAC Address: Device network identifier

Once flashing is complete, your device will:

Restart with TOMMY firmware
- Some devices don't restart automatically and require a manual reset by pressing the reset button or unplugging and reconnecting the USB cable
Enter serial provisioning mode - waiting for configuration over the USB connection

Configuration is sent to the device over the same USB/serial connection used for flashing:

In the TOMMY Flasher, disconnect the USB cable from the device, then reconnect it
Click "Connect device" and select the serial port
Enter your configuration in the dialog:
- Wi-Fi SSID (required): Your Wi-Fi network name
- Wi-Fi Password (required): Your Wi-Fi password
- Router BSSID (optional): Router MAC address (e.g., AA:BB:CC:DD:EE:FF) - required for mesh networks
- Instance IP (optional): The IP address of your TOMMY instance - fallback when mDNS is unavailable
- UDP Relay Port (optional): Defaults to 8547
- Max TX Power (optional): In dBm (2–20), rounds to nearest 0.25 dBm - leave empty for default
Click "Configure Device" to send the configuration
The device stores the configuration, restarts, and connects to your network - initial boot may take a few minutes

Make sure to use the correct Wi-Fi band (2.4GHz or 5GHz) that your device supports.

Router BSSID is optional but required for TOMMY to work on mesh networks. Please refer to the information about mesh networks in system requirements.

Instance IP and ports are optional but recommended as a fallback for when auto-discovery using mDNS isn't possible.

If you can't connect to your device: