KNX ↔ IoT Bridge

Il bridge normalizza i telegrammi KNX in messaggi strutturati per trasporti IoT (MQTT, REST, Modbus) e accetta input dal flow per riscrivere sul bus. Qui trovi una guida rapida e i collegamenti consigliati ai nodi di trasporto di Node-RED.

Riepilogo mappatura

| Campo | Scopo | Note | | – | – | – | | Label | Nome descrittivo | Appare nello status e in msg.bridge.label. | | GA / DPT | Indirizzo di gruppo e datapoint | Puoi usare l’autocomplete ETS o inserirli a mano. | | Direzione | KNX→IoT, IoT→KNX, Bidirezionale | Determina quali pin sono attivi. | | Tipo canale | MQTT / REST / Modbus | Cambia il significato di Target. | | Target | Topic, URL base o registro | Vuoto = usa outputtopic del nodo. | | Template | Formattazione stringa | Segnaposto ,, ,, ,. | | Scala / Offset | Conversione numerica | Applicata KNX→IoT; in IoT→KNX viene invertita. | | Timeout / Tentativi | Suggerimenti pass-through | Servono ai nodi a valle per gestire ritentativi/timeouts. |

Trasporti tipici

MQTT broker

• Pubblicazione: collega l’uscita 1 al nodo core mqtt out. Il bridge imposta msg.topic e msg.payload già pronti per il broker.
• Sottoscrizione: collega un nodo mqtt in all’ingresso del bridge. I payload sono convertiti secondo il DPT e scritti su KNX; l’ack sul pin 2 conferma la scrittura.

  REST API

• Invita l’uscita 1 nel nodo core http request (o contrib come node-red-contrib-http-request).
• Il bridge propaga bridge.method in msg.method e il template in msg.payload, così puoi inviare JSON o form-data.

  Registri Modbus

• Abbinalo a node-red-contrib-modbus (modbus-flex-write, modbus-write).
• Usa Target come indirizzo/registro Modbus. L’uscita 1 porta il valore in msg.payload e i metadati in msg.bridge.

  Flow di esempio

  Stato KNX → MQTT

  ```json

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

### Comando MQTT → KNX
```json

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

Unisci i due snippet nello stesso flow per ottenere il round-trip KNX ↔ MQTT con ack.

Payload REST

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

Instrada l’uscita 1 verso http request e usa la risposta per log o retry basati su bridge.retry.

Scrittura Modbus

1. Mappa con Target = 40010, Tipo = Modbus, Direzione = Bidirezionale.
2. Collega l’uscita 1 a modbus-flex-write di node-red-contrib-modbus, assegnando msg.payload al campo value del nodo Modbus.
3. L’ack informa quando KNX è stato aggiornato dopo un comando proveniente dal registro.

   Suggerimenti finali

   • Se lasci Target vuoto puoi reindirizzare più mappature sullo stesso topic/endpoint tramite outputtopic.
   • emitOnChangeOnly limita il rumore dei sensori; disattivalo se serve ogni telegramma.
   • L’uscita 2 replica sempre il payload arrivato dal mondo IoT con i metadati bridge: utile per il debug di scaling.
   • Per registri Modbus floating usa un function per comporre il formato richiesto dal dispositivo (16/32 bit). Buon bridging!