Integrations
KNX
Write a KNX group address when somebody is recognised: a switch, a number or a text over a KNXnet/IP gateway, with examples.
On this page
FaceStream.AI writes a value to a group address when it recognises somebody: a switch command, a number or a short text, sent through your KNXnet/IP gateway. Which actuator listens to that group address, and what it does, is decided in your KNX project, the hallway light, a scene, a display in the kitchen.
Of all connection types this is the one that switches rather than reports, so plan the group addresses as carefully as any other sensor's.
What you need
| FaceStream.AI | Pro and up |
| A KNXnet/IP gateway | An IP interface or IP router that offers tunnelling, nearly all do. FaceStream.AI needs its address, not the address of a device on the bus |
| A free tunnel | FaceStream.AI keeps one tunnel open. Gateways have few, four is common, some have one, and every KNX connection to the same gateway shares that one tunnel |
| Group addresses | One per thing FaceStream.AI should say, created in ETS and linked to whatever should react |
Routing over multicast is deliberately not offered: multicast does not leave a Docker network. Tunnelling works wherever FaceStream.AI runs.
The connection
Notifications → Add connection → KNX:
| Field | What to enter |
|---|---|
| IP gateway | The address of the KNXnet/IP interface, for example 192.168.1.15 |
| Port | 3671, the KNXnet/IP default |
| Transport | Tunneling over UDP works with every gateway. Tunneling over TCP is steadier, if your gateway offers it |
| Group address | In three levels, for example 1/2/3 |
| Datapoint type | What the group address expects, see below |
| Value | What to write. Placeholders work here, and a rule can give each of its actions its own value |
| Datapoint type | Value | Good for |
|---|---|---|
| 1.001, switch | 1 or 0; on/off and true/false work as well |
A light, a relay, a presence flag |
| 5.010, a number from 0 to 255 | A number, for example 3 |
A person number or a scene number that a logic module translates |
| 16.001, text | Up to 14 characters, for example [[name]] |
A name on a display. Longer text is cut off, characters outside Latin-1 are replaced |
Test writes the value once, so you can watch the actuator. Under Recent deliveries, a KNX message reads confirmed on the bus: the gateway put the telegram on the bus. Whether an actuator did anything, the bus does not say, a group address nobody listens to looks exactly like success.
Examples
The hallway light for the family, in the evening
A connection to the group address of the hallway light, datapoint type 1.001, value 1.
A rule: Visit starts, Selected people, the family, Between 17:00 and 23:00,
Report Once per time window, the front door camera. The first family member home
switches the light on; the light's own timer switches it off again.
Somebody is at the door: on while they are there
One connection, group address 1/5/1, datapoint type 1.001. Two rules:
| Rule | Event | Value |
|---|---|---|
| At the door | Visit starts | 1 |
| Gone again | Visit ends | 0 |
Each rule gives its action its own value, so both use the same connection. The group address is on while somebody is being seen at the door, and off once they have not been seen for the Visit gap. Visits are counted per person, so with two people at the door the first one to leave switches it off.
One number per person
For logic that should react differently to each person: one connection with datapoint type
5.010, and one rule per person, Selected people with that person ticked, whose action
carries the person's number as its own value: 1 for Amelia, 2 for Tom. A logic module
or visualisation in your KNX system turns the number into a scene. The same number twice
in a row is sent twice: every arrival is a telegram of its own.
The name on a display
Datapoint type 16.001, value [[name]], on the group address of a display or a room
controller that shows text. Fourteen characters are all KNX allows, so Amelia Hart
fits and longer names are shortened.
When it does not work
| What you see | What to check |
|---|---|
| The connection times out | The gateway's address and port, and whether a tunnel is free, a visualisation, ETS and FaceStream.AI all use one |
| is not a switch value | Datapoint type 1.001 takes 1, 0, on, off, true, false |
| is outside 0-255 | Datapoint type 5.010 holds numbers from 0 to 255 |
| Confirmed on the bus, nothing happens | The group address is not linked to the actuator in ETS, or the actuator expects a different datapoint type |
KNX is a trademark of the KNX Association. FaceStream.AI is not affiliated with or certified by the KNX Association.