node-red-contrib-knx-ultimate 4.1.18 → 4.1.21

package/nodes/locales/fr/knxUltimateMultiRouting.json

@@ -2,10 +2,24 @@
   "knxUltimateMultiRouting": {
     "title": "KNX Multi Routing",
     "properties": {
+      "mode": "Mode",
+      "modeGateway": "Gateway / Routing",
+      "modeServer": "Server KNX/IP",
       "server": "Gateway",
       "name": "Name",
       "outputtopic": "Output topic",
-      "dropIfSameGateway": "Drop messages already tagged for this gateway"
+      "dropIfSameGateway": "Drop messages already tagged for this gateway",
+      "respectRoutingCounter": "Respect routing counter (drop if 0)",
+      "decrementRoutingCounter": "Decrement routing counter when routing",
+      "tunnelTitle": "KNX/IP Server",
+      "tunnelListenHost": "Listen host",
+      "tunnelListenPort": "Listen port",
+      "tunnelAdvertiseHost": "Advertise host",
+      "tunnelAdvertiseHostPlaceholder": "(optional) Host/IP to advertise to clients",
+      "tunnelAssignedIndividualAddress": "Assigned individual address",
+      "tunnelGatewayId": "Gateway id (tag)",
+      "tunnelGatewayIdPlaceholder": "(auto) Used as knxMultiRouting.gateway.id",
+      "tunnelMaxSessions": "Max sessions"
     },
     "outputs": {
       "raw": "RAW telegrams"

package/nodes/locales/fr/knxUltimateRouterFilter.html

@@ -24,6 +24,8 @@ Vous pouvez réécrire (optionnellement) :
 - destination (adresse de groupe) `knx.destination`
 - source (adresse physique) `knx.source`
 
+Lors d’une réécriture, le nœud met aussi à jour `knx.cemi.hex` pour refléter les valeurs réécrites de `knx.source`/`knx.destination` (lorsque `knx.cemi.hex` est présent).
+
 Les règles sont évaluées de haut en bas (première correspondance gagnante).
 
 Exemples :
@@ -33,5 +35,41 @@ Exemples :
 ## Métadonnées
 Le nœud ajoute `msg.payload.knxRouterFilter` :
 - rejetés : `{ dropped: true, reason: 'event'|'ga'|'source', ... }`
-- passés : `{ dropped: false, rewritten: <bool>, rewrite: { ... }, original: { ... } }`
+- passés : `{ dropped: false, rewritten: <bool>, cemiSynced: <bool>, rewrite: { ... }, original: { ... } }`
+
+## msg.setConfig
+Vous pouvez modifier la configuration du nœud à l’exécution en envoyant un objet `msg.setConfig` à l’entrée.
+Clés prises en charge : `allowWrite`, `allowResponse`, `allowRead`, `gaMode`, `gaPatterns`, `srcMode`, `srcPatterns`, `rewriteGA`, `gaRewriteRules`, `rewriteSource`, `srcRewriteRules`.
+La configuration est conservée jusqu’au prochain `msg.setConfig` ou jusqu’à un redeploy/redémarrage. Les messages de configuration ne sont pas transmis.
+
+Signification des propriétés :
+- `allowWrite` : autorise les télégrammes `GroupValue_Write`.
+- `allowResponse` : autorise les télégrammes `GroupValue_Response`.
+- `allowRead` : autorise les télégrammes `GroupValue_Read`.
+- `gaMode` : mode de filtre GA de destination (`off` = pas de filtre, `allow` = autoriser uniquement les correspondances, `block` = bloquer les correspondances).
+- `gaPatterns` : motifs GA de destination utilisés par `gaMode` (un par ligne, supporte `*` et `re:<regex>`).
+- `srcMode` : mode de filtre Source (adresse physique) (`off`/`allow`/`block`).
+- `srcPatterns` : motifs Source utilisés par `srcMode` (un par ligne, supporte `*` et `re:<regex>`).
+- `rewriteGA` : active la réécriture de `knx.destination` sur les télégrammes passés.
+- `gaRewriteRules` : règles de réécriture GA (`de => vers`, première correspondance gagnante ; supporte `*` et `re:<regex>`).
+- `rewriteSource` : active la réécriture de `knx.source` sur les télégrammes passés.
+- `srcRewriteRules` : règles de réécriture Source (`de => vers`, première correspondance gagnante ; supporte `*` et `re:<regex>`).
+
+Exemple :
+```js
+msg.setConfig = {
+  allowWrite: true,
+  allowResponse: true,
+  allowRead: true,
+  gaMode: "allow",
+  gaPatterns: "1/1/*\n1/2/3",
+  srcMode: "off",
+  srcPatterns: "",
+  rewriteGA: true,
+  gaRewriteRules: "5/5/1 => 1/1/1",
+  rewriteSource: true,
+  srcRewriteRules: "15.*.* => 1.1.254"
+};
+return msg;
+```
 </script>

package/nodes/locales/it/knxUltimateMultiRouting.html

@@ -4,6 +4,12 @@ Questo nodo serve per **collegare tra loro più gateway KNX Ultimate** (più `kn
 In output emette un oggetto con le informazioni **RAW** del telegramma (APDU + cEMI hex + indirizzi) per ogni telegramma ricevuto dal BUS KNX del gateway selezionato.
 In input può ricevere gli stessi oggetti RAW e inoltrarli sul BUS KNX del gateway selezionato.
 
+## Modalità Server KNX/IP
+Imposta **Modalità** su **Server KNX/IP** per avviare un server KNXnet/IP tunneling (UDP). I telegrammi ricevuti dai client vengono emessi nello stesso formato RAW usato dal MultiRouting.
+Il nodo accetta anche in input gli oggetti RAW e li inietta verso i client tunneling connessi.
+
+**Importante (Host annunciato):** i client KNXnet/IP inviano i dati all’IP annunciato dal server nella CONNECT_RESPONSE. Se il client risulta *connesso* ma il server non riceve telegrammi, imposta **Host annunciato** con l’IP LAN del server raggiungibile dal client (soprattutto se Node-RED gira in Docker/VM o se il PC ha più schede di rete).
+
 ## Formato messaggio in output
 `msg.payload` contiene:
 - `knx.event`: `GroupValue_Write` / `GroupValue_Response` / `GroupValue_Read`
@@ -15,6 +21,16 @@ In input può ricevere gli stessi oggetti RAW e inoltrarli sul BUS KNX del gatew
 - `knx.echoed`: `true` se telegramma echoed dal gateway
 - `knxMultiRouting.gateway`: info gateway (`id`, `name`, `physAddr`)
 
+## Routing counter (hop count)
+MultiRouting può usare il routing counter (hop count) presente in `knx.cemi.hex` per prevenire loop di telegrammi.
+- **Rispetta routing counter (scarta se 0)**: i telegrammi con routing counter `0` non vengono inoltrati.
+- **Decrementa routing counter durante l'inoltro**: il nodo decrementa il routing counter durante l'inoltro. Quando arriva a `0`, il telegramma viene scartato.
+
+Il valore corrente è disponibile come `knx.routingCounter` (e come `knx.cemi.hopCount` quando `knx.cemi` è un oggetto).
+
+## Riscrittura telegrammi
+Se nel flow riscrivi `knx.source` / `knx.destination`, devi mantenere coerente anche `knx.cemi.hex`. Consigliato: inserisci **KNX Router Filter** tra i nodi MultiRouting: manterrà automaticamente coerente `knx.cemi.hex` durante il rewrite.
+
 ## Nota
 Quando inoltri su un altro gateway, l’**indirizzo fisico sorgente cambia** (diventa l’indirizzo fisico del gateway che invia). Usa `knx.source` e/o `knxMultiRouting.gateway` per filtrare i loop.
 L’opzione **Scarta messaggi già marcati per questo gateway** aiuta a prevenire loop semplici quando colleghi più router tra loro.

package/nodes/locales/it/knxUltimateMultiRouting.json

@@ -2,10 +2,24 @@
   "knxUltimateMultiRouting": {
     "title": "KNX Multi Routing",
     "properties": {
+      "mode": "Modalità",
+      "modeGateway": "Gateway / Routing",
+      "modeServer": "Server KNX/IP",
       "server": "Gateway",
       "name": "Nome",
       "outputtopic": "Topic output",
-      "dropIfSameGateway": "Scarta messaggi già marcati per questo gateway"
+      "dropIfSameGateway": "Scarta messaggi già marcati per questo gateway",
+      "respectRoutingCounter": "Rispetta routing counter (scarta se 0)",
+      "decrementRoutingCounter": "Decrementa routing counter durante l'inoltro",
+      "tunnelTitle": "Server KNX/IP",
+      "tunnelListenHost": "Host in ascolto",
+      "tunnelListenPort": "Porta in ascolto",
+      "tunnelAdvertiseHost": "Host annunciato",
+      "tunnelAdvertiseHostPlaceholder": "(opzionale) Host/IP da annunciare ai client",
+      "tunnelAssignedIndividualAddress": "Indirizzo individuale assegnato",
+      "tunnelGatewayId": "Gateway id (tag)",
+      "tunnelGatewayIdPlaceholder": "(auto) Usato come knxMultiRouting.gateway.id",
+      "tunnelMaxSessions": "Sessioni max"
     },
     "outputs": {
       "raw": "Telegrammi RAW"

package/nodes/locales/it/knxUltimateRouterFilter.html

@@ -24,6 +24,8 @@ Puoi (opzionalmente) riscrivere:
 - destination Group Address (`knx.destination`)
 - source indirizzo fisico (`knx.source`)
 
+Durante il rewrite, il nodo aggiorna anche `knx.cemi.hex` per riflettere i valori riscritti di `knx.source`/`knx.destination` (quando `knx.cemi.hex` è presente).
+
 Le regole sono valutate dall’alto verso il basso: la prima che matcha vince.
 
 Esempi sintassi:
@@ -33,5 +35,41 @@ Esempi sintassi:
 ## Metadati
 Il nodo aggiunge `msg.payload.knxRouterFilter`:
 - messaggi scartati: `{ dropped: true, reason: 'event'|'ga'|'source', ... }`
-- messaggi passati: `{ dropped: false, rewritten: <bool>, rewrite: { ... }, original: { ... } }`
+- messaggi passati: `{ dropped: false, rewritten: <bool>, cemiSynced: <bool>, rewrite: { ... }, original: { ... } }`
+
+## msg.setConfig
+Puoi cambiare la configurazione del nodo a runtime inviando un oggetto `msg.setConfig` all’ingresso.
+Chiavi supportate: `allowWrite`, `allowResponse`, `allowRead`, `gaMode`, `gaPatterns`, `srcMode`, `srcPatterns`, `rewriteGA`, `gaRewriteRules`, `rewriteSource`, `srcRewriteRules`.
+La nuova configurazione viene mantenuta fino al prossimo `msg.setConfig` o fino a redeploy/riavvio. I messaggi di configurazione non vengono inoltrati.
+
+Significato delle proprietà:
+- `allowWrite`: consente i telegrammi `GroupValue_Write`.
+- `allowResponse`: consente i telegrammi `GroupValue_Response`.
+- `allowRead`: consente i telegrammi `GroupValue_Read`.
+- `gaMode`: modalità filtro per la GA di destinazione (`off` = nessun filtro, `allow` = consenti solo i match, `block` = scarta i match).
+- `gaPatterns`: pattern GA di destinazione usati da `gaMode` (uno per riga, supporta `*` e `re:<regex>`).
+- `srcMode`: modalità filtro per la source (indirizzo fisico) (`off`/`allow`/`block`).
+- `srcPatterns`: pattern source usati da `srcMode` (uno per riga, supporta `*` e `re:<regex>`).
+- `rewriteGA`: abilita la riscrittura di `knx.destination` sui telegrammi passati.
+- `gaRewriteRules`: regole di riscrittura GA (`da => a`, prima regola che matcha vince; supporta `*` e `re:<regex>`).
+- `rewriteSource`: abilita la riscrittura di `knx.source` sui telegrammi passati.
+- `srcRewriteRules`: regole di riscrittura source (`da => a`, prima regola che matcha vince; supporta `*` e `re:<regex>`).
+
+Esempio:
+```js
+msg.setConfig = {
+  allowWrite: true,
+  allowResponse: true,
+  allowRead: true,
+  gaMode: "allow",
+  gaPatterns: "1/1/*\n1/2/3",
+  srcMode: "off",
+  srcPatterns: "",
+  rewriteGA: true,
+  gaRewriteRules: "5/5/1 => 1/1/1",
+  rewriteSource: true,
+  srcRewriteRules: "15.*.* => 1.1.254"
+};
+return msg;
+```
 </script>

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

@@ -4,6 +4,12 @@
 它会为所选网关的 KNX 总线上收到的每个电报输出一条包含**RAW 电报信息**（APDU + cEMI 十六进制 + 地址）的消息。
 同时它也可以在输入端接收相同格式的 RAW 对象，并将其转发到所选网关的 KNX 总线。
 
+## KNX/IP 服务器模式
+将 **Mode** 设置为 **Server KNX/IP** 可启动一个内置的 KNXnet/IP tunneling（UDP）服务器。来自 tunneling 客户端的电报会以相同的 RAW 格式输出。
+该节点也会在输入端接收 RAW 对象，并将其注入到已连接的 tunneling 客户端。
+
+**重要（Advertise host）：** KNXnet/IP 客户端会把数据发送到服务器在 CONNECT_RESPONSE 中通告的 IP。如果客户端显示 *已连接* 但服务器收不到电报，请将 **Advertise host** 设为客户端可达的服务器 LAN IP（尤其是在 Docker/VM 中运行 Node-RED 或主机有多网卡时）。
+
 ## 输出消息格式
 `msg.payload` 包含：
 - `knx.event`：`GroupValue_Write` / `GroupValue_Response` / `GroupValue_Read`
@@ -15,6 +21,16 @@
 - `knx.echoed`：若被网关回显则为 `true`
 - `knxMultiRouting.gateway`：网关元信息（`id`, `name`, `physAddr`）
 
+## Routing counter (hop count)
+MultiRouting 可使用 `knx.cemi.hex` 中的 KNX routing counter（hop count）来避免电报环路。
+- **Respect routing counter (drop if 0)**：routing counter 为 `0` 的电报不会被转发。
+- **Decrement routing counter when routing**：转发时递减 routing counter；若递减后到达 `0`，电报将被丢弃。
+
+当前值会暴露为 `knx.routingCounter`（当 `knx.cemi` 为对象时，也会作为 `knx.cemi.hopCount` 提供）。
+
+## 重写电报
+如果你在 flow 中重写 `knx.source` / `knx.destination`，也必须保持 `knx.cemi.hex` 的一致性。建议：在 MultiRouting 节点之间放置 **KNX Router Filter**；它会在重写时自动同步 `knx.cemi.hex`。
+
 ## 注意
 - 转发到其它网关时，**源物理地址会改变**（变为发送网关的物理地址）。可使用 `knx.source` 和/或 `knxMultiRouting.gateway` 来过滤环路。
 - 选项 **“Drop messages already tagged for this gateway”** 可帮助在互联多个路由节点时避免简单环路。

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

@@ -2,10 +2,24 @@
   "knxUltimateMultiRouting": {
     "title": "KNX Multi Routing",
     "properties": {
+      "mode": "Mode",
+      "modeGateway": "Gateway / Routing",
+      "modeServer": "Server KNX/IP",
       "server": "Gateway",
       "name": "Name",
       "outputtopic": "Output topic",
-      "dropIfSameGateway": "Drop messages already tagged for this gateway"
+      "dropIfSameGateway": "Drop messages already tagged for this gateway",
+      "respectRoutingCounter": "Respect routing counter (drop if 0)",
+      "decrementRoutingCounter": "Decrement routing counter when routing",
+      "tunnelTitle": "KNX/IP Server",
+      "tunnelListenHost": "Listen host",
+      "tunnelListenPort": "Listen port",
+      "tunnelAdvertiseHost": "Advertise host",
+      "tunnelAdvertiseHostPlaceholder": "(optional) Host/IP to advertise to clients",
+      "tunnelAssignedIndividualAddress": "Assigned individual address",
+      "tunnelGatewayId": "Gateway id (tag)",
+      "tunnelGatewayIdPlaceholder": "(auto) Used as knxMultiRouting.gateway.id",
+      "tunnelMaxSessions": "Max sessions"
     },
     "outputs": {
       "raw": "RAW telegrams"

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

@@ -24,6 +24,8 @@
 - 目的组地址 `knx.destination`
 - 源物理地址 `knx.source`
 
+在重写时，节点也会更新 `knx.cemi.hex` 以匹配重写后的 `knx.source`/`knx.destination`（当 `knx.cemi.hex` 存在时）。
+
 规则自上而下匹配（先匹配先执行）。
 
 示例：
@@ -33,5 +35,41 @@
 ## 元数据
 节点会在输出中添加 `msg.payload.knxRouterFilter`：
 - 丢弃：`{ dropped: true, reason: 'event'|'ga'|'source', ... }`
-- 通过：`{ dropped: false, rewritten: <bool>, rewrite: { ... }, original: { ... } }`
+- 通过：`{ dropped: false, rewritten: <bool>, cemiSynced: <bool>, rewrite: { ... }, original: { ... } }`
+
+## msg.setConfig
+你可以通过向输入端发送 `msg.setConfig` 对象来在运行时修改节点配置。
+支持的键：`allowWrite`, `allowResponse`, `allowRead`, `gaMode`, `gaPatterns`, `srcMode`, `srcPatterns`, `rewriteGA`, `gaRewriteRules`, `rewriteSource`, `srcRewriteRules`。
+新配置会保持到下一次 `msg.setConfig` 或 redeploy/重启。配置消息不会被转发。
+
+各属性含义：
+- `allowWrite`：允许 `GroupValue_Write` 电报。
+- `allowResponse`：允许 `GroupValue_Response` 电报。
+- `allowRead`：允许 `GroupValue_Read` 电报。
+- `gaMode`：目的组地址过滤模式（`off`=不启用过滤，`allow`=仅放行匹配项，`block`=丢弃匹配项）。
+- `gaPatterns`：`gaMode` 使用的目的 GA pattern（每行一个，支持 `*` 和 `re:<regex>`）。
+- `srcMode`：源物理地址过滤模式（`off`/`allow`/`block`）。
+- `srcPatterns`：`srcMode` 使用的 source pattern（每行一个，支持 `*` 和 `re:<regex>`）。
+- `rewriteGA`：对通过的电报启用 `knx.destination` 重写。
+- `gaRewriteRules`：目的 GA 重写规则（`from => to`，先匹配先执行；支持 `*` 和 `re:<regex>`）。
+- `rewriteSource`：对通过的电报启用 `knx.source` 重写。
+- `srcRewriteRules`：源 PA 重写规则（`from => to`，先匹配先执行；支持 `*` 和 `re:<regex>`）。
+
+示例：
+```js
+msg.setConfig = {
+  allowWrite: true,
+  allowResponse: true,
+  allowRead: true,
+  gaMode: "allow",
+  gaPatterns: "1/1/*\n1/2/3",
+  srcMode: "off",
+  srcPatterns: "",
+  rewriteGA: true,
+  gaRewriteRules: "5/5/1 => 1/1/1",
+  rewriteSource: true,
+  srcRewriteRules: "15.*.* => 1.1.254"
+};
+return msg;
+```
 </script>

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.1.18",
+  "version": "4.1.21",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, and KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",
@@ -20,7 +20,7 @@
     "crypto-js": "4.2.0",
     "dns-sync": "0.2.1",
     "js-yaml": "4.1.1",
-    "knxultimate": "5.2.6",
+    "knxultimate": "5.2.7",
     "lodash": "4.17.21",
     "mkdirp": "3.0.1",
     "node-color-log": "12.0.1",