node-red-contrib-knx-ultimate 4.3.24 → 5.0.1

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)",
@@ -148,7 +148,11 @@
             "clear_persist_ok": "Delete",
             "clear_persist_cancel": "Cancel",
             "clear_persist_done": "Persisted GA cache deleted.",
-            "clear_persist_fail": "Unable to delete persisted GA cache"
+            "clear_persist_fail": "Unable to delete persisted GA cache",
+            "reveal_keyring_label": "Reveal keyring passwords in clear text (KNX Secure)",
+            "reveal_keyring_button": "Reveal",
+            "reveal_keyring_loading": "Decoding keyring, please wait...",
+            "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,29 @@
 <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.
+
+- **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.
+- **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 +84,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,55 @@
 {
   "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",
+      "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",

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

@@ -148,7 +148,11 @@
       "clear_persist_ok": "Eliminar",
       "clear_persist_cancel": "Cancelar",
       "clear_persist_done": "Caché persistente de GA eliminada.",
-      "clear_persist_fail": "No se puede eliminar la caché persistente de GA"
+      "clear_persist_fail": "No se puede eliminar la caché persistente de GA",
+      "reveal_keyring_label": "Mostrar las contraseñas del keyring en texto claro (KNX Secure)",
+      "reveal_keyring_button": "Mostrar",
+      "reveal_keyring_loading": "Decodificando el keyring, espere...",
+      "reveal_keyring_fail": "No se puede decodificar el keyring. Comprueba el archivo keyring y la contraseña general."
     }
   }
 }

package/nodes/locales/es/knxUltimateIoTBridge.html

@@ -1,8 +1,29 @@
 <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.
+
+- **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.
+- **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,55 @@
 {
   "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",
+      "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",

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

@@ -148,7 +148,11 @@
       "clear_persist_ok": "Supprimer",
       "clear_persist_cancel": "Annuler",
       "clear_persist_done": "Cache GA persistant supprimé.",
-      "clear_persist_fail": "Impossible de supprimer le cache GA persistant"
+      "clear_persist_fail": "Impossible de supprimer le cache GA persistant",
+      "reveal_keyring_label": "Afficher les mots de passe du keyring en clair (KNX Secure)",
+      "reveal_keyring_button": "Afficher",
+      "reveal_keyring_loading": "Décodage du keyring en cours, veuillez patienter...",
+      "reveal_keyring_fail": "Impossible de décoder le keyring. Vérifiez le fichier keyring et le mot de passe général."
     }
   }
 }

package/nodes/locales/fr/knxUltimateIoTBridge.html

@@ -1,8 +1,29 @@
 <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.
+
+- **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.
+- **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,55 @@
 {
   "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",
+      "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",

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",
@@ -152,7 +152,11 @@
             "clear_persist_ok": "Elimina",
             "clear_persist_cancel": "Annulla",
             "clear_persist_done": "Cache persistente GA eliminata.",
-            "clear_persist_fail": "Impossibile eliminare la cache persistente GA"
+            "clear_persist_fail": "Impossibile eliminare la cache persistente GA",
+            "reveal_keyring_label": "Mostra le password del keyring in chiaro (KNX Secure)",
+            "reveal_keyring_button": "Mostra",
+            "reveal_keyring_loading": "Decodifica del keyring in corso, attendere...",
+            "reveal_keyring_fail": "Impossibile decodificare il keyring. Verifica il file keyring e la password generale."
         }
     }
-}
+}

package/nodes/locales/it/knxUltimateIoTBridge.html

@@ -1,8 +1,29 @@
 <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.
+
+- **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.
+- **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|

package/nodes/locales/it/knxUltimateIoTBridge.json

@@ -1,13 +1,55 @@
 {
   "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": "Nome",
     "node-input-outputtopic": "Topic predefinito per gli output",
     "node-input-emitOnChangeOnly": "Invia KNX→IoT solo quando il valore cambia",
     "node-input-readOnDeploy": "Esegui la lettura dei valori KNX al deploy",
     "node-input-acceptFlowInput": "Accetta input dal flow (IoT → KNX)",
+    "node-input-nodeMode": "Modalità",
+    "mode": {
+      "iot": "Bridge IoT (messaggi MQTT/REST/Modbus)",
+      "homeassistant": "MQTT / Home Assistant (nativo)"
+    },
+    "ha": {
+      "intro": "Bridge MQTT nativo con discovery di Home Assistant. Ogni indirizzo di gruppo importato nel gateway KNX (lista ETS) viene esposto automaticamente come entità Home Assistant (switch, sensor, binary_sensor, number, text), più le tapparelle e i termostati che definisci qui sotto.",
+      "broker_url": "URL del broker",
+      "username": "Nome utente",
+      "password": "Password",
+      "optional": "(facoltativo)",
+      "base_topic": "Topic di base",
+      "discovery": "Pubblica discovery Home Assistant",
+      "discovery_prefix": "Prefisso discovery",
+      "hint": "Richiede un broker MQTT raggiungibile sia da Node-RED che da Home Assistant, con l'integrazione MQTT attiva in HA. Le entità compaiono sotto un dispositivo con il nome di questo nodo. I valori dal bus KNX vengono pubblicati su MQTT e i datapoint scrivibili accettano comandi da Home Assistant.",
+      "exposed_gas": "Indirizzi di gruppo da esporre",
+      "exposed_gas_hint": "Spunta gli indirizzi di gruppo che vuoi pubblicare su Home Assistant. Per impostazione predefinita sono tutti selezionati. Gli indirizzi usati da una tapparella/termostato qui sotto vengono gestiti lì e non serve spuntarli qui.",
+      "filter_placeholder": "Filtra per indirizzo o nome…",
+      "select_all": "Seleziona tutti",
+      "select_none": "Deseleziona tutti",
+      "exposed_count": "selezionati",
+      "no_gateway": "Seleziona prima un gateway KNX.",
+      "no_ga": "Nessun indirizzo di gruppo trovato. Importa la lista ETS nel gateway KNX.",
+      "csv_error": "Impossibile caricare la lista degli indirizzi di gruppo dal gateway.",
+      "custom_entities": "Tapparelle e Termostati",
+      "custom_entities_hint": "Tapparelle e termostati raggruppano più indirizzi di gruppo in un'unica entità Home Assistant, quindi non possono essere creati automaticamente dal DPT. Aggiungili qui. I datapoint vengono presi 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, questi GA dovrebbero essere presenti nell'import ETS.",
+      "ce_type_cover": "Tapparella",
+      "ce_type_climate": "Termostato",
+      "ce_name": "Nome entità",
+      "ce_gaUpDown": "GA su/giù (1.008)",
+      "ce_gaStop": "GA stop (1.007)",
+      "ce_gaPosSet": "GA imposta posizione (5.001)",
+      "ce_gaPosState": "GA stato posizione (5.001)",
+      "ce_invertPosition": "Inverti posizione (KNX 0% = aperto)",
+      "ce_gaCurrentTemp": "GA temp attuale (9.001)",
+      "ce_gaSetpointSet": "GA imposta setpoint (9.001)",
+      "ce_gaSetpointState": "GA stato setpoint (9.001)",
+      "ce_gaOnOff": "GA On/Off (1.001)",
+      "ce_minTemp": "Temperatura min",
+      "ce_maxTemp": "Temperatura max",
+      "ce_tempStep": "Step temperatura"
+    },
     "section_mappings": "Mappature bridge",
     "mapping": {
       "enabled": "Abilita",

package/nodes/locales/zh-CN/knxUltimate-config.json

@@ -140,7 +140,11 @@
             "clear_persist_ok": "删除",
             "clear_persist_cancel": "取消",
             "clear_persist_done": "已删除持久化 GA 缓存。",
-            "clear_persist_fail": "无法删除持久化 GA 缓存"
+            "clear_persist_fail": "无法删除持久化 GA 缓存",
+            "reveal_keyring_label": "以明文显示密钥环密码 (KNX Secure)",
+            "reveal_keyring_button": "显示",
+            "reveal_keyring_loading": "正在解码密钥环，请稍候...",
+            "reveal_keyring_fail": "无法解码密钥环。请检查密钥环文件和通用密码。"
         }
     }
 }

package/nodes/locales/zh-CN/knxUltimateIoTBridge.html

@@ -1,8 +1,29 @@
 <script type="text/markdown" data-help-name="knxUltimateIoTBridge">
-# KNX ↔ IoT Bridge
+# MQTT Home Assistant - IoT
 
 在 KNX 组地址与 IoT 通道（MQTT 主题、REST 接口、Modbus 寄存器）之间创建双向桥接。每条映射都可以对数值进行缩放、格式化载荷，并向后续节点暴露元数据。
 
+> **两种模式。** 使用节点顶部的**模式**选择器：
+> - **IoT 桥接**（默认）— 下文描述的经典行为（映射列表，MQTT/REST/Modbus 输出消息）。
+> - **MQTT / Home Assistant（原生）** — 节点直接连接 MQTT broker，在 KNX ↔ MQTT 之间双向桥接，并发布 Home Assistant MQTT 自动发现，使实体自动出现。
+
+## MQTT / Home Assistant 模式
+
+带 Home Assistant 自动发现的原生 MQTT 桥接。需要一个 Node-RED 和 Home Assistant 都能访问的 MQTT broker，并在 HA 中启用 MQTT 集成。所有实体都出现在以该节点命名的同一个设备下。
+
+- **Broker URL / 用户名 / 密码** — 连接到你的 MQTT broker。
+- **基础主题 / 自动发现前缀** — 状态/命令主题的根主题以及 HA 自动发现前缀（默认 `homeassistant`）。
+- **要暴露的组地址** — KNX 网关中导入的每个地址（ETS 列表）都带有一个复选框。勾选的地址会作为 Home Assistant 实体发布，并根据 DPT 自动分类（switch、sensor、binary_sensor、number、text）。可使用筛选框和*全选* / *全不选*按钮。默认全部选中。
+- **卷帘与温控器** — 将多个地址组合成一个实体：
+    - *卷帘*：上/下 GA (1.008)、可选停止 GA (1.007)、可选位置 设置/状态 GA (5.001)。*反转位置* 将 KNX 约定（0% = 打开）映射到 Home Assistant（100% = 打开）。
+    - *温控器*：当前温度 GA (9.001)、设定值 设置/状态 GA (9.001)、可选开/关 GA (1.001 → off/heat)，以及最低/最高温度和步长。
+
+KNX 总线的值会发布到 MQTT，可写的数据点接受来自 Home Assistant 的命令。数据点类型在可用时取自导入的 ETS 列表，否则取自 KNX 默认值（1.008 上/下、1.007 停止、5.001 位置、9.001 温度、1.001 开/关）；为获得可靠的状态反馈，卷帘/温控器使用的地址应包含在 ETS 导入中。
+
+---
+
+本帮助的其余部分描述经典的 **IoT 桥接**模式。
+
 ## 输入
 
 |属性|说明|

package/nodes/locales/zh-CN/knxUltimateIoTBridge.json

@@ -1,13 +1,55 @@
 {
   "knxUltimateIoTBridge": {
-    "title": "KNX ↔ IoT Bridge",
-    "paletteLabel": "IoT Bridge",
+    "title": "MQTT Home Assistant - IoT",
+    "paletteLabel": "MQTT Home Assistant - IoT",
     "node-input-server": "KNX 网关",
     "node-input-name": "名称",
     "node-input-outputtopic": "输出的默认主题",
     "node-input-emitOnChangeOnly": "仅在值变化时发送 KNX→IoT 更新",
     "node-input-readOnDeploy": "部署时读取 KNX 数值",
     "node-input-acceptFlowInput": "允许流程输入 (IoT → KNX)",
+    "node-input-nodeMode": "模式",
+    "mode": {
+      "iot": "IoT 桥接（MQTT/REST/Modbus 消息）",
+      "homeassistant": "MQTT / Home Assistant（原生）"
+    },
+    "ha": {
+      "intro": "带 Home Assistant 自动发现的原生 MQTT 桥接。KNX 网关中导入的每个组地址（ETS 列表）都会自动作为 Home Assistant 实体（switch、sensor、binary_sensor、number、text）暴露，此外还有下方定义的卷帘和温控器。",
+      "broker_url": "Broker URL",
+      "username": "用户名",
+      "password": "密码",
+      "optional": "（可选）",
+      "base_topic": "基础主题",
+      "discovery": "发布 Home Assistant 自动发现",
+      "discovery_prefix": "自动发现前缀",
+      "hint": "需要一个 Node-RED 和 Home Assistant 都能访问的 MQTT broker，并在 HA 中启用 MQTT 集成。实体会出现在以该节点命名的设备下。KNX 总线的值会发布到 MQTT，可写的数据点接受来自 Home Assistant 的命令。",
+      "exposed_gas": "要暴露的组地址",
+      "exposed_gas_hint": "勾选要发布到 Home Assistant 的组地址。默认全部选中。被下方卷帘/温控器使用的地址会在那里处理，无需在此勾选。",
+      "filter_placeholder": "按地址或名称筛选…",
+      "select_all": "全选",
+      "select_none": "全不选",
+      "exposed_count": "已选择",
+      "no_gateway": "请先选择一个 KNX 网关。",
+      "no_ga": "未找到组地址。请在 KNX 网关中导入 ETS 列表。",
+      "csv_error": "无法从网关加载组地址列表。",
+      "custom_entities": "卷帘与温控器",
+      "custom_entities_hint": "卷帘和温控器将多个组地址组合成一个 Home Assistant 实体，因此无法根据 DPT 自动创建。请在此添加。数据点类型在可用时取自导入的 ETS 列表，否则取自 KNX 默认值（1.008 上/下、1.007 停止、5.001 位置、9.001 温度、1.001 开/关）。为获得可靠的状态反馈，这些组地址应包含在 ETS 导入中。",
+      "ce_type_cover": "卷帘",
+      "ce_type_climate": "温控器",
+      "ce_name": "实体名称",
+      "ce_gaUpDown": "上/下 GA (1.008)",
+      "ce_gaStop": "停止 GA (1.007)",
+      "ce_gaPosSet": "设置位置 GA (5.001)",
+      "ce_gaPosState": "位置状态 GA (5.001)",
+      "ce_invertPosition": "反转位置（KNX 0% = 打开）",
+      "ce_gaCurrentTemp": "当前温度 GA (9.001)",
+      "ce_gaSetpointSet": "设定值设置 GA (9.001)",
+      "ce_gaSetpointState": "设定值状态 GA (9.001)",
+      "ce_gaOnOff": "开/关 GA (1.001)",
+      "ce_minTemp": "最低温度",
+      "ce_maxTemp": "最高温度",
+      "ce_tempStep": "温度步长"
+    },
     "section_mappings": "桥接映射",
     "mapping": {
       "enabled": "启用",