Please note these instructions are for Zigbee2MQTT only.

You should not attempt this update unless your batch # and date code aren't in the table below.

The most up-to-date firmware has Date Code: 20241020.

The most up-to-date SW build ID is 1.30.

Compatible devices

To check whether your device is compatible with the firmware update, you will need to check the firmware date code of your switch, and also the “#” number on the back of the switch. 

1: Check your device is compatible

1. Check the # number on the back of the switch.
2. Check firmware date of your Candeo device, which can be found on the Zigbee2MQTT dashboard.
3. If the combination of the date code and # number is not in the table, proceed with this firmware upgrade. Otherwise, do not proceed.

2: Download OTA firmware and add to your zigbee2mqtt system

1. Download the firmware file for your device from the bottom of this page.
2. Add the firmware file to your zigbee2mqtt folder in config > zigbee2mqtt
3. Add these lines to your zigbee2mqtt configuration.yaml file:
   

   
   ota:
     zigbee_ota_override_index_location: my_index.json
           

4. Create a new file called “my_index.json” in the same folder as the configuration.yaml file.
5. Add this code to the my_index.json file (referencing the correct OTA file you have just downloaded (for either C201 or C202) and added to your zigbee2mqtt folder:
   

   [

       {

           "url": "Candeo_C202_firmware_1.30.ota",

           "force": true

       }

   ]

3: Add The Local Converter to you zigbee2mqtt system

1. Download the local converter file here (It is the same converter file for both C201 and C202):  https://raw.githubusercontent.com/candeosmart/zigbee2mqtt/refs/heads/main/candeo_converter.js
   
2. Add the converter file to your config > zigbee2mqtt folder
   
3. In the zigbee2mqtt dashboard go to:
   
1. Settings
   
2. External Converters
   
3. Add your converter file (e.g. candeo_converter.js)
   
   
   
   
   
   
   
4. Restart zigbee2mqtt
   
5. After restarting check to see if your device is using the new converter by looking at the device description in zigbee2mqtt:
   
1. The device should show the description as “Candeo C201 / C202 – local v1” (or v2)
   
2. If the device shows a different description (such as Candeo Zigbee Dimmer), you may need to unpair and re-pair your device.
   

1. Delete the reference to the local converters from zigbee2mqtt dashboard, by going to Settings > External Converters and deleting the reference to the Candeo converter which you previously added.
   
2. Delete the candeo_converter.js