Wb-rules: различия между версиями
(→Примеры правил и решения сообщества: поправил ссылку) |
|||
(не показано 15 промежуточных версий 4 участников) | |||
Строка 2: | Строка 2: | ||
== Описание == | == Описание == | ||
[[File:Wb rules demo.png|300px|thumb|right|Редактирование правил в веб-интерфейсе]] | [[File:Wb rules demo.png|300px|thumb|right|Редактирование правил в веб-интерфейсе]] | ||
wb-rules | {{note|note| Читайте полное описание движка правил на [https://github.com/wirenboard/wb-rules Github].}} | ||
Wb-rules это возможность писать правила на языке JS ([https://es5.javascript.ru/ ECMAScript 5]). В первую очередь нужно понимать, что такое JS. Знать синтаксис, как происходит работа с функциями, переменными и основными языковыми конструкциями. Подробнее про язык можно узнать в официальном учебнике https://learn.javascript.ru/ | |||
Если вы не готовы программировать, возможно вам стоит попробовать создавать правила в среде [[Node-Red | Node-RED]]. | |||
Если ваше правило не работает или показывает красным строку и вы не понимаете причину, то возможно вы можете получить дополнительную информацию в [[Wiren_Board_Web_Interface#logs|Системном журнале]], который можно отфильтровать по имени сервиса — wb-rules. | |||
По умолчанию движок правил wb-rules предустановлен на контроллер и запускается автоматически. Но вы можете управлять им самостоятельно из консоли контроллера, читайте подробнее в статье [[How to diagnose#Управление сервисами | Диагностика ошибок в работе контроллера Wiren Board]]. | |||
== Как создавать и редактировать правила == | == Как создавать и редактировать правила == | ||
Правила хранятся на контроллере в папке <code>/etc/wb-rules/</code>, поэтому вы можете [[Просмотр файлов контроллера с компьютера|редактировать и загружать их напрямую с компьютера]] или использовать [[Wiren Board Web Interface | веб-интерфейс]], вкладка '''Rules'''. | |||
Если в правиле нет ошибок, оно начинает работать сразу после сохранения файла. | |||
Подробнее о создании правил и возможностях wb-rules, читайте в [https://github.com/wirenboard/wb-rules документации на Github]. | |||
Примеры правил смотрите: | |||
Примеры правил: | |||
* в статье [[Rule_Examples|Примеры правил]]; | * в статье [[Rule_Examples|Примеры правил]]; | ||
* в [http://forums.contactless.ru/t/dvizhok-pravil-primery-koda/483 специальной теме на портале техподдержки]; | |||
* в [ | |||
Проекты сообщества на wb-rules: | Проекты сообщества на wb-rules: | ||
* Конвертер ESPHome → Wiren Board: [https://github.com/ | * Конвертер ESPHome → Wiren Board: [https://github.com/wb-adegtyarev/esphome2wb esphome2wb]. | ||
* Конвертер OpenMQTTGateway → Wiren Board [https://github.com/ | * Конвертер OpenMQTTGateway → Wiren Board [https://github.com/wb-adegtyarev/omg2wb omg2wb]. | ||
* Телеграм-бот [https://github.com/ | * Телеграм-бот [https://github.com/wb-adegtyarev/telegram2wb telegram2wb]. | ||
== Версии wb-rules и совместимость скриптов == | == Версии wb-rules и совместимость скриптов == |
Версия 15:17, 2 августа 2022
Описание
Читайте полное описание движка правил на 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, то прочитайте статью Совместимость скриптов — в ней мы описали возможные проблемы и пути решения.