KNX Receiver

KNX Receiver

ID: uniflow.plugin.knxreceiver Category: Building Automation Version: v1.1.0 Min Uniflow Version: Uniflow ≥ v1.4.0

KNX Receiver Plugin Reference Manual

1. Overview

Plugin Name: KNX Receiver

Type: Building Automation

Identifier: uniflow.plugin.knxreceiver

Description

Connect to KNX IP Interfaces and Routers to read/write Group Addresses.


2. Technical Architecture

The KNX Receiver plugin provides seamless integration with KNX building automation networks via KNXnet/IP standards. It supports both Tunneling (point-to-point UDP unicast to KNX IP Interfaces) and Routing (UDP multicast over IPv4 backbone to KNX IP Routers).

The plugin translates KNX Datapoint Types (DPTs) between raw KNX payload bytes and Uniflow's strongly typed data engine. It maintains an active supervisor loop for keepalive frames, automatic socket reconnection, NAT traversal support, and continuous background processing of incoming bus telegrams (GroupValueWrite, GroupValueResponse).

Supported Datapoint Types (DPTs)

DPT IdentifierNameEncoding / FormatData Type
1.001Switch1-bit boolean flag (On/Off)Bool
5.001Scaling8-bit unsigned byte (0% to 100%)Double
5.003Angle8-bit unsigned byte (0° to 360°)Double
6.0018-bit Signed Int8-bit 2's complement integerInt32
7.00116-bit Unsigned Int16-bit unsigned integerInt32
8.00116-bit Signed Int16-bit 2's complement integerInt32
9.001Temperature (°C)16-bit KNX floating point (IEEE-754 half/mantissa)Double
9.004Illuminance (Lux)16-bit KNX floating pointDouble
9.007Humidity (%)16-bit KNX floating pointDouble
12.00132-bit Unsigned Int32-bit unsigned integerInt32
13.00132-bit Signed Int32-bit 2's complement integerInt32
14.056Power (W)32-bit IEEE-754 single precision floatDouble
16.001String (ASCII)14-byte ASCII stringString
20.102HVAC Mode8-bit enumeration (Auto, Comfort, Standby, Economy, Building Protection)Int32

System Interaction & Exposed Catalog Routes

The KNX Receiver plugin listens to KNX IP Multicast traffic (224.0.23.12:3671) or Point-to-Point Tunneling sessions. It parses cEMI telegram frames, decodes DPT Data Point Types (e.g. DPT 1.001 Switch, DPT 9.001 Float), and injects telemetry into Uniflow.

Catalog Routes & Node Integration

Input Event Triggers (Input Nodes):

  • knx.telegram_received - Emitted upon raw KNX cEMI telegram receipt.
  • knx.group_value_notified - Emitted when a decoded DPT value arrives.
  • knx.bus_online - Multicast listener status event.
  • Executable Actions (Action Nodes):

  • knx.send_telegram - Transmits a raw cEMI frame to multicast.
  • knx.reconnect_multicast - Reinitializes multicast socket listener.
  • Architecture Diagram

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...

    3. Configuration Parameters

    The following configuration fields are available in the User Interface for this plugin:

    Configuration SettingDescription
    Friendly NameHuman-readable label for this KNX Receiver connection (e.g., *Building A Gateway*).
    EnabledMaster toggle to enable or disable connection.
    IP Address / HostIP address or hostname of the KNX IP Interface / Router (e.g., 192.168.1.120).
    PortUDP port (default 3671).
    ModeConnection mode: Tunneling (point-to-point) or Routing (multicast).
    Physical AddressAssigned KNX Individual Address (e.g., 1.1.250).
    Multicast Group IPMulticast group IP for Routing mode (default 224.0.23.12).
    NAT TraversalEnables Network Address Translation traversal for remote connections.
    Connect Timeout (ms)Timeout for socket handshake establishing connection.
    Keepalive Interval (ms)Frequency of heartbeat heartbeat check messages (default 10000 ms).
    Reconnect Delay (ms)Time to wait before attempting socket reconnect on error (default 5000 ms).
    KNX Group Address PointsConfigured point registry table mapping Group Addresses (1/2/10) to DPT types and access controls.

    4. Exposed Routes & Data Types

    This plugin exposes catalog fields across the following rule graph nodes:

    Input Source

    The Input Source node reads polled or telegram-pushed values from KNX Group Addresses on the bus.

    Human-Readable Field NameData TypeDescription
    Configured KNX Group Address Point  Double` / `Bool` / `Int32` / `String
    Live value received from KNX bus telegrams or polling cycle.

    Output Target

    The Output Target node acts as an action sink node to write values (GroupValueWrite) to KNX Group Addresses.

    Target NameData TypeAssociated ParametersParameter Data TypeRequiredDescription
    Configured Writable KNX Group Address  Double` / `Bool` / `Int32` / `String
    ValueDouble / Bool / Int32 / StringTrueValue payload to format according to DPT and transmit to target KNX Group Address.

    5. Usage Examples

    Scenario A: KNX Motion Sensor Telegram (DPT 1.001) Triggers Milestone Camera Recording

    Workflow Overview:

    When a KNX ceiling presence detector emits a GroupValueWrite telegram on Group Address 3/0/1 (knx.group_value_notified with Value == True), Uniflow decodes the DPT 1.001 boolean payload and immediately commands Milestone XProtect to start recording on camera CAM-03-HALLWAY.

    Rule Node Configuration:

    1. Event Input Node: KNX Receiver Listener

  • Filter Event: knx.group_value_notified
  • Exposed Schema Fields: GroupAddress (String), Value (Bool), DPT (String), Timestamp (DateTime)
  • 2. Logic Filter Node: And Condition

  • Expression: GroupAddress == "3/0/1" AND Value == True
  • 3. Output Target Node: Milestone XProtect

  • Action Target: Milestone Trigger Event
  • EventSourceGuid: CAM-03-HALLWAY_GUID
  • DataType: analytics
  • Tag: KNX Motion Triggered Recording
  • Logic Flow Diagram:

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...

    Scenario B: KNX Window Contact Open Telegram Triggers Modbus HVAC Setpoint Reduction

    Workflow Overview:

    When a KNX magnetic window contact opens (GA 4/2/1, Value == True), Uniflow evaluates the telegram notification and writes a Modbus TCP holding register (HoldingRegister 110 = 16.0°C) to force the HVAC zone controller into setback mode to conserve energy.

    Rule Node Configuration:

    1. Event Input Node: KNX Receiver Listener

  • Filter Event: knx.group_value_notified
  • Exposed Schema Fields: GroupAddress (String), Value (Bool), Timestamp (DateTime)
  • 2. Logic Filter Node: And Condition

  • Expression: GroupAddress == "4/2/1" AND Value == True
  • 3. Output Target Node: Modbus Client Writer

  • Action Target: Direct Access
  • Type: Holding Register
  • Address: 110
  • Value: 16.0
  • Logic Flow Diagram:

    VISUAL ARCHITECTURE FLOW DIAGRAM
    Rendering Flow Architecture Diagram...
    Architecture Flow Diagram — Full Preview