Update deCONZ manually - dresden-elektronik/deconz-rest-plugin GitHub Wiki
In case flashing doesn't succeed or causes any Zigbee network troubles afterwards, please refer to the FAQ section.
Backup first: Before flashing new firmware always make sure to create a backup, see Phoscon App Settings Documentation.
Warning: It is strongly advised to use a native installation of one of the update methods. Virtual Machines may work but are not supported, using a VM while trying to update firmware is on your own risk.
It is always recommended to use the latest stable version, refer to Firmware Changelog for details on each version.
- Update ConBee via Browser
- Update in Docker
- Update in Raspbian
- Update in Ubuntu or Debian
- Update in Windows
- GCFFlasher standalone
- RaspBee, RaspBee II, ConBee, ConBee II and ConBee III
- Raspbian
Jessie,StretchBuster, Bullseye and Bookworm Ubuntu 16.04 LTS 64-Bit PC (AMD64)- Ubuntu 18.04 LTS 64-Bit PC (AMD64)
- Ubuntu 20.04 LTS 64-Bit PC (AMD64)
- Debian
Jessie,Stretch, Buster, Bullseye and Bookworm - Windows 7, 10 and 11
This is the easiest method to update the firmware without the need to use command line tools.
Visit https://phoscon.de/updater and follow the steps there (requires Google Chrome or MS Edge browser).
Important: Supported products for the Web Updater:
- FLS-M
- ConBee III
- ConBee II (coming soon)
Tip: You can save the updater HTML page to your desktop it contains the full updater and also works locally.
If you are using deconz-community/deconz-docker deCONZ Docker image the steps in this guide won't work.
Please refer to the following guide, which describes how to update the firmware inside Docker.
https://github.com/deconz-community/deconz-docker#updating-conbeeraspbee-firmware
This method can also be used for Home Assistant OS users. Stop the deCONZ add-on in HA and use the 'SSH & Web Terminal' add-on. In the terminal you can install the above mentioned docker container and use the same steps to flash you firmware. After flashing you may remove that docker container again. More info: https://community.home-assistant.io/t/how-to-update-conbee-ii-on-hassio-with-deconz-phoscon-integration/402826/12
-
Login to your machine and stop the deCONZ service.
sudo systemctl stop deconz
(Headless version), or
sudo systemctl stop deconz-gui
(GUI version) -
Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and replace the filename accordingly.
RaspBee and ConBee
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_Rpi_0x26400500.bin.GCF
ConBee II
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_ConBeeII_0x26780700.bin.GCF
ConBee III
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_ConBeeIII_0x26550900.bin.GCF
RaspBee II
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_RaspBeeII_0x26780700.bin.GCF
-
Flash deCONZ firmware.
Before starting the update, stop ModemManager:
sudo systemctl stop ModemManager
.Change the filename according to your download in step 2. If you are using multiple USB devices, use
ls -la /dev/serial/by-id/
to check for the correct serial port.RaspBee
sudo GCFFlasher_internal -t 60 -d /dev/serial0 -f deCONZ_Rpi_0x26400500.bin.GCF
RaspBee II
sudo GCFFlasher_internal -t 60 -d /dev/serial0 -f deCONZ_RaspBeeII_0x26780700.bin.GCF
ConBee
sudo GCFFlasher_internal -t 60 -d /dev/ttyUSB0 -f deCONZ_Rpi_0x26400500.bin.GCF
ConBee II
sudo GCFFlasher_internal -t 60 -d /dev/ttyACM0 -f deCONZ_ConBeeII_0x26780700.bin.GCF
ConBee III
sudo GCFFlasher_internal -t 60 -d /dev/ttyUSB0 -f deCONZ_ConBeeIII_0x26550900.bin.GCF
You may run GCFFlasher with the additional parameter
-x 3
for verbose logging. In case manual flashing ConBee II fails with an error message similar to:
flashing 160930 bytes: |======error: timeout flashing firmware after 3002 ms
-
[Optional] Update the deCONZ package as well.
wget -O deconz-latest-beta.deb https://deconz.dresden-elektronik.de/raspbian/beta/deconz-latest-beta.deb
(Latest Beta Version), or
wget -O deconz-latest.deb https://deconz.dresden-elektronik.de/raspbian/stable/deconz-latest.deb
(Latest Stable Version)
sudo dpkg -i deconz-latest-beta.deb
orsudo dpkg -i deconz-latest.deb
-
[Optional] Check if ConBee II still uses the desired port and will start after a reboot of the Pi
sudo nano /lib/systemd/system/deconz.service
Check existing of following line (minimal and port at your desire)
ExecStart=/usr/bin/deCONZ -platform minimal --http-port=8081
-
Have deCONZ up and running again.
sudo systemctl start deconz
(Headless version), or
sudo systemctl start deconz-gui
(GUI version)
Note: If you have not yet installed deCONZ, you will need to do so in order to use the GCFFlasher_internal
command below or alternatively install the GCFFlasher standalone package. You can install deCONZ incl. GCFFlasher following the instructions here: https://phoscon.de/en/conbee/install#ubuntu
-
Login to your machine and stop the deCONZ service
sudo systemctl stop deconz
(Headless version), or
sudo systemctl stop deconz-gui
(GUI version) -
Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and replace the filename accordingly.
ConBee
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_Rpi_0x26400500.bin.GCF
ConBee II
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_ConBeeII_0x26780700.bin.GCF
ConBee III
wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_ConBeeIII_0x26550900.bin.GCF
-
Flash deCONZ firmware. Change the filename according to your download in step 2. If you are using multiple USB devices, use
ls -la /dev/serial/by-id/
to check for the correct serial port.Before starting the update, stop ModemManager:
sudo systemctl stop ModemManager
.ConBee
sudo GCFFlasher_internal -t 60 -d /dev/ttyUSB0 -f deCONZ_Rpi_0x26400500.bin.GCF
ConBee II
sudo GCFFlasher_internal -t 60 -d /dev/ttyACM0 -f deCONZ_ConBeeII_0x26780700.bin.GCF
ConBee III
sudo GCFFlasher_internal -t 60 -d /dev/ttyUSB0 -f deCONZ_ConBeeIII_0x26550900.bin.GCF
-
[Optional] Update the deCONZ package as well.
wget https://deconz.dresden-elektronik.de/ubuntu/stable/deconz-2.25.3-qt5.deb
sudo dpkg -i deconz-2.25.3-qt5.deb
-
Start deCONZ again.
sudo systemctl start deconz
(Headless version), or
sudo systemctl start deconz-gui
(GUI version)
GCFFlasher can be downloaded from: https://github.com/dresden-elektronik/gcfflasher/releases
Are you performing the update from a system, where you also have the deCONZ software running? Then continue to this chapter.
-
Unzip the downloaded GCFFlasher, you will get a folder named
GCFFlasher_Vx_x
(where x is a version number). -
Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and put it in the same folder.
-
Open a command prompt in the
GCFFlasher_Vx_x
folder.- In Windows Explorer Shift+Right Click in a free area of the folder and select "Open command window here" from the context menu. In new versions of Windows 10, select "Open PowerShell window here" - if using Powershell, you will need to add a
.\
before every command. Make sure to run the PowerShell or CMD window as Administrator!
- In Windows Explorer Shift+Right Click in a free area of the folder and select "Open command window here" from the context menu. In new versions of Windows 10, select "Open PowerShell window here" - if using Powershell, you will need to add a
-
Plug the ConBee, ConBee II or ConBee III in and wait 10 seconds
-
List all available devices and their COM ports with:
GCFFlasher -l
GCFFlasher.exe -l
Path | Serial | Type
------------------+-------------+---------------
COM8 | DE1948474 | ConBee II
Do not proceed, if there is no ConBee Stick listed here!
- Update the firmware. (Replace X with COM number and Y with firmware filename)
GCFFlasher -d COMX -t 60 -f Y
Example: GCFFlasher -d COM8 -t 60 -f deCONZ_ConBeeII_0x26780700.bin.GCF
- Output in Windows if flashing is successful
read file success: deCONZ_ConBeeII_0x26780700.bin.GCF (163244 bytes)
flash firmware
connect \\.\COM8, baudrate 115200
command reset timeout
connect \\.\COM8, baudrate 115200
query bootloader id V1
bootloader detected (60)
bootloader synced: unlock! READY
100% uploading #############################################################
done, wait validation...
firmware successful written
-
Close deCONZ if it is running
-
Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and replace the filename accordingly.
-
Open the deCONZ installation folder in Windows Explorer
If deCONZ is installed in your user profile, like
C:\Users\bob\AppData\Local\deCONZ
, you can quickly open the folder with the command prompt:-
Windows+R
-
%APPDATA%\..\local\deconz\bin
-
press enter
If the folder doesn't exist deCONZ is probably installed in:
C:\Program Files (x86)\deCONZ\bin
, navigate here in Windows Explorer. -
-
Place the files from the GCFFlasher zip file in to the
deCONZ\bin
folder. -
Open a command prompt in the
deCONZ\bin
folder.- In Windows Explorer Shift+Right Click in a free area of the
bin
folder and select "Open command window here" from the context menu. In new versions of Windows 10, select "Open PowerShell window here" - if using Powershell, you will need to add a.\
before every command. Make sure to run the PowerShell or CMD window as Administrator!
- In Windows Explorer Shift+Right Click in a free area of the
-
Unplug the ConBee or ConBee II for 10 seconds
-
Plug the ConBee or ConBee II in again and wait 10 seconds
-
List all available devices and their COM ports with:
GCFFlasher -l
GCFFlasher.exe -l
Path | Serial | Type
------------------+-------------+---------------
COM8 | DE1948474 | ConBee II
Do not proceed, if there is no ConBee Stick listed here!
-
Update the firmware. Use the COM port from the previous step.
ConBee
GCFFlasher -d COM8 -t 60 -f ../firmware/deCONZ_Rpi_0x26400500.bin.GCF
ConBee II
GCFFlasher -d COM8 -t 60 -f ../firmware/deCONZ_ConBeeII_0x26780700.bin.GCF
ConBee III
GCFFlasher -d COM8 -t 60 -f ../firmware/deCONZ_ConBeeIII_0x26550900.bin.GCF
-
Output in Windows if flashing is successful
read file success: deCONZ_ConBeeII_0x26780700.bin.GCF (163244 bytes)
flash firmware
connect \\.\COM8, baudrate 115200
command reset timeout
connect \\.\COM8, baudrate 115200
query bootloader id V1
bootloader detected (60)
bootloader synced: unlock! READY
100% uploading #############################################################
done, wait validation...
firmware successful written
The command line firmware update tool GCFFlasher is also available as standalone package which doesn't require installation of deCONZ. The latest release can be downloaded from https://github.com/dresden-elektronik/gcfflasher/releases
If after an firmware update settings network problems arise, please refer to Wiki: Network Lost Issues for instructions how to restore previous network configuration settings.
The term './GCFFlasher' is not recognized as the name of ...
You get this message when the files GCFFlasher.exe and GCFFlasherCommandline.bat are missing from the folder where you opened the command prompt. Perform step 4 again to resolve the issue.
There might be occasions where the stick still refuses to flash. In that case:
- Unplug the ConBee and wait 10 seconds
- Issue the command to flash, make sure you you've selected the correct device on your system for the
-d
parameter and also ensure to use-t 60 -x 3
- Attach the ConBee again
That typically gets the flash process going.
There is a method using the serial number, if others recommanded method realy don't work :
- Use
GCFflasher -l
to get the serial number - Use
GCFFlasher -d COM7 -f ../firmware/deCONZ_ConBeeII_0x26780700.bin.GCF -sn serial_number