Skip to content

Releases

zigbee2knx 0.6.2

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.

zigbee2knx 0.6.1

zigbee2knx 0.6.1 Pre-release
Pre-release

Choose a tag to compare

@tostmann tostmann released this 19 Nov 13:07

Zigbee devices as KNX devices, with one gateway that is the Zigbee coordinator itself. This preview runs with IKEA
lights and plugs and ETS 6.4.1 on a TUL32. For the bus-powered TULX32 there is an image for the first time: it has run
there with an IKEA plug and a bench tool, not yet with ETS. The README
lists what has been tested and what not.

Install

Update the firmware first, then import the new product files and update the devices in ETS: the white spectrum light
0xC002 v6 needs firmware 0.6.1 to drive the LED2201G8 as described in
docs/devices.md. The device applications of 0.6.0
(tried: 0xC001 v3, 0xC002 v4, 0xC003 v3) run with firmware 0.6.1 until you update them. After updating the gateway in ETS, check its range of device numbers: version 4
has 200 to 231 by default, versions 1 to 3 had 1 to 48.

  • 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.1-tul32-bootloader.bin 0x8000 zigbee2knx-0.6.1-tul32-partition-table.bin 0x10000 zigbee2knx-0.6.1-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.1-tulx32.bin
    

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

In this release

Applications, each a new version that replaces those of 0.6.0 in ETS:

  • Gateway 0xC000 v4: for a gateway inserted anew the range of device numbers is 200 to 231 by default (was 1 to 48);
    the bus current in the product data is 47 mA (was 10 mA).
  • Dimmable light 0xC001 v5 and white spectrum light 0xC002 v6: switched on by a value or by dimming up, the brightness
    status goes out with the new brightness only, not first with the old one. The memory function keeps the last
    brightness the light reported while it was on. The LED2201G8 never gets Move to Level with On/Off, which restarts
    it while it is off.
  • White spectrum light 0xC002 v6: relative colour temperature with step code 1 stays within the minimum and maximum
    colour temperature; the texts of those parameters say that 1000 K and 10000 K mean no limit.
  • Remote 0xC004 v3 (experimental): fixes for toggling with inverted telegrams and for level 255.
  • All five: address and association tables of up to 255 entries; switch and plug 0xC003 v4 has no other change.

Firmware:

  • TULX32: the Zigbee transmit power is capped at 18 dBm; at 20 dBm the bus supply did not hold while the radio sent.
  • A new application version loaded into a running device needs far less memory in one piece: the gateway compiles
    the device's Berry program straight from the product data. A load that runs out of memory is tried three times;
    then the device stays in the load state error until its next download or a restart.
  • After a start, and after a Zigbee device restarted, the status objects of each device go on the bus once.
  • Pairing from ETS waits until the gateway's own application is loaded. A Zigbee device that joins while nothing holds
    the network open is asked to leave.
  • A ZCL command the Zigbee stack does not take is sent once more; colour temperature sent to a lamp that is off is
    taken by it (ExecuteIfOff).
  • A task watchdog restarts the gateway when one of its tasks stops.

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

zigbee2knx 0.6.0 (preview)

Pre-release

Choose a tag to compare

@tostmann tostmann released this 17 Nov 22:14

Zigbee devices as KNX devices, with one gateway that is the Zigbee coordinator itself. This preview runs with IKEA
lights and plugs and ETS 6.4.1 on a TUL32; the README lists what has
been tested and what not. IKEA came first only because those devices were lying around on the bench; other makes
are welcome.

Install

  • Web installer: https://tostmann.github.io/zigbee2knx/ (Chrome, Edge or Opera). 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.0-tul32-bootloader.bin 0x8000 zigbee2knx-0.6.0-tul32-partition-table.bin 0x10000 zigbee2knx-0.6.0-tul32.bin
    

There is no image for the TULX32 yet: on it the firmware has started, formed its Zigbee network and received
telegrams, but sending on the bus, pairing and downloads have not been tested.

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

In this release

  • The firmware trusts two hardware keys for the templates; the templates of this release are signed with the first
    of them.
  • Applications: gateway 0xC000 v3 (long frames, 55 octets by default), dimmable light 0xC001 v3, white spectrum light
    0xC002 v4, switch and plug 0xC003 v3, remote 0xC004 v2 (experimental).
  • The KNX serial number of a device is derived from its Zigbee device; the catalog has sections for gateway, lights,
    plugs and switches, and remotes.
  • Fixes in pairing, availability, the device server and the link layer.

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