node-red-contrib-knx-ultimate 6.3.0 → 6.3.2

package/CHANGELOG.md

@@ -6,6 +6,16 @@
 
 # CHANGELOG
 
+**Version 6.3.2** - August 2026<br/>
+
+- Fixed stop issue in dimme-up.<br/>
+
+**Version 6.3.1** - August 2026<br/>
+
+- Updated dependencies, including the security-fixed jsPDF release.<br/>
+- Replaced `node-color-log` with Winston, shared with the KNXUltimate engine.<br/>
+- **Documentation language navigation**: fixed localized homepage links returning `404` on GitHub Pages because they incorrectly included a trailing slash.<br/>
+
 **Version 6.3.0** - August 2026<br/>
 
 - **HUE Controller**: unified device-first workflow for all supported Hue API v2 resources, with automatic type detection and legacy-node migration.<br/>

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 Massimo Saccani
+Copyright (c) 2019 Massimo Saccani (maxsupergiovane@icloud.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/nodes/hue-config.js

@@ -5,6 +5,7 @@
 /* eslint-disable no-inner-declarations */
 /* eslint-disable max-len */
 const cloneDeep = require('lodash/cloneDeep')
+const LoggerClass = require('./utils/sysLogger')
 const {
   HUE_CONTROLLER_RESOURCE_TYPES,
   buildHueControllerResourceCatalog
@@ -12,14 +13,6 @@ const {
 // const classHUE = require("./utils/hueEngine").classHUE;
 const hueColorConverter = require('./utils/colorManipulators/hueColorConverter')
 
-// 10/09/2024 Setup the color logger
-loggerSetup = (options) => {
-  const clog = require('node-color-log').createNamedLogger(options.setPrefix)
-  clog.setLevel(options.loglevel)
-  clog.setDate(() => (new Date()).toLocaleString())
-  return clog
-}
-
 module.exports = (RED) => {
   function hueConfig (config) {
     RED.nodes.createNode(this, config)
@@ -33,7 +26,7 @@ module.exports = (RED) => {
     node.pendingHueResourceReload = null
     node.activeHueIdentifySessions = new Map()
     try {
-      node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'hue-config.js' })
+      node.sysLogger = new LoggerClass({ loglevel: node.loglevel, setPrefix: 'hue-config.js' })
     } catch (error) { console.log(error.stack) }
     node.name = config.name === undefined || config.name === '' ? node.host : config.name
 
@@ -798,6 +791,7 @@ module.exports = (RED) => {
 
     node.on('close', (done) => {
       try {
+        node.sysLogger?.destroy()
         node.sysLogger = null
         node.nodeClients = []
         node.closeConnection()

package/nodes/knxUltimate-config.js

@@ -2755,8 +2755,8 @@ module.exports = (RED) => {
       } catch (error) { /* empty */ }
       node.nodeClients = [] // 05/04/2022 Nullify
       try {
-        if (node.sysLogger !== null) node.sysLogger = null
-        loggerEngine.destroy()
+        node.sysLogger?.destroy()
+        node.sysLogger = null
       } catch (error) { /* empty */ }
       done()
     })

package/nodes/knxUltimateAI.html

@@ -115,7 +115,7 @@
 
 <script type="text/javascript">
     RED.nodes.registerType('knxUltimateAI', {
-        category: "KNX Ultimate",
+        category: "KNX Ultimate AI",
         color: '#FF9800',
         defaults: {
             server: { type: "knxUltimate-config", required: true },
@@ -875,4 +875,4 @@
             </div>
         </div>
     </div>
-</script>
+</script>

package/nodes/knxUltimateHueLight.js

@@ -750,7 +750,9 @@ module.exports = function (RED) {
         let numStep = 10 // Steps from 0 to 100 by 10
         const extendedConf = {}
 
-        if (_KNXbrightness_Direction === 0 && _KNXaction === 0) {
+        // DPT 3.x uses data/step-code 0 for BREAK. The direction bit may be
+        // either 0 ($00) or 1 ($08), so it must not be part of this check.
+        if (_KNXbrightness_Direction === 0) {
           // STOP DIM
           if (node.timerStepDim !== undefined) clearInterval(node.timerStepDim)
           node.brightnessStep = null
@@ -835,7 +837,7 @@ module.exports = function (RED) {
       // 23/23/2023 after many attempts to use dimming_delta function of the HueApeV2, loosing days of my life, without a decent success, will use the standard dimming calculations
       // i decide to go to the "step brightness" way.
       try {
-        if (_KNXbrightness_DirectionTunableWhite === 0 && _KNXaction === 0) {
+        if (_KNXbrightness_DirectionTunableWhite === 0) {
           // STOP DIM
           if (node.timerStepDimTunableWhite !== undefined) clearInterval(node.timerStepDimTunableWhite)
           node.brightnessStepTunableWhite = null
@@ -909,7 +911,7 @@ module.exports = function (RED) {
       // After many attempts to use dimming_delta function of the HueApiV2, loosing days of my life, without a decent success, will use the standard dimming calculations
       // i decide to go to the "step brightness" way.
       try {
-        if (_KNXbrightness_DirectionHSV_H === 0 && _KNXaction === 0) {
+        if (_KNXbrightness_DirectionHSV_H === 0) {
           // STOP DIM
           if (node.timerStepDimHSV_H !== undefined) clearInterval(node.timerStepDimHSV_H)
           node.deleteHueStateQueue() // Clear dimming queue.
@@ -997,7 +999,7 @@ module.exports = function (RED) {
       // After many attempts to use dimming_delta function of the HueApiV2, loosing days of my life, without a decent success, will use the standard dimming calculations
       // i decide to go to the "step brightness" way.
       try {
-        if (_KNXbrightness_DirectionHSV_S === 0 && _KNXaction === 0) {
+        if (_KNXbrightness_DirectionHSV_S === 0) {
           // STOP DIM
           if (node.timerStepDimHSV_S !== undefined) clearInterval(node.timerStepDimHSV_S)
           node.deleteHueStateQueue() // Clear dimming queue.

package/nodes/matter-config.js

@@ -1,17 +1,10 @@
 /* eslint-disable max-len */
 const path = require('path')
+const LoggerClass = require('./utils/sysLogger')
 const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
 const matterPackageVersion = require('@matter/main').version
 const { Specification } = require('@matter/model')
 
-// 10/09/2024 Setup the color logger
-const loggerSetup = (options) => {
-  const clog = require('node-color-log').createNamedLogger(options.setPrefix)
-  clog.setLevel(options.loglevel)
-  clog.setDate(() => (new Date()).toLocaleString())
-  return clog
-}
-
 module.exports = (RED) => {
   function matterConfig (config) {
     RED.nodes.createNode(this, config)
@@ -30,7 +23,7 @@ module.exports = (RED) => {
       message: 'Waiting for commissioning to start.'
     }
     try {
-      node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matter-config.js' })
+      node.sysLogger = new LoggerClass({ loglevel: node.loglevel, setPrefix: 'matter-config.js' })
     } catch (error) { console.log(error.stack) }
     node.name = config.name === undefined || config.name === '' ? 'Matter Controller' : config.name
     node.fabricLabel = config.fabricLabel === undefined || config.fabricLabel === '' ? 'KNX-Ultimate' : config.fabricLabel
@@ -378,6 +371,7 @@ module.exports = (RED) => {
           try {
             if (node.matterManager !== null) await node.matterManager.close()
             node.matterManager = null
+            node.sysLogger?.destroy()
             node.sysLogger = null
             done()
           } catch (error) {

package/nodes/matterbridge-config.js

@@ -1,17 +1,10 @@
 /* eslint-disable max-len */
 const path = require('path')
+const LoggerClass = require('./utils/sysLogger')
 const { exportMatterStorage, importMatterStorage } = require('./utils/matterStorageBackup')
 const matterPackageVersion = require('@matter/main').version
 const { Specification } = require('@matter/model')
 
-// 10/09/2024 Setup the color logger
-const loggerSetup = (options) => {
-  const clog = require('node-color-log').createNamedLogger(options.setPrefix)
-  clog.setLevel(options.loglevel)
-  clog.setDate(() => (new Date()).toLocaleString())
-  return clog
-}
-
 // The running Matter servers, keyed by config node id. Kept OUTSIDE the node lifecycle:
 // a re-deploy must NOT restart the Matter server, otherwise the paired controllers
 // resume their session without re-reading the structure and never see device changes.
@@ -26,7 +19,7 @@ module.exports = (RED) => {
     node.loglevel = config.loglevel !== undefined ? config.loglevel : 'error'
     node.sysLogger = null
     try {
-      node.sysLogger = loggerSetup({ loglevel: node.loglevel, setPrefix: 'matterbridge-config.js' })
+      node.sysLogger = new LoggerClass({ loglevel: node.loglevel, setPrefix: 'matterbridge-config.js' })
     } catch (error) { console.log(error.stack) }
 
     node.name = config.name === undefined || config.name === '' ? 'Matter Bridge' : config.name
@@ -258,6 +251,7 @@ module.exports = (RED) => {
         } catch (error) { /* empty */ }
         node.matterBridge = null
         node.deviceClients.clear()
+        node.sysLogger?.destroy()
         node.sysLogger = null
         done()
       })()