How to install drivers, quirks and blueprints

Home Assistant - ZHA & zigbee2mqtt

SmartThings

Hubitat

Home Assistant - ZHA & zigbee2mqtt

Quirks (ZHA only)

1. Editing your configuration.yaml file
   
1. Open Studio Code Server in your Home Assistant instance.
   
2. Select configuration.yaml, then click inside the editor to close the file system sidebar.
   
3. Paste the following into the open file:
   
   zha:
     custom_quirks_path: /config/zha_quirks/
4. Click the Save icon.
   
2. Installing the quirk files
   
1. In another browser tab, go to:
   https://github.com/candeosmart/homeassistant-zha
2. Find your Candeo model, and click the file name.
   
3. Click the Download raw file icon.
   
4. Return to Home Assistant and open Studio Code Server.
   
5. Click the New folder icon and create a folder called zha_quirks.
   
6. Right-click the new folder.
   
7. Select Upload…, then choose your downloaded .py quirk file.
   
8. The file should now appear inside your zha_quirks folder.
   
9. The last step is to reload your configuration.yaml.
   
1. Go to Settings → System.
   
2. Click the power icon in the top-right, and choose Quick reload.
   

Blueprints

1. Go to our Blueprints page.
   
2. In the README section please find the blueprint you need.
   
3. Click the import button
   
1. This should open your Home Assistant instance in a new tab.
   
2. You may need to click "Save" on the first page, to continue.
4. Click "Open link".
   
5. Login to Home Assistant.
6. Click "PREVIEW".
   
7. Click "IMPORT BLUEPRINT"

SmartThings

1. We recommend you unpair any device you are installing the driver for first.
   
2. On your web browser go to:
   
3. https://bestow-regional.api.smartthings.com/invite/1J2QyNNJAO20
   
4. Sign in to your Samsung account.
   
5. Click "Enroll".
   
6. Click "Available Drivers".
   
7. Now find your model in the descriptions.
   
8. Click "Install" under the driver details.
   

Hubitat

1. We recommend that any C‑ZB‑LC20 devices added previously should be unpaired, and then paired again after a factory reset and choosing the correct mode.
2. On your Hubitat instance go to Drivers code.
   
3. Click "+ New driver".
   
4. Click "Import".
   
5. Copy the correct URL for your device's driver from below:
   Dimming & Switching Modules

   C‑ZB‑DM201‑2G (2‑Gang Dimmer Module)

   • Main – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-DM201-2G%20Zigbee%202-Gang%20Dimmer%20Module.groovy
   • Child switch – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-DM201-2G%20Zigbee%202-Gang%20Dimmer%20Module%20Child%20Switch.groovy

   C‑ZB‑DM204 / C204

   • DM204 – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-DM204%20Zigbee%20Dimmer%20Module%20(With%20Or%20Without%20Neutral).groovy
   • C204 – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C204%20Zigbee%20Dimmer%20Module%20(With%20Or%20Without%20Neutral).groovy

   C203

   • Dimmer Module (L+N) – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C203%20Zigbee%20Dimmer%20Module%20(L%2BN).groovy

   C205

   • Switch Module (with or without neutral) – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C205%20Zigbee%20Switch%20Module%20(With%20Or%20Without%20Neutral).groovy

   C‑ZB‑SM205‑2G (2‑Gang Switch Module)

   • Main – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SM205-2G%20Zigbee%202-Gang%20Switch%20Module%20(L%2BN).groovy
   • Child switch – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SM205-2G%20Zigbee%202-Gang%20Switch%20Module%20(L%2BN)%20Child%20Switch.groovy
   Smart Plugs

   C210

   • Smart Plug – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C210%20Zigbee%20Dimming%20Smart%20Plug.groovy
   LED Controller

   C‑ZB‑LC20 (Smart LED Controller)

   • CCT Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-LC20%20Smart%20LED%20Controller%20(CCT%20Mode).groovy
   • Dimmer Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-LC20%20Smart%LED%20Controller%20(Dimmer%20Mode).groovy
   • RGB Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-LC20%20Smart%LED%20Controller%20(RGB%20Mode).groovy
   • RGBW Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-LC20%20Smart%LED%20Controller%20(RGBW%20Mode).groovy
   • RGBCCT Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-LC20%20Smart%LED%20Controller%20(RGBCCT%20Mode).groovy
   Rotary Dimmers

   C202 / C202N

   • Rotary Dimmer – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C202%20%26%20C202N%20Zigbee%20Rotary%20Dimmer.groovy

   C‑ZB‑RD1

   • Rotary Dimmer – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-RD1%20Zigbee%20Rotary%20Dimmer.groovy

   C‑ZB‑RD1P

   • Dimmer Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-RD1P%20Zigbee%20Rotary%20Dimmer%20Pro%20(Dimmer%20Mode).groovy
   • Dual‑Purpose Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-RD1P%20Zigbee%20Rotary%20Dimmer%20Pro%20(Dual%20Purpose%20Mode).groovy
   • Remote Mode – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-RD1P%20Zigbee%20Rotary%20Dimmer%20Pro%20(Remote%20Mode).groovy
   Sensors

   C‑ZB‑SEDC

   • Contact Sensor – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SEDC%20Zigbee%20Contact%20Sensor.groovy

   C‑ZB‑SEMO

   • Motion Sensor – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SEMO%20Zigbee%20Motion%20Sensor.groovy

   C‑ZB‑SESO

   • Soil Sensor – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SESO%20Zigbee%20Soil%20Sensor.groovy

   C‑ZB‑SETE

   • Temp/Humidity Sensor – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SETE%20Zigbee%20Temperature%20%26%20Humidity%20Sensor.groovy

   C‑ZB‑SEWA

   • Water Sensor – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SEWA%20Zigbee%20Water%20Sensor.groovy
   Irrigation / Remotes / Misc

   C‑ZB‑SR5BR

   • Scene Remote – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-ZB-SR5BR%20Smart%20Scene%20Remote.groovy

   C-RFZB-SM1

   • Switch Module – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20C-RFZB-SM1%20Zigbee%20%26%20RF%20Switch%20Module.groovy

   CSF1TZ

   • Irrigation Timer – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20CSF1TZ%20Zigbee%20Smart%20Irrigation%20Timer.groovy

   CMM‑1 Modmote

   • Scene Switch – https://raw.githubusercontent.com/candeosmart/hubitat-zigbee/main/Candeo%20Modmote%20Zigbee%20Scene%20Switch.groovy
     

   
   
6. Paste the URL into the import box that has popped up.
7. Click "Import".
   
8. Click "Save".
9. To add more drivers repeat the process.
   

Please note that our 2-gang modules need both a master and child driver

 

• Related Articles

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

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

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

• [C201] Firmware update instructions for ZHA

  Please note these instructions are currently for ZHA only. If your date code is 20241020, 20240813 or 20230824 and you're using ZHA you do not need to do this update. You should not attempt this update unless your batch # and date code aren't in the ...

• How to enable pairing mode on your Zigbee hub

  Home Assistant Zigbee2MQTT SmartThings Hubitat Other Zigbee 3.0 systems Home Assistant Open your Home Assistant dashboard. Go to the menu and click on settings. Click "Devices & Services". Click the blue "ADD INTEGRATION" button. Click "Add Zigbee ...