homebridge-zigbee

Flashing

Hardware requirements

In order to flash the ZigBee stick we need the following hardware:

Name Price Picture
CC debugger +-10$ on AliExpress CC debugger
Downloader cable CC2531 +-3.50$ on AliExpress Downloader cable CC2531

Flashing the CC2531 USB stick

The CC2531 USB stick needs to be flashed with a custom firmware. The following instructions assume you have a CC Debugger. In case you don’t, see Alternative firmware flashing methods.

For Windows

  1. Install SmartRF Flash programmer (NOT V2). This software is free but requires a Texas Instruments account in order to download.

  2. Install the CC debugger driver on your PC (Windows only). Before continuing, verify that the CC Debugger driver has been installed correctly. See Figure 1. Verify Correct Driver Installation @ Chapter 5.1. In case the CC Debugger is not recognized correctly install the driver manually.

  3. Connect CC debugger --> Downloader cable CC2531 --> CC2531 USB stick.

  4. Connect BOTH the CC2531 USB stick and the CC debugger to your PC using USB.

  5. If the light on the CC debugger is RED press set reset button on the CC debugger. The light on the CC debugger should now turn GREEN. If not use CC debugger user guide to troubleshoot your problem. How to connect

  6. Download the firmware CC2531ZNP-2018090201.hex

  7. Start SmartRF Flash Programmer, setup as shown below and press Perform actions. SmartRF Flash Programmer

For Linux/MacOS

  1. Install prerequisites for CC-Tool using a package manager (ex. brew for MacOS)

    Ubuntu: libusb-1.0, libboost-all-dev
    Fedora: boost-devel, libusb1-devel
    Mac OS: libusb boost pkgconfig

  2. Build your cc-tool
    git clone https://github.com/dashesy/cc-tool.git
    cd cc-tool
    ./configure
    make
    
  3. Download the firmware CC2531ZNP-Pro-Secure_LinkKeyJoin.hex

  4. Flash your firmware
    sudo ./cc-tool -e -w CC2531ZNP-Prod.hex
    

Alternative firmware flashing methods

TBD

This page is based on wiki from zigbee2mqtt project.