Add sunrise and sunset mandatory offset

Theo Arends 2018-04-15 12:56:37 +02:00
parent b5678b9f1c
commit 311383215b
1 changed files with 9 additions and 5 deletions

@ -191,10 +191,13 @@ WattRes | 0..3 | Set Power Resolution
### Timers ### Timers
To control a device locally 16 Timers are available. They can be configured with the Timer\<x\> command following by a JSON string with optional parameters. Full command examples are: To control a device locally 16 Timers are available. They can be configured with the Timer\<x\> command following by a JSON string with optional parameters. Full command examples are:
``` ```
Timer1 {"Arm":1,"Mode":1,"Time":"09:23","Days":"--TW--S","Repeat":1,"Output":1,"Action":1} Timer1 {"Arm":1,"Time":"02:23","Days":"--TW--S","Repeat":1,"Output":1,"Action":1}
Timer4 {"Arm":1,"Time":"16:23","Days":"SM00TF0","Repeat":0,"Output":2,"Action":2} Timer4 {"Arm":1,"Time":"16:23","Days":"SM00TF0","Repeat":0,"Output":2,"Action":2}
``` ```
When define USE_SUNRISE is enabled commands Latitude and Longitude together with parameter mode become available. When define USE_SUNRISE is enabled commands ``Latitude`` and ``Longitude`` together with parameter mode 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","Days":"11TW11S","Repeat":1,"Output":1,"Action":1}
```
Each parameter will be documented below. Each parameter will be documented below.
@ -215,13 +218,14 @@ JSON Parameter | Value | Description
Arm | 0 | Dis-arm or disable timer Arm | 0 | Dis-arm or disable timer
Arm | 1 | Arm or enable timer Arm | 1 | Arm or enable timer
Mode | 0 | Use clock time Mode | 0 | Use clock time
Mode | 1 | Use local sunrise time using Longitude and Latitude Mode | 1 | Use local sunrise time using Longitude, Latitude and Time offset
Mode | 2 | Use local sunset time using Longitude and Latitude Mode | 2 | Use local sunset time using Longitude, Latitude and Time offset
Time | "hh:mm" | Set time in hours 0 .. 23 and minutes 0 .. 59 Time | "hh:mm" | Set time in hours 0 .. 23 and minutes 0 .. 59
Time | "-hh:mm" | Set time in offset hours of -11 .. 12 and minutes 0 .. 59 used with Mode 1 and 2
Days | "SMTWTFS" | Set day of weeks mask where "0" or "-" = Off and any different character = On Days | "SMTWTFS" | Set day of weeks mask where "0" or "-" = Off and any different character = On
Repeat | 0 | Allow timer only once Repeat | 0 | Allow timer only once
Repeat | 1 | Repeat timer execution Repeat | 1 | Repeat timer execution
Output | 1 .. 16 | Select an output to be used Output | 1 .. 16 | Select an output to be used if no rule is enabled
Action | 0 | Turn output Off Action | 0 | Turn output Off
Action | 1 | Turn output On Action | 1 | Turn output On
Action | 2 | Toggle output On or Off Action | 2 | Toggle output On or Off