KNX.net

KNX.net provides a KNX API for C#

This API allows to connect in both modes:

Tunneling
Routing

After connecting you will be able to send actions to the bus and receive messages from it.

The following datapoints are available in the API:

DPT	input type	input range	output type	output range	Description
`3.007`	`int`, `float`, `long`, `double`, `decimal`	`[-7,7]`	`int`	`[-7,7]`	Control blinds (steps) [`0` stops]
`3.008`	`int`, `float`, `long`, `double`, `decimal`	`[-7,7]`	`int`	`[-7,7]`	Control dimming (steps) [`0` stops]
`5.001`	`int`, `float`, `long`, `double`, `decimal`	`[0,100]`	`decimal`	`[0,100]`	Percentage (%)
`5.003`	`int`, `float`, `long`, `double`, `decimal`	`[0,360]`	`decimal`	`[0,360]`	Angle (°)
`5.004`	`int`, `float`, `long`, `double`, `decimal`	`[0,255]`	`int`	`[0,255]`	Percentage `[0,255]` (%)
`5.010`	`int`, `float`, `long`, `double`, `decimal`	`[0,255]`	`int`	`[0,255]`	Counter Pulses
`6.001`	`int`, `float`, `long`, `double`, `decimal`	`[-128,127]`	`int`	`[-128,127]`	Percentage (%)
`6.010`	`int`, `float`, `long`, `double`, `decimal`	`[-128,127]`	`int`	`[-128,127]`	Counter Pulses
`9.001`	`int`, `float`, `long`, `double`, `decimal`	`[-273,670760]`	`decimal`	`[-273,670760]`	Temperature in Celsius (°C)

Also working but no implemented as datapoints (see below for better explanation):

bit (lights, buttons)
byte (dimmers, temperature difference, RGB)

Examples

Connecting using Routing (turn off and on a light)

static void Main(string[] args)
{
  var connection = new KnxConnectionRouting();
  connection.Connect();
  connection.KnxEventDelegate += Event;
  connection.Action("5/0/2", false);
  Thread.Sleep(5000);
  connection.Action("5/0/2", true);
  Thread.Sleep(5000);
}
static void Event(string address, string state)
{
  Console.WriteLine("New Event: device " + address + " has status " + state);
}

Working with datapoints

Sending an action

connection.Action("1/1/16", connection.ToDataPoint("9.001", 24.0f));
connection.Action("1/1/17", connection.ToDataPoint("5.001", 50));

Converting state from event

static void Event(string address, string state)
{
  if (address == "1/1/16")
  {
    decimal temp = (decimal)connection.FromDataPoint("9.001", state);
    Console.WriteLine("New Event: device " + address + " has status " + temp);
    return;
  }
  if (address == "1/1/17")
  {
    int perc = (int)connection.FromDataPoint("5.001", state);
    Console.WriteLine("New Event: device " + address + " has status " + perc);
    return;
  }
}

Requesting status

Sending an action

connection.KnxStatusDelegate += Status;
connection.RequestStatus("1/1/16");
connection.RequestStatus("1/1/17");

Converting state from status event

static void Status(string address, string state)
{
  if (address == "1/1/16")
  {
    decimal temp = (decimal)connection.FromDataPoint("9.001", state);
    Console.WriteLine("New Event: device " + address + " has status " + temp);
    return;
  }
  if (address == "1/1/17")
  {
    int perc = (int)connection.FromDataPoint("5.001", state);
    Console.WriteLine("New Event: device " + address + " has status " + perc);
    return;
  }
}

Sending actions without using datapoints

connection.Action("1/1/19", true);
connection.Action("1/1/20", false);
connection.Action("1/1/21", 60);
connection.Action("1/1/22", 0x4E);

Connecting using Tunneling

The only difference is how the connection object is created

connection = new KNXConnectionTunneling(remoteIP, remotePort, localIP, localPort);

Notes

If connecting in routing mode:

make sure the system firewall allows incoming connections to the routing port (if not specified when connecting, default is 3671)

If connecting in tunneling mode:

make sure the system firewall allows incoming connections to the specified localPort

payam49er/knx.net