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)
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);
}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;
}
}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;
}
}connection.Action("1/1/19", true);
connection.Action("1/1/20", false);
connection.Action("1/1/21", 60);
connection.Action("1/1/22", 0x4E);The only difference is how the connection object is created
connection = new KNXConnectionTunneling(remoteIP, remotePort, localIP, localPort);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
./packages/NUnit.ConsoleRunner/tools/nunit3-console.exe ./tests/KNXLibTests/bin/Release/KNXLibTests.dll --labels=On --nocolor --verbose --workers=1 --full --result:"./nunit-result.xml;format=nunit2"
./packages/NUnit.ConsoleRunner/tools/nunit3-console.exe ./tests/InfluxDB.FSharp.UnitTests/bin/Release/InfluxDB.FSharp.UnitTests.dll --labels=On --nocolor --verbose --workers=1 --full --result:"./nunit-result.xml;format=nunit2"
./packages/xunit.runners/tools/xunit.console.clr4.exe ./tests/FunctionalLiving.Parser.Tests/bin/Release/FunctionalLiving.Parser.Tests.dll