Движок правил wb-rules
Описание
Читайте полное описание движка правил на Github. Wb-rules это возможность писать правила на языке JS (ECMAScript 5). В первую очередь нужно понимать, что такое JS. Знать синтаксис, как происходит работа с функциями, переменными и основными языковыми конструкциями. Подробнее про язык можно узнать в официальном учебнике https://learn.javascript.ru/
Если вы не готовы программировать, возможно вам стоит попробовать создавать правила в среде Node-RED.
Если ваше правило не работает или показывает красным строку и вы не понимаете причину, то возможно вы можете получить дополнительную информацию в Системном журнале, который можно отфильтровать по имени сервиса — wb-rules.
По умолчанию движок правил wb-rules предустановлен на контроллер и запускается автоматически. Но вы можете управлять им самостоятельно из консоли контроллера, читайте подробнее в статье Диагностика ошибок в работе контроллера Wiren Board.
Как создавать и редактировать правила
Правила хранятся на контроллере в папке /etc/wb-rules/, поэтому вы можете редактировать и загружать их напрямую с компьютера или использовать веб-интерфейс, вкладка Rules.
Если в правиле нет ошибок, оно начинает работать сразу после сохранения файла.
Подробнее о создании правил и возможностях wb-rules, читайте в документации на Github.
Примеры правил смотрите:
- в статье Примеры правил;
- в специальной теме на портале техподдержки;
Проекты сообщества на wb-rules:
- Конвертер ESPHome → Wiren Board: esphome2wb.
- Конвертер OpenMQTTGateway → Wiren Board omg2wb.
- Телеграм-бот telegram2wb.
Версии wb-rules и совместимость скриптов
Существует две версии движка:
- wb-rules 1.7 — устаревшая версия, поддерживаются контроллеры Wiren Board 5 и 6.
- wb-rules 2.0 — актуальная версия, поддерживаются контроллеры Wiren Board 6 и 7.
Если у вас контроллер Wiren Board 6 из первых партий и вы переходите с версии 1.7 на 2.0, то прочитайте статью Совместимость скриптов — в ней мы описали возможные проблемы и пути решения.