node-red-contrib-knx-ultimate 8.0.6 → 8.1.1

package/CHANGELOG.md

@@ -6,9 +6,17 @@
 
 # CHANGELOG
 
+**Version 8.1.1** - October 2026
+
+- Updated the KNX engine to `knxultimate` 6.2.1.
+
+**Version 8.1.0** - October 2026
+
+- Updated the KNX engine to `knxultimate` 6.2.0.
+
 **Version 8.0.6** - September 2026
 
-- Updated the KNX engine to `knxultimate` 6.0.8 to restore reception of authenticated Data Secure status telegrams from gateways such as Apricum that omit the outer KNX/IP wrapper.
+- Updated the KNX engine to `knxultimate` 6.0.8 to restore reception of authenticated Data Secure status telegrams from gateways such as Apricum/MDT that omit the outer KNX/IP wrapper.
 - Secure status nodes now update after group writes while MAC validation and replay protection remain enabled.
 
 **Version 8.0.5** - September 2026

package/docs/README.md

@@ -4,6 +4,7 @@ The site uses GitHub Pages/Jekyll and keeps the existing URLs and six languages:
 
 - `docs/_data/knx8.json`: translated home-page content and version notices.
 - `docs/_includes/homepage/content.html`: shared home-page structure.
+- `docs/_data/homepage-community.json` and `docs/_includes/homepage/community.html`: partners, community links and translated Made in Italy/KNX acknowledgements, with logos in `docs/assets/community/`.
 - `docs/wiki/`: node reference, getting started, migration and examples. Use the same `translation_key` for translations and preserve existing `permalink` values.
 - `scripts/wiki-menu.json`: navigation source. `npm run docs:prepare` regenerates `docs/_data/wiki-nav.json` and copies the package examples to `docs/examples/`.
 - `examples/`: the maintained importable flows. The copies in `docs/examples/` are generated and ignored by Git.
@@ -12,14 +13,14 @@ The old HUE and Matter pages are version 7 references, marked by `legacy_package
 
 ## Local preview
 
-Install the Ruby/Jekyll dependencies from `docs/Gemfile`, then run from the repository root with `jekyll` available on PATH:
+Install the Ruby/Jekyll dependencies from `docs/Gemfile`, then run from the repository root with `ruby` available on PATH:
 
 ```sh
 npm run docs:build
 npm run docs:serve
 ```
 
-Open `http://127.0.0.1:4000/node-red-contrib-knx-ultimate/`. The preview uses the same Liquid templates as the real site.
+Open `http://127.0.0.1:4000/node-red-contrib-knx-ultimate/`. The preview uses the same Liquid templates as the real site. The scripts locate Jekyll through RubyGems, so the gem executable directory does not need to be on PATH. `docs:serve:norl` uses the same launcher.
 
 `npm run wiki:refresh` imports help for the current Device, Gateway, Viewer, IoT Bridge and routing nodes. It preserves page metadata and archive notices. Getting started, migration, Utility overview/function references and examples are maintained directly in `docs/wiki/`.
 

package/nodes/knxUltimate-config.js

@@ -32,6 +32,19 @@ try { NODE_VERSION = require('../package.json').version } catch (e) { /* empty *
 let KNX_ENGINE_VERSION = 'unknown'
 try { KNX_ENGINE_VERSION = require('knxultimate/package.json').version } catch (e) { /* empty */ }
 
+// Returns the group service of a bus telegram, or null when it is not one:
+// transport control TPDUs (T_Connect, T_Disconnect, T_ACK, T_NAK: TPCI only, no APCI)
+// and point-to-point telegrams (cEMI Ctrl2 address type 0 = individual destination).
+const getGroupServiceEvent = (cEMIMessage) => {
+  const npdu = cEMIMessage?.npdu
+  if (!npdu || npdu.isTransportControl === true) return null
+  if (cEMIMessage.control?.addressType === 0) return null
+  if (npdu.isGroupRead) return 'GroupValue_Read'
+  if (npdu.isGroupResponse) return 'GroupValue_Response'
+  if (npdu.isGroupWrite) return 'GroupValue_Write'
+  return null
+}
+
 // DATAPONT MANIPULATION HELPERS
 // ####################
 const sortBy = (field) => (a, b) => {
@@ -1399,18 +1412,20 @@ module.exports = (RED) => {
         return
       }
 
-      let _evt = null
-      if (_datagram.cEMIMessage.npdu.isGroupRead) _evt = 'GroupValue_Read'
-      if (_datagram.cEMIMessage.npdu.isGroupResponse) _evt = 'GroupValue_Response'
-      if (_datagram.cEMIMessage.npdu.isGroupWrite) _evt = 'GroupValue_Write'
-
       let _src = null
       _src = _datagram.cEMIMessage.srcAddress.toString()
 
       let _dest = null
       _dest = _datagram.cEMIMessage.dstAddress.toString()
 
-      if (_evt === null || _src === null || _dest === null) {
+      // Point-to-point and transport control telegrams (e.g. an ETS device scan) are valid, but not for us
+      const _evt = getGroupServiceEvent(_datagram.cEMIMessage)
+      if (_evt === null) {
+        node.sysLogger?.debug(`HandleBusEvent: ignored non group telegram src=${_src} dest=${_dest}`)
+        return
+      }
+
+      if (_src === null || _dest === null) {
         node.sysLogger?.warn(`HandleBusEvent: unable to parse telegram, ignored (evt=${_evt || 'n/a'} src=${_src || 'n/a'} dest=${_dest || 'n/a'})`)
         return
       };
@@ -2754,5 +2769,6 @@ module.exports = (RED) => {
 }
 
 module.exports.__test = {
-  resolveHostAddress
+  resolveHostAddress,
+  getGroupServiceEvent
 }

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "8.0.6",
+  "version": "8.1.1",
   "description": "KNX integration for Node-RED with KNX/IP and KNX Secure, ETS import, routing, diagnostics, automation utilities, MQTT and Modbus adapters. Optional Hue Ultimate and Matter Ultimate packages connect through the KNX gateway.",
   "files": [
     "nodes/",
@@ -19,7 +19,7 @@
     "scripts/check-legacy-flows.js"
   ],
   "dependencies": {
-    "knxultimate": "6.0.8",
+    "knxultimate": "6.2.1",
     "lodash": "4.18.1",
     "mqtt": "^5.15.2",
     "ping": "0.4.4",
@@ -97,8 +97,8 @@
     "docs:sync": "node scripts/export-wiki-to-pages.js",
     "wiki:refresh": "npm run wiki:help-export && node scripts/generate-wiki-navbar.js && node scripts/prepare-wiki-pages.js && npm run docs:sync",
     "docs:prepare": "node scripts/generate-wiki-navbar.js && node scripts/prepare-docs.js",
-    "docs:build": "npm run docs:prepare && jekyll build --source docs --destination docs/_site",
-    "docs:serve": "npm run docs:prepare && jekyll serve --source docs --destination docs/_site --host 127.0.0.1",
+    "docs:build": "npm run docs:prepare && ruby -e \"load Gem.bin_path('jekyll', 'jekyll')\" -- build --source docs --destination docs/_site",
+    "docs:serve": "npm run docs:prepare && ruby -e \"load Gem.bin_path('jekyll', 'jekyll')\" -- serve --source docs --destination docs/_site --host 127.0.0.1",
     "docs:serve:norl": "npm run docs:serve",
     "knx-utility:generate": "node scripts/generate-knx-utility-profiles.js",
     "knx-utility:check": "node scripts/generate-knx-utility-profiles.js --check",
@@ -113,4 +113,4 @@
     "marked": "^14.1.0",
     "js-yaml": "4.3.2"
   }
-}
+}