[C-ZB-RD1/C-ZB-RD1P] How do I pair my RD1/RD1-Pro Zigbee rotary switch to Home Assistant? (ZHA)

[C-ZB-RD1/C-ZB-RD1P] How do I pair my RD1/RD1-Pro Zigbee rotary switch to Home Assistant? (ZHA)


  1. Add our custom quirk to your ZHA instance:
    (If you need any guidance regarding installing custom quirks, please see our How-To article)
    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. Then, we recommend doing a factory reset:
    1. Turn on the light, press the knob 5 times with a long press (3 seconds) on the fifth time. Once reset successfully, the red LED will stay on for 3 seconds.
  3. RD1 - Go to step 3, RD1P - Choose your mode:
    1. Please refer to the detailed Mode comparison chart for mode details:
      Which mode should I select?

      Choose the mode in which you wish to operate your device before pairing, using the commands given below:
    2. ModeCommandLED Feedback
      Dimmer3 short pressesRed LED flashes 6 times
      Remote Mode (smart bulb mode)4 short pressesGreen LED flashes 6 times
      Dual Purpose Mode5 short pressesBlue LED flashes 6 times

  4. Set your hub to pairing mode:
    1. Open your Home Assistant dashboard.
    2. Go to the menu and click on settings.
    3. Click "Devices & Services".
    4. Click the blue "ADD INTEGRATION" button.
    5. Click "Add Zigbee device".
    6. Home Assistant will scan for new Zigbee devices.
  5. Activate pairing on RD1/RD1P
    1. Button sequence: 2 short presses + long 3rd press
      1. LED confirmation: Green and blue LEDs flash simultaneously
      2. Pairing mode lasts 3 minutes
  6. Complete pairing
    1. Hub should discover the device within 30 seconds
    2. Device will appear as “Candeo RD1” or "Candeo RD1-Pro"
    3. LED will show solid green briefly when successfully paired