node-red-contrib-knx-ultimate 4.3.1 → 4.3.3

package/nodes/knxUltimateLogger.js

@@ -1,7 +1,7 @@
 const fs = require('fs')
 
 module.exports = function (RED) {
-  function knxUltimateLogger(config) {
+  function knxUltimateLogger (config) {
     RED.nodes.createNode(this, config)
     const node = this
     node.serverKNX = RED.nodes.getNode(config.server) || undefined
@@ -66,7 +66,6 @@ module.exports = function (RED) {
 
     if (!node.serverKNX) return
 
-
     const buildXMLFromLines = (lines) => {
       const header = '<CommunicationLog xmlns="http://knx.org/xml/telegrams/01">\n'
       const stop = '<RecordStop Timestamp="' + new Date().toISOString() + '" />\n'
@@ -96,7 +95,7 @@ module.exports = function (RED) {
     }
 
     // 26/03/2020 Create and output the XML for ETS bus monitor
-    function createETSXML() {
+    function createETSXML () {
       let sFile = '<CommunicationLog xmlns="http://knx.org/xml/telegrams/01">\n'
       for (let index = 0; index < node.etsXMLRow.length; index++) {
         const element = node.etsXMLRow[index]
@@ -129,7 +128,7 @@ module.exports = function (RED) {
     };
 
     // 25/10/2021 Count Telegrams. Requested by RicharddeCrep https://github.com/Supergiovane/node-red-contrib-knx-ultimate/issues/149#issue-1034644956
-    function countTelegrams() {
+    function countTelegrams () {
       node.send([null, { topic: node.topic, payload: node.telegramCount, countIntervalInSeconds: node.intervalTelegramCount / 1000, currentTime: new Date().toLocaleString() }])
       node.setNodeStatus({ fill: 'green', shape: 'dot', text: 'Payload Telegram counter sent.', payload: node.telegramCount, GA: '', dpt: '', devicename: '' })
       node.telegramCount = 0

package/nodes/knxUltimateMultiRouting.js

@@ -326,7 +326,6 @@ module.exports = function (RED) {
       if (parsed.event === 'GroupValue_Read') {
         if (typeof client.read !== 'function') throw new Error('KNX client does not support read')
         client.read(ga)
-        return
       }
     }
 

package/nodes/locales/de/knxUltimateAI.html

@@ -46,6 +46,7 @@ Hier sind alle Felder aufgeführt, wie sie im KNX-AI-Editor sichtbar sind.
 - **Max changes per GA in window (0=off)**: Maximal erlaubte Änderungen im Fenster.
 
 ### LLM Assistant
+- Der Tab **LLM Assistant** steht im Editor jetzt an erster Stelle für eine schnellere Einrichtung.
 - **Enable LLM assistant**: Aktiviert Ask/Chat-Funktionen.
 - **Provider**: LLM-Backend (OpenAI-compatible oder Ollama).
 - **Endpoint URL**: URL des Chat/Completions-Endpunkts.
@@ -65,6 +66,16 @@ Hier sind alle Felder aufgeführt, wie sie im KNX-AI-Editor sichtbar sind.
 - **Max docs chars**: Max. Gesamtzeichen aus Doku.
 - Button **Refresh**: Provider abfragen und verfügbare Modelle laden.
 
+### Ollama Schnellstart (lokal)
+- **Provider = Ollama** auswählen.
+- Standard-Endpoint: `http://localhost:11434/api/chat`.
+- Wenn keine lokalen Modelle gefunden werden:
+  - **1) Download model**: öffnet die Seite **Model library**.
+  - **2) Install it**: lädt und installiert das Modell lokal (z. B. `llama3.1`).
+- Beim Refresh/Install versucht KNX AI zusätzlich, den Ollama-Server automatisch zu starten.
+- Bei Installationsfehlern mit Verbindungsproblem prüfen, ob Ollama läuft (Desktop-App oder `ollama serve`).
+- Wenn Node-RED in Docker läuft, im Endpoint `host.docker.internal` statt `localhost` verwenden.
+
 ## Sicherheitshinweis
 Bei aktiviertem LLM kann KNX-Traffic-Kontext an den konfigurierten Endpoint gesendet werden. Für striktes On-Premise lokale Provider verwenden.
 </script>

package/nodes/locales/de/knxUltimateAI.json

@@ -53,7 +53,7 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
-        "ollama": "Ollama (local) - not yet supported"
+        "ollama": "Ollama (local, beta)"
       }
     },
     "placeholder": {
@@ -63,7 +63,13 @@
       "llmSystemPrompt": "Optional. Leave empty for default."
     },
     "messages": {
-      "ollamaNotSupported": "Ollama integration is marked as not yet supported (testing in progress)."
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically."
     },
     "sidebar": {
       "ui": {
@@ -111,6 +117,11 @@
         "patternsTitle": "Muster (wiederkehrende Sequenzen):",
         "patternItem": "{{from}} → {{to}}  ({{count}} mal innerhalb von {{withinMs}}ms)"
       }
+    },
+    "buttons": {
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model"
     }
   }
 }

package/nodes/locales/en/knxUltimateAI.html

@@ -46,6 +46,7 @@ All fields exposed in the KNX AI editor are listed below.
 - **Max changes per GA in window (0=off)**: Max allowed changes in flap window.
 
 ### LLM Assistant
+- The **LLM Assistant** tab is shown first in the editor for faster setup.
 - **Enable LLM assistant**: Enable Ask/chat assistant features.
 - **Provider**: Select LLM backend (OpenAI-compatible or Ollama).
 - **Endpoint URL**: Chat/completions endpoint URL.
@@ -65,6 +66,16 @@ All fields exposed in the KNX AI editor are listed below.
 - **Max docs chars**: Max total docs characters.
 - **Refresh** button: Query provider and load available model IDs.
 
+### Ollama quick setup (local)
+- Choose **Provider = Ollama**.
+- Default endpoint: `http://localhost:11434/api/chat`.
+- If no local models are found, use:
+  - **1) Download model**: opens the **Model library** page.
+  - **2) Install it**: downloads and installs the model locally (for example `llama3.1`).
+- During model refresh/install, KNX AI also tries to auto-start the Ollama server when possible.
+- If install fails with connection errors, ensure Ollama is running (desktop app or `ollama serve`).
+- If Node-RED runs in Docker, use `host.docker.internal` instead of `localhost` in the endpoint URL.
+
 ## Security note
 If LLM is enabled, KNX traffic context can be sent to the configured endpoint. Use local providers if you need strict on-prem data handling.
 </script>

package/nodes/locales/en/knxUltimateAI.json

@@ -53,16 +53,25 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
-        "ollama": "Ollama (local) - not yet supported"
+        "ollama": "Ollama (local, beta)"
       }
     },
     "buttons": {
-      "refreshModels": "Refresh"
+      "refreshModels": "Refresh",
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model"
     },
     "messages": {
       "loadingModels": "Loading models…",
       "loadedModels": "Models loaded",
-      "ollamaNotSupported": "Ollama integration is marked as not yet supported (testing in progress)."
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",

package/nodes/locales/es/knxUltimateAI.html

@@ -46,6 +46,7 @@ Aquí tienes todos los campos tal como se muestran en el editor de KNX AI.
 - **Max changes per GA in window (0=off)**: cambios máximos permitidos en ventana.
 
 ### LLM Assistant
+- La pestaña **LLM Assistant** ahora aparece primero en el editor para facilitar la configuración.
 - **Enable LLM assistant**: habilita funciones Ask/chat.
 - **Provider**: backend LLM (OpenAI-compatible u Ollama).
 - **Endpoint URL**: URL endpoint chat/completions.
@@ -65,6 +66,16 @@ Aquí tienes todos los campos tal como se muestran en el editor de KNX AI.
 - **Max docs chars**: máximo total de caracteres de documentación.
 - Botón **Refresh**: consulta el provider y carga modelos disponibles.
 
+### Configuración rápida de Ollama (local)
+- Selecciona **Provider = Ollama**.
+- Endpoint por defecto: `http://localhost:11434/api/chat`.
+- Si no hay modelos locales:
+  - **1) Download model**: abre la página **Model library**.
+  - **2) Install it**: descarga e instala el modelo localmente (p. ej. `llama3.1`).
+- Durante refresh/instalación, KNX AI también intenta iniciar automáticamente el servidor Ollama.
+- Si la instalación falla con error de conexión, verifica que Ollama esté ejecutándose (app de escritorio o `ollama serve`).
+- Si Node-RED se ejecuta en Docker, usa `host.docker.internal` en lugar de `localhost` en el endpoint.
+
 ## Nota de seguridad
 Si el LLM está habilitado, el contexto de tráfico KNX puede enviarse al endpoint configurado. Para privacidad on-premise, usa proveedores locales.
 </script>

package/nodes/locales/es/knxUltimateAI.json

@@ -53,11 +53,17 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
-        "ollama": "Ollama (local) - not yet supported"
+        "ollama": "Ollama (local, beta)"
       }
     },
     "messages": {
-      "ollamaNotSupported": "Ollama integration is marked as not yet supported (testing in progress)."
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",
@@ -111,6 +117,11 @@
         "patternsTitle": "Patrones (secuencias recurrentes):",
         "patternItem": "{{from}} → {{to}}  ({{count}} veces en {{withinMs}}ms)"
       }
+    },
+    "buttons": {
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model"
     }
   }
 }

package/nodes/locales/fr/knxUltimateAI.html

@@ -46,6 +46,7 @@ Voici tous les champs tels qu'affichés dans l'éditeur KNX AI.
 - **Max changes per GA in window (0=off)** : nombre max de changements autorisés.
 
 ### LLM Assistant
+- L'onglet **LLM Assistant** est maintenant affiché en premier dans l'éditeur.
 - **Enable LLM assistant** : active les fonctions Ask/chat.
 - **Provider** : backend LLM (OpenAI-compatible ou Ollama).
 - **Endpoint URL** : URL endpoint chat/completions.
@@ -65,6 +66,16 @@ Voici tous les champs tels qu'affichés dans l'éditeur KNX AI.
 - **Max docs chars** : nombre total max de caractères documentation.
 - Bouton **Refresh** : interroge le provider et charge les modèles disponibles.
 
+### Démarrage rapide Ollama (local)
+- Choisir **Provider = Ollama**.
+- Endpoint par défaut : `http://localhost:11434/api/chat`.
+- Si aucun modèle local n'est trouvé :
+  - **1) Download model** : ouvre la page **Model library**.
+  - **2) Install it** : télécharge et installe le modèle localement (ex. `llama3.1`).
+- Pendant refresh/install, KNX AI tente aussi de démarrer automatiquement le serveur Ollama.
+- Si l'installation échoue avec une erreur de connexion, vérifier qu'Ollama est lancé (app desktop ou `ollama serve`).
+- Si Node-RED tourne dans Docker, utiliser `host.docker.internal` au lieu de `localhost` dans l'endpoint.
+
 ## Note sécurité
 Si le LLM est activé, le contexte trafic KNX peut être envoyé à l'endpoint configuré. Pour un usage strictement on-premise, utilisez un provider local.
 </script>

package/nodes/locales/fr/knxUltimateAI.json

@@ -53,11 +53,17 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
-        "ollama": "Ollama (local) - not yet supported"
+        "ollama": "Ollama (local, beta)"
       }
     },
     "messages": {
-      "ollamaNotSupported": "Ollama integration is marked as not yet supported (testing in progress)."
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",
@@ -111,6 +117,11 @@
         "patternsTitle": "Motifs (séquences récurrentes) :",
         "patternItem": "{{from}} → {{to}}  ({{count}} fois en {{withinMs}}ms)"
       }
+    },
+    "buttons": {
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model"
     }
   }
 }

package/nodes/locales/it/knxUltimateAI.html

@@ -46,6 +46,7 @@ Di seguito sono elencati tutti i campi presenti nell'editor del nodo KNX AI.
 - **Max cambi per GA nella finestra (0=off)**: massimo numero di cambi consentiti.
 
 ### Assistente LLM
+- Il tab **Assistente LLM** è mostrato per primo nell'editor, per semplificare la configurazione.
 - **Abilita assistente LLM**: abilita funzioni Ask/chat.
 - **Provider**: backend LLM (OpenAI-compatible o Ollama).
 - **URL endpoint**: URL endpoint chat/completions.
@@ -65,6 +66,16 @@ Di seguito sono elencati tutti i campi presenti nell'editor del nodo KNX AI.
 - **Max caratteri docs**: massimo totale caratteri docs.
 - Pulsante **Aggiorna**: interroga il provider e popola i modelli disponibili.
 
+### Setup rapido Ollama (locale)
+- Seleziona **Provider = Ollama**.
+- Endpoint predefinito: `http://localhost:11434/api/chat`.
+- Se non trovi modelli locali, usa:
+  - **1) Scarica il modello**: apre la pagina **Libreria modelli**.
+  - **2) Installalo**: scarica e installa localmente il modello (esempio `llama3.1`).
+- Durante refresh/installazione, KNX AI prova anche ad avviare automaticamente il server Ollama quando possibile.
+- Se l'installazione fallisce per errore di connessione, verifica che Ollama sia avviato (app desktop o `ollama serve`).
+- Se Node-RED gira in Docker, usa `host.docker.internal` al posto di `localhost` nell'endpoint.
+
 ## Nota sicurezza
 Se l'LLM è abilitato, il contesto traffico KNX può essere inviato all'endpoint configurato. Per privacy on-prem, usa provider locali.
 </script>

package/nodes/locales/it/knxUltimateAI.json

@@ -53,16 +53,25 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "Compatibile OpenAI (chat/completions)",
-        "ollama": "Ollama (locale) - non ancora supportato"
+        "ollama": "Ollama (locale, beta)"
       }
     },
     "buttons": {
-      "refreshModels": "Aggiorna"
+      "refreshModels": "Aggiorna",
+      "installOllamaModel": "2) Installalo",
+      "ollamaLibrary": "Libreria modelli",
+      "downloadOllamaModel": "1) Scarica il modello"
     },
     "messages": {
       "loadingModels": "Carico i modelli…",
       "loadedModels": "Modelli caricati",
-      "ollamaNotSupported": "Integrazione Ollama marcata come non ancora supportata (test in corso)."
+      "ollamaNotSupported": "Modalita locale Ollama: API key non richiesta. Endpoint predefinito: http://localhost:11434/api/chat.",
+      "ollamaNoModels": "Nessun modello Ollama locale trovato. Installa un modello o scegli dalla libreria.",
+      "installingOllamaModel": "Avvio Ollama e installo il modello…",
+      "installedOllamaModel": "Modello Ollama installato",
+      "installOllamaModelFailed": "Installazione modello Ollama non riuscita",
+      "ollamaInstallSteps": "1) Apri la libreria, scegli un modello e copiane il nome (es. llama3.1). 2) Inserisci il nome nel campo Modello e clicca Installalo.",
+      "ollamaStartedAuto": "Server Ollama avviato automaticamente."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (o endpoint compatibile)",

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

@@ -46,6 +46,7 @@
 - **Max changes per GA in window (0=off)**：窗口内允许的最大变化次数。
 
 ### LLM Assistant
+- **LLM Assistant** 标签页现在固定在编辑器最前面，便于快速配置。
 - **Enable LLM assistant**：启用 Ask/chat 功能。
 - **Provider**：LLM 后端（OpenAI-compatible 或 Ollama）。
 - **Endpoint URL**：chat/completions 接口 URL。
@@ -65,6 +66,16 @@
 - **Max docs chars**：文档片段最大总字符数。
 - **Refresh** 按钮：请求 provider 并加载可用模型 ID。
 
+### Ollama 快速配置（本地）
+- 选择 **Provider = Ollama**。
+- 默认 endpoint：`http://localhost:11434/api/chat`。
+- 若未发现本地模型：
+  - **1) Download model**：打开 **Model library** 页面。
+  - **2) Install it**：在本机下载并安装模型（例如 `llama3.1`）。
+- 在刷新/安装模型时，KNX AI 也会在可能情况下尝试自动启动 Ollama 服务。
+- 若安装因连接错误失败，请确认 Ollama 已运行（桌面应用或 `ollama serve`）。
+- 若 Node-RED 运行在 Docker 中，endpoint 请使用 `host.docker.internal` 替代 `localhost`。
+
 ## 安全说明
 启用 LLM 后，KNX 流量上下文可能发送到所配置的 endpoint。若需严格本地化，请使用本地 provider。
 </script>

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

@@ -53,11 +53,17 @@
     "selectlists": {
       "llmProvider": {
         "openai_compat": "OpenAI-compatible (chat/completions)",
-        "ollama": "Ollama (local) - not yet supported"
+        "ollama": "Ollama (local, beta)"
       }
     },
     "messages": {
-      "ollamaNotSupported": "Ollama integration is marked as not yet supported (testing in progress)."
+      "ollamaNotSupported": "Ollama local mode: API key not required. Default endpoint is http://localhost:11434/api/chat.",
+      "ollamaNoModels": "No local Ollama model found. Install one or pick one from the library.",
+      "installingOllamaModel": "Starting Ollama and installing model…",
+      "installedOllamaModel": "Ollama model installed",
+      "installOllamaModelFailed": "Failed to install Ollama model",
+      "ollamaInstallSteps": "1) Open the model library and copy the model name (for example llama3.1). 2) Put the name in the Model field and click Install it.",
+      "ollamaStartedAuto": "Ollama server started automatically."
     },
     "placeholder": {
       "llmBaseUrl": "https://api.openai.com/v1/chat/completions (or your compatible endpoint)",
@@ -111,6 +117,11 @@
         "patternsTitle": "模式（重复序列）：",
         "patternItem": "{{from}} → {{to}}（{{count}} 次，{{withinMs}}ms 内）"
       }
+    },
+    "buttons": {
+      "installOllamaModel": "2) Install it",
+      "ollamaLibrary": "Model library",
+      "downloadOllamaModel": "1) Download model"
     }
   }
 }