Skip to main content
Version: 2.6

KNX Driver Configuration

Plugin Configuration

The plugin configuration file is named settings.json located in <install directory>\Config\HumanOS.UHAL.KnxBusDriver\. It contains all global settings of the plugin.

See Generic Plugin Configuration for more details.

Example of default device configuration:

{
"Disabled": false,
"Devices": [
{
"MainTaskProcessor": {
"Name": "Main TaskProcessor",
"ProcessingPriority": "Normal",
"MaxSchedulingTimeSlice": 200,
"MinSchedulingTimeSlice": 10
}
}
]
}

Device Information File

Each device information file addresses a IP coupler in a KNX topology. Multiple IP couplers can be integrated in the same HumanOS IoT Gateway instance, each one having its own device description and overlapping KNX device addresses.

In the following example, two IP routers (internal address 1.0.0 and 2.0.0) can be integrated in HumanOS with two separate device information files:

The KNX Bus Driver information file contains

  • Id: unique device id (GUID), which MUST match the device license id.
  • DriverId: 2C42F493-2FF8-4E59-9A82-FAAC966992CF
  • Address: Connection address
  • Data Access
  • Commands

Detailed reference for device information files, see the Operation Manual - Device Information File.

Connection Address

Use the Ip-address for KNX IP routers to access them:

NameDescriptionExample
EthernetConnection over ethernet (IP tunneling). The address is {IP-Address}:{port}192.168.28.20:3671
CAUTION

USB connections are not supported.

Example connecting over KNX ip tunneling:

{
"Name": "BuildingA",
"Id": "3228f878-e1f3-4f62-84af-d9b6b0a18182",
"DriverId": "2C42F493-2FF8-4E59-9A82-FAAC966992CF",
"Address": "192.168.28.20:8271",
"DataNodes": [ ]
}