The deCONZ STD OTAU plugin implements a ZigBee Over-the-Air-Upgrade (OTAU) server in deCONZ.
See the Phoscon help topics for instructions on how to upgrade the firmware of your ZigBee devices using the STD OTAU plugin.
Note that after the firmware has upgraded, the deCONZ GUI (and the REST API) might still show the old values (notably the SW Build ID and Date Code). To refresh these, read the Basic cluster attributes, in the Cluster info panel in the GUI. Likewise, if the device exposes new or different endpoints and/or clusters (e.g. when upgrading from ZLL to ZigBee 3.0), refresh these by reading the Node Descriptor and Simple Descriptor(s) from the left drop-down menu on the node.
ZigBee firmware is identified by the Manufacturer Code, Image Code and Version.
On startup, the STD OTAU plugin will read all *.ota, *.ota.signed, *.sbl-ota, and *.zigbee files in ~/otau, and copy them to mmmm_iiii_vvvvvvvv.zigbee files, matching these attributes.
To find the Manufacturer Code for your device, see the Node info panel in the deCONZ GUI. To find the Image Code and (current) Version, see the STD OTAU Plugin panel in the deCONZ GUI. Select your device from the list (match the IEEE address) and press Query to populate the fields. Make sure to wake battery-powered devices before pressing Query.
Note that not all ZigBee devices support over-the-air firmware upgrading. Devices that do support this, expose a client (grey) OTAU cluster (0x0019). Only these devices are listed in the STD OTAU Plugin panel. However, not all devices that advertise this cluster have actually implemented it.
You need to obtain the firmware files from the device manufacturer. Some manufacturers have officially published their firmware. For some others, we found the location from where their native gateway downloads the firmware.
| Manufacturer | Code | Firmware Files |
|---|---|---|
| IKEA | 117C | Available on the IKEA website. Use the ikea-ota-download.py script to download the current IKEA firmware files directly to ~/otau. |
| Ledvance OSRAM |
1189 110C |
Published to the Ledvance website. |
| Lutron | 1144 | The firmware for the Aurora Friends-of-Hue dimmer is available through Hue Firmware. |
| Philips (Signify) | 100B | See Hue Firmware below. |
| ubisys | 10F2 | Published to the ubisys website. |
| Danfoss | 1246 | Published to the Danfoss website. |
See the Wiki for a community-maintained list of firmware files, including reports which files have actually been tested.
Signify don't provide their firmware for use with other ZigBee gateways than the Hue bridge. The communication between the bridge and the server hosting the firmware files is encrypted, so we cannot get an overview of the files available. To find the firmware files, you need to sniff the traffic from the Hue bridge to the Internet, as it downloads the files. Unfortunately, the bridge will only download firmware files for connected devices with outdated firmware. For details, see issue #10.
Below is an overview of the images found so far:
| Image | Device(s) | Firmware |
|---|---|---|
| 0100 | unknown | 5.127.1.26581 |
| 0103 | Gamut-A Color light | 5.127.1.26581 |
| 0104 | Gamut-B Extended color light | 5.130.1.30000 |
| 0105 | Dimmable light | 5.130.1.30000 |
| 0108 | unknown | 5.130.1.30000 |
| 0109 | Hue dimmer switch | 6.1.1.28573 |
| 010B | unknown | 5.130.1.30000 |
| 010C | Gamut-C Extended color light Color temperature light |
1.50.2_r30933 |
| 010D | Hue motion sensor | 6.1.1.27575 |
| 010E | Aurelle Panels, Signes, Playbar, Being White Ambiance | 1.50.2_r30933 |
| 010F | Outdoor led strip (?) | unknown |
| 0110 | Bluetooth light (?) | unknown |
| 0111 | Hue Go (2nd Gen) | 1.65.9_hB3217DF4 |
| 0112 | Bluetooth E27 | 1.76.10 |
| 0114 | Bluetooth GU10 | 1.76.6 |
| 0115 | Hue smart plug | 1.65.9_hB3217DF4 |
| 0116 | Hue smart button | 2.30.0_r30777 |
| 0119 | Hue dimmer switch (2021) | 2.42.0_h1F5E860 |
| 011c | Hue wall switch module | 1.0.3 |
| 0000 | Lutron Aurora Manufacturer Code: 1144 |
3.4 3.8* |
* Note that the Lutron Aurora firmware v3.8 doesn't work with deCONZ.
Basically, the deCONZ STD OTAU plugin uses the same setup as the deCONZ REST API plugin. To compile and install the STD OTAU plugin, follow the instructions to compile and install the REST API plugin, substituting the repository in step 1 with this one.
Start deCONZ with --dbg-ota=1 to make the STD OTAU plugin issue debug messages.