node-red-contrib-huemagic 4.0.0 → 4.0.4

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/README.md CHANGED
@@ -12,7 +12,6 @@ HueMagic provides several input and output nodes for Node-RED and is the most in
12
12
  * Output and input of multiple color code definitions *(HEX, RGB & human readable color names)*
13
13
  * Automatic color temperature & brightness setting based on the current time
14
14
  * Event-based status messages for all devices connected to the Hue Bridge
15
- * Virtual pressing of the Hue Bridge button (Link Button)
16
15
  * Pairing of new devices without app enforcement (TouchLink)
17
16
  * Automatic firmware updates to the Hue Bridge and connected devices
18
17
  * Activating / deactivating of sensors & rules on the Hue Bridge
@@ -25,7 +24,7 @@ HueMagic provides several input and output nodes for Node-RED and is the most in
25
24
  * Extensively documented in English & German
26
25
 
27
26
  ### Installation
28
- HueMagic was written for **Node.js 14+** and **Node-RED v2.1+**. It supports the square-shaped Hue Bridge with the **FW 1948086000+** or higher. You can install HueMagic directly via the [Node-RED Palette Manager](https://nodered.org/docs/user-guide/editor/palette/manager) or manually using [yarn / npm](https://nodered.org/docs/user-guide/runtime/adding-nodes).
27
+ HueMagic was written for **Node.js 14+** and **Node-RED v2.1+**. It supports the square-shaped Hue Bridge with the **firmware 1948086000+** or higher. You can install HueMagic directly via the [Node-RED Palette Manager](https://nodered.org/docs/user-guide/editor/palette/manager) or manually using [npm / yarn](https://nodered.org/docs/user-guide/runtime/adding-nodes).
29
28
 
30
29
  `npm install node-red-contrib-huemagic`
31
30
 
@@ -46,9 +45,9 @@ _Please make sure that you deactivate other Hue-related nodes in Node-RED and me
46
45
 
47
46
  ### Examples
48
47
 
49
- HueMagic provides a large selection of full featured sample flows for all nodes. You can find these examples in the "[examples](https://github.com/Foddy/node-red-contrib-huemagic/tree/master/examples)" folder on GitHub or directly in Node-RED. To import a full featured example into your Node-RED interface, click on the Node-RED menu icon, then select "Import" and navigate to "Examples" in the sidebar of the popup. Then select the HueMagic folder and your desired node to import a sample flow.
48
+ HueMagic provides a large selection of full featured sample flows for all nodes. You can find these examples in the [examples folder on GitHub](https://github.com/Foddy/node-red-contrib-huemagic/tree/master/examples) or directly in Node-RED. To import a full featured example into your Node-RED interface, click on the Node-RED menu icon, then select "Import" and navigate to "Examples" in the sidebar of the popup. Then select the HueMagic folder and your desired node to import a sample flow.
50
49
 
51
- <img alt="Instructions to import examples in Node-RED" src="https://user-images.githubusercontent.com/5302050/148696808-f730ad36-8d0b-4b5b-99b2-1917831f8916.gif" width="100%">
50
+ <a href="https://github.com/Foddy/node-red-contrib-huemagic/tree/master/examples"><img alt="Instructions to import examples in Node-RED" src="https://user-images.githubusercontent.com/5302050/148696808-f730ad36-8d0b-4b5b-99b2-1917831f8916.gif" width="100%"></a>
52
51
 
53
52
  ## Hue Bridge
54
53
  The "Hue Bridge" node is a universal node that can output all settings of the bridge and status messages from other nodes.
@@ -83,7 +82,7 @@ With the "fetch" command you can output a list of specific devices that are curr
83
82
 
84
83
  |Property|Description|
85
84
  |--|--|
86
- | fetch (string | array [string, ...]) | Can accept `light`, `group`, `button`, `motion`, `temperature`, `light_level` or `rule` as value(s) |
85
+ | fetch (string / array [string, ...]) | Can accept `light`, `group`, `button`, `motion`, `temperature`, `light_level` or `rule` as value(s) |
87
86
 
88
87
  ### Change Hue Bridge settings
89
88
 
@@ -98,7 +97,7 @@ You can use the following command to change specific settings on the bridge. Ple
98
97
  | netmask (string) | Changes the network mask in the network settings |
99
98
  | gateway (string) | Specifies the gateway in the network settings |
100
99
  | proxyAddress (string) | Sets a proxy address in the network settings |
101
- | proxyPort (string | int) | Specifies the port of the proxy in the network settings |
100
+ | proxyPort (string / int) | Specifies the port of the proxy in the network settings |
102
101
  | timeZone (string) | Changes the currently set time zone on the bridge |
103
102
 
104
103
  ### Status messages from the node
@@ -112,9 +111,9 @@ The status reports of the "Hue Bridge" node are dynamic. Although they follow a
112
111
  | id (string) | Unique ID of the Hue Bridge |
113
112
  | name (string) | Currently set name |
114
113
  | factoryNew (boolean) | Indicator whether the bridge is brand new |
115
- | replacesBridgeId (string | boolean) | Outputs the old bridge ID (if a migration was carried out) or outputs `false` |
114
+ | replacesBridgeId (string / boolean) | Outputs the old bridge ID (if a migration was carried out) or outputs `false` |
116
115
  | dataStoreVersion (string) | Version of the data store |
117
- | starterKitId (string | boolean) | Name of the starter kit created in the factory or `false` |
116
+ | starterKitId (string / boolean) | Name of the starter kit created in the factory or `false` |
118
117
  | softwareVersion (string) | Software version of the bridge |
119
118
  | apiVersion (string) | API version of the bridge |
120
119
  | zigbeeChannel (int) | Currently used ZigBee channel |
@@ -123,7 +122,7 @@ The status reports of the "Hue Bridge" node are dynamic. Although they follow a
123
122
  | dhcpEnabled (boolean) | Indicates whether DHCP is enabled |
124
123
  | netmask (string) | Netmask of the bridge |
125
124
  | gateway (string) | Gateway of the bridge |
126
- | proxyAddress (string | false) | Currently used proxy address or `false` |
125
+ | proxyAddress (string / boolean) | Currently used proxy address or `false` |
127
126
  | proxyPort (string) | Currently used proxy port |
128
127
  | utcTime (string) | UTC time on the bridge |
129
128
  | timeZone (string) | Currently set time zone on the bridge |
@@ -143,7 +142,7 @@ If the "fetch" command has been used on the node, the bridge outputs the corresp
143
142
 
144
143
  #### Global status messages under `msg.updated` (optional)
145
144
 
146
- Unless deactivated, the node issues an updated status message for each resource on the bridge. The status message under * msg.updated * follows the pattern of the respective resource and varies depending on the type of device that was last updated.
145
+ Unless deactivated, the node outputs an updated status message for each resource on the bridge. The status message under * msg.updated * follows the pattern of the respective resource and varies depending on the type of device that was last updated.
147
146
 
148
147
  #### Last command under `msg.command` (optional)
149
148
 
@@ -186,11 +185,11 @@ Create an `array` with the respective animation steps in the form of an object a
186
185
 
187
186
  If you have created your own animation that you would like to share with others, add it at `/huemagic/animations/XXX-youranimationname.json` and create a pull request. Take a look at [this directory](https://github.com/Foddy/node-red-contrib-huemagic/tree/master/huemagic/animations) for structure help.
188
187
 
189
- ### Example of your own animation
188
+ ### Example of a custom animation
190
189
 
191
190
  This example shows what a simple animation could look like. In the first step, the delay of 500 milliseconds is waited for. The color of the light is then slowly changed to red over a period of one second. As soon as the light has completely changed to red, the second step is carried out, which also has a delay of 500 milliseconds. Finally the color changes to blue.
192
191
 
193
- If you have set the animation to play indefinitely, this process is repeated indefinitely until you manually stop the animation or redeploy the node.
192
+ If you have set the animation to loop, this process is repeated indefinitely until you manually stop the animation or redeploy the node.
194
193
 
195
194
  Pass the following object in `msg.payload` to play the example animation.
196
195
 
@@ -220,7 +219,7 @@ Sometimes it makes sense to play an animation in a disorderly manner - e.g. if f
220
219
 
221
220
  |Property|Description|
222
221
  |--|--|
223
- | randomOrder (boolean | any) | `true`, activates the random playback of the individual animation steps |
222
+ | randomOrder (boolean / any) | `true`, activates the random playback of the individual animation steps |
224
223
 
225
224
  ### Tips and hints
226
225
 
@@ -262,11 +261,11 @@ In addition to simply switching it on and off, there are also many other options
262
261
  |Property|Description|
263
262
  |--|--|
264
263
  | on (boolean) | `true` switches the light on, `false` switches it off |
265
- | toggle (boolean | any) | Toggles between switching on and off, depending on the previous status of the light |
266
- | brightness (int | string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the brightness based on the current time |
264
+ | toggle (boolean / any) | Toggles between switching on and off, depending on the previous status of the light |
265
+ | brightness (int / string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the brightness based on the current time |
267
266
  | brightnessLevel (int) | Numerical value of the light brightness (0-254) |
268
- | incrementBrightness (int | boolean) | Specifies by how many percent the light should be made brighter or `true` to make the light brighter in 10% steps |
269
- | decrementBrightness (int | boolean) | Specifies the percentage by which the light should be made darker or `true` to make the light darker in 10% steps |
267
+ | incrementBrightness (int / boolean) | Specifies by how many percent the light should be made brighter or `true` to make the light brighter in 10% steps |
268
+ | decrementBrightness (int / boolean) | Specifies the percentage by which the light should be made darker or `true` to make the light darker in 10% steps |
270
269
  | color (string) | `random` to set a random color or an English color name (e.g. `red`) |
271
270
  | hex (string) | Color value in hexadecimal in the form of a string |
272
271
  | rgb (array [0,0,0]) | Color value in RGB format in the form of an array |
@@ -275,9 +274,9 @@ In addition to simply switching it on and off, there are also many other options
275
274
  | mixColor (object) | A color to be mixed with the current light color. Can accept `color`, `hex`, `rgb` or `xyColor` objects and optionally `amount` (int) to indicate the mixing ratio in percent |
276
275
  | image (string) | Path of an image (local or on the web) to set the current color of the light to the average color of the image |
277
276
  | saturation (int) | percentage of the saturation of the current color (beta) |
278
- | colorTemp (int | string) | Value between 153 and 500 to set the color temperature of the light or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
279
- | incrementColorTemp (int | boolean) | Value by how much the color temperature should be warmer or `true` to make the color temperature warmer in steps of 50 |
280
- | decrementColorTemp (int | boolean) | Value by how much the color temperature should be colder or `true` to make the color temperature colder in steps of 50 |
277
+ | colorTemp (int / string) | Value between 153 and 500 to set the color temperature of the light or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
278
+ | incrementColorTemp (int / boolean) | Value by how much the color temperature should be warmer or `true` to make the color temperature warmer in steps of 50 |
279
+ | decrementColorTemp (int / boolean) | Value by how much the color temperature should be colder or `true` to make the color temperature colder in steps of 50 |
281
280
  | transitionTime (float) | Transition time of the current setting in seconds. If `0` is entered, the light changes to the desired setting immediately. If `3` is entered, the light changes to the desired setting with a slight transition in the next 3 seconds |
282
281
  | colorloop (float) | Plays a "colorloop" animation for the selected duration in seconds and then switches back to the original state of the light |
283
282
  | alert (float) | Plays an "alert" animation for the selected duration in seconds and then switches back to the original state of the light |
@@ -291,17 +290,17 @@ As soon as a change in the light settings has been detected (regardless of wheth
291
290
  |Property|Description|
292
291
  |--|--|
293
292
  | on (boolean) | State of the light, where `true` stands for on and `false` for off |
294
- | brightness (int | boolean) | Current brightness in percent or `false`, if the light does not support a brightness setting |
295
- | brightnessLevel (int | boolean) | Current brightness from 0-254 or `false`, if the light does not support a brightness setting |
296
- | reachable (boolean | string) | `true` if the light is connected to the bridge, `unknown` if the connection status deviates |
293
+ | brightness (int / boolean) | Current brightness in percent or `false`, if the light does not support a brightness setting |
294
+ | brightnessLevel (int / boolean) | Current brightness from 0-254 or `false`, if the light does not support a brightness setting |
295
+ | reachable (boolean / string) | `true` if the light is connected to the bridge, `unknown` if the connection status deviates |
297
296
  | connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
298
- | rgb (array [int, int, int] | optional) | Current light color in the form of an RGB value, if the light can display colors |
299
- | hex (string | optional) | Current light color in the form of a hexadecimal value if the light can display colors |
300
- | xyColor (object {x [float], y [float]} | optional) | Current light color in the form of an XY value, if the light can display colors |
301
- | color (string | optional) | Current light name in English, if the light can display colors and the corresponding setting of the node has been activated |
302
- | gradient (object | optional) | Current gradient setting with all available color units in the form of an array, if the light supports gradient settings, where `colors` outputs the colors, `numColors` the number of set colors in the gradient and `totalColors` the maximum possible Number of colors the resource can support in the gradient |
303
- | colorTemp (int | boolean | optional) | Current color temperature of the light, if the light can display color temperatures and a color temperature has been set |
304
- | colorTempName (string | optional) | Current color temperature of the light in the form of a descriptive string with the values `cold`,`normal`, `warm` or `hot`, if the light can display color temperatures and a color temperature has been set. Otherwise `unknown` is output |
297
+ | rgb (array [int, int, int] / optional) | Current light color in the form of an RGB value, if the light can display colors |
298
+ | hex (string / optional) | Current light color in the form of a hexadecimal value if the light can display colors |
299
+ | xyColor (object {x [float], y [float]} / optional) | Current light color in the form of an XY value, if the light can display colors |
300
+ | color (string / optional) | Current light name in English, if the light can display colors and the corresponding setting of the node has been activated |
301
+ | gradient (object / optional) | Current gradient setting with all available color units in the form of an array, if the light supports gradient settings, where `colors` outputs the colors, `numColors` the number of set colors in the gradient and `totalColors` the maximum possible Number of colors the resource can support in the gradient |
302
+ | colorTemp (int / boolean / optional) | Current color temperature of the light, if the light can display color temperatures and a color temperature has been set |
303
+ | colorTempName (string / optional) | Current color temperature of the light in the form of a descriptive string with the values `cold`,`normal`, `warm` or `hot`, if the light can display color temperatures and a color temperature has been set. Otherwise `unknown` is output |
305
304
  | updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
306
305
 
307
306
  #### Information about the light under `msg.info`
@@ -309,7 +308,7 @@ As soon as a change in the light settings has been detected (regardless of wheth
309
308
  |Property|Description|
310
309
  |--|--|
311
310
  | id (string) | Indicates the new ID of the light |
312
- | idV1 (string | boolean) | Indicates the old ID of the light |
311
+ | idV1 (string / boolean) | Indicates the old ID of the light |
313
312
  | uniqueId (string) | The unique ID of the light |
314
313
  | deviceId (string) | The unique ID of the device |
315
314
  | name (string) | The currently set name of the light |
@@ -363,15 +362,15 @@ In addition to simply switching it on and off, there are also many other options
363
362
  |Property|Description|
364
363
  |--|--|
365
364
  | on (boolean) | `true` switches the entire group on, `false` switches it off (please note the note above) |
366
- | toggle (boolean | any) | Toggles between switching on and off, depending on the previous status of the group |
367
- | brightness (int | string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the light brightness based on the current time |
365
+ | toggle (boolean / any) | Toggles between switching on and off, depending on the previous status of the group |
366
+ | brightness (int / string) | Percentage value of the light brightness (0-100) or a string with the value `auto` to automatically set the light brightness based on the current time |
368
367
  | brightnessLevel (int) | Numerical value of the light brightness (0-254) |
369
368
  | color (string) | `random` to set a random color or an English color name (e.g. `red`) |
370
369
  | hex (string) | Color value in hexadecimal in the form of a string |
371
370
  | rgb (array [0,0,0]) | Color value in RGB format in the form of an array |
372
371
  | xyColor (object {x [float], y [float]}) | Color value in the XY color format in the form of an object |
373
372
  | image (string) | Path of an image (local or on the web) to set the current color of the group to the average color of the image |
374
- | colorTemp (int | string) | Value between 153 and 500 to set the color temperature of the group or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
373
+ | colorTemp (int / string) | Value between 153 and 500 to set the color temperature of the group or the values `cold`, `normal`, `warm`, `hot` and `auto` - where `auto` is the color temperature based on the current time |
375
374
  | transitionTime (float) | Transition time of the current setting in seconds. If `0` is passed, the group changes to the desired setting immediately. If you pass it to `3`, the group changes to the desired setting with a slight transition in the next 3 seconds |
376
375
  | colorloop (float) | Plays a “colorloop” animation for the selected duration in seconds and then changes back to the group's original state |
377
376
  | alert (float) | Plays an "alert" animation for the selected duration in seconds and then switches back to the original status of the group |
@@ -394,7 +393,7 @@ In contrast to the "Hue Light" node, you have much less status information avail
394
393
  |Property|Description|
395
394
  |--|--|
396
395
  | id (string) | Indicates the new ID of the group |
397
- | idV1 (string | boolean) | Indicates the old ID of the group |
396
+ | idV1 (string / boolean) | Indicates the old ID of the group |
398
397
  | name (string) | The currently set name of the group |
399
398
  | type (string) | The type of the group (always `group`) |
400
399
 
@@ -441,7 +440,7 @@ Connect the output of this node to one or more groups to apply a scene to specif
441
440
 
442
441
  |Property|Description|
443
442
  |--|--|
444
- | group (string | array [string,…]) | ID of the group or an array with the IDs of several groups in order to limit the scene to these groups |
443
+ | group (string / array [string,…]) | ID of the group or an array with the IDs of several groups in order to limit the scene to these groups |
445
444
 
446
445
  ### More information about the Node
447
446
 
@@ -454,7 +453,7 @@ The "Hue Buttons" node receives switching events from input devices connected to
454
453
 
455
454
  ### Node-RED Setup Instructions
456
455
 
457
- Select the pre-configured Hue Bridge and hit the search button to find all the available switches/buttons. If you already know the ID of the switch, you can also enter it here manually. You can either assign a new name for the switch internally or keep the predefined name of the device. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer output any switching events. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected switch after each deployment.
456
+ Select the pre-configured Hue Bridge and hit the search button to find all the available switches/buttons. If you already know the ID of the switches/buttons, you can also enter it here manually. You can either assign a new name for the switches/buttons internally or keep the predefined name of the device. Optionally, you can also deactivate all automatic status messages for this node by clicking the setting "Skip events from node". The node will then no longer output any switching events. Alternatively, you can also choose whether the node's initialization message should not be suppressed when Node-RED is started. If you activate this setting, you will receive a status message for the currently selected switches/buttons after each deployment.
458
457
 
459
458
  If you do not select a switch/button and use the node configuration in this way, the node works in the so-called "universal mode". In this mode, the node receives and outputs all status messages of the same type.
460
459
 
@@ -474,10 +473,10 @@ As soon as a key has been pressed, the following status message is returned by t
474
473
 
475
474
  |Property|Description|
476
475
  |--|--|
477
- | reachable (boolean | string) | `true` if the switch/button is connected to the bridge, `unknown` if the connection status deviates |
476
+ | reachable (boolean / string) | `true` if the switch/button is connected to the bridge, `unknown` if the connection status deviates |
478
477
  | connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
479
- | button (int | boolean) | Numeric ID of the key that was last pressed or `false` if no key was pressed |
480
- | action (string | boolean) | `false` if no key was pressed or `initial_press`, `repeat` , `short_release`, `long_release` or `double_short_release` in the form of a string |
478
+ | button (int / boolean) | Numeric ID of the key that was last pressed or `false` if no key was pressed |
479
+ | action (string / boolean) | `false` if no key was pressed or `initial_press`, `repeat` , `short_release`, `long_release` or `double_short_release` in the form of a string |
481
480
  | updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
482
481
 
483
482
  #### Information about the switch/button under `msg.info`
@@ -485,14 +484,14 @@ As soon as a key has been pressed, the following status message is returned by t
485
484
  |Property|Description|
486
485
  |--|--|
487
486
  | id (string) | Indicates the new ID of the switch/button |
488
- | idV1 (string | boolean) | Indicates the old ID of the switch/button |
487
+ | idV1 (string / boolean) | Indicates the old ID of the switch/button |
489
488
  | uniqueId (string) | The unique ID of the switch/button |
490
489
  | deviceId (string) | The unique ID of the device |
491
490
  | name (string) | The currently set name of the switch/button |
492
491
  | type (string) | The type of the switch/button (always `button`) |
493
492
  | softwareVersion (string) | The current firmware of the switch/button |
494
- | battery (float) | The current battery level of the switch/button |
495
- | batteryState (string) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value |
493
+ | battery (float / boolean) | The current battery level of the switch/button, `false`, when there is no battery |
494
+ | batteryState (string / boolean) | The current status of the battery level. Can contain `normal`, `low` or `critical` as a value, `false`, when there is no battery |
496
495
  | model (object) | Contains the model information of the switch/button under `id` , `manufacturer`, `name`, `type` and `certified` |
497
496
 
498
497
  #### Status changes under `msg.updated`
@@ -532,7 +531,7 @@ If necessary, the sensor can be turned on and off remotely. If the sensor has be
532
531
 
533
532
  |Property|Description|
534
533
  |--|--|
535
- | payload (boolean) | `true` turns the sensor on,` false` turns it off |
534
+ | payload (boolean) | `true` turns the sensor on, `false` turns it off |
536
535
 
537
536
  ### Status messages from the node
538
537
 
@@ -543,7 +542,7 @@ As soon as the sensor has registered a movement, the following status message is
543
542
  |Property|Description|
544
543
  |--|--|
545
544
  | active (boolean) | Indicates whether the sensor is switched on or off |
546
- | reachable (boolean | string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
545
+ | reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
547
546
  | connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
548
547
  | motion (boolean) | Indicates whether a motion has been registered |
549
548
  | updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
@@ -553,7 +552,7 @@ As soon as the sensor has registered a movement, the following status message is
553
552
  |Property|Description|
554
553
  |--|--|
555
554
  | id (string) | Indicates the new ID of the sensor |
556
- | idV1 (string | boolean) | Indicates the old ID of the sensor |
555
+ | idV1 (string / boolean) | Indicates the old ID of the sensor |
557
556
  | uniqueId (string) | The unique ID of the sensor |
558
557
  | deviceId (string) | The unique ID of the device |
559
558
  | name (string) | The currently set name of the sensor |
@@ -611,11 +610,11 @@ As soon as the sensor has registered a temperature change, the following status
611
610
  |Property|Description|
612
611
  |--|--|
613
612
  | active (boolean) | Indicates whether the sensor is switched on or off |
614
- | reachable (boolean | string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
613
+ | reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
615
614
  | connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`, `disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
616
615
  | celsius (float) | Indicates the current ambient temperature in °C (degrees Celsius) |
617
616
  | fahrenheit (float) | Indicates the current ambient temperature in °F (degrees Fahrenheit) |
618
- | temperatureIs (string) | Describes the current temperature with the values ´very cold´, ´cold´, ´slightly cold´, ´comfortable´, ´slightly warm´, ´warm´, ´hot´ or ´very hot´ |
617
+ | temperatureIs (string) | Describes the current temperature with the values `very cold`, `cold`, `slightly cold`, `comfortable`, `slightly warm`, `warm`, `hot` or `very hot` |
619
618
  | deviceValue (float) | The original value of the temperature from the sensor |
620
619
  | updated (string) | Time of the last update of the resource by HueMagic (ISO 8601) |
621
620
 
@@ -624,7 +623,7 @@ As soon as the sensor has registered a temperature change, the following status
624
623
  |Property|Description|
625
624
  |--|--|
626
625
  | id (string) | Indicates the new ID of the sensor |
627
- | idV1 (string | boolean) | Indicates the old ID of the sensor |
626
+ | idV1 (string / boolean) | Indicates the old ID of the sensor |
628
627
  | uniqueId (string) | The unique ID of the sensor |
629
628
  | deviceId (string) | The unique ID of the device |
630
629
  | name (string) | The currently set name of the sensor |
@@ -682,7 +681,7 @@ As soon as the sensor has detected a change in the light level, the following st
682
681
  |Property|Description|
683
682
  |--|--|
684
683
  | active (boolean) | Indicates whether the sensor is turned on or off |
685
- | reachable (boolean | string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
684
+ | reachable (boolean / string) | `true` if the sensor is connected to the bridge, `unknown` if the connection status deviates |
686
685
  | connectionStatus (string) | The current connection status with the bridge in the form of a string. Can contain `connected`,` disconnected`, `connectivity_issue` or `unidirectional_incoming` as a value |
687
686
  | lux (int) | Indicates the real LUX value of the light level |
688
687
  | lightLevel (int) | Indicates the light intensity of the sensor |
@@ -695,7 +694,7 @@ As soon as the sensor has detected a change in the light level, the following st
695
694
  |Property|Description|
696
695
  |--|--|
697
696
  | id (string) | Indicates the new ID of the sensor |
698
- | idV1 (string | boolean) | Indicates the old ID of the sensor |
697
+ | idV1 (string / boolean) | Indicates the old ID of the sensor |
699
698
  | uniqueId (string) | The unique ID of the sensor |
700
699
  | deviceId (string) | The unique ID of the device |
701
700
  | name (string) | The currently set name of the sensor |
@@ -796,9 +795,14 @@ If the status of the node has changed via a certain command, the entire command
796
795
 
797
796
  # Changelog
798
797
 
799
- ### v4.0.0 (latest)
798
+ ### v4.0.4 (latest)
799
+
800
+ * Fixed an issue with the bridge config node checking for updates too frequently ([#246](https://github.com/Foddy/node-red-contrib-huemagic/issues/246#issuecomment-1009376442))
801
+ * Fixed an issue with multiple bridges configured
802
+
803
+ ### v4.0.3
800
804
 
801
- > **Attention!** HueMagic v4 + has been almost completely rewritten under the hood and requires at least the (square-shaped) Philips Hue Bridge firmware 1948086000+ from November 1st, 2021 ([Upgrade instructions](https://www.lighting.philips.com/content/B2C/en_US/microsites/meethue/marketing-catalog/huewireless_ca/support/security-advisory/general/where-and-how-can-i-update-my-hue-system-with-the-latest-software.html)) and Node-RED v1 + ([Upgrade instructions](https://nodered.org/docs/getting-started/local#upgrading-node-red)). If you are upgrading from a previous HueMagic version to the v4, you will have to reconfigure (not completely rebuild) all nodes by clicking them and selecting the appropriate device from the list. This also applies to nodes / functions that are operated in universal mode, as the numeric identifiers of the latest Philips Hue API version have been replaced in UUIDs. The nodes "Hue Switch", "Hue Button" & "Hue Tap" have been replaced in v4 by the universal and uniform node "Hue Buttons", which works with all button / switch devices that are connected to the Hue Bridge (please note here also the new API in the documentation). The request and return objects of the individual nodes are largely compatible with older HueMagic versions - with the exception of the nodes "Hue Bridge", "Hue Buttons", "Hue Scene" & "Hue Group". These need to be adjusted in the v4. Make sure that you meet the minimum technical requirements and have a quiet minute for the migration before upgrading to the v4.
805
+ > **Attention!** HueMagic v4+ has been almost completely rewritten under the hood and requires at least the (square-shaped) Philips Hue Bridge firmware 1948086000+ from November 1st, 2021 ([Upgrade instructions](https://www.lighting.philips.com/content/B2C/en_US/microsites/meethue/marketing-catalog/huewireless_ca/support/security-advisory/general/where-and-how-can-i-update-my-hue-system-with-the-latest-software.html)) and Node-RED v1+ ([Upgrade instructions](https://nodered.org/docs/getting-started/local#upgrading-node-red)). If you are upgrading from a previous HueMagic version to the v4, you will have to reconfigure (not completely rebuild) all nodes by clicking them and selecting the appropriate device from the list. This also applies to nodes / functions that are operated in universal mode, as the numeric identifiers of the latest Philips Hue API version have been replaced in UUIDs. The nodes "Hue Switch", "Hue Button" & "Hue Tap" have been replaced in v4 by the universal and uniform node "Hue Buttons", which works with all button / switch devices that are connected to the Hue Bridge (please note here also the new API in the documentation). The request and return objects of the individual nodes are largely compatible with older HueMagic versions - with the exception of the nodes "Hue Bridge", "Hue Buttons", "Hue Scene" & "Hue Group". These need to be adjusted in the v4. Make sure that you meet the minimum technical requirements and have a quiet minute for the migration before upgrading to the v4.
802
806
 
803
807
  * HueMagic speaks now directly with the bridge without any submodules *(huejay dependency removed)*
804
808
  * Migrated to the newest CLIP/v2 API version from the Philips Hue bridge
@@ -809,9 +813,9 @@ If the status of the node has changed via a certain command, the entire command
809
813
  * New universal node "Hue Buttons" replaces the following nodes: "Hue Switch", "Hue Button", "Hue Tap"
810
814
  * New "updated" object for all nodes, which only contains the properties that have been updated since the last state
811
815
  * New configuration option to suppress first message after node initialization (for all nodes)
812
- * New gradient color setting for compatible light sources (in "Hue Light node)
816
+ * New gradient color setting for compatible light sources (in "Hue Light" node)
813
817
  * New inject button for almost all nodes, which triggers the current status of a node
814
- * New "universal mode" support for "Hue Rule" nodes
818
+ * New "universal mode" support for the "Hue Rule" node
815
819
  * New SVG-version of each node icon for higher quality rendering in the Node-RED UI
816
820
  * New and full featured examples for each node right inside Node-RED
817
821
  * New color mix feature in "Hue Light" nodes with the ability to mix the current light color with another
@@ -122,7 +122,7 @@
122
122
  "id": "a1d6fdeca2c9c014",
123
123
  "type": "comment",
124
124
  "z": "bf04a073.be4428",
125
- "name": "Fetch specific bridge ressources",
125
+ "name": "Fetch specific bridge resources",
126
126
  "info": "",
127
127
  "x": 150,
128
128
  "y": 420,
@@ -91,8 +91,8 @@
91
91
  // GET THE SENSORS
92
92
  $.get('hue/bridges')
93
93
  .done( function(data) {
94
- var allRessources = JSON.parse(data);
95
- if(allRessources.length <= 0)
94
+ var allResources = JSON.parse(data);
95
+ if(allResources.length <= 0)
96
96
  {
97
97
  notification.close();
98
98
  RED.notify(scope._("hue-bridge-config.config.none-found"), { type: "error" });
@@ -100,9 +100,9 @@
100
100
  }
101
101
 
102
102
  // SET OPTIONS
103
- allRessources.forEach(function(ressource)
103
+ allResources.forEach(function(resource)
104
104
  {
105
- options[ressource.ip] = { value: ressource.ip, label: ressource.ip };
105
+ options[resource.ip] = { value: resource.ip, label: resource.ip };
106
106
  });
107
107
 
108
108
  // SELECT CURRENT VALUE