Prepare
- Open this page in desktop Chrome or Edge.
- Use a USB data cable.
- Do not add the device to Home Assistant yet.
- Do not unplug anything while firmware is being written.
V3.0.0-beta.17 · unflashed device · guided first setup
Ready in five clear steps.
The RotaryKnob contains two processors. The orientation of the USB-C plug determines which one is connected. This wizard stores progress locally in your browser.
Checking browser …USB data cable required
- Prepare
- Display
- Turn
- Bridge
- Home Assistant
Install the display processor
Connect USB-C and select the port identified as ESP32-S3. The installer rejects other chip families.
Important: after writing reaches 100%, keep the dialog open, wait for “Installation complete”, select Next, and enter Wi-Fi in that same dialog.
Reverse USB-C
USB-C
↻Unplug
turn the connector by 180°
and reconnect it
turn the connector by 180°
and reconnect it
The display may briefly turn off. The second processor is now available.
Install the Home Assistant bridge
Select the port identified as ESP32 — without “S3” — and use the same Wi-Fi network.
Required bridge restart: after “Installation complete”, close the dialog, unplug USB for two seconds, and reconnect it in the same ESP32 orientation. This starts the newly flashed application before Wi-Fi setup.
After reconnecting, use the button below. Select the same ESP32 port and wait up to 10 seconds for Connect to Wi-Fi. This opens Improv without flashing again.
Finish in Home Assistant
This is one RotaryKnob with two chips. Install PassionWave through HACS first, restart Home Assistant, then power-cycle the RotaryKnob. PassionWave uses ESPHome 2026.7 to assign an individual encryption key to PassionWave RotaryKnob and PassionWave RotaryKnob Bridge without showing or asking you for a key.