Differences

This shows you the differences between two versions of the page.

--- dictionary:unitcontrol:turnon [2019/06/09 13:45] – removed old color handling information and fixed discussion of simple/smart/simulated James Sentman
+++ dictionary:unitcontrol:turnon [2023/02/13 14:52] (current) – external edit 127.0.0.1
@@ Line 36: / Line 36: @@
 <code>
---create a scheduled event that will turn on the light in 30 minutes
+--create a scheduled event that will turn on the light immediately and then return it to it’s current state, which may or may not be Off, in 30 minutes.
 turnon "Kitchen Overhead" for (30 * minutes)
+</code>
+<code>
+--to guarantee that a light turns back off after a specific time you need to verify the current state. The “for” switch
+-- returns a light to the state it was at when the command is executed. If the light can be turned on or off by other scripts or
+-- people use 2 commands to specifically generate the command you want.
+turnon “Kitchen Overhead”
+turnoff “Kitchen Overhead” in 30 * minutes
 </code>
 <code>
 --create a scheduled event to turn on the light in 90 seconds
---and another event in 20 minutes and 90 seconds that will turn it back off again.
+--and another event in 20 minutes and 90 seconds that will return it to it’s current state.
 turnon "Kitchen Overhead" in 90 for (20 * minutes)
 </code>
@@ Line 48: / Line 56: @@
 <code>
 -- turn on the light at 8pm and off at 10pm that day
+-- note that the until switch is the same as the for switch above. The light will
+-- return to it’s current state which is not necessarily off.
 turnon “outside light” at date (“8:00pm”) until date (“10:00pm”)
 </code>
@@ Line 70: / Line 80: @@
 turnon “my color device” rgb color “FF0000” for 2
 </code>
 ===Preset Levels===
 The behavior of the turn on command is dependent on the dimmable type setting of the unit.