KNX.net provides a KNX API for .NET
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 dimming (steps) [0 stops] |
3.008 |
int , float , long , double , decimal |
[-7,7] |
int |
[-7,7] |
Control blinds (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