KNX Commands

Pinging a Device

The command "Knx.PingDevice" can be used to detect if a device is online.

Input Arguments:

Name	Description	Data Type
Address	Address of the device, e.g. "1.3.2"	System.String

Output Argument:

Name	Description	Data Type
Result	Flag if ping has been responded.	System.Boolean

IMPORTANT

Note that a device - even if it exists - may not be reachable and thus not reported by this method. Reasons for this include:

• Battery-driven devices are not reachable when in energy-saving mode
• When a device is connected to the wrong segment, or when couplers between ETS and the device are not commissioned correctly, the communication across couplers may not work

Example:

{
  "Id": "A7AE5AD1-4A42-4425-94FD-966B1A2A21CD",
  "Name": "PingDevice",
  "Type": "CommandNode",
  "Address": "Knx.PingDevice",
  "Arguments": [
    {
      "Name": "Address",
      "Type": "Input",
      "DataType": "System.String",
      "Description": "Device address"
    },
    {
      "Name": "Result",
      "Type": "Output",
      "DataType": "System.Boolean",
      "Description": "Ping return"
    }
  ]
}

Writing Group Values

The command "Knx.WriteGroupValue" allows to write values to a group of devices.

Input Arguments:

Name	Description	Data Type
Address	Address of the group, e.g. "1/4/3"	System.String
Value	Value to write	System.Byte[]

Output Argument:

No output. Check the command return state to check if the value has bee written to the device.

Example:

{
  "Id": "A7AE5AD1-4A42-4425-94FD-966B1A2A21CD",
  "Name": "WriteGroupValue",
  "Type": "CommandNode",
  "Address": "Knx.WriteGroupValue",
  "Arguments": [
    {
      "Name": "Address",
      "Type": "Input",
      "DataType": "System.String",
      "Description": "Group address"
    },
    {
      "Name": "Value",
      "Type": "Input",
      "DataType": "System.Byte[]",
      "Description": "Data"
    }
  ]
}

Read Group Values

The command "Knx.ReadGroupValue" allows to read values from a group of devices.

Input Arguments:

Name	Description	Data Type
Address	Address of the group, e.g. "1/4/3"	System.String

Output Argument:

Name	Description	Data Type
Value	Value from KNX Bus	System.Byte[]

Example:

{
  "Id": "A7AE5AD1-4A42-4425-94FD-966B1A2A21CD",
  "Name": "ReadGroupValue",
  "Type": "CommandNode",
  "Address": "Knx.ReadGroupValue",
  "Arguments": [
    {
      "Name": "Address",
      "Type": "Input",
      "DataType": "System.String",
      "Description": "Group address"
    },
    {
      "Name": "Value",
      "Type": "Output",
      "DataType": "System.Byte[]",
      "Description": "Data from knx"
    }
  ]
}