Guide: toneLight firmware upgrades

Download the firmware file
Obtain a firmware file with a .bin extension. The filename includes a unique ID for bug reporting (e.g. merged-2bd110d.bin).
Click to download latest firmware (2bd110d, 2025-10-30)
Prepare the unit for flashing
In this order, remove all cables from the rear of the device: POWER (USB-PD), PC, MOTOR.
Never unplug or plug in the motor cable when the device is powered on as this may permanently damage the motor driver.
Connect the toneLight
Connect the toneLight to your PC or Mac using a USB-C cable by inserting the other end into the port labelled “PC”.
Enter bootloader mode
Hold down the BOOT button, short-press the RST button (while still holding BOOT), then release BOOT.

You may need to use a pen or small Allen key to reach the buttons.
After the sequence, try turning the front dial. If it does nothing, the device has successfully entered bootloader mode.
Open the flashing tool
Go to https://esptool.spacehuhn.com/ using Chrome, Edge, Brave, or Opera.
Connect the device
Click “Connect” and select ESP32 or TinyUSB from the list.
Prepare the flashing interface

Remove extra lines by pressing the delete button on three of them, leaving only one.

In the input field labelled 0x, enter 0.
Select the firmware file
Click “Select” and upload the .bin file downloaded earlier.
Flash the firmware
Press the green “PROGRAM” button and wait for the upload to complete.
Do not unplug the USB cable during flashing.
Reset the device
When prompted, press the RST button on the back of the toneLight to exit bootloader mode.
Verify operation
The front panel should show the boot animation. You can now control the LED panel using the buttons and dial.