node-red-contrib-knx-ultimate 4.3.21 → 4.3.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -6,6 +6,14 @@
6
6
 
7
7
  # CHANGELOG
8
8
 
9
+ **Version 4.3.23** - June 2026<br/>
10
+
11
+ - Hue nodes: fixed the **help text** not appearing in the editor sidebar when selecting a node. The help is now declared inline in each node's main HTML file (sidebar reads help from there; the `locales/` files keep providing translations). Affected nodes: Light/Outlet, Area Motion, Battery, Button, Contact Sensor, Light Sensor, Motion, Scene, Tap Dial, Temperature Sensor, Zigbee Connectivity and Device Software Update. Also closed an unterminated template `<script>` tag in the Hue Light node.<br/>
12
+
13
+ **Version 4.3.22** - June 2026<br/>
14
+
15
+ - Hue config node: when the user clicks **"I already have the credentials"** to enter the connection data manually, the now-useless **CONNECT** button is hidden.<br/>
16
+
9
17
  **Version 4.3.21** - June 2026<br/>
10
18
 
11
19
  - KNXUltimate engine: updated to 5.5.9.<br/>
@@ -112,6 +112,7 @@
112
112
  if ($clientKeyInput.val() === "_PWRD_") $clientKeyInput.val("");
113
113
  try { $usernameInput.focus(); } catch (e) { }
114
114
  $manualCredentialsButton.hide();
115
+ $("#getinfocam").hide();
115
116
  });
116
117
  }
117
118
 
@@ -598,3 +598,40 @@
598
598
 
599
599
  <input type="hidden" id="node-input-hueDevice">
600
600
  </script>
601
+
602
+
603
+ <script type="text/markdown" data-help-name="knxUltimateHueAreaMotion">
604
+ <p>The Hue Motion Area node listens to MotionAware area motion events (Hue Bridge Pro) and mirrors the aggregated detected/not-detected state to KNX or your Node-RED flow.</p>
605
+
606
+ Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.
607
+
608
+ **General**
609
+
610
+ |Property|Description|
611
+ |--|--|
612
+ | KNX GW | Select the KNX gateway to be used. |
613
+ | HUE Bridge | Select the Hue Bridge Pro to be used. |
614
+ | HUE Area | MotionAware area (convenience or security) to monitor (autocomplete while typing). |
615
+ | Read status at startup | On startup/reconnect, read the current value and send it to KNX (default: yes). |
616
+
617
+ **Mapping**
618
+
619
+ |Property|Description|
620
+ |--|--|
621
+ | Motion | KNX GA for the area motion state (boolean). Recommended DPT: <b>1.001</b>. |
622
+
623
+ **Behaviour**
624
+
625
+ |Property|Description|
626
+ |--|--|
627
+ | Node output pin | Show or hide the Node-RED output. When no KNX gateway is selected the output pin stays enabled so MotionAware events still reach your flow. |
628
+
629
+ ### Outputs
630
+
631
+ 1. Standard output
632
+ : `msg.payload` (boolean): `true` when motion is detected in the area, otherwise `false`.
633
+
634
+ ### Details
635
+
636
+ `msg.payload` carries the latest MotionAware area motion status (aggregated from the underlying sensors).
637
+ </script>
@@ -581,3 +581,33 @@
581
581
 
582
582
  <input type="hidden" id="node-input-hueDevice">
583
583
  </script>
584
+
585
+
586
+ <script type="text/markdown" data-help-name="knxUltimateHueBattery">
587
+ <p>This node exposes the battery level of a Hue device to KNX and raises an event whenever the value changes.</p>
588
+
589
+ Start typing the KNX device name or Group Address in the GA field; matching entries appear while you type. Use the refresh icon next to <q>Hue sensor</q> to reload the list from the Hue bridge after adding new devices.
590
+
591
+ **General**
592
+
593
+ |Property|Description|
594
+ |--|--|
595
+ | KNX GW | KNX gateway used to publish the battery level (required before KNX mapping fields appear). |
596
+ | Hue Bridge | Hue Bridge that hosts the device. |
597
+ | Hue battery sensor | Hue device/sensor providing the battery level (supports autocomplete and refresh). |
598
+
599
+ **Mapping**
600
+
601
+ |Property|Description|
602
+ |--|--|
603
+ | Level | KNX GA for the battery percentage (0-100%). Recommended DPT: <b>5.001</b>. |
604
+
605
+ **Behaviour**
606
+
607
+ |Property|Description|
608
+ |--|--|
609
+ | Read status at startup | On deploy/reconnect read the current battery value and publish it to KNX. Default: "yes”. |
610
+ | Node output pin | Show or hide the Node-RED output. When no KNX gateway is selected the output stays enabled so Hue events continue to reach the flow. |
611
+
612
+ > ℹ️ KNX mapping widgets remain hidden until a KNX gateway is selected. This keeps the editor tidy when the node is used only to forward Hue events into Node-RED.
613
+ </script>
@@ -724,3 +724,48 @@
724
724
 
725
725
  <input type="hidden" id="node-input-hueDevice">
726
726
  </script>
727
+
728
+
729
+ <script type="text/markdown" data-help-name="knxUltimateHueButton">
730
+ <p>The Hue Button node maps Hue button events to KNX group addresses and exposes the same events on its flow output via <code>button.button_report.event</code>.</p>
731
+
732
+ Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.
733
+
734
+ **General**
735
+
736
+ |Property|Description|
737
+ |--|--|
738
+ | KNX GW | Select the KNX gateway to be used |
739
+ | Hue Bridge | Select the Hue Bridge to be used |
740
+ | Hue Button | Hue button to be used (autocomplete while typing) |
741
+
742
+ **Switch**
743
+
744
+ |Property|Description|
745
+ |--|--|
746
+ | Switch | GA triggered by <code>short\_release</code> (quick press/release). |
747
+ | Status GA | Optional feedback GA when <em>Toggle values</em> is enabled to keep the internal toggle state aligned with other actuators. |
748
+
749
+ **Dim**
750
+
751
+ |Property|Description|
752
+ |--|--|
753
+ | Dim | GA used during <code>long\_press</code>/<code>repeat</code> events for dimming (typically DPT 3.007). |
754
+
755
+ **Behaviour**
756
+
757
+ |Property|Description|
758
+ |--|--|
759
+ | Toggle values on each event | If enabled, the node alternates between <code>true/false</code> and up/down dimming payloads. |
760
+ | Switch payload | Payload sent to KNX/flow when Toggle values is disabled. |
761
+ | Dim payload | Direction sent to KNX/flow when Toggle values is disabled. |
762
+
763
+ ### Outputs
764
+
765
+ 1. Standard output
766
+ : `msg.payload` carries the boolean (or dim object) sent to KNX; `msg.event` is the Hue event string (e.g. `short_release`, `repeat`).
767
+
768
+ ### Details
769
+
770
+ `msg.event` mirrors `button.button_report.event`. The original Hue event is exposed in `msg.rawEvent`. Use the optional Status GA to keep the toggle state in sync with wall switches or other controllers.
771
+ </script>
@@ -546,3 +546,31 @@
546
546
 
547
547
  <input type="hidden" id="node-input-hueDevice">
548
548
  </script>
549
+
550
+
551
+ <script type="text/markdown" data-help-name="knxUltimateHueContactSensor">
552
+ <p>This node forwards events from a Hue contact sensor and maps them to KNX group addresses.</p>
553
+
554
+ Start typing in the GA field, the name or group address of your KNX device, the avaiable devices start showing up while you're typing.
555
+
556
+ **General**
557
+
558
+ |Property|Description|
559
+ |--|--|
560
+ | KNX GW | Select the KNX gateway to be used |
561
+ | Hue Bridge | Select the Hue Bridge to be used |
562
+ | Hue Contact Sensor | Hue contact sensor to be used (autocomplete while typing).|
563
+
564
+ | Property | Description |
565
+ |--|--|
566
+ | Contact | When the contact opens/closes, send KNX value: _true_ on active/open, otherwise _false_. |
567
+
568
+ ### Outputs
569
+
570
+ 1. Standard output
571
+ : payload (boolean) : the standard output of the command.
572
+
573
+ ### Details
574
+
575
+ `msg.payload` carries the raw Hue event (boolean/object). Use it for custom logic if needed.
576
+ </script>
@@ -2367,3 +2367,121 @@
2367
2367
  </div>
2368
2368
  </div>
2369
2369
  <br />
2370
+ </script>
2371
+
2372
+
2373
+ <script type="text/markdown" data-help-name="knxUltimateHueLight">
2374
+ <p>This node controls Philips Hue lights (single or grouped) and maps their commands/states to KNX.</p>
2375
+
2376
+ **General**
2377
+
2378
+ |Property|Description|
2379
+ |--|--|
2380
+ | KNX GW | Select the KNX gateway to be used |
2381
+ | Hue Bridge | Select the Hue Bridge to be used |
2382
+ | Name | Hue light or grouped light to use (autocomplete while typing).|
2383
+
2384
+ <br/>
2385
+
2386
+ **Locate device**
2387
+
2388
+ Use the `Locate` button (play icon) to start a Hue identify session for the selected resource. While the session is active the button switches to a stop icon and the bridge makes the light — or every light in the grouped resource — blink once per second. Press the button again to stop immediately; otherwise the session ends automatically after 10 minutes.
2389
+
2390
+ <br/>
2391
+
2392
+ **OPTIONS**
2393
+
2394
+ Here you can link KNX Group Addresses to the available Hue commands/states.<br/>
2395
+ Start typing in the GA field (name or Group Address); suggestions appear while you type.
2396
+
2397
+ **Switch**
2398
+
2399
+ |Property|Description|
2400
+ |--|--|
2401
+ | Control | This GA is used to turn on/off the Hue light via a boolean KNX value true/false|
2402
+ | Status | Link this to the light's switch status group address|
2403
+
2404
+ <br/>
2405
+
2406
+ **Dim**
2407
+
2408
+ |Property|Description|
2409
+ |--|--|
2410
+ | Control dim | Relative DIM of the Hue light. You can set the dimming speed in the **Behaviour** tab. |
2411
+ | Control % | Changes the absolute Hue light's brightness (0-100%)|
2412
+ | Status % | Link this to the light's brightness status KNX group address |
2413
+ | Dim Speed (ms) | Dimming speed in milliseconds. Applies to both the light brightness and the tunable-white datapoints. Calculated over the 0%→100% range. |
2414
+ | Min Dim brightness | Tha Minimum brightness that the lamp can reach. For example, if you are dimming the light down, the light will stop dimming at the specified brightness %. |
2415
+ | Max Dim brightness | Tha Maximum brightness that the lamp can reach. For example, if you are dimming the light up, the light will stop dimming at the specified brightness %. |
2416
+
2417
+ <br/>
2418
+
2419
+ **Tunable White**
2420
+
2421
+ |Property|Description|
2422
+ |--|--|
2423
+ | Control dim | Change white temperature using DPT 3.007 dimming. Speed is set in the **Behaviour** tab.|
2424
+ | Control % | Change white temperature using DPT 5.001. 0 = full warm, 100 = full cold.|
2425
+ | Status %| Temperature status GA. DPT 5.001 absolute value: 0 = full warm, 100 = full cold.|
2426
+ | Control kelvin | **DPT 7.600: ** set temperature in Kelvin using the KNX range 2000-6535 (converted to Hue mirek).<br/>**DPT 9.002:** set temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations.|
2427
+ | Status kelvin | **DPT 7.600: ** read temperature in Kelvin using KNX range 2000-6535 (converted from Hue).<br/>**DPT 9.002:** read temperature using Hue range 2000-6535 K (Ambiance starts at 2200 K). Conversions may introduce small deviations. |
2428
+ | Invert dim direction | Inverts the DIM direction. |
2429
+ <br/>
2430
+
2431
+ **RGB/HSV**
2432
+
2433
+ |Property|Description|
2434
+ |--|--|
2435
+ | **RGB section** ||
2436
+ | Control rgb| Change color using RGB triplet (r,g,b). Gamut correction is handled. Sending a color turns the light on and sets color/brightness (perceptual). Sending r,g,b = 0 turns the light off. |
2437
+ | Status rgb | The light's color status group address. Accepted datapoint is RGB triplet (r,g,b)|
2438
+ | **HSV section** ||
2439
+ | Color H dim | Cycle through HSV hue using DPT 3.007 dimming. Speed is set in the **Behaviour** tab.|
2440
+ | Status H %| Status of the HSV chromatic circle.|
2441
+ | Control S dim | Changes the light's color saturation, using DPT 3.007 dimming. You can set the dimming speed in the **_Behaviour_** tab.|
2442
+ | Status S %| The light color saturation status group address.|
2443
+ | Dim Speed (ms) | The dimming speed, in Milliseconds, from bottom to top scale. |
2444
+
2445
+ For controlling the HSV "V” (brightness), use the standard controls under the **Dim** tab.
2446
+
2447
+ <br/>
2448
+
2449
+ **Effects**
2450
+
2451
+ _Non-Hue basic effects_
2452
+
2453
+ |Property|Description|
2454
+ |--|--|
2455
+ | Blink | _true_ Blink the light, _false_ Stop blinking. Blinks the light on and off. Useful for signalling. Works with all Hue lights. |
2456
+ | Color Cycle | _true_ start cycle, _false_ Stop cycle. Randomly changes the Hue light's color at regular interval. Works with all Hue lights having color capabilities. The color effect will start 10 seconds after set. |
2457
+
2458
+ _Hue native effects_
2459
+
2460
+ Use the **Hue native effects** table to map your KNX values to the effects supported by the selected light (for example `candle`, `fireplace`, `prism`). Each row links a KNX value (boolean, numeric or textual, depending on the datapoint you pick) with a Hue effect. On the KNX side you can:
2461
+
2462
+ - send the mapped value to activate that effect;
2463
+ - optionally provide a status Group Address: the node emits the mapped value whenever the Hue bridge reports an effect change; if no mapping exists the raw effect name is sent (requires a textual DPT such as 16.xxx).
2464
+
2465
+ <br/>
2466
+
2467
+ **Behaviour**
2468
+
2469
+ | Property | Description |
2470
+ | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2471
+ | Read status at startup | Read the Hue light status at node-red's startup or node-red's full deploy, and send that status to the KNX BUS |
2472
+ | KNX Brightness Status | Updates the KNX brightness group address status, whenever the Hue lamp is switched ON/OFF. The options are **When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour) ** and**Leave as is (default Hue behaviour) ** . If you have KNX dimmer with brightness status, like MDT, the suggested option is _**When Hue light is Off send 0%. When Hue On, restore previous value (Default KNX behaviour)** _ |
2473
+ | Update local cached Hue state from KNX bus writes | Advanced option, enabled by default. When enabled, writes arriving from the KNX bus also update the node's local cached Hue state immediately, without waiting for feedback/events from the Hue bridge. This gives faster local reactions and more consistent immediate KNX read responses, especially while the light or grouped light is OFF. Disable it if you prefer the cache to follow only real feedback/events from the Hue bridge. |
2474
+ | Switch on behaviour | It sets the behaviour of your lights when switched on. You can choose from differents behaviours.<br/> **Select color: ** the light will be switched on with the color of your choice. To change color, just CLICK on the color selector (under the _Select color_ control).<br/>**Select temperature and brightness: ** the light will be switched on with the temperature (Kelvin) and brightness (0-100) of your choice.<br/>**None:** the light will retain its last status. In case you've enable the night lighting, after the night time ends, the lamp will resume the color/temperature/brightness state set at day time. |
2475
+ | Night Lighting | It allows to set a particular light color/brightness at nighttime. The options are the same as the daytime. You could select either a temperature/brightness or color. A cozy temperature of 2700 Kelvin, with a brightness of 10% or 20%, is a good choice for bathroom's night light.|
2476
+ | Day/Night | Select the group address used to set the day/night behaviour. The group address value is _true_ if daytime, _false_ if nighttime. |
2477
+ | Invert day/night value | Invert the values of _Day/Night_ group address. Default value is **unchecked** . |
2478
+ | Read status at startup | Read the status at startup and emit the event to the KNX bus at startup/reconnection. (Default "no")|
2479
+ | Force day mode | You can force the day mode by manually switching the light as described here: **Switch to DAY mode by rapid switching the ligth off then on (This light only) ** does what described and acts only on this light.**Switch to DAY mode by rapid switching the ligth off then on (apply yo ALL light nodes)** acts to ALL Light nodes, by setting the Day/Night group address to Day mode. |
2480
+ | Node Input/Output PINs | Hide or show the input/output PINs. Input/output PINS allow the node to accept msg input from the flow and send msg output to the flow. Input msg must follow the Hue API v.2 Standards. This is an example msg, that turns on the light: <code>msg.on = {"on":true}</code>. Please refer to the [official Hue Api page](https://developers.meethue.com/develop/hue-api-v2/api-reference/#resource_light__id__put) |
2481
+
2482
+ ### Note
2483
+
2484
+ The Dimming function works in **KNX mode `start` and`stop` ** . To start dimming, send only one "start" KNX telegram. To stop dimming, send a "stop" KNX telegram. Please**remember that** , when you set your wall swiches properties.
2485
+
2486
+ <br/>
2487
+ </script>
@@ -570,3 +570,34 @@
570
570
 
571
571
  <input type="hidden" id="node-input-hueDevice">
572
572
  </script>
573
+
574
+
575
+ <script type="text/markdown" data-help-name="knxUltimateHueLightSensor">
576
+ <p>This node reads lux events from a Hue Light Sensor and maps them to KNX.</p>
577
+
578
+ It emits the ambient illuminance (lux) each time it changes. Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.
579
+
580
+ **General**
581
+
582
+ |Property|Description|
583
+ |--|--|
584
+ | KNX GW | Select the KNX gateway to be used |
585
+ | Hue Bridge | Select the Hue Bridge to be used |
586
+ | Hue Light Sensor | Hue Light Sensor to use (autocomplete while typing).|
587
+ | Read status at startup | Read the status at startup and emit the event to the KNX bus at startup/reconnection. (Default "no")|
588
+
589
+ **Mapping**
590
+
591
+ | Property | Description |
592
+ |--|--|
593
+ | Lux | KNX GA that receives the lux value. |
594
+
595
+ ### Outputs
596
+
597
+ 1. Standard output
598
+ : payload (number): current lux value.
599
+
600
+ ### Details
601
+
602
+ `msg.payload` carries the numeric lux value. Use it for custom logic if needed.
603
+ </script>
@@ -565,3 +565,37 @@
565
565
 
566
566
  <input type="hidden" id="node-input-hueDevice">
567
567
  </script>
568
+
569
+
570
+ <script type="text/markdown" data-help-name="knxUltimateHueMotion">
571
+ <p>This node listens to a Hue motion sensor and mirrors the events to KNX and/or your Node-RED flow.</p>
572
+
573
+ Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type. Hit the refresh button next to "Hue sensor” to reload the device list from the bridge if you add new sensors.
574
+
575
+ **General**
576
+
577
+ |Property|Description|
578
+ |--|--|
579
+ | KNX GW | KNX gateway that receives the motion updates (required before KNX mapping fields appear). |
580
+ | Hue Bridge | Hue Bridge to query. |
581
+ | Hue motion sensor | Hue motion sensor (supports autocomplete and refresh). |
582
+
583
+ **Mapping**
584
+
585
+ |Property|Description|
586
+ |--|--|
587
+ | Motion | KNX GA that receives `true` when motion is detected and `false` when the area is clear. Recommended DPT: <b>1.001</b>. |
588
+
589
+ **Behaviour**
590
+
591
+ |Property|Description|
592
+ |--|--|
593
+ | Node output pin | Show or hide the Node-RED output. When no KNX gateway is selected the output pin stays enabled so Hue motion events still reach your flow. |
594
+
595
+ > ℹ️ KNX widgets remain hidden until you select a KNX gateway, making it easy to use the node purely as a Hue → Node-RED listener.
596
+
597
+ ### Output
598
+
599
+ 1. Standard output — `msg.payload` (boolean)
600
+ : `true` on motion, `false` when motion ends.
601
+ </script>
@@ -894,3 +894,41 @@
894
894
 
895
895
  <input type="hidden" id="node-input-hueDevice">
896
896
  </script>
897
+
898
+
899
+ <script type="text/markdown" data-help-name="knxUltimateHueScene">
900
+ The **Hue Scene** node exposes Hue scenes to KNX and can forward the raw Hue events to a Node-RED flow. The scene field supports autocomplete; use the refresh icon after adding scenes on the bridge so the list stays up to date.
901
+
902
+ ### Tabs at a glance
903
+
904
+ - **Mapping** - link KNX group addresses to the selected Hue scene. DPT 1.xxx performs boolean recall, while DPT 18.xxx sends a KNX scene number.
905
+ - **Multi scene** - build a rule list that associates KNX scene numbers with different Hue scenes and chooses whether each scene is recalled as _active_, _dynamic\_palette_ or _static_.
906
+ - **Behaviour** - toggle the Node-RED output pin. When no KNX gateway is configured the pin remains enabled so bridge events still reach the flow.
907
+
908
+ ### General settings
909
+
910
+ |Property|Description|
911
+ |--|--|
912
+ | KNX GW | KNX gateway supplying the address catalogue used for autocomplete. |
913
+ | Hue Bridge | Hue Bridge that hosts the scenes. |
914
+ | Hue Scene | Scene to recall (autocomplete; refresh button reloads the bridge catalogue). |
915
+
916
+ ### Mapping tab
917
+
918
+ |Property|Description|
919
+ |--|--|
920
+ | Recall | KNX group address that recalls the scene. Use DPT 1.xxx for boolean control or DPT 18.xxx to transmit a KNX scene number. |
921
+ | DPT | Datapoint used with the recall GA (1.xxx or 18.001). |
922
+ | Name | Friendly label for the recall GA. |
923
+ | # | Appears when a KNX scene DPT is chosen; select the KNX scene number to send. |
924
+ | Status GA | Optional boolean GA that mirrors whether the scene is currently active. |
925
+
926
+ ### Multi scene tab
927
+
928
+ |Property|Description|
929
+ |--|--|
930
+ | Recall | KNX GA (DPT 18.001) that selects scenes by number. |
931
+ | Scene selector | Editable list that maps KNX scene numbers to Hue scenes with the desired recall mode. Drag handles reorder entries. |
932
+
933
+ > ℹ️ KNX-specific widgets only appear after a KNX gateway is selected. The Mapping tabs remain hidden until both the bridge and the gateway are configured.
934
+ </script>
@@ -572,3 +572,36 @@
572
572
 
573
573
  <input type="hidden" id="node-input-hueDevice">
574
574
  </script>
575
+
576
+
577
+ <script type="text/markdown" data-help-name="knxUltimateHueTapDial">
578
+ The **Hue Tap Dial** node maps the rotary service of the Hue Tap Dial to KNX and forwards the raw Hue events to your flow. Use the refresh icon beside the device field after pairing a new dial on the bridge.
579
+
580
+ ### Tabs
581
+
582
+ - **Mapping** - select the KNX GA and DPT used for the rotation events. Supported datapoints: DPT 3.007 (relative dim), DPT 5.001 (absolute level 0-100 %) and DPT 232.600 (vendor colour control).
583
+ - **Behaviour** - show or hide the Node-RED output pin. When no KNX gateway is configured the output is kept enabled so Hue events still reach the flow.
584
+
585
+ ### General settings
586
+
587
+ |Property|Description|
588
+ |--|--|
589
+ | KNX GW | KNX gateway used for GA autocomplete. |
590
+ | Hue Bridge | Hue Bridge hosting the Tap Dial. |
591
+ | Hue Tap Dial | Rotary device to control (autocomplete; refresh button reloads the list). |
592
+
593
+ ### Mapping tab
594
+
595
+ |Property|Description|
596
+ |--|--|
597
+ | Rotate GA | KNX GA receiving rotation events (supports DPT 3.007, 5.001, 232.600). |
598
+ | Name | Friendly label for the GA. |
599
+
600
+ ### Outputs
601
+
602
+ |#|Port|Payload|
603
+ |--|--|--|
604
+ |1|Standard output|`msg.payload` (object) Raw Hue event emitted by the Tap Dial.|
605
+
606
+ > ℹ️ KNX-specific widgets appear only after selecting a KNX gateway; the Mapping tab stays hidden until both the bridge and the gateway are configured.
607
+ </script>
@@ -573,3 +573,34 @@
573
573
 
574
574
  <input type="hidden" id="node-input-hueDevice">
575
575
  </script>
576
+
577
+
578
+ <script type="text/markdown" data-help-name="knxUltimateHueTemperatureSensor">
579
+ <p>This node reads temperature (°C) from a Hue temperature sensor and maps it to KNX.</p>
580
+
581
+ Start typing in the GA field (name or Group Address) to link the KNX GA; devices appear while you type.
582
+
583
+ **General**
584
+
585
+ |Property|Description|
586
+ |--|--|
587
+ | KNX GW | Select the KNX gateway to be used |
588
+ | Hue Bridge | Select the Hue Bridge to be used |
589
+ | Hue temperature sensor | Hue temperature sensor (autocomplete while typing) |
590
+ | Read status at startup | On startup/reconnect, read current value and send it to KNX (default: no) |
591
+
592
+ **Mapping**
593
+
594
+ |Property|Description|
595
+ |--|--|
596
+ | Temp | KNX GA for temperature in Celsius. Recommended DPT: <b>9.001</b> |
597
+
598
+ ### Outputs
599
+
600
+ 1. Standard output
601
+ : `msg.payload` (number): current temperature in °C
602
+
603
+ ### Details
604
+
605
+ `msg.payload` carries the numeric temperature value.
606
+ </script>
@@ -581,3 +581,35 @@
581
581
 
582
582
  <input type="hidden" id="node-input-hueDevice">
583
583
  </script>
584
+
585
+
586
+ <script type="text/markdown" data-help-name="knxUltimateHueZigbeeConnectivity">
587
+ <p>This node retrieves the Zigbee connectivity status from a Hue device and exposes it to KNX.</p>
588
+
589
+ Start typing the KNX device name or Group Address in the GA field; suggestions appear while you type.
590
+
591
+ **General**
592
+
593
+ |Property|Description|
594
+ |--|--|
595
+ | KNX GW | KNX gateway used to publish the status. |
596
+ | Hue Bridge | Hue Bridge to query. |
597
+ | Hue zigbee connectivity | Hue sensor/device providing the Zigbee connectivity info. Autocomplete while typing. |
598
+
599
+ **Mapping**
600
+
601
+ |Property|Description|
602
+ |--|--|
603
+ | Status | KNX Group Address that reflects Zigbee connectivity. Becomes _true_ when connected, otherwise _false_. |
604
+ | Read status at startup | Reads current status at editor start/reconnection and emits to KNX. Default: "yes”. |
605
+
606
+ ### Outputs
607
+
608
+ 1. Standard output
609
+ : payload (boolean): connectivity state.
610
+
611
+ ### Details
612
+
613
+ `msg.payload` carries the boolean state (true/false).\
614
+ `msg.status` contains a textual status: one of **connected, disconnected, connectivity\_issue, unidirectional\_incoming** .
615
+ </script>
@@ -586,3 +586,32 @@
586
586
 
587
587
  <input type="hidden" id="node-input-hueDevice">
588
588
  </script>
589
+
590
+
591
+ <script type="text/markdown" data-help-name="knxUltimateHuedevice_software_update">
592
+ <p>This node monitors whether a selected Hue device has a software update available and publishes the status to KNX.</p>
593
+
594
+ Start typing the name or group address of your KNX device in the GA field, the avaiable devices start showing up while
595
+ you're typing.
596
+
597
+ **General**
598
+
599
+ |Property|Description|
600
+ |--|--|
601
+ | KNX GW | Select the KNX gateway to be used |
602
+ | Hue Bridge | Select the Hue Bridge to be used |
603
+ | Hue device | Hue device to monitor for software updates (autocomplete while typing).|
604
+
605
+ **Mapping**
606
+
607
+ | Property | Description |
608
+ |--|--|
609
+ | Status | KNX GA reflecting update status. _true_ if an update is available/ready/being installed, otherwise _false_. |
610
+ | Read status at startup | Read current status at startup/reconnection and emit to KNX (default "yes”). |
611
+
612
+ ### Outputs
613
+
614
+ 1. Standard output
615
+ : payload (boolean): update flag.
616
+ : status (string): one of **no\_update, update\_pending, ready\_to\_install, installing** .
617
+ </script>
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "engines": {
4
4
  "node": ">=20.18.1"
5
5
  },
6
- "version": "4.3.21",
6
+ "version": "4.3.23",
7
7
  "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, KNX AI for diagnosticsand KNX routing between interfaces. Easy to use and highly configurable.",
8
8
  "files": [
9
9
  "nodes/",