This blueprint provides a comprehensive and flexible way to control your Philips Hue Tap Dial Switch (RDM002) via ZHA.
It features two distinct dimming modes to fit your personal workflow and includes a robust logic to handle the rotary dial without “stuttering” or blocking other actions.
Key Features
- Full Button Support: Supports Press, Double Press, Triple Press, Quadruple Press, Quintuple Press, Hold, Short Release, and Long Release.
- Two Dimming Modes: Choose between a “Standard” click-to-select style or an “Advanced” hold-to-dim style.
The Two Dimming Modes
You can select your preferred mode in the blueprint settings.
1. Standard Mode (Default)
How it works:
- The button short-pressed last (1-4) selects the associated light.
- Turn the dial to dim the currently selected light.
Button Behavior:
- Short Press: Selects the light AND executes your custom action (e.g., toggle scene).
- Hold: Executes your custom hold action.
Use Case:
Best if you usually control one room/zone and want to tweak brightness without holding buttons.
2. Advanced Mode (Hold-to-Dim)
How it works:
- Hold a button (1-4) to temporarily “select” the associated light.
- Turn the dial while holding (or immediately after) to dim that specific light.
- Release the button to stop the dimming session.
Button Behavior:
- Short Press: Executes your custom action immediately.
- Hold: Selects the light for the dial. The custom “Hold” action is suppressed to prevent conflicts.
- Long Release: Only triggers if you did not rotate the dial.
Use Case:
Best for Power Users, as it requires more computing power and events will be missed more easily.
Prerequisites (Required Helpers)
To store the logic state, this blueprint requires 1 Helper in Standard or 3 Helpers in Advanced Mode. You must create these in Home Assistant (Settings > Devices & Services > Helpers > Create Helper) before setting up the blueprint.
| Helper Type | Name (Example) | Entity ID (Example) | Dimming Mode |
|---|---|---|---|
| Text | Hue Tap: Selected Light |
input_text.tap_dial_selected_light |
Both |
| Toggle | Hue Tap: Dimming Active |
input_boolean.tap_dial_dimming_active |
Advanced |
| Toggle | Hue Tap: Dimming Happened |
input_boolean.tap_dial_dimming_happened |
Advanced |
Note: You can name them whatever you want, but remember to select them correctly in the Blueprint inputs.
Optimization Tips
For the best experience, especially on slower hardware (e.g., Raspberry Pi 3) or busy Zigbee networks:
-
Recorder Exclusion: Exclude the 3 helpers from your
recorderinconfiguration.yaml. This prevents SD card wear and database lag, as the rotary dial updates these values very frequently. -
When running the blueprint on less powerfull I suggest you use the default mode.
Feedback is welcome! Let me know if you have any questions or suggestions for improvement.