Skip to content

Update deCONZ manually

Jump to bottom Edit New page
Manuel Pietschmann edited this page Feb 11, 2022 · 82 revisions

As this question came up recently, this one should come in handy for some people having trouble to update deCONZ and the firmware via Phoscon App.

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.

Supported platforms

  • RaspBee, RaspBee II, ConBee and ConBee II
  • Raspbian Jessie, Stretch Buster and Bullseye
  • 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 and Bullseye
  • 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 cannot be used for the Home-Assistant add-on and no current workaround is known. This also includes the button in Phoscon App within the addon.

Update in Raspbian

Important On Raspberry Pi 4B with a RaspBee you need to update the WiringPi package manually to version 2.52, otherwise the update will fail.

cd /tmp
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb

  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 http://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_0x26720700.bin.GCF

    RaspBee II
    wget https://deconz.dresden-elektronik.de/deconz-firmware/deCONZ_RaspBeeII_0x26720700.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 -f deCONZ_Rpi_0x26400500.bin.GCF

    RaspBee II
    sudo GCFFlasher_internal -t 60 -f deCONZ_RaspBeeII_0x26720700.bin.GCF

    ConBee
    sudo GCFFlasher_internal -t 60 -d 0 -f deCONZ_Rpi_0x26400500.bin.GCF

    ConBee II
    sudo GCFFlasher_internal -t 60 -d /dev/ttyACM0 -f deCONZ_ConBeeII_0x26720700.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 Beat 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. 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 http://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_0x26720700.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 0 -f deCONZ_Rpi_0x26400500.bin.GCF

    ConBee II
    sudo GCFFlasher_internal -t 60 -d /dev/ttyACM0 -f deCONZ_ConBeeII_0x26720700.bin.GCF

  4. [Optional] Update the deCONZ package as well.

    wget https://deconz.dresden-elektronik.de/ubuntu/stable/deconz-2.13.04-qt5.deb
    sudo dpkg -i deconz-2.13.04-qt5.deb

  5. Start deCONZ again.

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

Update in Windows

Precautions when no ConBee related software is installed

The ConBee Stick II can be updated even without the installed deCONZ / Phoscon Software. But keep in mind you have to download the the 32bit VCP DDrivers, extract the file ftd2xx.dll and put in in the same directory as the GCFFlasher. As of time of writing the version 2.12.28 works perfect. The needed GCFFlasher can be downloaded here: http://deconz.dresden-elektronik.de/win/

Update on a system where deCONZ is already installed.

  1. Close deCONZ if it is running

  2. Download latest deCONZ firmware. Check http://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. 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!

  5. Unplug the ConBee or ConBee II for 10 seconds

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

  7. List all available devices and their COM ports GCFFlasher -l

GCFFlasher V3_10 (c) dresden elektronik ingenieurtechnik gmbh
Path             | Vendor | Product | Serial     | Type
-----------------+--------+---------+------------+-------
\\.\COM7         | 0x1CF1 | 0x0030  | DE214xxxx  | 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 COM7 -t 60 -f ../firmware/deCONZ_Rpi_0x26400500.bin.GCF

    ConBee II
    GCFFlasher -d COM7 -t 60 -f ../firmware/deCONZ_ConBeeII_0x26720700.bin.GCF

  2. Sample Output in Windows

Reboot device COM7 (ConBee II)
deCONZ firmware version 266f0700
action: update firmware after 7166 ms
flashing 164373 bytes: |==============================|
verify: .
SUCCESS
Wait 10 seconds until application starts```

Home Remember : Not all devices listed here are supported by deconz.

deCONZ for Dummies

Backup & Restore

Request Device Support

Supported Devices

Community Device Reports

Hue API Compatibility

Enable core dumps on Raspbian

Clone this wiki locally