01 · Before you start
DialCaptain connects a Philips Hue Tap Dial RDM002 over Zigbee to an ESP32-C6 Zero with 8 MB flash. The ESP then sends commands over your Wi-Fi to Roon, BluOS, WiiM, an RME Bridge or Sonos. Optional modules also allow direct IR commands. Your existing audio system continues to play the music.
- A computer with Chrome or Edge, a USB data cable and the ESP. A charge-only cable is not enough. If you have trouble with a USB hub, use a direct computer port.
- Your 2.4 GHz Wi-Fi name and password. The computer, ESP and player or Roon Server must be able to communicate on your home network. An isolated guest network is unsuitable.
- For Roon: a running Roon Server and an existing playback zone. For BluOS, WiiM or Sonos: a configured player; ideally create your desired presets in its app beforehand.
- The Tap Dial uses one CR2032 battery. Philips Hue specifies at least two years of battery life. The ESP needs continuous USB power; a small, stable 5 V USB power supply is sufficient. A high-power fast charger is not required. The computer is only needed for USB setup.
The battery-life figure is a manufacturer specification for the Tap Dial and depends on use. No DialCaptain long-term measurement is available yet. The ESP’s actual power consumption has not been measured either.
No Hue Bridge, RoonPilot, Home Assistant or extra computer service is required. A Tap Dial belongs to one Zigbee network; it cannot be paired with a Hue Bridge and DialCaptain simultaneously.
More devices and future extensions
Network audio equipment from other manufacturers could be supported through an additional integration if its reachable REST API provides suitable commands and allows the required access. Each integration must be implemented and tested on the device; suitable test devices are currently missing. The development build contains six profiles: Roon, BluOS, WiiM, infrared, RME Bridge and Sonos. Read about future extensions.
02 · Install over USB
The Web Installer writes firmware over USB. The same assistant then guides you through Wi-Fi, server selection or restoration. You do not need a development environment or speculative driver downloads.
- Prepare for a clean installation: The current package installs firmware and storage together and removes all settings and Tap Dial pairing. Export a current format 2 backup if you want to restore it afterwards. Old format 1 backups are not imported.
- Connect the ESP directly: Plug a USB data cable into the computer and ESP32-C6. Close serial monitors and other browser tabs that have opened this device.
- Open the installer: Use the button below in Chrome or Edge on your computer. A hosted page needs HTTPS; the local preview on
localhostalso works. Do not open the HTML file by double-clicking it.
- Choose “Install firmware”. The browser opens its USB device chooser. Select your connected ESP and click Connect. Its name is often USB JTAG/serial debug unit or similar.
COM…on Windows andcu.usbmodem…on macOS are port names and may differ. - Select “Install DialCaptain” and confirm the clean installation. All settings are removed; firmware and the current storage layout are installed together.
- Confirm installation and wait. Do not disconnect the cable or close the browser. Wait for the completion message, not merely a progress bar.
- Close the installer dialog. This releases the serial connection. If the firmware does not start after flashing, release BOOT and press RESET once. Wait for the USB device to reappear.
- Choose “Start setup” below, select the ESP again and connect. Now choose “Set up as new” or “Restore backup”. Restoration can start immediately, before Wi-Fi has been configured.
No device listed or connection failing?
- Try another USB data cable and a direct USB port. Check that Chrome or Edge is allowed to show the USB chooser and no other program owns the serial port.
- For empty flash, or if automatic entry fails: hold BOOT, briefly press and release RESET, then release BOOT. Select the newly detected port again in the browser. This enters download mode without erasing settings.
- After successful flashing, leave BOOT released; press RESET once if necessary and start USB setup again.
This sequence follows the Waveshare C6 Zero instructions. It differs from holding BOOT for three seconds when DialCaptain firmware is already running.
03 · Wi-Fi & server
Set up as new
- After “Start setup”, connect the ESP and choose Set up as new.
- Select your 2.4 GHz Wi-Fi from the list. “Search again” refreshes it; enter the network name manually for a hidden network. Enter the password only in its password field.
- Click “Test connection and save”. The ESP checks connectivity and only saves the new credentials after success. This can take about 20 seconds. If it fails, follow the displayed explanation; a failed attempt does not replace stored credentials.
- If the ESP is already connected, choose “Use connected Wi-Fi”.
If you want to use Roon
- Select the discovered Roon Server and click “Select server and save”.
- If it is missing, check that Roon Server is running. Search again or enter its IP/hostname and API port under “Add a server by its address”. The default is 9330. “Check server” verifies its identity before saving.
- In Roon, open Settings → Extensions and enable DialCaptain. Use “Check connection” in the assistant to refresh its status. Select your zone afterwards through the extension’s settings gear.
BluOS, WiiM, RME Bridge and Sonos do not require Roon approval. Once Wi-Fi is connected, choose “Activate web configuration” → “Open web configuration” in the additional section; skip the Roon Server selection.
192.168.4.1.04 · Pair the Tap Dial
First pairing works without an already assigned remote. After configuring Wi-Fi, activate and open web configuration from the USB assistant. Alternatively hold BOOT on the running ESP for three seconds and open its known IP address.
- In “Pair Philips Hue Tap Dial”, choose “Pair your first Tap Dial”. Joining is open for three minutes.
- Place the new Tap Dial near the ESP. Hold button 1, marked with one dot, for about three seconds until its LED blinks.
- The browser shows Searching → Checking → Setting up → Done. During setup, press a button briefly from time to time to keep the battery-powered remote awake. These presses do not send music commands while pairing is active.
- The assignment is only saved at Done. Now choose your audio mode and button mappings.
Previously paired with a Hue Bridge or another ESP?
Reset only the Tap Dial itself: hold the SETUP button on its back for more than ten seconds. This removes its former Zigbee association. Then hold button 1 for about three seconds while the joining window is open. The ESP does not need a factory reset.
Set up again or replace
“Set up the current Tap Dial again” repairs setup for the same remote; normally a brief press to wake it is enough. “Pair a different Tap Dial” asks for confirmation and only replaces the existing assignment after complete success. One ESP uses one assigned Tap Dial. Cancellation or expiry does not erase your current assignment or audio settings.
References: Philips Hue manual and product FAQ.
05 · Roon control
- On the device webpage, select Control mode → Roon and save if another mode is active.
- In Roon, open Settings → Extensions → DialCaptain, enable it and open its settings gear.
- Choose Language / Sprache. It is independent of the Roon app language.
- Select your desired Roon zone from the list.
- Set Dial sensitivity and Steps per click separately. Choose 1–4 native Roon steps. For example, with an output using 0.5 dB per native step, two steps give 1 dB per click. The selected Roon volume provider determines the unit and resolution.
- Assign each of the four buttons a short and long action, such as Play/Pause, next/previous track, mute or a favourite.
- For each of the three favourites, choose Roon playlist or Roon radio station, then select the entry from the list. Radio entries come from My Live Radio. Use the next/previous pages for longer lists; there is no need to type names.
- Save. At a low listening level, try one command first. The extension status line also shows the Tap Dial battery reading after its first report; until then it says that no reading is available.
The screenshot shows an example zone with two native Roon steps per click. An RME Bridge can act as the volume provider in Roon; DialCaptain does not need its own RME or IR connection. A fixed-volume output may not be controllable with the ring.
06 · BluOS control
- Open the device webpage and select Control mode → BluOS control.
- Choose your player from network discovery. It shows names, models and addresses. If the list is empty, enter its IP address or hostname manually; the default port is 11000. Use “Check player & load presets” to confirm the device. Discovery and checking do not start playback.
- Select three presets already stored on the player. Set up desired stations, playlists or other content as BluOS presets first; DialCaptain does not manage their contents.
- Assign short and long actions: Play/Pause, play, pause, previous/next, toggle mute, stop, preset 1–3 or no action. The player’s current source determines which transport actions are supported.
- Choose sensitivity and 0.5 / 1 / 2 dB per click. Player limits and actual resolution still apply. A fixed output level is respected.
- Save settings. Saving activates your selection. The Roon and WiiM profiles remain stored.
Volume commands address the chosen BluOS player without explicitly adjusting its other group members. Failed or old commands are not replayed later. Tested examples do not imply that every BluOS model, source and grouping combination has been tested.
07 · WiiM control
- In WiiM Home, save your chosen content as presets. Depending on the service, a preset may start radio, a playlist, an album or other content.
- Open the device webpage and select Control mode → WiiM control.
- Select your discovered WiiM or enter its IP address. The local HTTPS API normally uses port 443. “Check player & load presets” verifies the device and reads up to twelve presets.
- Choose three favourites from those presets and assign short/long button actions. Previous/next only work with sources that support them.
- If you want to control the WiiM’s own volume, enable “Control WiiM volume with the dial”. It is initially disabled for a new profile. Set 1 / 2 / 5 percentage points per click and sensitivity independently.
- Save settings. Other mode profiles stay stored.
DialCaptain does not browse entire streaming-service catalogues; presets are managed in WiiM Home. According to the WiiM API, mute may also affect members of an existing WiiM group. DialCaptain does not create groups. Integration has been tested with a WiiM Ultra; other models and sources may behave differently.
08 · Infrared control
Connect IR modules directly to the DialCaptain ESP and use the Tap Dial like an audio remote. Learn up to ten commands, assign volume up/down to the ring and assign the four buttons' short/long presses. Other control profiles stay saved.
Optional modules and wiring
Use an Adafruit 5639 High Power IR emitter and a KY-022/CHQ1838 IR receiver, as used by the RoonPilot IR Bridge. Unplug USB before wiring and check the markings on your actual modules.
| Module pin | ESP connection |
|---|---|
| Emitter SIG | GPIO14 |
| Emitter V+ | 5 V |
| Receiver S/OUT | GPIO0 |
| Receiver + | 3.3 V |
| Both GND/− | Common ESP ground |
Viewed from the component side with USB at the bottom: GPIO14 is the third left pad from the bottom; GPIO0 is the fourth right pad. The right-hand bottom pads are 5 V, GND and 3.3 V. Keep wires short at the USB end, away from the antenna. Never apply 5 V to a GPIO. Supply ESP and emitter from stable 5 V USB power.
Check the Waveshare pinout. RGB, BOOT and USB remain available.
Learn and assign commands
- Open temporary web configuration and choose Infrared control.
- Enter a command name, such as Volume up, and choose Learn. Aim the original remote at the receiver from about 10–30 cm away.
- Following the first prompt, briefly press and release the desired button. Wait for the second prompt, then briefly press the same button again. Each capture allows 15 seconds. Do not hold the button.
- Matching captures are saved together. Mismatch, timeout or cancellation preserves the previous command. The board LED blinks amber during learning, then briefly green on success or red on error.
- Test sends one real button step. Keep the audio output low while testing. Learn volume down and any playback, input or power commands provided by your remote.
- Assign commands to the ring and the four short/long button actions. Choose sensitivity and 1–3 IR button steps per click. Select Save IR assignments, then Save settings below to activate the mode.
The IR Bridge's proven volume cadence is retained. Fast rotation uses a small fresh queue; reversing direction discards the old backlog. IR cannot provide an absolute dB reading or acknowledgement from the player. Normal IR operation needs neither Roon nor working Wi-Fi; learning uses web configuration.
Defaults are 38 kHz and 33% duty. A demodulating receiver cannot measure the carrier. Change advanced settings only for a remote needing another carrier. NEC/extended NEC and suitable repeatable RAW frames are supported; changing toggle/rolling codes and very long or multi-frame appliance signals are not generally guaranteed. Learned commands and assignments are included in current backups.
09 · RME Bridge control
Control the RME DAC directly through an RME Bridge on your home Wi-Fi. Neither Roon nor RoonPilot is needed for this profile. The ring follows the DAC’s currently active output; this mode does not control music playback or playlists.
- Open web configuration and select Control mode → RME Bridge.
- Enter the bridge’s IP address or hostname and HTTP port, normally 80. Choose Check bridge; this reads status without changing the DAC. The bridge needs compatible firmware, 0.3.0-dev.12 or later.
- Choose sensitivity, 0.5 / 1 / 2 dB per click and optional limited acceleration. An optional volume ceiling limits levels requested by DialCaptain.
- Assign short/long buttons to mute, DAC power, AutoDark or output switching. Power commands use the RME Bridge’s IR emitter; DialCaptain does not need its own IR module for this.
- Save settings, then test at a safe, low listening level. Other profiles remain saved.
Higher output levels are reduced once to −60 dB on first contact and after a new DAC USB connection; quieter levels remain unchanged. Brief Wi-Fi interruptions do not repeat this protection. The optional operating ceiling is an additional setting.
The DAC remains the source of the displayed volume. If the bridge also connects to Roon, a DialCaptain volume change appears there too. Direct DAC on/off does not send Play/Pause to Roon. IR cannot confirm the physical power state. Direct control has been tested with the ADI-2 DAC FS; other RME models are not covered by this test.
10 · Sonos control
Control a Sonos room directly over your home Wi-Fi, using either an S1 or S2 system. Roon is not required, and you do not enter Sonos cloud credentials into DialCaptain. Configure the player and any music services in the appropriate Sonos app first.
- Activate and open the temporary web configuration. Select Control mode → Sonos control.
- Choose the desired room from network discovery. If it is missing, check the shared home network, choose Search again or enter the local address manually. The usual port is 1400.
- Select Check device to confirm the target. Discovery, checking and loading lists only read information; saving activates the new profile.
- Choose 1 / 2 / 5 percentage points per click and dial sensitivity. These are percentage points, not dB. The default is volume control for the selected room only. A fixed-level output cannot be adjusted with the ring.
- Optionally enable Control volume of the entire existing Sonos group. Playback and favourites already apply to the selected room’s existing group. DialCaptain does not create or split groups; S1 and S2 remain separate systems.
- For each of three favourite slots choose Sonos favourites or Saved Sonos playlists, then Load list and select an entry. Use Previous/Next for lists longer than four entries. Save the desired content in the Sonos app first.
- Assign short and long button actions. Defaults: button 1 short Play/Pause, long Toggle mute; buttons 2–4 short Favourite 1–3. Play, Pause, Stop, Next, Previous and No action are also available. The separate eight-second web shortcut remains available.
- Save settings. Test one quieter click first, then playback at a safe level. The other five profiles and their settings remain stored; the Sonos profile is included in settings export and restoration.
Playback, playlists and groups
Starting a saved playlist replaces the existing group’s queue. Next/Previous depend on the source. Radio sources that offer Stop instead of Pause are stopped by the pause action and can be resumed with Play. Sonos power on/off is not offered. Music-service availability and any subscription requirements remain those of Sonos and the service.
Changing the target address requires another device check. Selecting a different Sonos device clears the Sonos favourite assignments in the form, so selections from different S1/S2 systems are not mixed. Select the appropriate content again and save.
A favourite is listed but will not play
A saved entry can remain in Sonos even when its stream URL or music service no longer works, especially after years without use. Test the same entry in the appropriate Sonos app, then save a current, working station or playlist and load the list again. A service folder without directly playable content cannot be started as a favourite. Discovery or a visible list alone does not prove that the content can play.
11 · Web configuration
The web server is only needed for configuration and normally stays closed. The ESP still retains its network address.
| Entry point | How it works |
|---|---|
| Tap Dial | By default, hold button 4 for at least eight seconds and release. Repeat this extra-long press to close the web server. It does not trigger the normal short/long action. Choose another button or disable just this shortcut in web configuration. |
| ESP BOOT button | Hold for three seconds on the running ESP to toggle the web server. Do not press RESET. |
| USB assistant | Connect the ESP; after the Wi-Fi step choose Activate web configuration, then Open web configuration. This works before your very first Tap Dial pairing. |
The RGB LED gently blinks amber while web configuration is active. In a normal browser open the address shown by the assistant, for example http://192.168.1.50/. That is only an example; your router assigns the actual address. Your phone or computer must be able to reach the ESP on your home network.
The page shows the remaining time. Extend by 10 minutes gives you more time; Close now ends it immediately. After ten minutes without interaction the HTTP service stops; background status polling does not extend the session. Zigbee, Wi-Fi and audio control keep running. Closing the web server does not put the ESP into deep sleep.
The device page offers German/English, mode selection, pairing and file backup. Roon’s button actions and favourites are still configured through the extension settings gear.
12 · Backup & updates
Export settings
Under “Back up and restore” on the device page or USB assistant choose “Export settings”. Your browser downloads a JSON file to your computer. It includes the saved state, not unsaved form edits.
- Wi-Fi credentials, active mode and web-access shortcut.
- Roon Server, authorization, zone, language, buttons, favourites, sensitivity and steps.
- Complete BluOS, WiiM, RME Bridge and Sonos profiles, including inactive modes and their favourite assignments.
- All learned IR signals, names, signal settings and IR assignments.
- The selected Tap Dial and stored Zigbee network/pairing information for the same ESP.
No extra password or cloud account is required. The file contains Wi-Fi and pairing keys: keep it private on your computer and do not attach it to a public bug report. Importing it onto a different ESP is not supported.
Restore directly after a clean USB installation
- Close the installer dialog after flashing.
- Choose Start setup, connect the same ESP and choose Restore backup. Wi-Fi does not have to be configured yet.
- Select the current format 2 JSON file and review the summary, including its learned IR command count. Uploading and checking it does not yet change active settings.
- Confirm replacement and choose Prepare restoration.
- Use the separate Restart now button to apply it. Until then, other settings and audio-button commands are blocked. Keep power connected while restoration is being applied.
- Reconnect USB if necessary, or open the restored network address. Wake a sleeping Tap Dial with a brief button press.
Future firmware updates
DialCaptain has no dedicated OTA updater. Use the current complete USB package. The installer performs a clean installation and removes settings. A current format 2 backup can be restored immediately afterwards in the USB assistant. Old installations and the previous format 1 are not migrated automatically.
13 · Troubleshooting
| Observation | Next step |
|---|---|
| No USB device / connection fails | Check a data cable, direct USB port and Chrome/Edge. Close serial monitors. For a factory-new/empty ESP, use the BOOT/RESET sequence above. |
| No setup after flashing | Close the installer dialog, release BOOT, press RESET once, then select “Start setup” and the newly detected ESP. |
| Wi-Fi connection fails | Check 2.4 GHz, the exact network name and password. Avoid isolated guest Wi-Fi. Retry over USB; a failed connection test does not replace saved credentials. |
| Device page does not load | Activate the temporary web server first. Use the actual ESP address shown by the assistant/router and check reachability on the same network. |
| Roon Server or player missing | Check that it is running. Network segmentation can filter discovery. Search again or check a manual address. Use 9330 for Roon, 11000 for BluOS, normally 443 for WiiM, normally 80 for RME Bridge and normally 1400 for Sonos. |
| Tap Dial does not respond | Check its battery, assignment and active mode. Wake it briefly. Try “Set up again”. Deliberately reset an already elsewhere-paired remote when required, not the ESP. |
| Playback works, volume does not | Check the output in Roon. Respect fixed volume in BluOS; enable WiiM’s separate dial option and check its output configuration. Direct WiiM control does not adjust an external RME DAC; use RME Bridge for direct DAC control or Roon mode for its Roon volume provider. |
| Sonos favourite will not play | Test the same entry in the appropriate Sonos app. Old streams or unavailable music services may remain in the favourites list. Save current content, reload the list, select it and save. Sonos help. |
| Sonos dial does not change volume | Check the active profile, verified target room and fixed-level output. Room and group volume are separate options. |
| Restore is rejected | Use the correct format from the same ESP. Preserve the error text. Do not import another coordinator’s pairing data or erase settings hastily. |
When reporting a problem, include the firmware version, mode, board model, failing step and exact error text. The USB installer console can help diagnose it. Do not copy Wi-Fi passwords or backup files into public reports.
Technical references: ESP Web Tools, ESP32-C6 USB connection, BluOS API, WiiM API.