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

package/CHANGELOG.md

@@ -6,6 +6,19 @@
 
 # CHANGELOG
 
+**Version 4.3.5** - April 2026<br/>
+
+- NEW: **KNX DEVICE** now supports explicit **`dpt = raw`** mode for incoming telegrams: decoding is skipped, `msg.payload` is `null`, and raw bytes remain available in `msg.knx.rawValue`.<br/>
+- FIX: **KNX DEVICE RAW write** now accepts both **`msg.bitlength`** and legacy **`msg.bitlenght`**, with `bitlength` preferred and old flows kept backward compatible.<br/>
+- CHANGE: **KNX DEVICE** in **`dpt = raw`** mode now accepts raw outgoing telegrams only via **`msg.writeraw`**, preventing accidental normal writes with an invalid datapoint.<br/>
+- Docs/help/wiki: updated **KNX DEVICE** help HTML and **Device** wiki pages in all supported languages (**EN/IT/DE/FR/ES/zh-CN**) to document **raw mode** and the preferred **`bitlength`** property.<br/>
+
+**Version 4.3.4** - April 2026<br/>
+
+- UI: **KNX Function** editor areas now have colored backgrounds (light green for *input→bus*, light yellow for *bus→output*) for easier visual distinction.<br/>
+- UI: **KNX Function** Monaco editor no longer shows red underlines for custom KNX functions (`getGAValue`, `setGAValue`, `toggle`, `self`).<br/>
+- NEW: **KNX Function** : **`let val = await getGAValue(...)`** now automatically sends a `GroupValue_Read` to the KNX bus when the requested group address has no cached value yet, and waits up to 3 seconds for the device to respond before returning `null`. Use `await getGAValue(...)` in your KNX Function code to benefit from this behaviour.<br/>
+
 **Version 4.3.3** - April 2026<br/>
 
 - UI: in the **KNX Function helper**, the **Search GA** field is now always visible; if the ETS CSV is not imported, the field is disabled and shows `To enable the search, IMPORT THE ETS FILE`.<br/>

package/nodes/knxUltimate-config.js

@@ -2066,6 +2066,8 @@ module.exports = (RED) => {
         }
       }
 
+      const isRawMode = typeof _inputDpt === 'string' && _inputDpt.trim().toLowerCase() === 'raw'
+
       const errorMessage = {
         topic: _outputtopic,
         payload: 'UNKNOWN, PLEASE IMPORT THE ETS FILE!',
@@ -2088,83 +2090,18 @@ module.exports = (RED) => {
 
       // Resolve DPT and convert value if available
       if (_Rawvalue !== null) {
-        try {
-          sInputDpt = _inputDpt === null ? tryToFigureOutDataPointFromRawValue(_Rawvalue) : _inputDpt
-        } catch (error) {
-          // Here comes if no datapoint has beeen found
-          node.sysLogger?.error(
-            'buildInputMessage: Error returning from tryToFigureOutDataPointFromRawValue. Device ' +
-            _srcGA +
-            ' Destination ' +
-            _destGA +
-            ' Event ' +
-            _event +
-            " GA's Datapoint " +
-            (_inputDpt === null
-              ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
-              : _inputDpt) +
-            ' Devicename ' +
-            _devicename +
-            ' Topic ' +
-            _outputtopic +
-            ' ' +
-            error.message
-          )
-          errorMessage.payload = 'UNKNOWN: ERROR tryToFigureOutDataPointFromRawValue:' + error.message
-          return errorMessage
-        }
-
-        try {
-          var dpt = dptlib.resolve(sInputDpt)
-        } catch (error) {
-          node.sysLogger?.error(
-            'buildInputMessage: Error returning from dptlib.resolve(sInputDpt). Device ' +
-            _srcGA +
-            ' Destination ' +
-            _destGA +
-            ' Event ' +
-            _event +
-            " GA's Datapoint " +
-            (_inputDpt === null
-              ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
-              : _inputDpt) +
-            ' Devicename ' +
-            _devicename +
-            ' Topic ' +
-            _outputtopic +
-            ' ' +
-            error.message
-          )
-          errorMessage.payload = 'UNKNOWN: ERROR dptlib.resolve:' + error.messages
-          return errorMessage
-        }
-
-        if (dpt !== null && _Rawvalue !== null) {
+        if (isRawMode) {
+          sInputDpt = 'raw'
+          sPayloadmeasureunit = ''
+          sDptdesc = 'Raw value'
+          sPayloadsubtypevalue = ''
+        } else {
           try {
-            jsValue = dptlib.fromBuffer(_Rawvalue, dpt)
-            if (jsValue === null) {
-              node.sysLogger?.warn(
-                'buildInputMessage: received a wrong datagram form KNX BUS, from device ' +
-                _srcGA +
-                ' Destination ' +
-                _destGA +
-                ' Event ' +
-                _event +
-                " GA's Datapoint " +
-                (_inputDpt === null
-                  ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
-                  : _inputDpt) +
-                ' Devicename ' +
-                _devicename +
-                ' Topic ' +
-                _outputtopic +
-                ' NodeID ' +
-                _oNode.id || ''
-              )
-            }
+            sInputDpt = _inputDpt === null ? tryToFigureOutDataPointFromRawValue(_Rawvalue) : _inputDpt
           } catch (error) {
+            // Here comes if no datapoint has beeen found
             node.sysLogger?.error(
-              'buildInputMessage: Error returning from DPT decoding. Device ' +
+              'buildInputMessage: Error returning from tryToFigureOutDataPointFromRawValue. Device ' +
               _srcGA +
               ' Destination ' +
               _destGA +
@@ -2179,34 +2116,112 @@ module.exports = (RED) => {
               ' Topic ' +
               _outputtopic +
               ' ' +
-              error.message +
-              ' NodeID ' +
-              _oNode.id || ''
+              error.message
             )
-            errorMessage.payload = 'UNKNOWN: ERROR dptlib.fromBuffer:' + error.stack
+            errorMessage.payload = 'UNKNOWN: ERROR tryToFigureOutDataPointFromRawValue:' + error.message
             return errorMessage
           }
-        }
 
-        // 19/01/2023 FORMATTING THE OUTPUT PAYLOAD (ROUND, ETC) BASED ON THE NODE CONFIG
-        //* ********************************************************
-        jsValue = payloadRounder.Manipulate(_oNode, jsValue)
-        //* ********************************************************
+          try {
+            var dpt = dptlib.resolve(sInputDpt)
+          } catch (error) {
+            node.sysLogger?.error(
+              'buildInputMessage: Error returning from dptlib.resolve(sInputDpt). Device ' +
+              _srcGA +
+              ' Destination ' +
+              _destGA +
+              ' Event ' +
+              _event +
+              " GA's Datapoint " +
+              (_inputDpt === null
+                ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
+                : _inputDpt) +
+              ' Devicename ' +
+              _devicename +
+              ' Topic ' +
+              _outputtopic +
+              ' ' +
+              error.message
+            )
+            errorMessage.payload = 'UNKNOWN: ERROR dptlib.resolve:' + error.messages
+            return errorMessage
+          }
 
-        if (dpt.subtype !== undefined) {
-          sPayloadmeasureunit = dpt.subtype.unit !== undefined ? dpt.subtype.unit : 'unknown'
-          sDptdesc = dpt.subtype.desc !== undefined ? dpt.subtype.desc.charAt(0).toUpperCase() + dpt.subtype.desc.slice(1) : 'unknown'
-          if (dpt.subtype.enc !== undefined) {
+          if (dpt !== null && _Rawvalue !== null) {
             try {
-              if (!jsValue) sPayloadsubtypevalue = dpt.subtype.enc[0]
-              if (jsValue) sPayloadsubtypevalue = dpt.subtype.enc[1]
+              jsValue = dptlib.fromBuffer(_Rawvalue, dpt)
+              if (jsValue === null) {
+                node.sysLogger?.warn(
+                  'buildInputMessage: received a wrong datagram form KNX BUS, from device ' +
+                  _srcGA +
+                  ' Destination ' +
+                  _destGA +
+                  ' Event ' +
+                  _event +
+                  " GA's Datapoint " +
+                  (_inputDpt === null
+                    ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
+                    : _inputDpt) +
+                  ' Devicename ' +
+                  _devicename +
+                  ' Topic ' +
+                  _outputtopic +
+                  ' NodeID ' +
+                  _oNode.id || ''
+                )
+              }
             } catch (error) {
-              // Don't care
+              node.sysLogger?.error(
+                'buildInputMessage: Error returning from DPT decoding. Device ' +
+                _srcGA +
+                ' Destination ' +
+                _destGA +
+                ' Event ' +
+                _event +
+                " GA's Datapoint " +
+                (_inputDpt === null
+                  ? "THE ETS FILE HAS NOT BEEN IMPORTED, SO I'M TRYING TO FIGURE OUT WHAT DATAPOINT BELONGS THIS GROUP ADDRESS. DON'T BLAME ME IF I'M WRONG, INSTEAD, IMPORT THE ETS FILE!"
+                  : _inputDpt) +
+                ' Devicename ' +
+                _devicename +
+                ' Topic ' +
+                _outputtopic +
+                ' ' +
+                error.message +
+                ' NodeID ' +
+                _oNode.id || ''
+              )
+              errorMessage.payload = 'UNKNOWN: ERROR dptlib.fromBuffer:' + error.stack
+              return errorMessage
+            }
+          }
+
+          // 19/01/2023 FORMATTING THE OUTPUT PAYLOAD (ROUND, ETC) BASED ON THE NODE CONFIG
+          //* ********************************************************
+          jsValue = payloadRounder.Manipulate(_oNode, jsValue)
+          //* ********************************************************
+
+          if (dpt.subtype !== undefined) {
+            sPayloadmeasureunit = dpt.subtype.unit !== undefined ? dpt.subtype.unit : 'unknown'
+            sDptdesc = dpt.subtype.desc !== undefined ? dpt.subtype.desc.charAt(0).toUpperCase() + dpt.subtype.desc.slice(1) : 'unknown'
+            if (dpt.subtype.enc !== undefined) {
+              try {
+                if (!jsValue) sPayloadsubtypevalue = dpt.subtype.enc[0]
+                if (jsValue) sPayloadsubtypevalue = dpt.subtype.enc[1]
+              } catch (error) {
+                // Don't care
+              }
             }
           }
         }
       } else {
         // Don't care, it's a READ REQUEST
+        if (isRawMode) {
+          sInputDpt = 'raw'
+          sPayloadmeasureunit = ''
+          sDptdesc = 'Raw value'
+          sPayloadsubtypevalue = ''
+        }
       }
 
       try {

package/nodes/knxUltimate.html

@@ -1,5 +1,25 @@
 <!-- <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/jquery.searchableSelect.js"></script> -->
 
+<style>
+/* Monaco editor - first area (input to bus): light green */
+#sendMsgToKNXCode-editor .monaco-editor,
+#sendMsgToKNXCode-editor .monaco-editor-background,
+#sendMsgToKNXCode-editor .monaco-editor .margin,
+#sendMsgToKNXCode-editor .monaco-editor .overflow-guard,
+#sendMsgToKNXCode-editor .monaco-editor .lines-content,
+#sendMsgToKNXCode-editor .monaco-editor .editor-scrollable {
+    background-color: #e8f5e9 !important;
+}
+/* Monaco editor - second area (bus to output): light yellow */
+#receiveMsgFromKNXCode-editor .monaco-editor,
+#receiveMsgFromKNXCode-editor .monaco-editor-background,
+#receiveMsgFromKNXCode-editor .monaco-editor .margin,
+#receiveMsgFromKNXCode-editor .monaco-editor .overflow-guard,
+#receiveMsgFromKNXCode-editor .monaco-editor .lines-content,
+#receiveMsgFromKNXCode-editor .monaco-editor .editor-scrollable {
+    background-color: #fffde7 !important;
+}
+</style>
 
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/htmlUtils.js"></script>
 <script type="text/javascript" src="resources/node-red-contrib-knx-ultimate/KNXSendSnippets.js"></script>
@@ -225,6 +245,15 @@
                 }
             ];
             const globalScope = typeof window !== 'undefined' ? window : (typeof globalThis !== 'undefined' ? globalThis : {});
+            const rawDptOption = { value: 'raw', text: 'raw Raw telegram (no decode)' }
+
+            function appendRawDptOption($select) {
+                if (!$select || !$select.length) return
+                if ($select.find("option[value='raw']").length > 0) return
+                $select.prepend($("<option></option>")
+                    .attr("value", rawDptOption.value)
+                    .text(rawDptOption.text))
+            }
 
             function knxUltimateDptsGetHelp(_dpt, _forceClose) {
                 const detailsContainer = $("#dptDetailsContainer")
@@ -233,6 +262,39 @@
                 }
                 const serverId = $("#node-input-server").val()
                 if (serverId === "_ADD_" || serverId === '' || _dpt === null || _dpt === '') return
+                if (String(_dpt).trim().toLowerCase() === 'raw') {
+                    const helplinkContainer = $("#sampleCodeEditor")
+                    try {
+                        if (node.sampleEditor) {
+                            node.sampleEditor.destroy()
+                            delete node.sampleEditor
+                        }
+                    } catch (error) { }
+                    $("#example-editor").empty()
+                    helplinkContainer.empty()
+                    node.sampleEditor = RED.editor.createEditor({
+                        id: 'example-editor',
+                        mode: 'ace/mode/javascript',
+                        value: `// KNX-Ultimate set as RAW NODE
+// Incoming telegrams skip datapoint decoding.
+// msg.payload will be null and the raw telegram bytes are available in msg.knx.rawValue.
+// For outgoing telegrams, use msg.writeraw = Buffer.from("0730", "hex")
+// and optionally msg.bitlength for 1-bit / 2-bit / 4-bit datapoints.
+return msg;`
+                    })
+                    try {
+                        node.sampleEditor.setReadOnly(true)
+                        node.sampleEditor.setShowPrintMargin(false)
+                    } catch (error) { }
+                    $("<div>", {
+                        class: "dpt-details-link"
+                    })
+                        .append($("<span>").text("RAW mode keeps the telegram undecoded and exposes the bytes in "))
+                        .append($("<code>").text("msg.knx.rawValue"))
+                        .append($("<span>").text("."))
+                        .appendTo(helplinkContainer)
+                    return
+                }
                 $.getJSON("knxUltimateDptsGetHelp?dpt=" + _dpt + "&serverId=" + serverId + "&" + { _: new Date().getTime() }, (data) => {
                     const helplinkContainer = $("#sampleCodeEditor")
                     try {
@@ -336,15 +398,29 @@
                     }
                     if (typeof monaco !== 'undefined' && !globalScope.knxFunctionMonacoCompletionProvider) {
                         try {
-                            const suggestions = knxFunctionHelperItems.map(item => ({
+                            const functionSuggestions = knxFunctionHelperItems.map(item => ({
                                 label: item.label,
                                 kind: monaco.languages.CompletionItemKind.Function,
                                 insertText: item.snippet,
                                 insertTextRules: monaco.languages.CompletionItemInsertTextRule.InsertAsSnippet,
                                 documentation: item.doc
                             }));
+
                             globalScope.knxFunctionMonacoCompletionProvider = monaco.languages.registerCompletionItemProvider('javascript', {
-                                provideCompletionItems: () => ({ suggestions })
+                                provideCompletionItems: () => ({ suggestions: functionSuggestions })
+                            });
+
+                            monaco.languages.typescript.javascriptDefaults.addExtraLib([
+                                '/** Read the cached value of a KNX group address. */',
+                                'declare function getGAValue(address: string, dpt?: string): any;',
+                                '/** Send a value to a KNX group address. */',
+                                'declare function setGAValue(address: string, value: any, dpt?: string): void;',
+                                '/** Toggle (invert) this node\'s current value on the KNX bus. */',
+                                'declare function toggle(): void;',
+                            ].join('\n'), 'knx-ultimate-globals.d.ts');
+                            monaco.languages.typescript.javascriptDefaults.setDiagnosticsOptions({
+                                noSemanticValidation: true,
+                                noSyntaxValidation: false
                             });
                         } catch (error) { }
                     }
@@ -499,6 +575,27 @@
                 value: node.receiveMsgFromKNXCode
             });
             applyEditorOptions(node.receiveMsgFromKNXCodeEditor);
+            if (typeof monaco !== 'undefined') {
+                try {
+                    if (!globalScope._knxEditorThemesDefined) {
+                        monaco.editor.defineTheme('knx-send-theme', {
+                            base: 'vs', inherit: true, rules: [],
+                            colors: { 'editor.background': '#e8f5e9', 'editorGutter.background': '#e8f5e9' }
+                        });
+                        monaco.editor.defineTheme('knx-receive-theme', {
+                            base: 'vs', inherit: true, rules: [],
+                            colors: { 'editor.background': '#fffde7', 'editorGutter.background': '#fffde7' }
+                        });
+                        globalScope._knxEditorThemesDefined = true;
+                    }
+                    if (typeof node.sendMsgToKNXCodeEditor.updateOptions === 'function') {
+                        node.sendMsgToKNXCodeEditor.updateOptions({ theme: 'knx-send-theme' });
+                    }
+                    if (typeof node.receiveMsgFromKNXCodeEditor.updateOptions === 'function') {
+                        node.receiveMsgFromKNXCodeEditor.updateOptions({ theme: 'knx-receive-theme' });
+                    }
+                } catch (e) { }
+            }
             node.activeCodeEditor = null;
             attachFocusHandlers(node.sendMsgToKNXCodeEditor);
             attachFocusHandlers(node.receiveMsgFromKNXCodeEditor);
@@ -666,11 +763,13 @@
                         refreshSecureGAs();
                         $.getJSON("knxUltimateDpts?serverId=" + $("#node-input-server").val() + "&_=" + new Date().getTime(), (data) => {
                             $("#node-input-dpt").empty();
+                            appendRawDptOption($("#node-input-dpt"));
                             data.forEach(dpt => {
                                 $("#node-input-dpt").append($("<option></option>")
                                     .attr("value", dpt.value)
                                     .text(dpt.text))
                             });
+                            if (node.dpt === undefined || node.dpt === '') node.dpt = '1.001'
                             $("#node-input-dpt").val(node.dpt);
                             // Load help sample
                             knxUltimateDptsGetHelp(node.dpt, true);

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;
 ```

package/package.json

@@ -3,7 +3,7 @@
   "engines": {
     "node": ">=20.18.1"
   },
-  "version": "4.3.3",
+  "version": "4.3.5",
   "description": "Control your KNX and KNX Secure intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control, ETS group address importer, and KNX routing between interfaces. Easy to use and highly configurable.",
   "files": [
     "nodes/",