Skip to content

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.