User Guide: KNX Agent

Connect to a KNX network via a KNX IP Interface/Router.

Agent configuration

The following describes the supported agent configuration attributes:

Attribute	Description	Value type	Required
host	IP Interface/Router hostname or IP address	Hostname or IP address	Y
port	IP Interface/Router port	Port number	N
NATMode	Enable NAT mode	Boolean	N (Default = false)
routingMode	Enable Routing mode	Boolean	N (Default = false)
messageSourceAddress	Source group address	Text (KNX Group Address e.g. 1.1.1)	N (Default = 0.0.0)

Agent link

For attributes linked to this agent, the following describes the supported agent link fields which are in addition to the standard Agent Link fields:

Field	Description	Value type	Required
type	Agent type	Text (Must be KNXAgentLink)	Y
dpt	The DPT (data point type) of the group address	Text (DPT e.g. 1.001)	Y
actionGroupAddress	Group address for attribute write	Text (KNX Group Address e.g. 1.1.1)	N (Default = 0.0.0)
statusGroupAddress	Group address for attribute read	Text (KNX Group Address e.g. 1.1.1)	N (Default = 0.0.0)

Discovery and Import

To understand discovery and import refer to Agent and Asset Discovery/Import. This protocol supports the following:

• Protocol Asset Import (*.knxproj)

Each group address in the project file will create a new asset with a single attribute also with the same name (no spaces in attribute name), the attribute type is determined by the following naming convention:

• Group Address ends with #A - Actuator (executable attribute)
• Group Address ends with #S - Sensor (read only)
• Group Address ends with #SA or #AS - Actuator and sensor

Only group addresses using this convention will be imported