Действие "property"
Это действие управляет выбранным свойством, то есть отправляет команду устройству. Примеры описания действия:
...
"actions":
[
{
"type": "property",
"endpoint": "zigbee/kitchenLight",
"property": "level",
"increase": 10
},
{
"type": "property",
"endpoint": "zigbee/roomCurtain",
"property": "position",
"decrease": 25
},
{
"type": "property",
"endpoint": "zigbee/hallLight",
"property": "status",
"value": "off"
}
]
...
Поля "increase", "decrease", "value" не могут использоваться в одном действии одновременно.
endpoint
Конечная точка, которой управляет действие. Описывается в формате "сервис/устройство" или "сервис/устройство/N", где N это номер конечной точки для многоканальных устройств.
По сути, значение этого поля идентично части MQTT-топика для отправки команд устройству после homed/td/.
property
Свойство конечной точки, которым управляет действие. Другими словами - название поля в сообщении с командой.
increase
В команде будет передано числовое значение свойства, увеличенное на значение этого поля.
decrease
В команде будет передано числовое значение свойства, уменьшенное на значение этого поля.
value
Конкретное значение свойства, передаваемое в команде. Текстовое значение состояния может содержать шаблоны.
Действие "mqtt"
Это действие отправляет сообщение в заданный MQTT-топик. Примеры описания действия:
...
"actions":
[
{
"type": "mqtt",
"topic": "my/action/topic",
"message": "hello world"
},
{
"type": "mqtt",
"topic": "other/topic",
"message": "retained message",
"retain": true
}
]
...
topic
MQTT-топик.
message
Текст отправляемого сообщения. Сообщение может содержать шаблоны.
retain
Отправка сообщения с флагом retain.
Действие "state"
Это действие позволяет устанавливать или удалять состояния. Примеры описания действий:
...
"actions":
[
{
"type": "state",
"name": "myFavoriteState",
"value": true
},
{
"type": "state",
"name": "otherState",
"value": "hello there"
},
{
"type": "state",
"name": "uselessState"
}
]
...
name
Название состояния.
value
Значение состояния, устанавливаемое действием. Текстовое значение состояния может содержать шаблоны. Если это поле остутствует или равно null, состояние будет удалено.
Действие "telegram"
Это действие отправляет текстовое сообщение с помощью Telegram-бота. Пример описания действия:
...
"actions":
[
{
"type": "telegram",
"message": "свет в гараже выключен",
"silent": true
},
{
"type": "telegram",
"message": "входная дверь открыта!",
"chats": [123456789, 4815162342]
}
]
...
message
Текст отправляемого сообщения. Сообщение может содержать шаблоны.
silent
Отправка сообщения с уведомлением без звука.
chats
Массив идентификаторов чатов, в которые будет отправлено сообщение. В случае отсутствия этого поля сообщение будет отправлено в чат, идентификатор которого указан в конфигурации.
Действие "shell"
Это действие запускает заданную shell-команду. Пример описания действия:
...
"actions":
[
{
"type": "shell",
"command": "sh /home/user/script.sh"
}
]
...
command
Shell-команда, которая будет запущена. Команда может содержать шаблоны.
Действие "condition"
Это действие является контейнером для других действий, которые будут выполнены при соблюдении или несоблюдении заданных условий. Пример описания действия:
...
"actions":
[
{
"type": "condition",
"conditions":
[
{
"type": "date",
...
},
{
"type": "time",
...
}
],
"then":
[
{
"type": "property",
...
}
],
"else":
[
{
"type": "telegram",
...
}
]
}
]
...
conditions
Массив условий.
then
Массив действий, которые будут выполнены, если условия соблюдены.
else
Массив действий, которые будут выполнены, если условия не соблюдены.
Действие "delay"
Это действие добавляет задержку перед выполнением следующего по списку действия. Пример описания действия:
...
"actions":
[
{
"type": "delay",
"delay": 10
}
]
...
delay
Время задержки в секундах.
Дополнительные условия
Условия для выполнения действий могут определяться не тольлько действием "condition", но и тем, какой именно триггер вызвал срабатывание автоматизации, если для триггеров заданы имена. В этом случае нужные действия будут выполнены только при срабатывании соответсвующего им триггера, например:
...
"actions":
[
{
"type": "property",
"triggerName": "a",
...
},
{
"type": "telegram",
"triggerName": "b",
...
}
]
...
Шаблоны
Шаблоны позволяют использовать в действиях свойства устройств, данные из MQTT-топиков, состояния, метки времени и имена триггеров. Примеры использования шаблонов приведены ниже.
Показания датчика температуры:
{{ property | zigbee/kitchenThermometer | temperature }}
MQTT-сообщение целиком:
{{ mqtt | test/topic }}
Поле fieldName из MQTT-сообщения, содержащего JSON:
{{ mqtt | test/json/topic | fieldName }}
Значение состояния myState:
{{ state | myState }}
Текущее время и дата:
{{ timestamp }}
Текущее время и дата в заданном формате:
{{ timestamp | dd.MM.yy hh:mm }}
Имя триггера, вызвавшего срабатывание автоматизации:
{{ triggerName }}
Кроме того, шаблоны могут содержать математические выражения. Каждое выражение может содержать любые математические операции (сложение, вычитание, умножение, деление, возведение в степень), включая операции в скобках, некоторые функции, а так же любые другие шаблоны. Если выражение некорретно, результатом вычислений будет nan. Список досутпных функций можно посмотреть здесь.
Примеры:
[[ sqrt(2 ^ 2) ]]
[[ {{ state | counter }} + 1 ]]
[[ {{ propery | zigbee/sensor | temperature }} * 0.99 ]]
В одном действии может быть использовано любое количество шаблонов и математических операций.