KNX Troubleshooting

KNX Troubleshooting

KNX Troubleshooting

Below are some common KNX related issues reported by customers. We recommend reviewing the following items, as they may help identify and resolve existing problems.

Issue 1: “sys::IOErr: tuwien.auto.calimero.KNXException: no local host address available”

This error on a Linux OS server is coming from Calimero (the Java KNX library) when it tries to open a KNXnet/IP tunneling connection, and it means quite literally that it cannot determine a usable local IP address on your machine to bind the KNX connection to.

To resolve this on Linux systems, OPC UA and KNX connectors require the system hostname to resolve to a non‑loopback IPv4 address.

If /etc/hosts maps the hostname to 127.0.1.1 (default on many distributions), network communication may fail with errors such as:

  • KNX: no local host address available

  • OPC UA: clients unable to connect to advertised endpoints

Ensure /etc/hosts maps the hostname to the system’s actual network IP address.

Issue 2: “sys::ArgErr: java.lang.IllegalArgumentException: malformed input off : 19, length : 1”

This error is due to special characters in the file names. If your .knxproj file contains special characters, you can enable custom encoding by running knxEnableCustomEncoding(true) from Folio > Launch, then restart the FIN service to prevent errors.