MQTT Home Assistant - IoT

Der Bridge normalisiert KNX-Telegramme zu strukturierten Nachrichten für IoT-Transporte (MQTT, REST, Modbus) und nimmt Flow-Eingaben entgegen, um zurück in den KNX-Bus zu schreiben. Diese Seite fasst die Konfiguration und empfohlene Drittanbieter-Nodes zusammen.

Betriebsmodus

Der Node hat einen Modus-Schalter:

• IoT-Bridge (Standard) — das unten beschriebene Verhalten: eine Zuordnungsliste, die KNX-Telegramme in MQTT/REST/Modbus-Ausgabemeldungen umwandelt und umgekehrt.
• MQTT / Home Assistant (nativ) — der Node verbindet sich direkt mit einem MQTT-Broker und überbrückt KNX ↔ MQTT in beide Richtungen, mit Home-Assistant-MQTT-Discovery, sodass KNX automatisch in Home Assistant erscheint. Keine mqtt in/mqtt out-Verdrahtung nötig.

Modus MQTT / Home Assistant

Voraussetzungen: ein MQTT-Broker, der sowohl von Node-RED als auch von Home Assistant erreichbar ist, mit aktivierter MQTT-Integration in HA. Alle Entitäten werden unter einem einzigen HA-Gerät mit dem Namen des Nodes gruppiert.

Rollläden & Thermostate

Rollläden und Thermostate fassen mehrere Gruppenadressen zu einer HA-Entität zusammen und können daher nicht aus einem einzelnen DPT abgeleitet werden - fügen Sie sie in der Liste hinzu:

• Rollladen: Auf/Ab-GA (1.008), optionale Stopp-GA (1.007), optionale Positions-GA Befehl/Status (5.001). Position invertieren bildet KNX (0% = offen) auf Home Assistant (100% = offen) ab.
• Thermostat: GA Ist-Temperatur (9.001), GA Sollwert Befehl/Status (9.001), optionale Ein/Aus-GA (1.001 → off/heat), plus Min-/Max-Temperatur und Schrittweite.

Die Datenpunkttypen werden aus dem ETS-Import gelesen, sofern vorhanden, andernfalls aus KNX-Standardwerten. Für zuverlässige Statuswerte sollten die von Rollläden/Thermostaten verwendeten Adressen im ETS-Import enthalten sein.

Native KNX-Integration vs. MQTT-Bridge. Wenn Home Assistant bereits über seine eingebaute KNX-Integration mit KNX kommuniziert, werden Rollläden/Klima dort mit Gruppenadressen konfiguriert und diese MQTT-Bridge wird nicht benötigt. Verwenden Sie diesen Modus, wenn Node-RED den KNX-Bus besitzt und Home Assistant alles über MQTT sieht.

Feldübersicht

Typische Transporte

MQTT-Broker

• Publizieren: Ausgang 1 an den Core-Node mqtt out anschließen. msg.topic und msg.payload sind bereits gesetzt.
• Abonnieren: Ein mqtt in-Node am Eingang wandelt MQTT-Nachrichten in KNX-Schreibvorgänge um. Ausgang 2 liefert eine Bestätigung.

REST-API

• Ausgang 1 in den Core-Node http request (oder contrib wie node-red-contrib-http-request) führen.
• Der Bridge kopiert bridge.method nach msg.method und den Template-Output nach msg.payload, ideal für Webhooks.

Modbus-Register

Die IoT-Bridge ist ein Nachrichtenadapter für node-red-contrib-modbus. Sie erstellt keinen TCP-/seriellen Client und fragt Geräte nicht selbst ab. Installieren Sie eine mit Ihrer Node-RED-Laufzeit kompatible Paketversion und konfigurieren Sie diese Aufgaben in den externen Modbus-Nodes.

Wählen Sie für neue Zeilen Mit Flex Write kompatibel, stellen Sie Unit-ID, Bereich und Datentyp ein und tragen Sie in Target die nullbasierte Protokolladresse ein. Ein KNX-Wert für ein Coil erzeugt FC5, für ein Holding Register FC6. Ausgang 1 ist direkt mit modbus-flex-write kompatibel:

msg.payload = {
  value: 215,
  fc: 6,
  unitid: 1,
  address: 9,
  quantity: 1
}

Für Daten in Richtung KNX verbinden Sie den Datenausgang von modbus-flex-getter oder modbus-read mit dem Bridge-Eingang. Flex Getter stellt die Anfrage (fc, unitid, address, quantity) in msg.modbusRequest bereit; Modbus Read behält sie in msg.input.payload. Das zurückgegebene Werte-Array kann in msg.payload oder msg.values liegen. Die Bridge unterstützt beide Nachrichtenformen. Aktivieren Sie Keep Msg Properties am Flex Getter. Eine Leseantwort kann mehrere konfigurierte Adressen abdecken, und die Bridge verwendet für jede passende Zeile das richtige Array-Element.

Unterstützt wird pro Zuordnung ein Bit oder ein einzelnes 16-Bit-Register: bool, uint16 oder int16. Multiword-Werte, 32-Bit-/Float-Dekodierung und Byte-/Wortreihenfolge gehören nicht zu diesem Adapter. Skalierung und Offset folgen raw = KNX × Skalierung + Offset; Modbus → KNX nutzt die inverse Rechnung. KNX-Werte beim Deploy lesen führt kein Modbus-Polling aus.

Zuordnungen ohne modbusMessageFormat behalten die skalare Legacy-Ausgabe mit msg.address und msg.modbusFunction auf oberster Ebene; gespeicherte Flows werden daher nicht still migriert.

Beispiel-Flows

Status KNX → MQTT

[
  {
    "id": "bridge1",
    "type": "knxUltimateIoTBridge",
    "z": "flow1",
    "server": "gateway1",
    "name": "Licht-Bridge",
    "emitOnChangeOnly": true,
    "readOnDeploy": true,
    "acceptFlowInput": true,
    "mappings": [
      {
        "id": "map-licht",
        "enabled": true,
        "label": "Wohnzimmerlicht",
        "ga": "1/1/10",
        "dpt": "1.001",
        "direction": "bidirectional",
        "iotType": "mqtt",
        "target": "knx/light/living",
        "method": "POST",
        "modbusFunction": "writeHoldingRegister",
        "scale": 1,
        "offset": 0,
        "template": "{{value}}",
        "property": "",
        "timeout": 0,
        "retry": 0
      }
    ],
    "wires": [["mqttOut"],["debugAck"]]
  },
  {
    "id": "mqttOut",
    "type": "mqtt out",
    "name": "MQTT Status",
    "topic": "",
    "qos": "0",
    "retain": "false",
    "broker": "mqttBroker",
    "x": 520,
    "y": 120,
    "wires": []
  },
  {
    "id": "debugAck",
    "type": "debug",
    "name": "KNX Ack",
    "active": true,
    "tosidebar": true,
    "complete": "true",
    "x": 520,
    "y": 180,
    "wires": []
  }
]

MQTT-Befehl → KNX

[
  {
    "id": "mqttIn",
    "type": "mqtt in",
    "name": "MQTT Befehl",
    "topic": "knx/light/living/set",
    "qos": "1",
    "datatype": "auto",
    "broker": "mqttBroker",
    "x": 140,
    "y": 200,
    "wires": [["bridge1"]]
  }
]

Kombinieren Sie beide Ausschnitte, um einen KNX ↔ MQTT Roundtrip mit Bestätigung zu erhalten.

REST-Snapshot

{
  "id": "bridge-rest",
  "type": "knxUltimateIoTBridge",
  "name": "Leistungs-Bridge",
  "mappings": [
    {
      "label": "Wirklast gesamt",
      "ga": "2/1/20",
      "dpt": "9.024",
      "direction": "knx-to-iot",
      "iotType": "rest",
      "target": "https://example/api/knx/power",
      "method": "POST",
      "template": "{\"value\":{{value}},\"ga\":\"{{ga}}\",\"ts\":\"{{isoTimestamp}}\"}"
    }
  ]
}

Leiten Sie Ausgang 1 in http request und nutzen Sie die Antwort samt bridge.retry für Wiederholstrategien.

Modbus-Schreibvorgang

1. Setzen Sie Target = 9, Typ = Modbus, Format = Mit Flex Write kompatibel, Unit-ID = 1, Bereich = Holding Register, Datentyp = uint16.
2. Verbinden Sie Ausgang 1 direkt mit modbus-flex-write; ein Function-Node ist nicht erforderlich.
3. Verbinden Sie die Antwort von modbus-read oder modbus-flex-getter für Modbus → KNX mit dem Bridge-Eingang.
4. Importieren Sie examples/IoT Bridge - Modbus Flex Adapter.json als manuellen Starter-Flow ohne Polling.

Tipps

• Lassen Sie Target nur bei MQTT-/REST-Zuordnungen leer, die outputtopic übernehmen sollen; Modbus Flex benötigt eine Adresse.
• emitOnChangeOnly reduziert Sensordatenrauschen; deaktivieren Sie es bei Bedarf.
• Ausgang 2 bestätigt den tatsächlich an KNX gesendeten Wert; er ist keine physische Modbus-Lese-/Schreibbestätigung.
• Eine Handbuchreferenz wie 40010 entspricht häufig der Adresse 9; prüfen Sie immer die Gerätedokumentation.

Viel Erfolg beim Bridging!