mirrors
/
Tasmota
mirror of https://github.com/arendst/Tasmota.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Created Timers (markdown)

blakadder 2019-10-27 20:31:00 +01:00
parent 949a044329
commit 400e8cc916
1 changed files with 35 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
Timers.md Normal file

@ -0,0 +1,35 @@
To control a device locally 16 timers are programmable. They can be configured with the Timer\<x\> command following by a JSON payload with optional parameters. For example:
Timer 1 will ENABLE output of POWER1 at exactly 2:23 every Tue/Wed and Sat
```
Timer1 {"Arm":1,"Time":"02:23","Window":0,"Days":"--TW--S","Repeat":1,"Output":1,"Action":1}
```
Timer 4 will TOGGLE output of POWER2 within a 30 minute window centered around 16:23 each Sunday, Monday, Thursday and Friday and will disable (disarm) after executing.
```
Timer4 {"Arm":1,"Time":"16:23","Window":15,"Days":"SM00TF0","Repeat":0,"Output":2,"Action":2}
```
When `Mode 1` or `Mode 2` is used, `Latitude` and `Longitude` become available. In that case the `Time` value is **always** used as an offset so make sure to set it to `00:00` if no offset is wanted.
```
Timer1 {"Arm":1,"Mode":2,"Time":"-2:23","Window":0,"Days":"11TW11S","Repeat":1,"Output":1,"Action":1}
```
<a id="tb-timers">Command|Parameters
:---|:---
Latitude<a id="Latitude"></a>|**5.13.1**<BR>`<value>` = set latitude
Longitude<a id="Longitude"></a>|**5.13.1**<BR>`<value>` = set longitude
Timers<a id="Timers"></a>|**5.13.0**<BR>Timers control<BR>&emsp; » v6.2.0<BR>`0` = disable all timers<BR>`1` = enable all timers<BR>`2` = toggle all timers<BR>
Timer\<x\><a id="Timer"></a>|**5.13.0**<BR>Parameters for Timer\<x\> where x = `1..16`<BR>&emsp; » v6.2.0<BR>`0` = clear parameters for Timer\<x\><BR>`1..16` = copy Timer\<y\> parameters to Timer\<x\><BR>`{ "name":value ; .. }` = set all or individual parameters using [JSON payload](#timerJSON) with names and values of data pairs from the [table below](#timerJSON)
<a id="timerJSON"></a>JSON Name|JSON Value
:---|:---
Arm|`0` = disarm or disable timer<BR>`1` = arm or enable timer
Mode|`0` = use clock time<BR>`1` = Use local sunrise time using `Longitude`, `Latitude` and `Time` offset<BR>`2` = use local sunset time using `Longitude`, `Latitude` and `Time` offset
Time|`hh:mm` = set time in hours `0 .. 23` and minutes `0 .. 59`<BR>`-hh:mm` = set time in offset hours `-11 .. 12` and minutes `0 .. 59` (used with `Mode 1` and `Mode 2`)
Window|`0..15` = add or subtract a random number of minutes to `Time`
Days|`SMTWTFS` = set day of weeks mask where `0` or `-` = OFF and any different character = ON
Repeat|`0` = allow timer only once<BR>`1` = repeat timer execution
Output|`1..16` = select an output to be used if no rule is enabled
Action|`0` = turn output OFF<BR> `1` = turn output ON<BR>`2` = TOGGLE output<BR>`3` = RULE/BLINK<ul><li>If the Tasmota [Rules](#rules) feature has been activated by compiling the code (activated by default in all pre-compiled Tasmota binaries), a rule with `Clock#Timer=<timer>` will be triggered if written and turned on by the user.</li><li>If Rules are not compiled, BLINK output using [BlinkCount](#BlinkCount) parameters.</li></ul>