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: 20250201.

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

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 above, 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://github.com/candeosmart/zigbee2mqtt/blob/main/candeo_C201_C202_fw_update.js
   
2. Add the converter file to your zigbee2mqtt>external_converters folder:
   
1. You will need a file explorer tool such as Studio Code Server.
   
2. Open your file explorer.
   
3. Open/Expand the Zigbee2MQTT folder
   
4. If you don't already have a folder called external_converters, you will need to create one.
   
1. This must be inside the Zigbee2MQTT folder; if you close/collapse the Zigbee2MQTT folder, you should not be able to see the external_converters folder.
   
5. Upload the candeo_converter.js file to the external_converters folder.
3. Restart zigbee2mqtt
   
4. 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 candeo_converter.js from the external_converters folder.