node-red-contrib-knx-ultimate 5.2.5 → 6.0.0

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 
 # CHANGELOG
 
+**Version 6.0.0** - July 2026<br/>
+
+- **BREAKING CHANGE**: this release intentionally bumps the package to `6.0.0` because the Matter node model changed. The unpublished dedicated Matter controller nodes and the old generic Matter Device node have been replaced by the new single **Control Matter from KNX (BETA)** node, and the KNX-to-Matter bridge/editor behaviour has been reworked. Existing experimental Matter flows created with the previous beta nodes may need to be rebuilt or adjusted.<br/>
+- **Matter nodes are BETA**: all Matter nodes are experimental and may be changed, renamed, removed, or replaced at any time until the Matter integration leaves the BETA phase. Do not treat their editor fields, flow JSON structure, runtime behaviour, storage layout, or exposed APIs as stable yet.<br/>
+- New **Control Matter from KNX (BETA)** node: a single capability-driven Matter controller node. Select a commissioned Matter endpoint and the editor shows only the KNX mappings supported by that endpoint (switch, brightness, color temperature, temperature, humidity, lux, occupancy, contact and battery). Light endpoints keep the familiar light-style tabs and the main KNX light options from the dedicated node, including relative DIM (DPT 3.007), brightness %, tunable-white DIM/Kelvin, switch-on brightness/temperature, dim speed, min/max dim level, tunable-white direction inversion and optional day/night lighting. This replaces the unpublished dedicated Matter controller nodes and the old generic Matter Device node.<br/>
+- **Matter Bridge device (BETA)** is now presented as **Expose KNX to Matter (BETA)** in the editor, with advanced compatibility options for real-world KNX actuators: dimmable devices can ignore brightness commands sent immediately after `On`, and covers/shutters can optimistically update their Matter position while waiting for the real KNX status feedback.<br/>
+- Matter Controller pairing and device list improvements: clearer commissioning errors, persistent error dialogs, better logging, device names shown more consistently, and direct rename support from the associated-devices list.<br/>
+- **Documentation**: added localized editor help and online docs for the new Matter nodes in EN/IT/DE/FR/ES/zh-CN, and expanded the Matter section in the documentation navigation.<br/>
+
 **Version 5.2.5** - July 2026<br/>
 
 - Maintenance release.<br/>

package/nodes/commonFunctions.js

@@ -982,10 +982,47 @@ module.exports = (RED) => {
           res.json({ error: 'PLEASE DEPLOY FIRST: then try again.' })
           return
         }
-        const nodeId = await matterServer.commission(req.query.code)
-        res.json({ nodeId })
+        const nodeId = await matterServer.commission(req.query.code, { targetHost: req.query.targetHost })
+        const requestedName = String(req.query.name || '').trim()
+        let renameError = null
+        if (requestedName !== '') {
+          try {
+            await matterServer.renameCommissionedNode(nodeId, requestedName)
+          } catch (error) {
+            renameError = error.message
+            RED.log.warn(`Warn KNXUltimateMatterPair rename node ${nodeId}: ${error.message}`)
+          }
+        }
+        let device = null
+        try {
+          device = matterServer.getCommissionedNodesDetails().find((item) => String(item.nodeId) === String(nodeId)) || null
+        } catch (error) { /* empty */ }
+        res.json({ nodeId, name: device?.name, productName: device?.productName, vendorName: device?.vendorName, renameError })
+      } catch (error) {
+        const targetHost = req.query.targetHost ? ` targetHost=${req.query.targetHost}` : ''
+        RED.log.error(`Err KNXUltimateMatterPair:${targetHost} ${error.stack || error.message}`)
+        res.json({ error: error.message })
+      }
+    })
+
+    // MATTER: renames a commissioned Matter device by writing BasicInformation.nodeLabel
+    RED.httpAdmin.get('/KNXUltimateMatterRename', RED.auth.needsPermission('matter-config.write'), async (req, res) => {
+      try {
+        const matterServer = RED.nodes.getNode(req.query.serverId)
+        if (matterServer === null || matterServer === undefined) {
+          res.json({ error: 'PLEASE DEPLOY FIRST: then try again.' })
+          return
+        }
+        const nodeId = String(req.query.nodeId || '').trim()
+        const name = String(req.query.name || '').trim()
+        if (nodeId === '' || name === '') {
+          res.json({ error: 'Missing nodeId or name.' })
+          return
+        }
+        await matterServer.renameCommissionedNode(nodeId, name)
+        res.json({ status: 'ok', nodeId, name })
       } catch (error) {
-        RED.log.error(`Err KNXUltimateMatterPair: ${error.message}`)
+        RED.log.error(`Err KNXUltimateMatterRename: ${error.stack || error.message}`)
         res.json({ error: error.message })
       }
     })