Update deCONZ manually - dresden-elektronik/deconz-rest-plugin GitHub Wiki

IMPORTANT

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.


Guides

Supported platforms

  • RaspBee, RaspBee II, ConBee, ConBee II and ConBee III
  • Raspbian Jessie, Stretch Buster, 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

Update in Docker

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

Update in Raspbian

  1. Login to your machine and stop the deCONZ service.

    sudo systemctl stop deconz (Headless version), or
    sudo systemctl stop deconz-gui (GUI version)

  2. 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_0x26500900.bin.GCF

    RaspBee II
    wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_RaspBeeII_0x26780700.bin.GCF

  3. 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_0x26500900.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

  4. [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 or sudo dpkg -i deconz-latest.deb

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

  6. Have deCONZ up and running again.

    sudo systemctl start deconz (Headless version), or
    sudo systemctl start deconz-gui (GUI version)

Update in Ubuntu or Debian

Note: If you have not yet installed deCONZ, you will need to do so in order to use the GCFFlasher_internal command below. You install the utility following the instructions here: https://phoscon.de/en/conbee/install#ubuntu

  1. Login to your machine and stop the deCONZ service

    sudo systemctl stop deconz (Headless version), or
    sudo systemctl stop deconz-gui (GUI version)

  2. 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_0x26500900.bin.GCF

  3. 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
    GCFFlasher_internal -t 60 -d /dev/ttyACM0 -f deCONZ_ConBeeII_0x26780700.bin.GCF

    ConBee III
    GCFFlasher_internal -t 60 -d /dev/ttyUSB0 -f deCONZ_ConBeeIII_0x26500900.bin.GCF

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

  5. Start deCONZ again.

    sudo systemctl start deconz (Headless version), or
    sudo systemctl start deconz-gui (GUI version)

Update in Windows

Requirements

Are you performing the update from a system, where you also have the deCONZ software running? Then continue to this chapter.

Update on a system without deCONZ software

  1. Unzip the downloaded GCFFlasher, you will get a folder named GCFFlasher_Vx_x (where x is a version number).

  2. Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and put it in the same folder.

  3. 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!
  4. Plug the ConBee, ConBee II or ConBee III in and wait 10 seconds

  5. 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!

  1. 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

  1. 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

Update on a system where deCONZ is already installed

  1. Close deCONZ if it is running

  2. Download latest deCONZ firmware. Check https://deconz.dresden-elektronik.de/deconz-firmware for the latest release and replace the filename accordingly.

  3. 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.

  4. Place the files from the GCFFlasher zip file in to the deCONZ\bin folder.

  5. 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!
  6. Unplug the ConBee or ConBee II for 10 seconds

  7. Plug the ConBee or ConBee II in again and wait 10 seconds

  8. 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!

  1. 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_0x264e0900.bin.GCF

  2. 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

FAQ

Network lost after firmware update

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.

Can't start GCFFlasher on Windows

The term './GCFFlasher' is not recognized as the name of ...

image

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.

What if ConBee (all Versions) still refuses to flash

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.

Other methods

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
⚠️ **GitHub.com Fallback** ⚠️