node-red-contrib-boolean-logic-ultimate 1.0.56 → 1.0.58

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 
 # CHANGELOG
 
+<p>
+<b>Version 1.0.58</b> December 2022<br/>
+- NEW: added string conversion from "home", "not_home" to boolean.</br>
+- Updated the README</br>
+</p>
+<p>
+<b>Version 1.0.57</b> September 2022<br/>
+- Added node help in the node-red help tab.</br>
+</p>
 <p>
 <b>Version 1.0.56</b> August 2022<br/>
 - NEW: added string conversion from "true", "false", "0", "1", "close" to boolean.</br>

package/README.md

@@ -35,6 +35,8 @@ Other than true/false, all nodes accepts these strings and convert it to true/fa
 | "false" | false |
 | "1" | true |
 | "0" | false |
+| "home" | true |
+| "not_home" | false |
 
 
 <br/>
@@ -62,14 +64,14 @@ Other than true/false, all nodes accepts these strings and convert it to true/fa
 The node performs Boolean logic on the incoming payloads.<br/>
 The node expects a fixed number of topics (configured in the settings) on which it will operate. It will only output a value 
 when it has seen the expected number of topics. If it ever sees more than the configured number of topics it will log a message then reset its state and start over.<br/>
-The input message is preserved and passed to the output pin, changing only the topic and the payload. 
+The input message is preserved and passed to the output, changing only the topic and the payload. 
 
 The node performs some checks on the incoming boolean payloads and outputs all results at the same time, as follow:<br/>
 - Output "AND": true or false<br/>
 - Output "OR": true or false<br/>
 - Output "XOR": true or false<br/>
 
-If you need ***"NAND"*** or ***"NOR"*** gate, just put an **InvertUltimate** node respectively after the "AND" or "OR" pin.
+If you need ***"NAND"*** or ***"NOR"*** gate, just put an **InvertUltimate** node respectively after the "AND" or "OR" output.
 
 The node can have a persistent input: the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload.<br/>
 You can also set the default values of the topic inputs.<br/>
@@ -180,7 +182,7 @@ This allow to save the state of a node and then replay it back whenever you want
 # INVERT ULTIMATE
 
 Outputs the inverted input. For example true -> false<br />
-The input message is preserved and passed to the output pin, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
+The input message is preserved and passed to the output, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
 
 ### NODE CONFIGURATION
 
@@ -200,9 +202,9 @@ The input message is preserved and passed to the output pin, changing only the t
 # FILTER ULTIMATE
 
 This node has 2 outputs.<br />
-If the input payload is true, the node will send <code>true</code> on output 1 and nothing on oputput 2<br />
-If the input payload is false, the node will send nothing on output 1, and <code>false</code> on oputput 2<br />
-The input message is preserved and passed to the output pin, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
+If the input payload is true, the node will send <code>true</code> on output 1 and nothing on output 2<br />
+If the input payload is false, the node will send nothing on output 1 and <code>false</code> on output 2<br />
+The input message is preserved and passed to the output, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
 
 ### NODE CONFIGURATION
 
@@ -222,8 +224,8 @@ The input message is preserved and passed to the output pin, changing only the t
 # BLINKER ULTIMATE
 
 The pourpose of this node is to blink a led or something.<br />
-Output PIN1 : outputs the value true/false<br/>
-Output PIN2 : outputs the inverted value false/true<br/>
+output1 : outputs the value true/false<br/>
+output2 : outputs the inverted value false/true<br/>
 <br/>
 
 ### NODE CONFIGURATION
@@ -239,8 +241,8 @@ Pass <code>msg.payload = true</code> to start blinking</br>
 Pass <code>msg.payload = false</code> to stop blinking</br>
 Pass <code>msg.interval = 2000</code> to change the blinking interval</br>
 
-- PIN1 stop behavior : when the blinker receives the stop message, you can select the behavior of the pin1<br/>
-- PIN2 stop behavior : when the blinker receives the stop message, you can select the behavior of the pin2<br/>
+- output1 stop behavior : when the blinker receives the stop message, you can select the behavior of the output1<br/>
+- output2 stop behavior : when the blinker receives the stop message, you can select the behavior of the output2<br/>
 
 
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/blinker.png' width='60%'>
@@ -259,7 +261,7 @@ Pass <code>msg.interval = 2000</code> to change the blinking interval</br>
 
 # SIMPLE OUTPUT ULTIMATE
 
-The pourpose of this node is to send a message with payload TRUE on the first pin and FALSE on second pin, independently from the msg input.<br />
+The pourpose of this node is to send a message with payload TRUE on the first output and FALSE on second output, independently from the msg input.<br />
 This is useful if you need to simply send a true or false payload.
 
 ### NODE CONFIGURATION
@@ -275,7 +277,7 @@ This is useful if you need to simply send a true or false payload.
 
 <details><summary>CLICK HERE, copy and paste it into your flow</summary>
 <code>
-[{"id":"e1149e22.c9b298","type":"inject","z":"81a64dae.012c18","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":100,"y":820,"wires":[["6a419c72.5a4e7c"]]},{"id":"6a419c72.5a4e7c","type":"SimpleOutputUltimate","z":"81a64dae.012c18","name":"T/F","x":290,"y":820,"wires":[["8ba3f611.26beb8"],["b469193b.950598"]]},{"id":"8ba3f611.26beb8","type":"debug","z":"81a64dae.012c18","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":530,"y":800,"wires":[]},{"id":"b469193b.950598","type":"debug","z":"81a64dae.012c18","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":530,"y":840,"wires":[]},{"id":"2451f593.04e62a","type":"comment","z":"81a64dae.012c18","name":"Whatever the input is, output msg with payload TRUE on first and FALSE on second pin.","info":"","x":330,"y":760,"wires":[]}]
+[{"id":"e1149e22.c9b298","type":"inject","z":"81a64dae.012c18","name":"","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"onceDelay":0.1,"x":100,"y":820,"wires":[["6a419c72.5a4e7c"]]},{"id":"6a419c72.5a4e7c","type":"SimpleOutputUltimate","z":"81a64dae.012c18","name":"T/F","x":290,"y":820,"wires":[["8ba3f611.26beb8"],["b469193b.950598"]]},{"id":"8ba3f611.26beb8","type":"debug","z":"81a64dae.012c18","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":530,"y":800,"wires":[]},{"id":"b469193b.950598","type":"debug","z":"81a64dae.012c18","name":"","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":530,"y":840,"wires":[]},{"id":"2451f593.04e62a","type":"comment","z":"81a64dae.012c18","name":"Whatever the input is, output msg with payload TRUE on first and FALSE on second output.","info":"","x":330,"y":760,"wires":[]}]
 </code>
 </details>
 
@@ -287,8 +289,8 @@ This is useful if you need to simply send a true or false payload.
 
 # INJECT ULTIMATE
 
-The pourpose of this node is to send a message with payload TRUE on the first pin, FALSE on second pin and a TOGGLE (true/false) on the third pin, by pressing the pushbutton.<br />
-This is useful if you need to simply test your flow. The node is simpler as the default node-red inject node.
+The pourpose of this node is to send a message with payload TRUE on the first output, FALSE on second output and a TOGGLE (true/false) on the third output, by pressing the pushbutton.<br />
+This is useful if you need to simply test your flow. 
 
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/Inject.png' width='60%'>
 
@@ -439,7 +441,7 @@ Any message that arrives on input, will be passwd through to the output with the
 
 # RAILWAY SWITCH ULTIMATE
 
-The railway switcher, switches the input msg flow to one ot the two output pins (upper or lower).
+The railway switcher, switches the input msg flow to one ot the two outputs (upper or lower).
 
 <img src='https://raw.githubusercontent.com/Supergiovane/node-red-contrib-boolean-logic-ultimate/master/img/railroadSwitchScambio.png' width='80%'>
 
@@ -447,7 +449,7 @@ The railway switcher, switches the input msg flow to one ot the two output pins
 
 |Property|Description|
 |--|--|
-| Switcher topic | Whenever the node receives a payload from this **topic**, it switches the input messages to an output PIN. |
+| Switcher topic | Whenever the node receives a payload from this **topic**, it switches the input messages to an output. |
 | With Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 | Then | This property, allow you to auto toggle the selected start state after some time. |
 
@@ -458,8 +460,8 @@ The railway switcher, switches the input msg flow to one ot the two output pins
 
 **INPUT MSG WITH "TRIGGER" TOPIC**
 
-Pass <code>msg.payload = false</code> switches the msg input to the UPPER PIN</br>
-Pass <code>msg.payload = true</code> switches the msg input to the LOWER PIN</br>
+Pass <code>msg.payload = false</code> switches the msg input to the UPPER output</br>
+Pass <code>msg.payload = true</code> switches the msg input to the LOWER output</br>
 
 </br>
 

package/boolean-logic-ultimate/BlinkerUltimate.html

@@ -81,15 +81,21 @@
 	</div>
 </script>
 
-<script type="text/x-red" data-help-name="BlinkerUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="BlinkerUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+<br/>
+
+
+Pass <code>msg.payload = true</code> to start blinking</br>
+Pass <code>msg.payload = false</code> to stop blinking</br>
+Pass <code>msg.interval = 2000</code> to change the blinking interval</br>
 
 </script>

package/boolean-logic-ultimate/BooleanLogicUltimate.html

@@ -131,7 +131,7 @@
         <label for="node-input-inputCount"><i class="fa fa-step-forward"></i> Inputs count</label>
 		<input style="width:100px" type="text" id="node-input-inputCount" placeholder="Inputs count, for example: 2">
 	</div>
-	<div class="form-tips" style="margin-top: 8px;background-color:lightgreen;text-align:center">Inputs count: each incoming msg.topic represents one input.</div>
+	<div class="form-tips" style="margin-top: 8px;text-align:center">Inputs count: each incoming msg.topic represents one input.</div>
 <br/>
 	<div class="form-row">
         <label for="node-input-name"><i class="icon-tag"></i> Name</label>
@@ -191,14 +191,20 @@
 	<br/>
 </script>
 
-<script type="text/x-red" data-help-name="BooleanLogicUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="BooleanLogicUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+ 
+|Property|Description|
+|--|--|
+| Inputs count | Set the number of different topics to be evaluated. The node will output a message to the flow, after this number of *different* topics arrives. *Remember: each input topic must be different. For example, if you set this field to 3, the node expects 3 different topics.* |
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Filter output | **Output both 'true' and 'false'** results: Standard behaviour, the node will output <b>true</b> and <b>false</b> whenever it receives an input and calculate the boolean logics as output. **Output only 'true'** results: whenever the node receives an input, it outputs a payload <b>true</b> only if the result of the logic is true. <b>False</b> results are filtered out. |
+| Trigger mode | **All topics**: standard behaviour, the node will evaluate each input topic and ouputs the values. At each input change, it will output a msg on the flow. **Single topic + eval other inputs**: the node evaluates all the input topics, but only whenever it receives a msg input with the **specified topic**, it  outputs a msg to the flow.|
+| If input states are undefined | Every time you create a node or modify the node, all inputs are set to undefined. This means that the node will wait the arrive of all topics (for example 3 topics, if you've selected 3 topics in the option), before it can output a payload. This can be a problem if your logic must be operative as soon as you deploy the flow. To overcome this problem, you can "initialize" all the undefined inputs with True or False. **Leave undefined**: Standard behaviour, the node will wait all the "undefined" topics to arrive, then starts a flow with the result. **True or False**: The node is immediately operative, by force the initialization of the "undefined" inputs with "true" or "false".|
+| Remember latest input values after reboot | If checked, the input values are retained after a node-red reboot. That means, that if you reboot your node-red, you don't need to wait all inputs to arrive and initialize the node, before the node can output a payload. Every time you modify the node's config, <b>the retained values are cleared</b>.|
+| Reject non boolean (true/false) input values | If checked, the node will accept only boolean true/false values. Otherwise, it will try to convert the payload value to a logic true/false boolean. |
+| Delay evaluation (ms) | Delays the evaluation until this time (in milliseconds) is elapsed. Each time a message or "topic trigger message" (see **Trigger mode**) arrives, the delay is restarted. This option is useful for debouncing pourposes or simply for adding some delay. For example, you can turn on a light if the room is occupied for a long time, allowing people to fast transit repeatedly, without the need of turning the light on. Another example, if you have many sensors changing state rapidly, you can wait until these sensor reach a quiet state, then evaluate the inputs.|
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
 </script>

package/boolean-logic-ultimate/FilterUltimate.html

@@ -55,15 +55,19 @@
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="FilterUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="FilterUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+This node has 2 outputs.<br />
+If the input payload is true, the node will send <code>true</code> on output 1 and nothing on output 2<br />
+If the input payload is false, the node will send nothing on output 1 and <code>false</code> on output 2<br />
+The input message is preserved and passed to the output, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
 
 </script>

package/boolean-logic-ultimate/ImpulseUltimate.html

@@ -81,15 +81,33 @@
 
 </script>
 
-<script type="text/x-red" data-help-name="ImpulseUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="ImpulseUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The pourpose of this node is to send a sequence of pulsed commands to for example, open a garage door or to command an appliance requiring a set of timed commands.<br />
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+**Avaiable Commands**<br />
+Commands are to be wrote in the format: command:value. For example ***send:200***, ***wait:2000***. Each row represents a command.<br />
+<br /><b>send</b><br />
+sends a value. For example: ***send:true*** or ***send:100*** or ***send:Hello***<br />
+<br /><b>wait</b><br />
+wait for specified time (in milliseconds). For example ***wait:500*** waits for 500 milliseconds<br />
+<br /><b>restart</b><br />
+Restart the sequence from the beginning. Use ***restart*** alone, without **:** and extra value. For example ***restart*** <br />
+<br /><b>//</b><br />
+comment. For example: ***// This opens the garage***. The comment are ignored, so you can write what you want.<br />
+<br />
+
+Pass <code>msg.payload = true</code> to the node to start the sequence</br>
+Pass <code>msg.payload = false</code> to the node to stop the running sequence</br>
+<br />
+
+- Output: the node outputs a message you specified in the command textbox<br/>
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
-	
 </script>

package/boolean-logic-ultimate/InjectUltimate.html

@@ -76,15 +76,13 @@
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="InjectUltimate">
-    <p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="InjectUltimate">
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The pourpose of this node is to send a message with payload TRUE on the first output, FALSE on second output and a TOGGLE (true/false) on the third output, by pressing the pushbutton.<br />
+This is useful if you need to simply test your flow. 
 
 </script>

package/boolean-logic-ultimate/InterruptFlowUltimate.html

@@ -86,15 +86,26 @@
 	</div>
 </script>
 
-<script type="text/x-red" data-help-name="InterruptFlowUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="InterruptFlowUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
+The interrupt flows is able to stop the input messages to exiting the node.
+
+### NODE CONFIGURATION
+
+|Property|Description|
+|--|--|
+| Trigger by topic | Whenever the node receives a payload = false from this topic,it stops output messages to the flow. As soon it receives payload = true from this topic, the output messages start to flow out again. The node will output the current stored message plus an added property "isReplay = true", as soon as it receives a ***msg.play = true*** from this topic. The node will clear the current stored message, as soon as it receives a ***msg.reset = true*** from this topic. |
+| With Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Then | This property, allow you to auto toggle the selected start state (pass or block) after a timer has elapsed. You can choose from some pre-defined delays. If you have, for example, an Homekit-Bridged nodeset with a thermostat node or security system node in your flow, once node-red restarts, these homekit nodes output a default message to the flow. Just put an InterruptFlow node with a "block at start" behaviour and a toggle delay enabled behind homekit nodes, to temporary stop the chained nodes to receive the unwanted startup message.|
+
+**INPUT MSG WITH "TRIGGER" TOPIC**
+
+Pass <code>msg.payload = true</code> to allow messages to pass through</br>
+Pass <code>msg.payload = false</code> to prevent messages from passing through</br>
+Pass <code>msg.play = true</code> from a message having the "trigger" topic, to replay the last stored message</br>
+Pass <code>msg.reset = true</code> from a message having the "trigger" topic, to clear the last stored message</br>
 
 </script>

package/boolean-logic-ultimate/InvertUltimate.html

@@ -42,15 +42,17 @@
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="InvertUltimate">
-    <p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="InvertUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+Outputs the inverted input. For example true -> false<br />
+The input message is preserved and passed to the output, changing only the topic and the payload. If the input message has it's own topic, it'll be preserved as well.<br/>
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
 
 </script>

package/boolean-logic-ultimate/RailwaySwitchUltimate.html

@@ -87,15 +87,23 @@
 	</div>
 </script>
 
-<script type="text/x-red" data-help-name="RailwaySwitchUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="RailwaySwitchUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The railway switcher, switches the input msg flow to one ot the two outputs (upper or lower).
+
+|Property|Description|
+|--|--|
+| Switcher topic | Whenever the node receives a payload from this **topic**, it switches the input messages to an output. |
+| With Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+| Then | This property, allow you to auto toggle the selected start state after some time. |
+
+**INPUT MSG WITH "TRIGGER" TOPIC**
+
+Pass <code>msg.payload = false</code> switches the msg input to the UPPER output</br>
+Pass <code>msg.payload = true</code> switches the msg input to the LOWER output</br>
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
 
 </script>

package/boolean-logic-ultimate/SimpleOutputUltimate.html

@@ -46,15 +46,17 @@
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="SimpleOutputUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="SimpleOutputUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The pourpose of this node is to send a message with payload TRUE on the first output and FALSE on second output, independently from the msg input.<br />
+This is useful if you need to simply send a true or false payload.
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
 
 </script>

package/boolean-logic-ultimate/StatusUltimate.html

@@ -41,15 +41,15 @@
     </div>
 </script>
 
-<script type="text/x-red" data-help-name="StatusUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="StatusUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The pourpose of this node is to show a status of the passingthrough message.<br />
+
+**Show msg.**
+
+- Write here the property you want to get the status from. For example, "payload", "mycar.color", etc.
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
-    
 </script>

package/boolean-logic-ultimate/SumUltimate.html

@@ -55,15 +55,16 @@
 	</div>
 </script>
 
-<script type="text/x-red" data-help-name="SumUltimate">
-	<p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="SumUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
+
+The pourpose of this node is to do maths on the incoming values. Each incoming message MUST HAVE OWN TOPIC.<br />
+
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
     
 </script>

package/boolean-logic-ultimate/toggleUltimate.html

@@ -44,7 +44,7 @@
 	<div class="form-row">
 		<label style="width:160px" for="node-input-valueToToggle"><i class="fa fa-toggle-on"></i> Initial value</label>
 		<select type="text" id="node-input-valueToToggle" placeholder="">
-			<option value="true">Initialize wiht True</option>
+			<option value="true">Initialize with True</option>
 			<option value="false">Initialize with False</option>			
 		</select>
 	</div>
@@ -59,15 +59,18 @@
 	
 </script>
 
-<script type="text/x-red" data-help-name="toggleUltimate">
-    <p>
-        SEE THE README FOR HELP CONFIGURING THE NODE
-    </p>
+<script type="text/markdown" data-help-name="toggleUltimate">
+[SEE THE README FOR FULL HELP AND SAMPLES](https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate)
 
-	<p>
-		<a href="https://github.com/Supergiovane/node-red-contrib-boolean-logic-ultimate" target="_blank">Click here to learn how to configure the node.</a>
-	</p>
+[Find it useful?](https://www.paypal.me/techtoday)
 
-	<a href="https://www.paypal.me/techtoday" target="_blank"><img src='https://img.shields.io/badge/Donate-PayPal-blue.svg?style=flat-square' width='30%'></a>
+The pourpose of this node is to toggle between true/false, everytime an inboud message arrives.<br />
 
+|Property|Description|
+|--|--|
+| Input | Set the property where the input payload is. *By default, it is "payload", but you can also specify other properties, for example "payload.value"* |
+
+**INPUT**<br />
+
+Any message that arrives on input, will be passwd through to the output with the payload toggled between true and false.
 </script>

package/boolean-logic-ultimate/utils.js

@@ -22,6 +22,9 @@ module.exports.ToBoolean = function ToBoolean(value) {
         if (value.toLowerCase() === "true") return true;
         if (value.toLowerCase() === "false") return false;
 
+        if (value.toLowerCase() === "home") return true;
+        if (value.toLowerCase() === "not_home") return false;
+
     } else if (typeof value === 'number') {
         // Is it formated as a decimal number?
         if (decimal.test(value)) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "node-red-contrib-boolean-logic-ultimate",
-    "version": "1.0.56",
+    "version": "1.0.58",
     "description": "A set of Node-RED enhanced boolean logic and utility nodes, flow interruption, blinker, invert, filter, toggle etc.., with persistent values after reboot. Compatible also with Homeassistant values.",
     "author": "Supergiovane (https://github.com/Supergiovane)",
     "dependencies": {