TUL & TUL32 KNX/IP Gateway
Firmware for the busware TUL (ESP32-C3) and TUL32 (ESP32-C6) USB sticks. Bridges the KNX TP bus and your IP network: KNXnet/IP routing & tunneling (up to 10 concurrent tunnels), web dashboard, Wi-Fi setup via Improv. The TUL32 can optionally use wired ethernet through a W5500 module on its FPC header.
Works only in Chrome, Edge or
Opera on a desktop computer — Safari and Firefox do not
support the Web Serial API.
Supported hardware
TUL (ESP32-C3)
busware TUL USB stick with ESP32-C3ESP32-C3 4 MB flash Dual OTA
TUL32 (ESP32-C6)
busware TUL USB stick with ESP32-C6 — the version sold in the shopESP32-C6 4 MB flash Dual OTA W5500 LAN optional
You do not have to choose: the installer detects which stick is connected. The bus-powered TULX has no USB port and installs firmware through its recovery system — see install.busware.de/tulx/.
Installation
- Plug the stick into a USB port of this computer.
- Click “Connect”. A dialog opens in which you select the
stick's serial port (typically
/dev/ttyACM0orCOMx). - Choose “Install ip4knx…” to write the firmware.
- After flashing, the tool stays open and offers
Wi-Fi setup via Improv (enter SSID and password right
in the browser). Alternatively, a stick without stored Wi-Fi credentials
opens the access point “
TUL AP xxxx”; join it and set up Wi-Fi in the captive portal (http://192.168.4.1). Holding the button for more than 2 s opens the access point again later. - The dashboard is then reachable at
http://tul.localor at the address your router assigned.
Updating: a stick that already runs ip4knx updates itself
over the network and keeps its settings — dashboard, card “Firmware &
System”, Online Update → Check for Updates. Installing from
this page resets the stored settings (Wi-Fi and KNX configuration); the stick
then has to be set up again.
What's inside
- KNXnet/IP routing + tunneling (10 concurrent connections)
- Long frames (extended frames) up to a 254-byte APDU
- Patched OpenKNX stack on the NCN5130 transceiver (tunnel fixes, connection state tracking, lcconfig fix, heap-leak fixes for stability under continuous routing load)
- Web dashboard with live bus statistics, NCN power-rail status and tunnel usage
- Programming-mode toggle in the dashboard for ETS commissioning without touching the hardware
- Online update with MD5 verification — no USB connection needed for later firmware changes
- Hardened web interface: cross-origin protection (CSRF) on all write endpoints; access-point mode is onboarding only (scan, connect, status)
- Improv serial for easy first-time Wi-Fi setup
- Home Assistant: found by the KNX integration's gateway scan — guide