node-red-contrib-knx-ultimate 4.3.2 → 4.3.5

package/nodes/knxUltimate.js

@@ -136,6 +136,7 @@ module.exports = function (RED) {
         }
         const mode = (req.body && req.body.mode ? String(req.body.mode) : 'read').toLowerCase()
         const grpaddr = targetNode.topic
+        const isRawMode = typeof targetNode.dpt === 'string' && targetNode.dpt.trim().toLowerCase() === 'raw'
         if (mode !== 'read') {
           if (!grpaddr || String(grpaddr).trim() === '') {
             res.status(400).json({ error: 'Group address not set' })
@@ -145,6 +146,10 @@ module.exports = function (RED) {
             res.status(400).json({ error: 'Datapoint not defined for this node' })
             return
           }
+          if (isRawMode) {
+            res.status(400).json({ error: 'Manual write is not available when the node datapoint is set to raw' })
+            return
+          }
         }
 
         if (mode === 'read') {
@@ -299,7 +304,7 @@ module.exports = function (RED) {
   const payloadRounder = require('./utils/payloadManipulation')
   const dptlib = require('knxultimate').dptlib
 
-  function knxUltimate (config) {
+  function knxUltimate(config) {
     RED.nodes.createNode(this, config)
     const node = this
     node.serverKNX = RED.nodes.getNode(config.server) || undefined
@@ -365,7 +370,7 @@ module.exports = function (RED) {
     // Get the Group Address from various sources
     if (config.setTopicType === undefined || config.setTopicType === 'str') {
       node.topic = config.topic
-      node.dpt = config.dpt || '1.001'
+      node.dpt = (config.dpt === undefined || config.dpt === '') ? '1.001' : config.dpt
     } else if (config.setTopicType === 'flow') {
       try {
         node.topic = node.context().flow.get(config.topic)
@@ -467,6 +472,7 @@ module.exports = function (RED) {
           if (node.listenallga === true) return
           if (typeof node.topic !== 'string' || node.topic === '') return
           if (typeof node.dpt !== 'string' || node.dpt === '' || node.dpt === 'auto') return
+          if (node.dpt.trim().toLowerCase() === 'raw') return
 
           node.serverKNX.sendKNXTelegramToKNXEngine({
             grpaddr: node.topic,
@@ -500,36 +506,61 @@ module.exports = function (RED) {
     }
 
     // Used in the KNX Function TAB
-    const getGAValue = function getGAValue (_ga = undefined, _dpt = undefined) {
-      try {
-        if (_ga === undefined) return
-        // The GA can have the devicename as well, separated by a blank space (1/1/0 light table ovest),
-        // I must take the GA only
-        const blankSpacePosition = _ga.indexOf(' ')
-        if (blankSpacePosition > -1) _ga = _ga.substring(0, blankSpacePosition)
-        // Is there a GA in the server's exposedGAs?
-        const found = node.serverKNX.exposedGAs.find(a => a.ga === _ga)
+    const getGAValue = async function getGAValue(_ga = undefined, _dpt = undefined) {
+      if (_ga === undefined) return null
+      // Strip devicename if present (e.g. "1/1/1 Light name" → "1/1/1")
+      const blankSpacePosition = _ga.indexOf(' ')
+      if (blankSpacePosition > -1) _ga = _ga.substring(0, blankSpacePosition)
+
+      const tryDecode = (rawValue, dpt) => {
+        try {
+          if (rawValue === null || rawValue === undefined) return undefined
+          return dptlib.fromBuffer(rawValue, dptlib.resolve(dpt))
+        } catch (_e) { return undefined }
+      }
+
+      const sendRead = () => {
+        try {
+          node.serverKNX.sendKNXTelegramToKNXEngine({
+            grpaddr: _ga, payload: '', dpt: '', outputtype: 'read', nodecallerid: node.id
+          })
+          RED.log.warn('getGAValue: sent groupvalue_read for ' + _ga)
+        } catch (e) {
+          RED.log.error('getGAValue: failed to send read for ' + _ga + ': ' + e.message)
+        }
+      }
+
+      // Check cache first
+      let found = node.serverKNX.exposedGAs.find(a => a.ga === _ga)
+      if (found !== undefined) {
+        const dptFinal = _dpt || found.dpt
+        if (!dptFinal) {
+          RED.log.error('getGAValue: no DPT for ' + _ga + '. Provide it as second parameter.')
+          return null
+        }
+        const val = tryDecode(found.rawValue, dptFinal)
+        if (val !== undefined) return val
+        // rawValue present but decode failed (bad format) — fall through to read
+        RED.log.warn('getGAValue: cached rawValue for ' + _ga + ' could not be decoded, sending read request')
+      }
+
+      // Not cached or decode failed: send read and poll up to 3 seconds
+      sendRead()
+      for (let i = 0; i < 30; i++) {
+        await new Promise(resolve => setTimeout(resolve, 100))
+        found = node.serverKNX.exposedGAs.find(a => a.ga === _ga)
         if (found !== undefined) {
-          if (_dpt === undefined && found.dpt === undefined) {
-            const errM = 'getGaValue: node ID:' + node.id + ' ' + 'No CSV file imported. Please provide the dpt manually'
-            RED.log.error(errM)
-            if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.error(errM)
-            return
-          };
-          return dptlib.fromBuffer(found.rawValue, dptlib.resolve(_dpt || found.dpt))
-        } else {
-          const errM = 'getGaValue: node ID:' + node.id + ' ' + 'Group Address not yet read, try later.'
-          RED.log.error(errM)
-          if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.error(errM)
+          const dptFinal = _dpt || found.dpt
+          if (!dptFinal) return null
+          const val = tryDecode(found.rawValue, dptFinal)
+          if (val !== undefined) return val
         }
-      } catch (error) {
-        const errM = 'getGaValue: node ID:' + node.id + ' ' + error.stack
-        RED.log.error(errM)
-        if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.error(errM)
       }
+      RED.log.warn('getGAValue: no response from KNX bus for ' + _ga + ' within 3 seconds')
+      return null
     }
     // Used in the KNX Function TAB
-    const setGAValue = function setGAValue (_ga = undefined, _value = undefined, _dpt = undefined) {
+    const setGAValue = function setGAValue(_ga = undefined, _value = undefined, _dpt = undefined) {
       try {
         if (_ga === undefined) return
         // The GA can have the devicename as well, separated by a blank space (1/1/0 light table ovest),
@@ -556,7 +587,7 @@ module.exports = function (RED) {
       }
     }
     // Used in the KNX Function TAB
-    const self = function self (_value) {
+    const self = function self(_value) {
       try {
         node.serverKNX.sendKNXTelegramToKNXEngine({
           grpaddr: node.topic, payload: _value, dpt: node.dpt, outputtype: 'write', nodecallerid: node.id
@@ -568,7 +599,7 @@ module.exports = function (RED) {
       }
     }
     // Used in the KNX Function TAB
-    const toggle = function toggle () {
+    const toggle = function toggle() {
       if (node.currentPayload === true || node.currentPayload === false) {
         try {
           node.serverKNX.sendKNXTelegramToKNXEngine({
@@ -583,7 +614,7 @@ module.exports = function (RED) {
     }
 
     // This function is called by the knx-ultimate config node, to output a msg.payload.
-    node.handleSend = (msg) => {
+    node.handleSend = async (msg) => {
       // 27/03/2020 can i merge the last input msg arrived, with the output?
       try {
         if (node.passthrough === 'yes') {
@@ -613,8 +644,8 @@ module.exports = function (RED) {
       // -+++++++++++++++++++++++++++++++++++++++++++
       if (node.receiveMsgFromKNXCode !== undefined) {
         try {
-          const receiveMsgFromKNXCode = new Function('msg', 'getGAValue', 'node', 'RED', 'self', 'toggle', 'setGAValue', node.receiveMsgFromKNXCode)
-          msg = receiveMsgFromKNXCode(msg, getGAValue, node, RED, self, toggle, setGAValue)
+          const receiveMsgFromKNXCode = (new (Object.getPrototypeOf(async function () { }).constructor)('msg', 'getGAValue', 'node', 'RED', 'self', 'toggle', 'setGAValue', node.receiveMsgFromKNXCode))
+          msg = await receiveMsgFromKNXCode(msg, getGAValue, node, RED, self, toggle, setGAValue)
         } catch (error) {
           RED.log.error('knxUltimate: receiveMsgFromKNXCode: node ID:' + node.id + ' ' + error.message)
           if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.error(`receiveMsgFromKNXCode: node id ${node.id} ` || ' ' + error.stack)
@@ -631,7 +662,7 @@ module.exports = function (RED) {
       if (msg !== undefined) node.send(msg)
     }
 
-    node.on('input', (msg) => {
+    node.on('input', async (msg) => {
       if (typeof msg === 'undefined') return
       if (!node.serverKNX) return // 29/08/2019 Server not instantiate
 
@@ -679,8 +710,8 @@ module.exports = function (RED) {
       // -+++++++++++++++++++++++++++++++++++++++++++
       if (node.sendMsgToKNXCode !== undefined) {
         try {
-          const sendMsgToKNXCode = new Function('msg', 'getGAValue', 'node', 'RED', 'self', 'toggle', 'setGAValue', node.sendMsgToKNXCode)
-          msg = sendMsgToKNXCode(msg, getGAValue, node, RED, self, toggle, setGAValue)
+          const sendMsgToKNXCode = (new (Object.getPrototypeOf(async function () { }).constructor)('msg', 'getGAValue', 'node', 'RED', 'self', 'toggle', 'setGAValue', node.sendMsgToKNXCode))
+          msg = await sendMsgToKNXCode(msg, getGAValue, node, RED, self, toggle, setGAValue)
           if (msg === undefined) return
         } catch (error) {
           RED.log.error('knxUltimate: sendMsgToKNXCode: node ID:' + node.id + ' ' + error.message)
@@ -886,8 +917,11 @@ module.exports = function (RED) {
           // connection.writeRaw('1/0/0', Buffer.from('0730', 'hex'))
           if (msg.hasOwnProperty('writeraw') && msg.hasOwnProperty('writeraw') !== null) {
             try {
-              if (msg.hasOwnProperty('bitlenght') && msg.bitlenght !== null) {
-                node.serverKNX.knxConnection.writeRaw(grpaddr, msg.writeraw, msg.bitlenght)
+              const rawBitlength = msg.hasOwnProperty('bitlength') && msg.bitlength !== null
+                ? msg.bitlength
+                : (msg.hasOwnProperty('bitlenght') && msg.bitlenght !== null ? msg.bitlenght : null)
+              if (rawBitlength !== null) {
+                node.serverKNX.knxConnection.writeRaw(grpaddr, msg.writeraw, rawBitlength)
               } else {
                 node.serverKNX.knxConnection.writeRaw(grpaddr, msg.writeraw)
               }
@@ -902,6 +936,20 @@ module.exports = function (RED) {
             return
           }
 
+          if (typeof dpt === 'string' && dpt.trim().toLowerCase() === 'raw') {
+            node.setNodeStatus({
+              fill: 'red',
+              shape: 'dot',
+              text: 'RAW mode accepts only msg.writeraw for outgoing telegrams',
+              payload: '',
+              GA: grpaddr,
+              dpt: '',
+              devicename: ''
+            })
+            node.sysLogger?.error(`node id: ${node.id} RAW mode accepts only msg.writeraw for outgoing telegrams (${grpaddr})`)
+            return
+          }
+
           if (outputtype == 'response') {
             try {
               node.currentPayload = msg.payload// 31/12/2019 Set the current value (because, if the node is a virtual device, then it'll never fire "GroupValue_Write" in the server node, causing the currentPayload to never update)
@@ -960,9 +1008,9 @@ module.exports = function (RED) {
     })
 
     // On each deploy, add the node to the server list
-	    if (node.serverKNX) {
-	      node.serverKNX.addClient(node)
-	      if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.info(`addClient: node id ${node.id}` || '' + ` with topic ${node.topic || ''} has been added to the server.`)
+    if (node.serverKNX) {
+      node.serverKNX.addClient(node)
+      if (node.sysLogger !== undefined && node.sysLogger !== null) node.sysLogger.info(`addClient: node id ${node.id}` || '' + ` with topic ${node.topic || ''} has been added to the server.`)
       // 05/11/2021 if the node is set to read from bus, issue a read.
       // "node-input-initialread0": "No",
       // "node-input-initialread1": "Leggi dal BUS KNX",
@@ -975,11 +1023,11 @@ module.exports = function (RED) {
         const t = setTimeout(() => { // 21/03/2022 fixed possible memory leak. Previously was setTimeout without "let t = ".
           node.emit('input', { readstatus: true })
         }, 3000)
-	      }
-	    }
+      }
+    }
 
-	    // Start periodic send timer (optional)
-	    startPeriodicSendTimer()
-	  }
-	  RED.nodes.registerType('knxUltimate', knxUltimate)
+    // Start periodic send timer (optional)
+    startPeriodicSendTimer()
+  }
+  RED.nodes.registerType('knxUltimate', knxUltimate)
 }

package/nodes/locales/de/knxUltimate.html

@@ -112,7 +112,7 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){ return; }
 - **event (string)**: `GroupValue_Write`, `GroupValue_Response`, `Update_NoWrite` (nur interner Wert, kein BUS-Senden)
 - **readstatus (boolean)**: Leseauftrag an den BUS
 - **dpt (string)**: z. B. `1.001`
-- **writeraw (buffer)** + **bitlenght (int)**: RAW-Senden; `bitlenght` in Bit
+- **writeraw (buffer)** + **bitlength (int)**: RAW-Senden; `bitlength` in Bit (`bitlenght` wird aus Kompatibilitaetsgruenden weiterhin akzeptiert)
 - **resetRBE (boolean)**: RBE-Filter zurücksetzen
 - **setConfig (json)**: GA/DPT des Nodes per Nachricht ändern
 
@@ -181,7 +181,8 @@ Für Read statt `event` bitte `msg.readstatus = true` verwenden.
 
 - **msg.readstatus = true**: Read an den BUS
 - **msg.dpt**: z. B. `1.001` (auch `9`, `"9"`, `"DPT9.001"`)
-- **msg.writeraw** + **msg.bitlenght**: RAW-Senden; ignoriert den am Node gesetzten DPT
+- **msg.dpt = raw**: eingehende Telegramme bleiben undekodiert; `msg.payload` ist `null` und die Bytes stehen in `msg.knx.rawValue`. Zum Senden von RAW-Telegrammen `msg.writeraw` verwenden
+- **msg.writeraw** + **msg.bitlength**: RAW-Senden; ignoriert den am Node gesetzten DPT
 - **msg.resetRBE = true**: RBE-Filter zurücksetzen
 
 ## Konfiguration per Nachricht ändern
@@ -227,7 +228,7 @@ msg.readstatus = true; return msg;
 ```javascript
 
 msg.writeraw = Buffer.from('01','hex');
-msg.bitlenght = 1; return msg;
+msg.bitlength = 1; return msg;
 // Temperatur (DPT9): 18.4 °C = <0730>
 // msg.writeraw = Buffer.from('0730','hex'); return msg;
 ```

package/nodes/locales/en/knxUltimate.html

@@ -159,8 +159,9 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){
 - **event (string)**: `_GroupValue_Write_` / `_GroupValue_Response_` / `_Update_NoWrite_` (`_Update_NoWrite_` updates the internal value only)
 - **readstatus (boolean)**: issue a read request to the KNX bus (pass `_true_` every time: `msg.readstatus = true`)
 - **dpt (string)**: for example `"1.001"` (sets the datapoint)
-- **writeraw (buffer)**: sends a raw buffer value to the bus (use with **bitlenght**)
-- **bitlenght (int)**: bit length of **writeraw**
+- **dpt = raw**: keeps incoming telegrams undecoded; `msg.payload` will be `null` and the bytes will be available in `msg.knx.rawValue`. Use `msg.writeraw` to send raw telegrams
+- **writeraw (buffer)**: sends a raw buffer value to the bus (use with **bitlength**)
+- **bitlength (int)**: bit length of **writeraw** (`bitlenght` is still accepted for backward compatibility)
 - **resetRBE (boolean)**: resets the internal RBE filters (`msg.resetRBE = true`)
 - **setConfig (json)**: programmatically change the node Group Address and Datapoint (see details)
 
@@ -263,8 +264,9 @@ msg = {
 - **event (string)**: `_GroupValue_Write_` / `_GroupValue_Response_` / `_Update_NoWrite_` (`_Update_NoWrite_` updates the internal value only)
 - **readstatus (boolean)**: issue a read request to the KNX bus (pass `_true_` every time: `msg.readstatus = true`)
 - **dpt (string)**: for example `"1.001"` (sets the datapoint)
-- **writeraw (buffer)**: sends a raw buffer value to the bus (use with **bitlenght**)
-- **bitlenght (int)**: bit length of **writeraw**
+- **dpt = raw**: keeps incoming telegrams undecoded; `msg.payload` will be `null` and the bytes will be available in `msg.knx.rawValue`. Use `msg.writeraw` to send raw telegrams
+- **writeraw (buffer)**: sends a raw buffer value to the bus (use with **bitlength**)
+- **bitlength (int)**: bit length of **writeraw** (`bitlenght` is still accepted for backward compatibility)
 - **resetRBE (boolean)**: resets the internal RBE filters (`msg.resetRBE = true`)
 - **setConfig (json)**: programmatically change the node Group Address and Datapoint (see details)
 
@@ -436,7 +438,7 @@ Issue a "Read" command to the BUS.
 **msg.dpt** <br/>
 For example "1.001". Sets the <b>Datapoint</b>. (You can write it in these formats: 9 , "9" , "9.001" or "DPT9.001")
 
-**msg.writeraw ** <br/>**msg.bitlenght** <br/>
+**msg.writeraw ** <br/>**msg.bitlength** <br/>
 Writes RAW data to the KNX BUS. Please see below an example.<br/>
 
 **msg.resetRBE** <br/> pass msg.resetRBE = true to a device node, to reset both input and output RBE filter on that particular node.<br/>
@@ -500,23 +502,23 @@ return msg;
 
 **SEND RAW VALUE TO THE BUS** <br/>
 
-To send a RAW buffer value to the KNX bus, use the _ **writeraw ** _ and _**bitlenght** _ properties of the msg input.<br/>
+To send a RAW buffer value to the KNX bus, use the _ **writeraw ** _ and _**bitlength** _ properties of the msg input.<br/>
 In this case, the _Datapoint_ you set in the property window will be ignored.<br/>
 Slap a function node in front of knx-ultimate and paste his code:
 
 ```javascript
 
 // If you encode the values by yourself, you can write raw buffers with writeraw.
-// The bitlenght is necessary for datapoint types where the bitlenght does not equal the buffers bytelenght * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlenght 2) and 3 (bitlenght 4).
+// The bitlength is necessary for datapoint types where the bitlength does not equal the buffer bytelength * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlength 2) and 3 (bitlength 4).
 // Write raw buffer to a groupaddress with dpt 1 (e.g light on = value true = Buffer<01>) with a bitlength of 1
 msg.writeraw = Buffer.from('01', 'hex'); // Put '00' instead of '01' to switch off the light.
-msg.bitlenght = 1;
+msg.bitlength = 1;
 return msg;
 
 // Temperature sample (uncomment below and comment above)
 // Write raw buffer to a groupaddress with dpt 9 (e.g temperature 18.4 °C = Buffer<0730>) without bitlength
 // msg.writeraw = Buffer.from('0730', 'hex');
-// msg.bitlenght = 1;
+// msg.bitlength = 1;
 // return msg;
 
 ```

package/nodes/locales/es/knxUltimate.html

@@ -159,7 +159,8 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){
 - **event (string)**: `GroupValue_Write` / `GroupValue_Response` / `Update_NoWrite` (`Update_NoWrite` actualiza el valor interno y no envía al BUS)
 - **readstatus (boolean)**: emite una solicitud de lectura al bus (use siempre `true`: `msg.readstatus = true`)
 - **dpt (string)**: por ejemplo `1.001` (datapoint)
-- **writeraw (buffer)** + **bitlenght (int)**: envío RAW al BUS (ver ejemplo)
+- **dpt = raw**: mantiene los telegramas entrantes sin decodificar; `msg.payload` sera `null` y los bytes estaran disponibles en `msg.knx.rawValue`. Para enviar RAW use `msg.writeraw`
+- **writeraw (buffer)** + **bitlength (int)**: envio RAW al BUS (ver ejemplo); `bitlenght` sigue siendo aceptado por compatibilidad
 - **resetRBE (boolean)**: restablece filtros RBE internos (`msg.resetRBE = true`)
 - **setConfig (json)**: cambia programáticamente GA y DPT (ver detalles)
 
@@ -257,7 +258,8 @@ msg = {
 - **event (string)**: `GroupValue_Write` / `GroupValue_Response` / `Update_NoWrite`
 - **readstatus (boolean)**: solicitud de lectura al bus (`msg.readstatus = true`)
 - **dpt (string)**: por ejemplo `1.001`
-- **writeraw (buffer)** + **bitlenght (int)**: envío RAW (ver ejemplo)
+- **dpt = raw**: mantiene los telegramas entrantes sin decodificar; `msg.payload` sera `null` y los bytes estaran disponibles en `msg.knx.rawValue`. Para enviar RAW use `msg.writeraw`
+- **writeraw (buffer)** + **bitlength (int)**: envio RAW (ver ejemplo); `bitlenght` sigue siendo aceptado por compatibilidad
 - **resetRBE (boolean)**: restablece los filtros RBE (`msg.resetRBE = true`)
 - **setConfig (json)**: cambia GA y DPT (ver detalles)
 
@@ -418,7 +420,7 @@ PRECAUCIÓN: en el caso de _msg.event = "update \ _nowrite" _ Todos los nodos co
 
 Si desea emitir un comando "Leer", use "ReadStatus" en su lugar (ver más abajo). <BR/> ** msg.readstatus = true** <br/>
 Emita un comando de "leer" al bus. ** msg.dpt** <br/>
-Por ejemplo "1.001". Establece el punto de datos <b> </b>. (Puede escribirlo en estos formatos: 9, "9", "9.001" o "DPT9.001") ** msg.writeraw ** <br/>**msg.bitlenght** <br/>
+Por ejemplo "1.001". Establece el punto de datos <b> </b>. (Puede escribirlo en estos formatos: 9, "9", "9.001" o "DPT9.001") ** msg.writeraw ** <br/>**msg.bitlength** <br/>
 Escribe datos sin procesar en el bus KNX. Consulte a continuación un ejemplo. <br/> ** msg.resetrbe** <br/> pase msg.resetrbe = true a un nodo de dispositivo, para restablecer tanto el filtro de entrada como de salida RBE en ese nodo particular. <br/>
 
 <br/>
@@ -478,23 +480,23 @@ return msg;
 
 ** Enviar valor bruto al bus** <br/>
 
-Para enviar un valor de búfer en bruto al bus KNX, use el _ ** escritorw ** _ y _**bitLenght** _ Propiedades de la entrada de MSG. <br/>
+Para enviar un valor de buffer RAW al bus KNX, use las propiedades _ **writeraw** _ y _**bitlength** _ de la entrada MSG. <br/>
 En este caso, se ignorará el _datapoint_ que establece en la ventana de la propiedad. <br/>
 Softe un nodo de función frente a KNX-Ulimate y pegue su código:
 
 ```javascript
 
 // If you encode the values by yourself, you can write raw buffers with writeraw.
-// The bitlenght is necessary for datapoint types where the bitlenght does not equal the buffers bytelenght * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlenght 2) and 3 (bitlenght 4).
+// The bitlength is necessary for datapoint types where the bitlength does not equal the buffer bytelength * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlength 2) and 3 (bitlength 4).
 // Write raw buffer to a groupaddress with dpt 1 (e.g light on = value true = Buffer<01>) with a bitlength of 1
 msg.writeraw = Buffer.from('01', 'hex'); // Put '00' instead of '01' to switch off the light.
-msg.bitlenght = 1;
+msg.bitlength = 1;
 return msg;
 
 // Temperature sample (uncomment below and comment above)
 // Write raw buffer to a groupaddress with dpt 9 (e.g temperature 18.4 °C = Buffer<0730>) without bitlength
 // msg.writeraw = Buffer.from('0730', 'hex');
-// msg.bitlenght = 1;
+// msg.bitlength = 1;
 // return msg;
 
 ```

package/nodes/locales/fr/knxUltimate.html

@@ -159,7 +159,8 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){
 - **event (string)**: `GroupValue_Write` / `GroupValue_Response` / `Update_NoWrite` (`Update_NoWrite` met à jour la valeur interne et n'envoie rien au BUS)
 - **readstatus (boolean)**: demande de lecture au bus (utiliser toujours `true`: `msg.readstatus = true`)
 - **dpt (string)**: par exemple `1.001` (datapoint)
-- **writeraw (buffer)** + **bitlenght (int)**: envoi RAW au BUS (voir exemple)
+- **dpt = raw**: conserve les telegrammes entrants sans decodage ; `msg.payload` sera `null` et les octets seront disponibles dans `msg.knx.rawValue`. Pour envoyer du RAW, utilisez `msg.writeraw`
+- **writeraw (buffer)** + **bitlength (int)**: envoi RAW au BUS (voir exemple) ; `bitlenght` reste accepte pour compatibilite
 - **resetRBE (boolean)**: réinitialise les filtres RBE (`msg.resetRBE = true`)
 - **setConfig (json)**: modifier GA et DPT par message (voir détails)
 
@@ -257,7 +258,8 @@ msg = {
 - **event (string)**: `GroupValue_Write` / `GroupValue_Response` / `Update_NoWrite`
 - **readstatus (boolean)**: demande de lecture au bus (`msg.readstatus = true`)
 - **dpt (string)**: par exemple `1.001`
-- **writeraw (buffer)** + **bitlenght (int)**: envoi RAW au BUS (voir exemple)
+- **dpt = raw**: conserve les telegrammes entrants sans decodage ; `msg.payload` sera `null` et les octets seront disponibles dans `msg.knx.rawValue`. Pour envoyer du RAW, utilisez `msg.writeraw`
+- **writeraw (buffer)** + **bitlength (int)**: envoi RAW au BUS (voir exemple) ; `bitlenght` reste accepte pour compatibilite
 - **resetRBE (boolean)**: réinitialise les filtres RBE (`msg.resetRBE = true`)
 - **setConfig (json)**: modifier GA et DPT (voir détails)
 
@@ -418,7 +420,7 @@ ATTENTION: Dans le cas de _msg.event = "Update \ _Nowrite" _ Tous les nœuds ave
 
 Si vous souhaitez émettre une commande "lire", veuillez utiliser "ReadStatus" à la place (voir ci-dessous). <br/> ** msg.readstatus = true** <br/>
 Émettez une commande "lire" au bus. ** msg.dpt** <br/>
-Par exemple "1.001". Définit le <b> datapoint </b>. (Vous pouvez l'écrire dans ces formats: 9, "9", "9.001" ou "DPT9.001") ** msg.writeraw ** <br/>**msg.bitlenght** <br/>
+Par exemple "1.001". Définit le <b> datapoint </b>. (Vous pouvez l'écrire dans ces formats: 9, "9", "9.001" ou "DPT9.001") ** msg.writeraw ** <br/>**msg.bitlength** <br/>
 Écrit des données brutes au bus KNX. Veuillez voir ci-dessous un exemple. <br/> ** MSG.RESETRBE** <BR/> PASS MSG.RESETRBE = VRAI À un nœud de périphérique, pour réinitialiser à la fois l'entrée et la sortie du filtre RBE sur ce nœud particulier. <br/>
 
 <br/>
@@ -478,23 +480,23 @@ return msg;
 
 **Envoyez la valeur brute au bus** <br/>
 
-Pour envoyer une valeur de tampon brute au bus KNX, utilisez les propriétés _ ** writerraw ** _ et _**bitlenght** _ de l'entrée msg. <br/>
+Pour envoyer une valeur RAW au bus KNX, utilisez les proprietes _ **writeraw** _ et _**bitlength** _ de l'entree msg. <br/>
 Dans ce cas, le _datapoint_ que vous définissez dans la fenêtre de propriété sera ignoré. <br/>
 Grapez un nœud de fonction devant KNX-ultime et collez son code:
 
 ```javascript
 
 // If you encode the values by yourself, you can write raw buffers with writeraw.
-// The bitlenght is necessary for datapoint types where the bitlenght does not equal the buffers bytelenght * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlenght 2) and 3 (bitlenght 4).
+// The bitlength is necessary for datapoint types where the bitlength does not equal the buffer bytelength * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlength 2) and 3 (bitlength 4).
 // Write raw buffer to a groupaddress with dpt 1 (e.g light on = value true = Buffer<01>) with a bitlength of 1
 msg.writeraw = Buffer.from('01', 'hex'); // Put '00' instead of '01' to switch off the light.
-msg.bitlenght = 1;
+msg.bitlength = 1;
 return msg;
 
 // Temperature sample (uncomment below and comment above)
 // Write raw buffer to a groupaddress with dpt 9 (e.g temperature 18.4 °C = Buffer<0730>) without bitlength
 // msg.writeraw = Buffer.from('0730', 'hex');
-// msg.bitlenght = 1;
+// msg.bitlength = 1;
 // return msg;
 
 ```

package/nodes/locales/it/knxUltimate.html

@@ -141,7 +141,7 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){
 - **event (string)**: `GroupValue_Write` (scrive sul BUS), `GroupValue_Response` (risponde sul BUS), `Update_NoWrite` (non invia al BUS, aggiorna solo il valore interno del nodo)
 - **readstatus (boolean)**: invia un "Read" al BUS (usa sempre `true`)
 - **dpt (string)**: per es. `1.001` (imposta il Datapoint)
-- **writeraw (buffer)** + **bitlenght (int)**: invio RAW verso il BUS (vedi esempio); `bitlenght` è la lunghezza in bit del dato RAW
+- **writeraw (buffer)** + **bitlength (int)**: invio RAW verso il BUS (vedi esempio); `bitlength` è la lunghezza in bit del dato RAW (`bitlenght` resta accettato per retrocompatibilità)
 - **resetRBE (boolean)**: resetta i filtri RBE interni (`msg.resetRBE = true`)
 - **setConfig (json)**: cambia via msg il GA e il DPT del nodo (vedi sotto)
 
@@ -230,7 +230,8 @@ Se vuoi emettere un "read”, usa `msg.readstatus = true`.
 
 - **msg.readstatus = true**: emette un comando di lettura verso il BUS
 - **msg.dpt**: per es. `1.001` (accetta anche `9`, `"9"`, `"DPT9.001"`)
-- **msg.writeraw** + **msg.bitlenght**: invio RAW al BUS (vedi esempio sotto); se usi `writeraw`, il DPT impostato nel nodo viene ignorato
+- **msg.dpt = raw**: lascia i telegrammi in ingresso non decodificati; `msg.payload` sara' `null` e i byte saranno disponibili in `msg.knx.rawValue`. Per inviare RAW usa `msg.writeraw`
+- **msg.writeraw** + **msg.bitlength**: invio RAW al BUS (vedi esempio sotto); se usi `writeraw`, il DPT impostato nel nodo viene ignorato
 - **msg.resetRBE = true**: resetta i filtri RBE di input e output del nodo
 
 ## Cambiare la configurazione via msg
@@ -285,7 +286,7 @@ Inserisci un function node prima del nodo KNX-Ultimate e usa questo codice:
 
 // Esempio DPT 1: luce ON = Buffer<01> con bitlength = 1
 msg.writeraw = Buffer.from('01', 'hex');
-msg.bitlenght = 1;
+msg.bitlength = 1;
 return msg;
 
 // Esempio temperatura (DPT 9): 18.4 °C = Buffer<0730>

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

@@ -112,7 +112,7 @@ if (msg.payload === false && getGAValue('0/0/11','1.001') === false){ return; }
 - **event (string)**：`GroupValue_Write` / `GroupValue_Response` / `Update_NoWrite`（`Update_NoWrite` 仅更新内部值，不发送）
 - **readstatus (boolean)**：向总线发起读取（使用 `msg.readstatus = true`）
 - **dpt (string)**：如 `1.001`
-- **writeraw (buffer)** + **bitlenght (int)**：发送 RAW，`bitlenght` 为比特长度
+- **writeraw (buffer)** + **bitlength (int)**：发送 RAW，`bitlength` 为比特长度（为兼容旧流程，`bitlenght` 仍然可用）
 - **resetRBE (boolean)**：重置内部 RBE 过滤（`msg.resetRBE = true`）
 - **setConfig (json)**：通过消息修改节点的 GA 与 DPT
 
@@ -181,7 +181,8 @@ msg = {
 
 - **msg.readstatus = true**：向总线发起读取
 - **msg.dpt**：如 `1.001`（也接受 `9`、`"9"`、`"DPT9.001"`）
-- **msg.writeraw** + **msg.bitlenght**：发送 RAW；会忽略节点上设置的 DPT
+- **msg.dpt = raw**：保持收到的报文不做解码；`msg.payload` 将为 `null`，原始字节可在 `msg.knx.rawValue` 中获取。发送 RAW 时请使用 `msg.writeraw`
+- **msg.writeraw** + **msg.bitlength**：发送 RAW；会忽略节点上设置的 DPT
 - **msg.resetRBE = true**：重置 RBE 过滤
 
 ## 通过消息修改配置
@@ -229,7 +230,7 @@ msg.readstatus = true; return msg;
 
 // DPT1 示例：开灯 = Buffer<01>，bitlength = 1
 msg.writeraw = Buffer.from('01','hex');
-msg.bitlenght = 1; return msg;
+msg.bitlength = 1; return msg;
 // 温度（DPT9）示例：18.4 °C = <0730>
 // msg.writeraw = Buffer.from('0730','hex'); return msg;
 ```