busware

zigbee2knx

zigbee2knx is firmware for the busware TUL that makes the stick the Zigbee coordinator and turns every paired Zigbee device into a KNX device of its own: its own individual address, its own application with parameters and group objects, programmed from ETS like any other KNX device. No hub and no IP network sit in between; in operation the stick needs nothing but the KNX bus.

Need the hardware? busware TUL — TPUART USB module, with the ESP32-C6 (the C3 has no Zigbee radio). The TUL is a hardware platform for your own projects; this firmware is free, you install it yourself, and busware provides no support for it.

For the TULX there is no image yet: on it, sending on the bus, pairing and downloads have not been tested.

Flash it right here. Chrome, Edge or Opera on a PC; plug the TUL into USB and press the button.

Your browser cannot flash from a web page; use Chrome, Edge or Opera on a PC. Flashing needs a page served over HTTPS.

First installation: let the installer erase the stick. An update: do not erase — then the Zigbee network and the KNX devices stay, and the devices need not be paired again.

What you need

ETS (tested with ETS 6.4.1) and the product files of the device classes. You build the .knxprod files yourself with OpenKNXproducer and the signing library of your ETS; the instructions are in the project's README.

How it works

Insert the gateway into a KNX line and program its individual address. Then insert a Zigbee device's product (for example an IKEA lamp) into the same line and program its address: while ETS waits for the programming button, reset the Zigbee device — it joins and takes the address. Download the application and link the group objects like those of any KNX actuator.

ETS device list with the gateway and three Zigbee devices

Status

Preview 0.6.0. It runs with IKEA lights and plugs and ETS 6.4.1. Not released for production installations yet; what has been tested and what not is listed in the project's README.

Source and licence

Source code, device classes and documentation: github.com/tostmann/zigbee2knx, under the GPL-3.0.