[C-ZB-RD1/C-ZB-RD1-Pro] How do I install Home Assistant ZHA quirks?

[C-ZB-RD1/C-ZB-RD1-Pro] How do I install Home Assistant ZHA quirks?


To do this you must have a file editor installed on your Home Assistant instance, our instructions are based on Studio Code Server.

Editing your configuration.yaml file.
  1. On your Home Assistant instance click Studio Code Server.
  2. Select configuration.yaml, and then click in the text editor to close the filesystem. 
  3. Paste the following into the open configuration.yaml:
    zha:

      custom_quirks_path: /config/zha_quirks/

  4. Click the "Save" icon.
Installing the quirk files.
  1. In another browser tab go to: 
    1. RD1: 
      1. https://github.com/candeosmart/homeassistant-zha/blob/main/candeo_c-zb-rd1_rotary_dimmer.py
    2. RD1-Pro:
      1. Dimmer Mode: 
        1. https://github.com/candeosmart/homeassistant-zha/blob/main/candeo_c-zb-rd1p_rotary_dimmer_pro_dimmer_mode.py
      2. Remote Mode:
        1. https://github.com/candeosmart/homeassistant-zha/blob/main/candeo_c-zb-rd1p_rotary_dimmer_pro_remote_mode.py
      3. Dual Purpose Mode:
        1. https://github.com/candeosmart/homeassistant-zha/blob/main/candeo_c-zb-rd1p_rotary_dimmer_pro_dual_purpose_mode.py
  2. Click the download icon ("Download raw file")
  3. Go back to your Home Assistant instance, and Studio Code Server.
  4. Click the new folder icon and create a folder called zha_quirks
  5. Right click the new folder.
  6. Click "Upload..." file button, then click the file button.
  7. Browse to your downloaded quirk file ending in .py, select it and click open.
  8. The file should now be in your zha_quirks folder.
The last step is to reload your configuration.yaml file. This can be done by going to settings, system and then clicking the power button at the top right, and selecting quick reload.

    • Related Articles

    • [CSF1TZ] How do I install Home Assistant ZHA quirks?

      To do this you must have file editor installed on your Home Assistant instance. Editing your configuration.yaml file. On your Home Assistant instance click file editor. Click the folder button ("Browse Filesystem") Select configuration.yaml, and then ...

    • How to install drivers, quirks and blueprints

      Home Assistant - ZHA & zigbee2mqtt SmartThings Hubitat Home Assistant - ZHA & zigbee2mqtt Quirks (ZHA only) Editing your configuration.yaml file Open Studio Code Server in your Home Assistant instance. Select configuration.yaml, then click inside the ...

    • [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 ...

    • [C-ZB-LC20] Firmware update instructions for Home Assistant (ZHA and zigbee2mqtt)

      After the update, the device should report as C-ZB-LC20v2. zigbee2mqtt The update is available directly within the zigbee2mqtt interface. ZHA 1. Create a new folder inside your Home Assistant “config” directory for storing the OTA firmware file. In ...

    • [CMM-1] How do I install a new Home Assistant blueprint?

      Due to the Zigbee2MQTT 2.0.0 update, the Zigbee2MQTT blueprint has been updated, the old blueprint no longer works. (08/01/2025) If you haven't already installed our original blueprint, you can go ahead and click the Zigbee2MQTT Import to my home ...