[RD1-Pro] Button Events, Rotary Events & Automations

[RD1-Pro] Button Events, Rotary Events & Automations

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.

1. Supported Operational Modes & Event Sets [Click to Expand ▾]
Verify which operational modes unlock decoupled automation actions and view the complete list of multi-click triggers.
2. Smart Home Automation Control Strategies [Click to Expand ▾]
Explore configurations for dimming smart lights, cycling scenes, handling media, and setting up Dual Purpose Mode routines.
3. Blueprints, Quirks & Hub Troubleshooting [Click to Expand ▾]
Resolve missing double-clicks, faulty rotation directions, stale pairing values, or ZHA blueprint drops.

1. Supported Operational Modes & Event Sets

Do button events work in all modes?

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.

Which modes support Zigbee button events?

Remote Mode and Dual Purpose Mode support the Zigbee remote events.

What Zigbee button events are available in REM mode and DPM mode?

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.

Are press, double press, hold, and release supported?

Yes. These actions are supported in Remote Mode and Dual Purpose Mode and can be mapped to automations.

Are rotate-left and rotate-right events supported?

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.

Why are button events not available in normal Dimmer Mode?

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.

2. Smart Home Automation Control Strategies

How can I use button events to control smart bulbs?

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.

How can I use rotary events to dim smart bulbs?

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.

How can I use RD1-Pro to control colour temperature or colour?

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.

How can I use RD1-Pro to control multiple smart lights?

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.

How can I use RD1-Pro to cycle through scenes or scripts?

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.

How can I use RD1-Pro to control speaker volume or media playback?

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.

Is there a workaround to control wired non-smart lights and still retain button events?

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.

How does the DPM automation workaround control Endpoint 1 from Endpoint 2?

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.

3. Blueprints, Quirks & Hub Troubleshooting

Are Home Assistant blueprints available for RD1-Pro?

Yes. Candeo has published Home Assistant blueprint examples for smart-bulb control, multiple-light control, scenes/scripts, and media or speaker volume use cases.

Why are my ZHA rotary events or direction values unreliable?

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.

Why do my ZHA blueprints not behave as expected?

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.

What should I check if double press, hold, release, or rotation events are missing?

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.


    • Related Articles

    • [RD1-Pro] Mode Selection: DIM, REM & DPM

      Welcome to the Mode Selection: DIM, REM & DPM guide. Below you will find details on configuring the RD1-Pro operational profiles, setting up smart bulb isolation, understanding firmware model strings, and managing Zigbee multi-endpoints. 1. Mode ...
    • [RD1-Pro] Smart Bulbs, Hue & Remote Mode

      Welcome to the Smart Bulbs, Hue and Remote Mode hub. This section explains how to use the RD1-Pro as a decoupled controller, prevent cutting physical power to your smart lighting, and configure stable standby loads in no-neutral smart systems. 1. ...
    • [RD1 Series] Master FAQs Index

      Welcome to our RD1 series master FAQs index. Select a section below to find detailed guides, step-by-step instructions, and technical specifications for your Candeo devices. In this index: Product Choice & Compatibility Installation & Physical Setup ...
    • [C-ZB-SR5BR] How do I install a new Home Assistant blueprint?

      ? Available Blueprints ? Candeo C-ZB-SR5BR – Multi-Light Dimming Control up to 4 lights from one SR5BR: ? Buttons 1–4 choose which light is “active”. ? Centre button toggles the active light on/off. ? Rotary ring dims the active light (clockwise ...
    • [RD1 Series] Product Choice & Compatibility

      Welcome to the Product Choice & Compatibility hub. Please choose a category below. Click to expand the list, then select a question to jump straight to the answer. 1. Comparing Our Dimmer Models [Click to Expand ▾] Learn about the main features of ...