node-red-contrib-knx-ultimate 5.0.0 → 5.0.2

package/nodes/locales/de/knxUltimateIoTBridge.json

@@ -1,13 +1,63 @@
 {
   "knxUltimateIoTBridge": {
-    "title": "KNX ↔ IoT Bridge",
-    "paletteLabel": "IoT Bridge",
+    "title": "MQTT Home Assistant - IoT",
+    "paletteLabel": "MQTT Home Assistant - IoT",
     "node-input-server": "KNX-Gateway",
     "node-input-name": "Name",
     "node-input-outputtopic": "Standard-Topic für Ausgaben",
     "node-input-emitOnChangeOnly": "KNX→IoT nur bei Wertänderung senden",
     "node-input-readOnDeploy": "KNX-Werte beim Deploy lesen",
     "node-input-acceptFlowInput": "Flow-Eingaben akzeptieren (IoT → KNX)",
+    "node-input-nodeMode": "Modus",
+    "mode": {
+      "iot": "IoT-Bridge (MQTT/REST/Modbus-Nachrichten)",
+      "homeassistant": "MQTT / Home Assistant (nativ)"
+    },
+    "ha": {
+      "intro": "Native MQTT-Bridge mit Home-Assistant-Discovery. Jede im KNX-Gateway importierte Gruppenadresse (ETS-Liste) wird automatisch als Home-Assistant-Entität (switch, sensor, binary_sensor, number, text) bereitgestellt, zusätzlich zu den unten definierten Rollläden und Thermostaten.",
+      "broker_url": "Broker-URL",
+      "username": "Benutzername",
+      "password": "Passwort",
+      "optional": "(optional)",
+      "base_topic": "Basis-Topic",
+      "discovery": "Home-Assistant-Discovery veröffentlichen",
+      "discovery_prefix": "Discovery-Präfix",
+      "hint": "Erfordert einen MQTT-Broker, der sowohl von Node-RED als auch von Home Assistant erreichbar ist, mit aktivierter MQTT-Integration in HA. Die Entitäten erscheinen unter einem Gerät mit dem Namen dieses Knotens. KNX-Buswerte werden an MQTT veröffentlicht und beschreibbare Datenpunkte akzeptieren Befehle von Home Assistant.",
+      "exposed_gas": "Bereitzustellende Gruppenadressen",
+      "exposed_gas_hint": "Wähle die Gruppenadressen aus, die an Home Assistant veröffentlicht werden sollen. Standardmäßig sind alle importierten Adressen ausgewählt. Von einem Rollladen/Thermostat (unten) verwendete Adressen werden dort behandelt und müssen hier nicht ausgewählt werden.",
+      "filter_placeholder": "Nach Adresse oder Name filtern…",
+      "select_all": "Alle auswählen",
+      "select_none": "Keine auswählen",
+      "exposed_count": "ausgewählt",
+      "read_only": "Nur lesen",
+      "read_only_bulk": "Nur lesen für angezeigte Adressen:",
+      "read_only_all": "Nur lesen setzen",
+      "read_only_none": "Nur lesen entfernen",
+      "bus_mode": "KNX-Bus-Verbindung",
+      "bus_standalone": "Eigenständig (über das Gateway)",
+      "bus_flow": "Flow-Nachrichten (Ein-/Ausgangs-Pins)",
+      "bus_flow_hint": "Verbinde einen KNXUltimate-Knoten im Universal-Modus mit dem Eingangs-Pin (KNX → MQTT) und einen weiteren mit dem Ausgangs-Pin (MQTT → KNX).",
+      "no_gateway": "Wähle zuerst ein KNX-Gateway aus.",
+      "no_ga": "Keine Gruppenadressen gefunden. Importiere die ETS-Liste im KNX-Gateway.",
+      "csv_error": "Die Gruppenadressliste konnte nicht vom Gateway geladen werden.",
+      "custom_entities": "Rollläden & Thermostate",
+      "custom_entities_hint": "Rollläden und Thermostate fassen mehrere Gruppenadressen zu einer Home-Assistant-Entität zusammen und können daher nicht automatisch aus dem DPT erstellt werden. Füge sie hier hinzu. Die Datenpunkttypen stammen aus der importierten ETS-Liste, sofern vorhanden, andernfalls aus KNX-Standardwerten (1.008 Auf/Ab, 1.007 Stopp, 5.001 Position, 9.001 Temperatur, 1.001 Ein/Aus). Für zuverlässige Statuswerte sollten diese GAs im ETS-Import enthalten sein.",
+      "ce_type_cover": "Rollladen",
+      "ce_type_climate": "Thermostat",
+      "ce_name": "Entitätsname",
+      "ce_gaUpDown": "Auf/Ab-GA (1.008)",
+      "ce_gaStop": "Stopp-GA (1.007)",
+      "ce_gaPosSet": "Position setzen GA (5.001)",
+      "ce_gaPosState": "Positionsstatus-GA (5.001)",
+      "ce_invertPosition": "Position invertieren (KNX 0% = offen)",
+      "ce_gaCurrentTemp": "Ist-Temperatur-GA (9.001)",
+      "ce_gaSetpointSet": "Sollwert setzen GA (9.001)",
+      "ce_gaSetpointState": "Sollwert-Status-GA (9.001)",
+      "ce_gaOnOff": "Ein/Aus-GA (1.001)",
+      "ce_minTemp": "Min. Temperatur",
+      "ce_maxTemp": "Max. Temperatur",
+      "ce_tempStep": "Temperaturschritt"
+    },
     "section_mappings": "Bridge-Zuordnungen",
     "mapping": {
       "enabled": "Aktivieren",
@@ -71,7 +121,9 @@
     },
     "labels": {
       "outputKnxToIoT": "Strom KNX → IoT",
-      "outputIoTToKnx": "Bestätigungen IoT → KNX"
+      "outputIoTToKnx": "Bestätigungen IoT → KNX",
+      "inputKnxBus": "KNX-Bus-Eingang (von einem Universal-Knoten)",
+      "outputKnxWrite": "KNX-Schreibausgang (zu einem Universal-Knoten)"
     }
   }
 }

package/nodes/locales/en/knxUltimate-config.json

@@ -77,13 +77,13 @@
             "enable_flow_bubbles": "Enable flow bubbles plugin",
             "enable_flow_bubbles_help": "Draw live status bubbles next to KNX Device nodes in the editor. Useful during commissioning and debugging.",
             "log_level": "Loglevel",
-        "status_throttle": "Throttle node status updates",
-        "status_throttle_none": "Immediate (no throttle)",
-        "status_throttle_1s": "Update after 1 second",
-        "status_throttle_3s": "Update after 3 seconds",
-        "status_throttle_5s": "Update after 5 seconds",
-        "status_throttle_10s": "Update after 10 seconds",
-        "status_throttle_30s": "Update after 30 seconds",
+            "status_throttle": "Throttle node status updates",
+            "status_throttle_none": "Immediate (no throttle)",
+            "status_throttle_1s": "Update after 1 second",
+            "status_throttle_3s": "Update after 3 seconds",
+            "status_throttle_5s": "Update after 5 seconds",
+            "status_throttle_10s": "Update after 10 seconds",
+            "status_throttle_30s": "Update after 30 seconds",
             "status_datetime_format": "Status date/time format",
             "status_datetime_format_legacy": "Legacy (system locale)",
             "status_datetime_format_iso": "ISO (YYYY-MM-DD HH:mm:ss)",
@@ -155,4 +155,4 @@
             "reveal_keyring_fail": "Unable to decode the keyring. Check the keyring file and the general password."
         }
     }
-}
+}

package/nodes/locales/en/knxUltimateIoTBridge.html

@@ -1,8 +1,32 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-# KNX ↔ IoT Bridge
+# MQTT Home Assistant - IoT
 
 Create bidirectional bridges between KNX group addresses and IoT channels (MQTT topics, REST endpoints, Modbus registers). Each mapping can scale values, stringify payloads and expose metadata for downstream nodes.
 
+> **Two modes.** Use the **Mode** selector at the top of the node:
+> - **IoT bridge** (default) — the classic behaviour documented below (mapping list, MQTT/REST/Modbus output messages).
+> - **MQTT / Home Assistant (native)** — the node connects directly to an MQTT broker and bridges KNX ↔ MQTT both ways, publishing Home Assistant MQTT Discovery so entities appear automatically.
+
+## MQTT / Home Assistant mode
+
+A native MQTT bridge with Home Assistant discovery. It needs an MQTT broker reachable by both Node-RED and Home Assistant, with the MQTT integration enabled in HA. All entities appear under a single device named after this node.
+
+- **KNX bus connection** — how the node exchanges telegrams with KNX:
+    - *Stand-alone* (default) — the node talks to the KNX gateway directly and has no input/output pins.
+    - *Flow messages* — the node exposes an input pin and an output pin. Wire the output of a KNXUltimate node in **Universal** mode to the input (KNX bus → MQTT) and the output pin to the input of another KNXUltimate node in **Universal** mode (MQTT → KNX bus).
+- **Broker URL / Username / Password** — connection to your MQTT broker.
+- **Base topic / Discovery prefix** — root topic for state/command topics and the HA discovery prefix (default `homeassistant`).
+- **Group addresses to expose** — every address imported in the KNX gateway (ETS list) is shown with a checkbox. Ticked addresses are published as Home Assistant entities, typed automatically from the DPT (switch, sensor, binary_sensor, number, text). Use the filter box and the *Select all* / *Select none* buttons. By default all addresses are selected. Each row also has a **Read only** toggle: a read-only address is still published to Home Assistant (its state stays visible) but never accepts commands back to the KNX bus (switches become binary_sensors, numbers become sensors). The *Set read only* / *Clear read only* buttons apply it to all currently shown addresses.
+- **Covers & Thermostats** — group several addresses into one entity:
+    - *Cover*: Up/Down GA (1.008), optional Stop GA (1.007), optional Set/Status position GA (5.001). *Invert position* maps the KNX convention (0% = open) to Home Assistant (100% = open).
+    - *Thermostat*: current temperature GA (9.001), setpoint set/status GA (9.001), optional On/Off GA (1.001 → off/heat), plus min/max temperature and step.
+
+KNX bus values are published to MQTT and writable datapoints accept commands from Home Assistant. Datapoint types come from the imported ETS list when available, otherwise from KNX defaults (1.008 up/down, 1.007 stop, 5.001 position, 9.001 temperature, 1.001 on/off); for reliable status feedback the addresses used by covers/thermostats should be present in the ETS import.
+
+---
+
+The rest of this help describes the classic **IoT bridge** mode.
+
 ## Inputs
 
 |Property|Description|
@@ -63,7 +87,7 @@ Create bidirectional bridges between KNX group addresses and IoT channels (MQTT
 
 ### Modbus register sync
 
-- Pair the IoT Bridge with `node-red-contrib-modbus` `modbus-flex-write` nodes. Output&nbsp;1 carries the Modbus address in `msg.address` and the value in `msg.payload`.
+- Pair the MQTT - IoT with `node-red-contrib-modbus` `modbus-flex-write` nodes. Output&nbsp;1 carries the Modbus address in `msg.address` and the value in `msg.payload`.
 
 ## Sample Flow
 

package/nodes/locales/en/knxUltimateIoTBridge.json

@@ -1,13 +1,63 @@
 {
   "knxUltimateIoTBridge": {
-    "title": "KNX ↔ IoT Bridge",
-    "paletteLabel": "IoT Bridge",
+    "title": "MQTT Home Assistant - IoT",
+    "paletteLabel": "MQTT Home Assistant - IoT",
     "node-input-server": "KNX Gateway",
     "node-input-name": "Name",
     "node-input-outputtopic": "Default topic for outputs",
     "node-input-emitOnChangeOnly": "Emit KNX→IoT updates only when the value changes",
     "node-input-readOnDeploy": "Read KNX values on deploy",
     "node-input-acceptFlowInput": "Accept flow input (IoT → KNX)",
+    "node-input-nodeMode": "Mode",
+    "mode": {
+      "iot": "IoT bridge (MQTT/REST/Modbus messages)",
+      "homeassistant": "MQTT / Home Assistant (native)"
+    },
+    "ha": {
+      "intro": "Native MQTT bridge with Home Assistant discovery. Every group address imported in the KNX gateway (ETS list) is exposed automatically as a Home Assistant entity (switch, sensor, binary_sensor, number, text), plus the covers and thermostats you define below.",
+      "broker_url": "Broker URL",
+      "username": "Username",
+      "password": "Password",
+      "optional": "(optional)",
+      "base_topic": "Base topic",
+      "discovery": "Publish Home Assistant discovery",
+      "discovery_prefix": "Discovery prefix",
+      "hint": "Requires an MQTT broker reachable by both Node-RED and Home Assistant, with the MQTT integration enabled in HA. Entities appear under a device named after this node. KNX bus values are published to MQTT and writable datapoints accept commands from Home Assistant.",
+      "exposed_gas": "Group addresses to expose",
+      "exposed_gas_hint": "Tick the group addresses you want to publish to Home Assistant. By default every imported address is selected. Addresses used by a cover/thermostat below are handled there and don't need to be ticked here.",
+      "filter_placeholder": "Filter by address or name…",
+      "select_all": "Select all",
+      "select_none": "Select none",
+      "exposed_count": "selected",
+      "read_only": "Read only",
+      "read_only_bulk": "Read only for shown addresses:",
+      "read_only_all": "Set read only",
+      "read_only_none": "Clear read only",
+      "bus_mode": "KNX bus connection",
+      "bus_standalone": "Stand-alone (via the gateway)",
+      "bus_flow": "Flow messages (input/output pins)",
+      "bus_flow_hint": "Wire a KNXUltimate node in Universal mode to the input pin (KNX → MQTT) and another one to the output pin (MQTT → KNX).",
+      "no_gateway": "Select a KNX gateway first.",
+      "no_ga": "No group addresses found. Import the ETS list in the KNX gateway.",
+      "csv_error": "Unable to load the group address list from the gateway.",
+      "custom_entities": "Covers & Thermostats",
+      "custom_entities_hint": "Covers and thermostats group several group addresses into one Home Assistant entity, so they cannot be created automatically from the DPT. Add them here. Datapoint types come from the imported ETS list when available, otherwise from KNX defaults (1.008 up/down, 1.007 stop, 5.001 position, 9.001 temperature, 1.001 on/off). For reliable status, those GAs should be present in the ETS import.",
+      "ce_type_cover": "Cover",
+      "ce_type_climate": "Thermostat",
+      "ce_name": "Entity name",
+      "ce_gaUpDown": "Up/Down GA (1.008)",
+      "ce_gaStop": "Stop GA (1.007)",
+      "ce_gaPosSet": "Set position GA (5.001)",
+      "ce_gaPosState": "Position status GA (5.001)",
+      "ce_invertPosition": "Invert position (KNX 0% = open)",
+      "ce_gaCurrentTemp": "Current temp GA (9.001)",
+      "ce_gaSetpointSet": "Setpoint set GA (9.001)",
+      "ce_gaSetpointState": "Setpoint status GA (9.001)",
+      "ce_gaOnOff": "On/Off GA (1.001)",
+      "ce_minTemp": "Min temperature",
+      "ce_maxTemp": "Max temperature",
+      "ce_tempStep": "Temperature step"
+    },
     "section_mappings": "Bridge mappings",
     "mapping": {
       "enabled": "Enable",
@@ -71,7 +121,9 @@
     },
     "labels": {
       "outputKnxToIoT": "KNX → IoT stream",
-      "outputIoTToKnx": "IoT → KNX acknowledgements"
+      "outputIoTToKnx": "IoT → KNX acknowledgements",
+      "inputKnxBus": "KNX bus in (from a Universal node)",
+      "outputKnxWrite": "KNX write out (to a Universal node)"
     }
   }
 }

package/nodes/locales/es/knxUltimateIoTBridge.html

@@ -1,8 +1,32 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-# Puente KNX ↔ IoT
+# MQTT Home Assistant - IoT
 
 Crea puentes bidireccionales entre direcciones de grupo KNX y canales IoT (topics MQTT, endpoints REST, registros Modbus). Cada mapeo puede escalar valores, formatear payloads y exponer metadatos para los nodos posteriores.
 
+> **Dos modos.** Usa el selector **Modo** en la parte superior del nodo:
+> - **Bridge IoT** (predeterminado) — el comportamiento clásico descrito abajo (lista de mapeos, mensajes de salida MQTT/REST/Modbus).
+> - **MQTT / Home Assistant (nativo)** — el nodo se conecta directamente a un broker MQTT y hace de puente KNX ↔ MQTT en ambos sentidos, publicando el descubrimiento MQTT de Home Assistant para que las entidades aparezcan automáticamente.
+
+## Modo MQTT / Home Assistant
+
+Un puente MQTT nativo con descubrimiento de Home Assistant. Requiere un broker MQTT accesible tanto por Node-RED como por Home Assistant, con la integración MQTT activada en HA. Todas las entidades aparecen bajo un único dispositivo con el nombre de este nodo.
+
+- **Conexión al bus KNX** — cómo el nodo intercambia telegramas con KNX:
+    - *Autónomo* (predeterminado) — el nodo habla directamente con la pasarela KNX y no tiene pines de entrada/salida.
+    - *Mensajes de flujo* — el nodo muestra un pin de entrada y uno de salida. Conecta la salida de un nodo KNXUltimate en modo **Universal** al pin de entrada (bus KNX → MQTT) y el pin de salida a la entrada de otro nodo KNXUltimate en modo **Universal** (MQTT → bus KNX).
+- **URL del broker / Usuario / Contraseña** — conexión a tu broker MQTT.
+- **Topic base / Prefijo de descubrimiento** — topic raíz para los topics de estado/comando y el prefijo de descubrimiento de HA (predeterminado `homeassistant`).
+- **Direcciones de grupo a exponer** — cada dirección importada en la pasarela KNX (lista ETS) se muestra con una casilla. Las direcciones marcadas se publican como entidades de Home Assistant, tipadas automáticamente a partir del DPT (switch, sensor, binary_sensor, number, text). Usa el filtro y los botones *Seleccionar todo* / *Deseleccionar todo*. Por defecto están todas seleccionadas. Cada fila tiene además una opción **Solo lectura**: una dirección de solo lectura se sigue publicando en Home Assistant (su estado permanece visible) pero nunca acepta comandos de vuelta al bus KNX (los switch pasan a binary_sensor y los number a sensor). Los botones *Marcar solo lectura* / *Quitar solo lectura* la aplican a todas las direcciones mostradas actualmente.
+- **Persianas y termostatos** — agrupan varias direcciones en una sola entidad:
+    - *Persiana*: GA subir/bajar (1.008), GA stop opcional (1.007), GA posición comando/estado opcional (5.001). *Invertir posición* asigna la convención KNX (0% = abierto) a Home Assistant (100% = abierto).
+    - *Termostato*: GA temperatura actual (9.001), GA consigna comando/estado (9.001), GA on/off opcional (1.001 → off/heat), además de temperatura mín/máx y paso.
+
+Los valores del bus KNX se publican en MQTT y los datapoints escribibles aceptan comandos desde Home Assistant. Los tipos de datapoint provienen de la lista ETS importada cuando está disponible; en caso contrario, de los valores KNX por defecto (1.008 subir/bajar, 1.007 stop, 5.001 posición, 9.001 temperatura, 1.001 on/off); para un estado fiable, las direcciones usadas por persianas/termostatos deberían estar presentes en la importación ETS.
+
+---
+
+El resto de esta ayuda describe el modo clásico **Bridge IoT**.
+
 ## Entradas
 
 |Propiedad|Descripción|

package/nodes/locales/es/knxUltimateIoTBridge.json

@@ -1,13 +1,63 @@
 {
   "knxUltimateIoTBridge": {
-    "title": "KNX ↔ IoT Bridge",
-    "paletteLabel": "IoT Bridge",
+    "title": "MQTT Home Assistant - IoT",
+    "paletteLabel": "MQTT Home Assistant - IoT",
     "node-input-server": "Gateway KNX",
     "node-input-name": "Nombre",
     "node-input-outputtopic": "Tema predeterminado para salidas",
     "node-input-emitOnChangeOnly": "Emitir KNX→IoT solo cuando el valor cambie",
     "node-input-readOnDeploy": "Leer valores KNX al desplegar",
     "node-input-acceptFlowInput": "Aceptar entrada del flujo (IoT → KNX)",
+    "node-input-nodeMode": "Modo",
+    "mode": {
+      "iot": "Bridge IoT (mensajes MQTT/REST/Modbus)",
+      "homeassistant": "MQTT / Home Assistant (nativo)"
+    },
+    "ha": {
+      "intro": "Bridge MQTT nativo con descubrimiento de Home Assistant. Cada dirección de grupo importada en la pasarela KNX (lista ETS) se expone automáticamente como entidad de Home Assistant (switch, sensor, binary_sensor, number, text), además de las persianas y termostatos que definas a continuación.",
+      "broker_url": "URL del broker",
+      "username": "Usuario",
+      "password": "Contraseña",
+      "optional": "(opcional)",
+      "base_topic": "Topic base",
+      "discovery": "Publicar descubrimiento de Home Assistant",
+      "discovery_prefix": "Prefijo de descubrimiento",
+      "hint": "Requiere un broker MQTT accesible tanto por Node-RED como por Home Assistant, con la integración MQTT activada en HA. Las entidades aparecen bajo un dispositivo con el nombre de este nodo. Los valores del bus KNX se publican en MQTT y los datapoints escribibles aceptan comandos desde Home Assistant.",
+      "exposed_gas": "Direcciones de grupo a exponer",
+      "exposed_gas_hint": "Marca las direcciones de grupo que quieres publicar en Home Assistant. Por defecto están todas seleccionadas. Las direcciones usadas por una persiana/termostato (abajo) se gestionan allí y no necesitan marcarse aquí.",
+      "filter_placeholder": "Filtrar por dirección o nombre…",
+      "select_all": "Seleccionar todo",
+      "select_none": "Deseleccionar todo",
+      "exposed_count": "seleccionadas",
+      "read_only": "Solo lectura",
+      "read_only_bulk": "Solo lectura para las direcciones mostradas:",
+      "read_only_all": "Marcar solo lectura",
+      "read_only_none": "Quitar solo lectura",
+      "bus_mode": "Conexión al bus KNX",
+      "bus_standalone": "Autónomo (a través del gateway)",
+      "bus_flow": "Mensajes de flujo (pines entrada/salida)",
+      "bus_flow_hint": "Conecta un nodo KNXUltimate en modo Universal al pin de entrada (KNX → MQTT) y otro al pin de salida (MQTT → KNX).",
+      "no_gateway": "Selecciona primero una pasarela KNX.",
+      "no_ga": "No se encontraron direcciones de grupo. Importa la lista ETS en la pasarela KNX.",
+      "csv_error": "No se pudo cargar la lista de direcciones de grupo desde la pasarela.",
+      "custom_entities": "Persianas y termostatos",
+      "custom_entities_hint": "Las persianas y termostatos agrupan varias direcciones de grupo en una sola entidad de Home Assistant, por lo que no pueden crearse automáticamente a partir del DPT. Añádelos aquí. Los tipos de datapoint se toman de la lista ETS importada cuando está disponible; en caso contrario, de los valores KNX por defecto (1.008 subir/bajar, 1.007 stop, 5.001 posición, 9.001 temperatura, 1.001 on/off). Para un estado fiable, esas GA deberían estar presentes en la importación ETS.",
+      "ce_type_cover": "Persiana",
+      "ce_type_climate": "Termostato",
+      "ce_name": "Nombre de la entidad",
+      "ce_gaUpDown": "GA subir/bajar (1.008)",
+      "ce_gaStop": "GA stop (1.007)",
+      "ce_gaPosSet": "GA fijar posición (5.001)",
+      "ce_gaPosState": "GA estado posición (5.001)",
+      "ce_invertPosition": "Invertir posición (KNX 0% = abierto)",
+      "ce_gaCurrentTemp": "GA temperatura actual (9.001)",
+      "ce_gaSetpointSet": "GA fijar consigna (9.001)",
+      "ce_gaSetpointState": "GA estado consigna (9.001)",
+      "ce_gaOnOff": "GA on/off (1.001)",
+      "ce_minTemp": "Temperatura mín",
+      "ce_maxTemp": "Temperatura máx",
+      "ce_tempStep": "Paso de temperatura"
+    },
     "section_mappings": "Mapeos del bridge",
     "mapping": {
       "enabled": "Activar",
@@ -71,7 +121,9 @@
     },
     "labels": {
       "outputKnxToIoT": "Flujo KNX → IoT",
-      "outputIoTToKnx": "Confirmaciones IoT → KNX"
+      "outputIoTToKnx": "Confirmaciones IoT → KNX",
+      "inputKnxBus": "Entrada bus KNX (desde un nodo Universal)",
+      "outputKnxWrite": "Salida escritura KNX (hacia un nodo Universal)"
     }
   }
 }

package/nodes/locales/fr/knxUltimateIoTBridge.html

@@ -1,8 +1,32 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-# Passerelle KNX ↔ IoT
+# MQTT Home Assistant - IoT
 
 Créez des ponts bidirectionnels entre des adresses de groupe KNX et des canaux IoT (topics MQTT, points de terminaison REST, registres Modbus). Chaque correspondance peut mettre à l’échelle les valeurs, formater les charges utiles et exposer des métadonnées aux nœuds suivants.
 
+> **Deux modes.** Utilisez le sélecteur **Mode** en haut du nœud :
+> - **Passerelle IoT** (par défaut) — le comportement classique décrit ci-dessous (liste de correspondances, messages de sortie MQTT/REST/Modbus).
+> - **MQTT / Home Assistant (natif)** — le nœud se connecte directement à un broker MQTT et fait le pont KNX ↔ MQTT dans les deux sens, en publiant la découverte MQTT de Home Assistant pour que les entités apparaissent automatiquement.
+
+## Mode MQTT / Home Assistant
+
+Une passerelle MQTT native avec découverte Home Assistant. Nécessite un broker MQTT accessible à la fois par Node-RED et Home Assistant, avec l'intégration MQTT activée dans HA. Toutes les entités apparaissent sous un seul appareil portant le nom de ce nœud.
+
+- **Connexion au bus KNX** — comment le nœud échange les télégrammes avec KNX :
+    - *Autonome* (par défaut) — le nœud communique directement avec la passerelle KNX et n'a pas de broches d'entrée/sortie.
+    - *Messages de flux* — le nœud affiche une broche d'entrée et une de sortie. Reliez la sortie d'un nœud KNXUltimate en mode **Universel** à la broche d'entrée (bus KNX → MQTT) et la broche de sortie à l'entrée d'un autre nœud KNXUltimate en mode **Universel** (MQTT → bus KNX).
+- **URL du broker / Nom d'utilisateur / Mot de passe** — connexion à votre broker MQTT.
+- **Topic de base / Préfixe de découverte** — topic racine pour les topics d'état/commande et le préfixe de découverte HA (par défaut `homeassistant`).
+- **Adresses de groupe à exposer** — chaque adresse importée dans la passerelle KNX (liste ETS) est affichée avec une case à cocher. Les adresses cochées sont publiées comme entités Home Assistant, typées automatiquement d'après le DPT (switch, sensor, binary_sensor, number, text). Utilisez le champ de filtre et les boutons *Tout sélectionner* / *Tout désélectionner*. Par défaut, toutes les adresses sont sélectionnées. Chaque ligne dispose aussi d'une option **Lecture seule** : une adresse en lecture seule est toujours publiée vers Home Assistant (son état reste visible) mais n'accepte jamais de commandes vers le bus KNX (les switch deviennent des binary_sensor et les number des sensor). Les boutons *Activer lecture seule* / *Retirer lecture seule* l'appliquent à toutes les adresses actuellement affichées.
+- **Volets et thermostats** — regroupent plusieurs adresses en une seule entité :
+    - *Volet* : GA montée/descente (1.008), GA stop optionnelle (1.007), GA position commande/état optionnelle (5.001). *Inverser la position* fait correspondre la convention KNX (0% = ouvert) à Home Assistant (100% = ouvert).
+    - *Thermostat* : GA température actuelle (9.001), GA consigne commande/état (9.001), GA marche/arrêt optionnelle (1.001 → off/heat), plus températures min/max et pas.
+
+Les valeurs du bus KNX sont publiées sur MQTT et les points de données inscriptibles acceptent les commandes de Home Assistant. Les types de points de données proviennent de la liste ETS importée lorsqu'elle est disponible, sinon des valeurs KNX par défaut (1.008 montée/descente, 1.007 stop, 5.001 position, 9.001 température, 1.001 marche/arrêt) ; pour un retour d'état fiable, les adresses utilisées par les volets/thermostats doivent être présentes dans l'import ETS.
+
+---
+
+Le reste de cette aide décrit le mode classique **Passerelle IoT**.
+
 ## Entrées
 
 |Propriété|Description|

package/nodes/locales/fr/knxUltimateIoTBridge.json

@@ -1,13 +1,63 @@
 {
   "knxUltimateIoTBridge": {
-    "title": "Passerelle KNX ↔ IoT",
-    "paletteLabel": "Passerelle IoT",
+    "title": "MQTT Home Assistant - IoT",
+    "paletteLabel": "MQTT Home Assistant - IoT",
     "node-input-server": "Passerelle KNX",
     "node-input-name": "Nom",
     "node-input-outputtopic": "Topic par défaut pour les sorties",
     "node-input-emitOnChangeOnly": "Émettre KNX→IoT uniquement lorsque la valeur change",
     "node-input-readOnDeploy": "Lire les valeurs KNX au déploiement",
     "node-input-acceptFlowInput": "Accepter l'entrée du flow (IoT → KNX)",
+    "node-input-nodeMode": "Mode",
+    "mode": {
+      "iot": "Passerelle IoT (messages MQTT/REST/Modbus)",
+      "homeassistant": "MQTT / Home Assistant (natif)"
+    },
+    "ha": {
+      "intro": "Passerelle MQTT native avec découverte Home Assistant. Chaque adresse de groupe importée dans la passerelle KNX (liste ETS) est exposée automatiquement comme entité Home Assistant (switch, sensor, binary_sensor, number, text), en plus des volets et thermostats définis ci-dessous.",
+      "broker_url": "URL du broker",
+      "username": "Nom d'utilisateur",
+      "password": "Mot de passe",
+      "optional": "(facultatif)",
+      "base_topic": "Topic de base",
+      "discovery": "Publier la découverte Home Assistant",
+      "discovery_prefix": "Préfixe de découverte",
+      "hint": "Nécessite un broker MQTT accessible à la fois par Node-RED et Home Assistant, avec l'intégration MQTT activée dans HA. Les entités apparaissent sous un appareil portant le nom de ce nœud. Les valeurs du bus KNX sont publiées sur MQTT et les points de données inscriptibles acceptent les commandes de Home Assistant.",
+      "exposed_gas": "Adresses de groupe à exposer",
+      "exposed_gas_hint": "Cochez les adresses de groupe à publier vers Home Assistant. Par défaut, toutes les adresses importées sont sélectionnées. Les adresses utilisées par un volet/thermostat (ci-dessous) y sont gérées et n'ont pas besoin d'être cochées ici.",
+      "filter_placeholder": "Filtrer par adresse ou nom…",
+      "select_all": "Tout sélectionner",
+      "select_none": "Tout désélectionner",
+      "exposed_count": "sélectionnées",
+      "read_only": "Lecture seule",
+      "read_only_bulk": "Lecture seule pour les adresses affichées :",
+      "read_only_all": "Activer lecture seule",
+      "read_only_none": "Retirer lecture seule",
+      "bus_mode": "Connexion au bus KNX",
+      "bus_standalone": "Autonome (via la passerelle)",
+      "bus_flow": "Messages de flux (broches entrée/sortie)",
+      "bus_flow_hint": "Reliez un nœud KNXUltimate en mode Universel à la broche d'entrée (KNX → MQTT) et un autre à la broche de sortie (MQTT → KNX).",
+      "no_gateway": "Sélectionnez d'abord une passerelle KNX.",
+      "no_ga": "Aucune adresse de groupe trouvée. Importez la liste ETS dans la passerelle KNX.",
+      "csv_error": "Impossible de charger la liste des adresses de groupe depuis la passerelle.",
+      "custom_entities": "Volets et thermostats",
+      "custom_entities_hint": "Les volets et thermostats regroupent plusieurs adresses de groupe en une seule entité Home Assistant ; ils ne peuvent donc pas être créés automatiquement à partir du DPT. Ajoutez-les ici. Les types de points de données proviennent de la liste ETS importée lorsqu'elle est disponible, sinon des valeurs KNX par défaut (1.008 montée/descente, 1.007 stop, 5.001 position, 9.001 température, 1.001 marche/arrêt). Pour un retour d'état fiable, ces GA doivent être présentes dans l'import ETS.",
+      "ce_type_cover": "Volet",
+      "ce_type_climate": "Thermostat",
+      "ce_name": "Nom de l'entité",
+      "ce_gaUpDown": "GA montée/descente (1.008)",
+      "ce_gaStop": "GA stop (1.007)",
+      "ce_gaPosSet": "GA position (commande) (5.001)",
+      "ce_gaPosState": "GA état position (5.001)",
+      "ce_invertPosition": "Inverser la position (KNX 0% = ouvert)",
+      "ce_gaCurrentTemp": "GA température actuelle (9.001)",
+      "ce_gaSetpointSet": "GA consigne (commande) (9.001)",
+      "ce_gaSetpointState": "GA état consigne (9.001)",
+      "ce_gaOnOff": "GA marche/arrêt (1.001)",
+      "ce_minTemp": "Température min",
+      "ce_maxTemp": "Température max",
+      "ce_tempStep": "Pas de température"
+    },
     "section_mappings": "Correspondances de la passerelle",
     "mapping": {
       "enabled": "Activer",
@@ -71,7 +121,9 @@
     },
     "labels": {
       "outputKnxToIoT": "Flux KNX → IoT",
-      "outputIoTToKnx": "Accusés IoT → KNX"
+      "outputIoTToKnx": "Accusés IoT → KNX",
+      "inputKnxBus": "Entrée bus KNX (depuis un nœud Universel)",
+      "outputKnxWrite": "Sortie écriture KNX (vers un nœud Universel)"
     }
   }
 }

package/nodes/locales/it/knxUltimate-config.json

@@ -11,11 +11,11 @@
             "adv_options": "Opzioni avanzate",
             "ets_import": "Importa indirizzi di gruppo ETS",
             "node-config-input-name": "Nome",
-            "unsecureKNX" : "Connessione KNX semplice",
-            "secureKNX" : "Connessione KNX sicura",
-            "autoReconnect" : "Connetti al BUS KNX automaticamente all'avvio",
-            "autoReconnect_yes" : "Sì",
-            "autoReconnect_no" : "No (Per connetterti, invia msg.connectGateway = true ad un nodo Watchdog)",
+            "unsecureKNX": "Connessione KNX semplice",
+            "secureKNX": "Connessione KNX sicura",
+            "autoReconnect": "Connetti al BUS KNX automaticamente all'avvio",
+            "autoReconnect_yes": "Sì",
+            "autoReconnect_no": "No (Per connetterti, invia msg.connectGateway = true ad un nodo Watchdog)",
             "discovering": "Ricerca in corso...",
             "interfaces_found": "interfacce trovate.",
             "discovery_failed": "Ricerca fallita.",
@@ -103,11 +103,11 @@
             "select_error": "Error (Default)",
             "tiphost": "Scrivi EMULATE al posto dell'indirizzo IP, per simulare un gateway (il gateway non si connette al BUS KNX)",
             "delaybetweentelegrams": "Pausa tra l'invio di un telegramma ed un altro (in millisecondi)",
-            "delaybetweentelegramsfurtherdelayREAD" : "e moltiplica ritardo solo tra telegrammi -read- di",
-            "exposeAsVariable" : "Esponi come variabile globale",
-            "exposeAsVariableNO" : "No",
-            "exposeAsVariableREADONLY" : "Sola lettura",
-            "exposeAsVariableREADWRITE" : "Lettura/Scrittura"
+            "delaybetweentelegramsfurtherdelayREAD": "e moltiplica ritardo solo tra telegrammi -read- di",
+            "exposeAsVariable": "Esponi come variabile globale",
+            "exposeAsVariableNO": "No",
+            "exposeAsVariableREADONLY": "Sola lettura",
+            "exposeAsVariableREADWRITE": "Lettura/Scrittura"
         },
         "help": {
             "intro": "Configura la connessione al gateway KNX, l'import ETS e il comportamento avanzato dell'editor.",
@@ -119,15 +119,15 @@
         },
         "ets": {
             "description": "Puoi importare sia il file ETS in CSV, che ESF. Usa il CSV se possibile, perchè i datapoints sono più precisi.",
-            "youtube" : "&nbsp<i class=\"fa fa-youtube-play\"></i>&nbsp<a target=\"_blank\" href=\"https://youtu.be/egRbR_KwP9I\"><u>Guarda come si esporta un file CSV su YouTube.</u></a>",
+            "youtube": "&nbsp<i class=\"fa fa-youtube-play\"></i>&nbsp<a target=\"_blank\" href=\"https://youtu.be/egRbR_KwP9I\"><u>Guarda come si esporta un file CSV su YouTube.</u></a>",
             "help_ga": "Se l'indirizzo di gruppo non ha datapoint",
             "import_select_stop": "Blocca ed annulla l'importazione",
             "import_select_skip": "Salta l'importazione dell'indirizzo di gruppo",
             "import_select_fake": "Importa con un finto datapoint 1.001 (Non raccomandato)",
             "ga_list_title": "Incolla qui il contenuto del file esportato da ETS, oppure il percorso del file (es: /home/pi/mycsv.csv)",
             "ga_list_help": "Incolla qui il contenuto del file CSV o ESF esportato da ETS, oppure il percorso del file (es: /home/pi/mycsv.csv)",
-            "deploywithETS":"Verranno eseguite alcune operazioni di controllo. Eventuali problemi verranno segnalati nella finestra di debug a destra.",
-            "keyring":"Incolla qui il contenuto del file XML Keyring esportato da ETS",
+            "deploywithETS": "Verranno eseguite alcune operazioni di controllo. Eventuali problemi verranno segnalati nella finestra di debug a destra.",
+            "keyring": "Incolla qui il contenuto del file XML Keyring esportato da ETS",
             "youtubeKeyring": "Guarda come si esporta il Keyring XML su YouTube",
             "keyring_file": "File Keyring",
             "password": "Password",
@@ -159,4 +159,4 @@
             "reveal_keyring_fail": "Impossibile decodificare il keyring. Verifica il file keyring e la password generale."
         }
     }
-}
+}

package/nodes/locales/it/knxUltimateIoTBridge.html

@@ -1,8 +1,32 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-# KNX ↔ IoT Bridge
+# MQTT Home Assistant - IoT
 
 Crea collegamenti bidirezionali tra indirizzi di gruppo KNX e canali IoT (topic MQTT, endpoint REST, registri Modbus). Ogni mappatura può scalare i valori, formattare il payload ed esporre metadati per i nodi successivi.
 
+> **Due modalità.** Usa il selettore **Modalità** in cima al nodo:
+> - **Bridge IoT** (predefinito) — il comportamento classico descritto qui sotto (lista di mappature, messaggi di output MQTT/REST/Modbus).
+> - **MQTT / Home Assistant (nativo)** — il nodo si connette direttamente a un broker MQTT e fa da ponte KNX ↔ MQTT in entrambe le direzioni, pubblicando il discovery MQTT di Home Assistant così le entità compaiono automaticamente.
+
+## Modalità MQTT / Home Assistant
+
+Un bridge MQTT nativo con discovery di Home Assistant. Richiede un broker MQTT raggiungibile sia da Node-RED che da Home Assistant, con l'integrazione MQTT attiva in HA. Tutte le entità compaiono sotto un unico dispositivo con il nome di questo nodo.
+
+- **Connessione al bus KNX** — come il nodo scambia telegrammi con KNX:
+    - *Stand-alone* (predefinito) — il nodo parla direttamente col gateway KNX e non ha PIN di ingresso/uscita.
+    - *Messaggi di flow* — il nodo mostra un PIN di ingresso e uno di uscita. Collega l'uscita di un nodo KNXUltimate in modalità **Universale** al PIN di ingresso (bus KNX → MQTT) e il PIN di uscita all'ingresso di un altro nodo KNXUltimate in modalità **Universale** (MQTT → bus KNX).
+- **URL broker / Nome utente / Password** — connessione al tuo broker MQTT.
+- **Topic di base / Prefisso discovery** — topic radice per i topic di stato/comando e il prefisso discovery di HA (predefinito `homeassistant`).
+- **Indirizzi di gruppo da esporre** — ogni indirizzo importato nel gateway KNX (lista ETS) è elencato con una checkbox. Gli indirizzi spuntati vengono pubblicati come entità Home Assistant, tipizzate automaticamente dal DPT (switch, sensor, binary_sensor, number, text). Usa il filtro e i pulsanti *Seleziona tutti* / *Deseleziona tutti*. Per impostazione predefinita sono tutti selezionati. Ogni riga ha inoltre un'opzione **Sola lettura**: un indirizzo in sola lettura viene comunque pubblicato su Home Assistant (lo stato resta visibile) ma non accetta mai comandi verso il bus KNX (gli switch diventano binary_sensor, i number diventano sensor). I pulsanti *Imposta sola lettura* / *Togli sola lettura* la applicano a tutti gli indirizzi attualmente mostrati.
+- **Tapparelle e Termostati** — raggruppano più indirizzi in un'unica entità:
+    - *Tapparella*: GA su/giù (1.008), GA stop opzionale (1.007), GA posizione comando/stato opzionale (5.001). *Inverti posizione* mappa la convenzione KNX (0% = aperto) su Home Assistant (100% = aperto).
+    - *Termostato*: GA temperatura attuale (9.001), GA setpoint comando/stato (9.001), GA on/off opzionale (1.001 → off/heat), più temperatura min/max e step.
+
+I valori dal bus KNX vengono pubblicati su MQTT e i datapoint scrivibili accettano comandi da Home Assistant. I tipi di datapoint provengono dalla lista ETS importata se disponibili, altrimenti dai default KNX (1.008 su/giù, 1.007 stop, 5.001 posizione, 9.001 temperatura, 1.001 on/off); per uno stato affidabile, gli indirizzi usati da tapparelle/termostati dovrebbero essere presenti nell'import ETS.
+
+---
+
+Il resto di questo aiuto descrive la modalità classica **Bridge IoT**.
+
 ## Input
 
 |Proprietà|Descrizione|