Timers - stodev-com-br/Tasmota GitHub Wiki
» v5.13.1
To control a device locally 16 timers are programmable. They can be configured with the Timer<x>
command followed 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}
JSON Name | JSON Value |
---|---|
Arm |
0 = disarm or disable timer1 = arm or enable timer |
Mode |
0 = use clock time1 = Use local sunrise time using Longitude , Latitude and Time offset2 = use local sunset time using Longitude , Latitude and Time offset |
Time |
hh:mm = set time in hours 0 .. 23 and minutes 0 .. 59 -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 once1 = repeat timer execution |
Output |
1..16 = select an output to be used if no rule is enabled |
Action |
0 = turn output OFF1 = turn output ON2 = TOGGLE output3 = RULE/BLINKIf the Tasmota 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.If Rules are not compiled, BLINK output using BlinkCount parameters. |