Файл базы данных
База данных это файл, в котором хранится описание устройств. По умолчанию это /opt/homed-custom/database.json
. Путь к файлу базы данных может быть изменен в конфигурации. Не обязательно редактировать базу данных автоматизаций вручную, намного проще настраивать устройства через веб-интерфейс.
Структура базы данных
База данных HOMEd Сustom это JSON-объект. Общая структура базы данных выглядит так:
{
"automations":
[
{
"active": true,
"name": "my automation 1",
"triggers":
[
...
],
"conditions":
[
...
],
"actions":
[
...
]
},
{
"active": true,
"name": "my automation 2",
"debounce": 10,
"restart": true,
"triggers":
[
...
],
"actions":
[
...
]
}
],
"states":
{
...
}
}
Параметры автоматизаций
active
Включение/выключение автоматизации.
name
Название автоматизации, чтобы было проще отличать автоматизации друг от друга.
debounce
Минимальный допустимый интервал между срабатываниями автоматизации в секундах.
restart
В случае, когда автоматизация содержит действия задержки выполения, автоматизация будет "перезапущена", если значение этого поля установлено как true
. В противном случае повторное срабатывание триггеров будет проигнорировано до истечения времени задержки.
triggers
Массив триггеров автоматизации. Триггеры это события, которые вызывают срабатывание автоматизации, такие как изменение состояния устройства или выход какого-то параметра за заданный предел.
conditions
Массив условий автоматизации. Автоматизация сработает только в случае, если заданные условия выполнены. Данное поле не является обязательным.
actions
Массив действий автоматизации. Действия это итоговый результат автоматизации, например, действие может изменить состояние устройства или отправить сообщение в Telegram.
Состояния
Состояния это способ обмена данными между автоматизациями. У каждого состояния есть название. Состояния могут быть установлены или удалены соответсующими действиями и могут использоваться в условиях. В базе данных состояния сохраняются во вложенном объекте "states"
:
{
"states":
{
"windowIsOpen": true,
"mySpecialState": "hello",
"numericData": 24.2,
...
}
}
Примеры
{
"automations":
[
{
"active": true,
"name": "управление лампой на столе",
"triggers":
[
{
"type": "property",
"endpoint": "zigbee/freePad/1",
"property": "action",
"equals": "singleClick"
}
],
"conditions":
[
{
"type": "property",
"endpoint": "zigbee/roomLight/2",
"property": "status",
"equals": "off"
}
],
"actions":
[
{
"type": "property",
"endpoint": "zigbee/tableLight",
"property": "status",
"value": "toggle"
}
]
},
{
"active": true,
"name": "управление светом в комнате",
"triggers":
[
{
"type": "property",
"endpoint": "zigbee/freePad/2",
"property": "action",
"equals": "singleClick"
},
{
"type": "telegram",
"message": "включи свет в комнате"
}
],
"actions":
[
{
"type": "property",
"endpoint": "zigbee/roomLight/2",
"property": "status",
"value": "on"
}
]
},
{
"active": true,
"name": "уведомление о похолодании",
"triggers":
[
{
"type": "property",
"endpoint": "zigbee/outdoorTemperature",
"property": "temperature",
"below": 10
}
],
"actions":
[
{
"type": "telegram",
"message": "на улице холодно"
}
]
}
]
}