Движок правил wb-rules

From Wiren Board
This is the approved revision of this page, as well as being the most recent.

Описание

Редактирование правил в веб-интерфейсе

Читайте полное описание движка правил на 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, то прочитайте статью Совместимость скриптов — в ней мы описали возможные проблемы и пути решения.