Firmware Installer
The primary ESP32-S3 firmware is installed only through this authorized browser installer. Factory and OTA images are not offered as standalone downloads.
▶ Watch the step-by-step installation videoInstall in the browser
Use a current desktop Chromium browser such as Chrome or Edge. Close every serial monitor before continuing. Firefox and Safari do not support this Web Serial workflow.
Selected: RoonPilot 2.0.2 · clean USB installation with erase
A clean return to version 1.0.2
This choice always installs the original RoonPilot 1.0.2, not the latest release or Waveshare's manufacturer firmware. It works over USB without needing RoonPilot's local website.
- All settings and the profile library on RoonPilot are erased. Erasing is mandatory for this recovery. Set up Wi-Fi and Roon again after installation. The Companion processor and separate IR Bridges are not flashed.
- Before upgrading from 1.0.2, keep a configuration backup made under 1.0.2. Do not import a 2.0.x backup into 1.0.2; keep it for a later return to 2.0.2.
- The IR Bridge functions and extended group controls introduced in 2.0.0 are unavailable in 1.0.2.
- Do not run battery calibration in 1.0.2. It does not include the calibration safety improvements added in 2.0.0.
Entry in the device chooser
Use these names in the Web Installer device chooser. The name before the parentheses is what matters:
| Target device | Windows | macOS |
|---|---|---|
| RoonPilot main ESP32-S3 | USB JTAG/serial debug unit (COM…) | USB JTAG/serial debug unit (cu.usbmodem…) |
| RoonPilot companion, classic ESP32 | USB serial (COM…) | USB serial (cu.usbserial… or cu.wchusbserial…) |
| Separate IR Bridge, ESP32-S3 | USB JTAG/serial debug unit (COM…) | USB JTAG/serial debug unit (cu.usbmodem…) |
Select the first row here. No preliminary operating-system or esptool check is required. If the open chooser shows USB serial, unplug USB, turn the USB-C plug at the round RoonPilot device by 180° and reconnect it. The Web Installer immediately detects the device again. The Bridge row applies only to the separate Bridge Web Installer.
Erase during a Factory installation
Erase is mandatory and performed automatically before flashing. There is no optional erase checkbox to leave unchecked. Save any configuration backup you need before continuing. This clean installation erases all settings and profiles on RoonPilot, including Wi-Fi and Bridge pairings. Set up Wi-Fi and Roon again afterward and pair your Bridges again. It does not flash the companion ESP32 or any separate Bridge.
Available only through the Web Installer above. It erases the ESP32-S3 before installing RoonPilot.
RoonPilot's internal online updater is temporarily suspended. Use the USB Web Installer above.
Companion Sleep firmware
It releases shared signals, mutes the unused DAC path and puts the board's second ESP32 into deep sleep. RoonPilot also works fully without it.
The normal installation also needs no Python or command line and uses its own Web Installer. Select USB serial in the browser chooser, not USB JTAG/serial debug unit.
Open the Companion Web InstallerLicense and third-party notices
Official, unmodified RoonPilot firmware may be installed and used privately on supported hardware. RoonPilot-authored code, assets and integration may not be redistributed, modified, reverse engineered or used in another product. Independently licensed third-party components retain their own rights and licenses.