Skip to content

Latest commit

 

History

History
38 lines (32 loc) · 2.77 KB

Timers.md

File metadata and controls

38 lines (32 loc) · 2.77 KB

?> Timers allow you to automate your device based on time triggers.

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}

Commands

Command Parameters
Latitude <value> = set latitude
Longitude <value> = set longitude
Timers Timers control
0 = disable all timers  » v6.2.0
1 = enable all timers
2 = toggle all timers
Timer<x> Parameters for Timer<x> where x = 1..16
0 = clear parameters for Timer<x>  » v6.2.0
1..16 = copy Timer<y> parameters to Timer<x>
{ "name":value ; .. } = set all or individual parameters using JSON payload with names and values of data pairs from the table below

JSON Payload Anatomy

JSON Name JSON Value
Arm 0 = disarm or disable timer
1 = arm or enable timer
Mode 0 = use clock time
1 = Use local sunrise time using Longitude, Latitude and Time offset
2 = 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 once
1 = repeat timer execution
Output 1..16 = select an output to be used if no rule is enabled
Action 0 = turn output OFF
1 = turn output ON
2 = TOGGLE output
3 = RULE/BLINK
If 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.