Cleaning Timer

January 15, 2020 · View on GitHub

Gets / Sets the automatic start of the cleaning process. It uses a cron-like notation of the cleaning schedule.

Get Cleaning Timer

Command

KeyValueComment
method"get_timer"
ididRandom integer which is returned in the response used to link request and response.

Example

{
    "method": "get_timer",
    "id": 173
}

Response

KeyExampleDescription
-"1498595924541"timer_id corresponds to entry time of this schedule (Unix time)
-"on"Is this schedule active
-["38 9 28 6 *", ["start_clean", ""]]]Timing in cron-like notation. The time appears to be China timezone based (e.g. in Europe add + 6 hours to the CET time)
   ┌───────────── minute (0 - 59)
   │ ┌───────────── hour (0 - 23)
   │ │ ┌───────────── day of month (1 - 31)
   │ │ │ ┌───────────── month (1 - 12)
   │ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday,
   │ │ │ │ │                                       7 is also Sunday)
   │ │ │ │ │
   │ │ │ │ │
   * * * * *      command to execute + parameter
 ["1 5 * * 0,6", ["start_clean", ""]]]

Example

{
    "result": [
        ["1498595924541", "on", ["38 10 * * 0,6", ["start_clean", ""]]],
        ["1498595904821", "on", ["38 5 * * 1,2,3,4,5", ["start_clean", ""]]],
        ["1498595882094", "on", ["38 9 28 6 *", ["start_clean", ""]]]
    ],
    "id": 173
}

Set Cleaning Timer

Command

KeyValueComment
method"set_timer"
params[[timer_id, [schedule, [command, parameter]]]]See above for the schedule settings. timer_id is used as sort of record id
ididRandom integer which is returned in the response used to link request and response.

Example

{
    "method": "set_timer",
    "params": [["1498595904821", ["30 12 * * 1,2,3,4,5", ["start_clean", ""]]]],
    "id": 1734
}

Response

Standard response to succeeded command.

Example

{
    "result": ["ok"],
    "id": 1734
}

Enable/Disable Cleaning Timer

Command

KeyValueComment
method"upd_timer"
params[timer_id, de/active]timer_id see get_timer, activate = "on", deactive = "off"
ididRandom integer which is returned in the response used to link request and response.

Example

{
    "method": "upd_timer",
    "params": ["1498595904821", "off"],
    "id": 634
}

Response

Standard response to succeeded command.

Example

{
    "result": ["ok"],
    "id": 634
}