Skip to content

zigbee2knx 0.6.2

Pre-release
Pre-release

Choose a tag to compare

@tostmann tostmann released this 19 Nov 18:49

Zigbee devices as KNX devices, with one gateway that is the Zigbee coordinator itself. This preview moves to
esp-zigbee-lib 2.1.0. Development builds of it and then the release image ran on a TUL32 with IKEA lights and a plug
and a bench tool over KNXnet/IP, not with ETS; ETS 6.4.1 ran with 0.6.1 and earlier. For the bus-powered TULX32 there
is an image; 0.6.2 ran there with a bench tool and without a Zigbee device, not yet with ETS. The
README lists what has been tested and what not.

Install

This release changes the firmware only; the product files and applications of 0.6.1 stay (gateway 0xC000 v4, dimmable
light 0xC001 v5, white spectrum light 0xC002 v6, switch and plug 0xC003 v4, remote 0xC004 v3). An update from 0.6.1
keeps the Zigbee network and the paired devices.

  • Web installer: https://tostmann.github.io/zigbee2knx/ (Chrome, Edge or Opera), TUL32 only. On the first
    installation let it erase the device; for an update do not erase, then the Zigbee network and the KNX devices stay.

  • esptool, TUL32:

    esptool --chip esp32c6 write-flash 0x0 zigbee2knx-0.6.2-tul32-bootloader.bin 0x8000 zigbee2knx-0.6.2-tul32-partition-table.bin 0x10000 zigbee2knx-0.6.2-tul32.bin
    
  • esptool, TULX32: do not use the web installer, it would overwrite the bootloader and the partition table. Read
    the whole flash first: writing the application replaces the one the TULX32 was delivered with, and the way back
    through its recovery system has not been tested. Then write only the application, over the service header:

    esptool --chip esp32c6 read-flash 0 0x400000 backup.bin
    esptool --chip esp32c6 write-flash 0x10000 zigbee2knx-0.6.2-tulx32.bin
    
  • Back to 0.6.1: write only the application of 0.6.1 at 0x10000, without erasing; the network and the devices stay
    (tried on a TUL32 with a development build of 0.6.2, not on a TULX32). The rejoin problem of esp-zigbee-lib 2.0.1
    described below then applies again.

The product files for ETS are built from producer/ with OpenKNXproducer and your ETS, see
Building the product files.

In this release

  • Zigbee stack esp-zigbee-lib 2.1.0 (was 2.0.1): on a TC rejoin the trust center keeps a device's own link key and
    uses it (2.0.1 replaced it with the global key, esp-zigbee-sdk issue 876); a short address could be given that was
    reserved or the coordinator's own; leaks around ZDO requests and groupcast frames are fixed. A Zigbee 4.0 test device
    joined with a dynamic link key. Devices that do not exchange a link key (before Zigbee 3.0) are kept, as with 0.6.1;
    2.1.0 alone would remove them about 15 s after they join.
  • No new network after a start without the old one: if the Zigbee stack starts without its network (data lost or
    not readable) while Zigbee devices are paired, the gateway no longer forms a new network, which would take every
    device away. It reports it instead: the fault object goes to 1, the last message is NET; it decides again at the
    next start. zbform yes at the console forms a new network on purpose (not yet run on a device); then each device
    has to be reset and join anew.
  • Memory check before loading a device class: for a class whose unpacked data is larger than 16 KB it counts
    4 bytes per octet (was 3); the load measured on the device grew by about 3.8 bytes per octet.

Known limitations: docs/getting-started.md.

SHA256SUMS lists the checksums of the files.

Licence

zigbee2knx is licensed under GPL-3.0 with an additional permission for the libraries Espressif ships in object code
form; LICENSE and NOTICE.md are attached. The firmware images also contain Berry (MIT), ESP-IDF and esp-zigbee-lib
(Apache-2.0), see NOTICE.md. The source of this release is the tag v0.6.2.