Skip to content

Flashing and updating

There are two main modules in UZG-01 that can be flashed and updated, these are:

Tip

Both ESP32 and CC2652P7 modules can be updated remotely. You do not need to have physical access to the device. Please read the next sections for updating both chips.

Update ESP32

Updating ESP32 through the browser

  1. Connect your UZG-01 to the PC.
  2. Follow this link UPDATE FIRMWARE ONLINE and press "INSTALL" button at that page.

Updating ESP32 Over the Air (distantly)

If your UZG-01 device has a LAN connection, you can update the ESP32 firmware remotely via Over-the-Air (OTA) updates feature. To update the firmware via OTA, follow these steps:

  1. Download the latest firmware from Official UZG-01 Firmware repository;
  2. Go to the web interface of the device;
  3. Go to the System and Tools section. In the "ESP32 Update" card

    • click Choose file;
    • select the firmware (*.bin file) and
    • Click ESP32 OTA Update.

    UZG-01 ESP32 OTA Flashing

  4. Wait for the firmware to finish and reboot the device.

Updating ESP32 via USB

If your UZG-01 device is not connected to LAN or you want to flash ESP32 via USB for other reasons, it can be easily done via USB cable.

For this purposes you need:

  • A computer with Windows or Mac installed
  • USB - Type-C cable.

To flash via USB, follow these steps:

  1. Download the flashing software. Recommended is ESP_Flasher,can be downloaded from Official repository on Github;
  2. Download the latest firmware version from Official UZG-01 Firmware repository;
  3. Using USB cable, connect UZG-01 to your computer;
  4. Be sure, that you have downloaded and installed the drivers for USB/UART converter, built in to your UZG-01.
  5. Run the ESP_Flasher program and
    • Select Serial-port in the Serial port section;
    • In the Firmware section, select the file with your firmware;
    • Press the "Flash ESP" button.
  6. Wait for the firmware to complete.

    ESP Flasher - complete

Update Zigbee CC2652P

User can flash Zigbee SoC (which is Texas Instruments CC2562P) any of the tools described at Zigbee2MQTT.

Below you can find detail manuals for few flashing options from those links.

Coordinator Router
CC1352P7_coordinator_*.zip CC1352P7_Router.zip

Over-the-Air

Tip

Update over Ethernet can be done distantly without a physical access to your device!

Currently available methods are: Home Assistant Addon & ZigStar Multi Tool

HA Addon - Ethernet

Addon-ons for Home Assistant that allow you to easily flash new firmware on your ZigStar Coordinators

Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

Adding this add-ons repository to your Home Assistant instance is pretty easy. In the Home Assistant add-on store, a possibility to add a repository is provided.

Use the following URL to add this repository:

https://github.com/mercenaruss/zigstar_addons
  1. Add repository to your Home Assistant instance
  2. Install ZigStar: TI CC2652 Flasher Add-on
  3. Choose correct settings and start addon1

Until detailed instruction will be available,please check next video with English subtitles:

Multi Tool - Ethernet

  1. Download latest Zigbee firmware. UZG-01 Adapter is based on CC2652P from Texas Instruments. Firmware's are based on Z-Stack. You can see the best one here Koenkk Z-Stack firmware on Github.

    Danger

    Currently we are moving to new Texas Instruments Chip - CC2652P7 what will support up to 300 devices
    First users of UZG-01 are still using CC2652P2 chip

    Choose correct firmware:

    UZG-01 - Use firmware with a tag "..launchpad_coordinator_";
    UZG-01 v0.2+ - Use firmware with a tag "CC1352P7";

  2. Download ZigStar MultiTool - choose the right version for your OS;

  3. Connect your UZG-01 and PC with flashing firmware to the same LAN network over ethernet (cable) connection. It is important, as because WiFi can have some delays - it is incompatible for flashing. Flashing should be done only through ethernet connection;
  4. Open Flashing tool and make te following settings:

    • IP address and port of your UZG-01 will be identified automatically 192.168.110.122:6638 (1)

      1. 192.168.110.122 is an IP address and 6638 - port
    • click button ... and select your Zigbee firmware, downloaded at stage 1;

    • Put active checkboxes Erase, Write, Verify, and Auto BSL;
    • Press Start button

    Multi-Tool flasher - finish flashing

    Warning

    Zigbee connectivity (e.g. Zigbee2MQTT or ZHA) should be disconnected. Flashing is impossible when the adapter is in active state.

    Danger

    It is crucial that you download the correct firmware for your gateway as using the wrong firmware will disable the BSL and you will need an external debugger / programmer to flash your gateway again.

  5. Wait until the process is completed: the progress bar contains the message "100%" and below text All is Ok. Restarting Zigbee. Flashing takes about 8 minutes;

  6. That is it. Flashing is done. You can use your device now with the new Zigbee firmware. Proceed with installation

Over-the-USB

Multi Tool - USB

  1. Download latest Zigbee firmware. UZG-01 Adapter is based on CC6252P from Texas Instruments. Firmware's are based on Z-Stack. You can see the best one here Koenkk Z-Stack firmware on Github.

    Danger

    Currently we are moving to new Texas Instruments Chip - CC2652P7 what will support up to 300 devices
    First users of UZG-01 are still using CC2652P2 chip

    Choose correct firmware:

    UZG-01 - Use firmware with a tag "..launchpad_coordinator_";
    UZG-01 v0.2+ - Use firmware with a tag "CC1352P7";

  2. Download ZigStar MultiTool - choose the right version for your OS;

  3. Connect your UZG-01 to your network and USB port;
  4. Be sure, that your PC has USB drivers and UZG-01 USB is recognized. If no, please install.
  5. Change your UZG-01 mode to Zigbee-to-USB by pressing once Control Button.
    When UZG-01 is in USB-Mode please hold 4-8 seconds to activate Flashing Mode

    BSL Mode

  6. Open Flashing tool and make te following settings:

    • IP address and port of your UZG-01 will be identified automatically 192.168.110.122:6638 (1)

      1. 192.168.110.122 is an IP address and 6638 - port
    • click button ... and select your Zigbee firmware, downloaded at stage 1;

    • Put active checkboxes Erase, Write, Verify, and Auto BSL;
    • Press Start button

    Multi-Tool flasher - finish flashing

    Warning

    Zigbee connectivity (e.g. Zigbee2MQTT or ZHA) should be disconnected. Flashing is impossible when the adapter is in active state.

    Danger

    It is crucial that you download the correct firmware for your gateway as using the wrong firmware will disable the BSL and you will need an external debugger / programmer to flash your gateway again.

  7. Wait until the process is completed: the progress bar contains the message "100%" and below text All is Ok. Restarting Zigbee. Flashing takes about 8 minutes;

  8. That is it. Flashing is done. You can use your device now with the new Zigbee firmware. Proceed with installation

SmartRF FP2 - USB

Tip

Texas Instruments is a manufacturer of Zigbee SoC CC2652P which is used in UZG-01 adapter. The most "original" method is to use official flasher but it is more complicated process.

  1. Download latest Zigbee firmware. UZG-01 Adapter is based on CC6252P from Texas Instruments. Firmware's are based on Z-Stack. You can see the best one here Koenkk Z-Stack firmware on Github.

    Danger

    Currently we are moving to new Texas Instruments Chip - CC2652P7 what will support up to 300 devices
    First users of UZG-01 are still using CC2652P2 chip

    Choose correct firmware:

    UZG-01 - Use firmware with a tag "..launchpad_coordinator_";
    UZG-01 v0.2+ - Use firmware with a tag "CC1352P7";

  2. Download official Texas Instruments Flash Programmer 2;

  3. Install Flash Programmer 2;
  4. Connect your UZG-01 to your network and USB port;
  5. Be sure, that your PC has USB drivers and UZG-01 USB is recognized. If no, please install.
  6. Change your UZG-01 mode to Zigbee-to-USB by pressing once Control Button.
    When UZG-01 is in USB-Mode please hold 4-8 seconds to activate Flashing Mode

    Flash programmer 2 - BSL Mode

  7. Open your Flash Programmer 2 from step 3. At the left window Connected devices click on Unknown and below at Selected target choose CC2652P;

    • Select firmware file under the Flash images(s) with the option Single;
    • Make active checkboxes Erase (All unprotected pages), Program (Entire source file), Verify (CRC check)
    • Please very very careful, the Disable bootloader should remain UNCHECKED. Otherwise you will not be able to flash CC2652P via USB or LAN but just with external programmer;
    • Press the Start button (with Triangular) to Start the flashing.
    • Wait until the message Success! is appeared at the progressbar and Status window states Reset of target successful.

    Flash programmer 2 - to select target device

    Warning

    Disable bootloader should remain UNCHECKED

  8. That is it. Flashing is done. You can use your device now with the new Zigbee firmware. Proceed with installation

Update with HW flasher

UZG-01 adapter contains DIY pinouts that enable users to flash directly by J-TAG. Please note, that pin-outs are 2.54mm size.


  1. Detailed video instruction will provided soon.