Setup Guide

Important: A Candeo custom ZHA quirk is currently required. Install the current Candeo RD1 / RD1-Pro V2 quirk before adding the device to ZHA. The quirk supplies the Candeo-specific device handling and automation triggers required by this firmware release.

Install the Candeo ZHA Quirk

1. Create a folder for custom ZHA quirks if you do not already have one. For Home Assistant OS, a suitable path is /config/zha_quirks/.
2. Copy the current Candeo V2 quirk file(s) supplied on this support page into that folder.
3. Add the custom quirk path to configuration.yaml. If you already have a zha: section, add custom_quirks_path to the existing section rather than creating a second zha: block.
   zha: custom_quirks_path: /config/zha_quirks/

4. Restart Home Assistant so ZHA loads the custom quirk. Then continue with the pairing process in the main RD1 / RD1-Pro instructions.
   1. If the device was already added before the quirk was installed, restart Home Assistant first. If the correct device features still do not appear, remove and re-add the device using the main pairing instructions.

What the Quirk Adds

• RD1-Pro Dimmer Mode: Exposes the Extra Button Commands configuration control and the associated double-press, hold and release automation triggers.
• RD1-Pro Remote / Dual Purpose modes: Exposes the knob press actions and clockwise / counter-clockwise rotary actions as device automation triggers.

The device triggers are defined by the quirk, so they can be presented directly when building an automation.

Enable Extra Button Commands - RD1-Pro Dimmer Mode

Open the RD1-Pro device page and locate the configuration entity named Extra Button Commands. Set it to Enabled when you want to use double press, hold and release in automations.

Candeo Blueprints

For common RD1-Pro automation patterns, import the relevant Candeo Blueprint rather than building the device-event logic manually.

Troubleshooting

• No Extra Button Commands entity or expected triggers: Confirm the current Candeo V2 quirk file is in the configured custom_quirks_path, then restart Home Assistant.
• Quirk import error reported: Check the file is the current Candeo version and that all required Candeo quirk files supplied together have been copied into the same custom quirk folder.
• Dimmer Mode double press / hold / release are absent: Confirm Extra Button Commands is enabled on the device page.