Welcome to the Button Events, Rotary Events & Automations reference. This guide details how to leverage the decoupled rotary control map, capture click or hold signals, and troubleshoot Zigbee event streams in smart automation systems.
No, Zigbee button and rotary events are available in Remote Mode and Dual Purpose Mode. In normal Dimmer Mode the physical knob controls the wired circuit directly rather than acting as an automation remote.
Remote Mode and Dual Purpose Mode support the Zigbee remote events.
The event set includes press, double press, hold, release, rotate left, and rotate right. Depending on the platform these may appear as StepUp/StepDown, MoveUp/MoveDown, or named rotary/button events.
Yes. These actions are supported in Remote Mode and Dual Purpose Mode and can be mapped to automations.
Yes. Rotate left and rotate right are supported in Remote Mode and Dual Purpose Mode. Platform naming varies, so check the events exposed by your hub.
In Dimmer Mode the knob is coupled to the wired dimmer function. The physical action changes the connected light directly, rather than being reported as remote events for automations.
Create automations that listen for RD1-Pro press, double press, hold, release, or rotary events and then send commands to the target smart bulbs. For example, press can toggle, rotation can dim, and hold can change mode or scene.
Map rotate-right events to brightness up and rotate-left events to brightness down in the smart home platform. Home Assistant blueprints can simplify this by translating RD1-Pro events into light brightness steps.
Use an automation or blueprint that changes the meaning of rotary movement based on a helper, mode, or previous button press. The knob can then adjust brightness, colour temperature, or colour depending on the selected automation state.
Use a helper or selector in the automation platform to choose the active light or group. Button events can cycle between targets, and the rotary events then dim or control whichever target is selected.
Use double press or another button event to advance through a list of scenes or scripts. The Candeo Home Assistant blueprint examples use a numeric helper to step through up to six scene/script slots.
Use automations that map rotary movement to media volume and single/double/long presses to play, pause, skip, scenes, or other media commands. This requires an automation platform that can control the media device.
Yes. Use Dual Purpose Mode. Endpoint 2 sends the remote event to the hub, and an automation can then control Endpoint 1, the wired dimmer endpoint. This gives the feel of physical control while still leaving button events available.
The knob action is received by the hub as an Endpoint 2 remote event. An automation interprets that event and sends a new command to Endpoint 1, the dimmable-light endpoint. The hub is therefore in the middle of the control path.
Yes. Candeo has published Home Assistant blueprint examples for smart-bulb control, multiple-light control, scenes/scripts, and media or speaker volume use cases.
First confirm the RD1-Pro is paired in the correct mode with the latest Candeo ZHA quirk or built-in support, then remove/reset/re-pair if needed. If only one device is affected, collect debug logs and a screen recording showing the rotation direction and resulting event. Direction issues may be quirk, firmware, or integration related and should be escalated with logs.
Common causes are missing/outdated ZHA quirks, the device being paired in the wrong mode, the blueprint listening to the wrong endpoint or event names, stale pairing state, or inconsistent direction events. Reinstall/update quirks, reset, select mode, re-pair, then check raw ZHA events before troubleshooting the automation.
Confirm the RD1-Pro is in REM or DPM, not DIM. Check drivers/quirks, confirm the correct endpoint is used, look at raw hub events, re-pair after reset if the device was previously in a different mode, and verify that the platform supports the event set.