Rule Examples: различия между версиями

var motion_timer_1_id = null;

defineRule("motion_detector_1", {

     whenChanged: "wb-gpio/D2_IN",

})();

</syntaxhighlight>

Импульсный счетчик подключен к WB-MCM8. Выдает 1 импульс на 10 литров воды. При подключении на счетчике были показания 123.120 м³, что равно 123120 литрам воды. У WB-MCM8 при подключении было насчитано 7 импульсов.

<syntaxhighlight lang="ecmascript">

var meterCorrection = 123120 // Корректировочное значение счетчика в литрах

var inpulseValue = 10 // Количество литров на один импульс

defineVirtualDevice("water_meters", { // Создаем виртуальный девайс для отображения в веб интерфейсе.

     title: "Счетчики воды",

});

defineRule("water_meter_1", {

     whenChanged: "wb-mcm8_29/Input 1 counter",

</syntaxhighlight>

{{Anchor|press-actions}}

=== Описание ===

Последние версии прошивок устройств Wiren Board могут распознавать типы нажатий подключённых к входам кнопок и транслировать их по [[Modbus]] на контроллер Wiren Board. О том, как устройство распознаёт типы нажатий, читайте в его документации.  

Для обработки нажатий нужно отслеживать на контроллере состояние счётчика нужного типа нажатия и, при его изменении, выполнять действие.

Обработку счётчиков удобно делать на [[wb-rules]], но вы можете использовать любой инструмент для автоматизации, например, [[Node-RED]]. Чтобы ускорить опрос счетчиков, настройте [[RS-485:Configuration via Web Interface#poll-period |период опроса]].

{{YouTube

|link=https://youtu.be/C60KB7TCeKg

# Короткое, а затем длинное — уменьшает яркость.

Так как изменение яркости требует растянутое во времени действие, то мы используем таймер. Также мы контролируем состояние входа с кнопкой и прекращаем действие при отпускании кнопки.

<syntaxhighlight lang="js">

/* ---------------------------- */

/* ---------------------------- */

defineRule({

   whenChanged: "wb-mcm8_20/Input 1 Single Press Counter",

/* ---------------------------- */

/* 2. Double Press Counter: Off action*/

/* ---------------------------- */

defineRule({

   whenChanged: "wb-mcm8_20/Input 1 Double Press Counter",

/* --------------------------------------- */

/* 3. Long Press Counter: Increase brightness */

/* --------------------------------------- */

defineRule({

   whenChanged: "wb-mcm8_20/Input 1 Long Press Counter",

});

// A rule that will increase the brightness on a timer

defineRule({

     var i = dev["wb-mdm3_58/Channel 1"];

       i++

       dev["wb-mdm3_58/Channel 1"] = i

/* -------------------------------------------- */

/* 4. Shortlong Press Counter: Decrease brightness */

/* -------------------------------------------- */

defineRule({

   whenChanged: "wb-mcm8_20/Input 1 Shortlong Press Counter",

});

// A rule that will decrease the brightness on a timer

defineRule({

     var i = dev["wb-mdm3_58/Channel 1"];

       i--

       dev["wb-mdm3_58/Channel 1"] = i

});

</syntaxhighlight>

Мы написали модуль для wb-rules [https://github.com/wirenboard/wb-community/tree/main/wb-press-actions wb-press-actions], который облегчает обработку нажатий в ваших скриптах.

При подключении датчика WB-MSW v.3 к контроллеру Wiren Board есть возможность создавать интересные сценарии, используя данные с датчика. На пример Включать свет по движению, сигнализировать светодиодами о превышении значения СО2 или VOC, Включать Кондиционер, если жарко или увлажнитель воздуха, если воздух слишком сухой. Правила создаются индивидуально под задачи. Здесь мы приведем несколько примеров для понимания принципа работы с датчиком. Больше примеров написания правил можно найти в документации '''[[Движок правил wb-rules]]'''.

При концентрации CO2 меньше 650 - раз в 10 секунд мигаем зеленым.

При концентрации CO2 свыше 651, но меньше 1000 - раз в 5 секунд мигаем желтым.

При концентрации CO2 свыше 1001 - раз в секунду мигаем красным.

<div class="mw-collapsible mw-collapsed"; style="width:600px; overflow: hidden;">

</syntaxhighlight>

</div>

"Max Motion" - максимальное значение датчика движения за N время. Время от 1 до 60 секунд можно выставить в 282 регистре. По умолчанию 10 секунд. При достижении Max Motion значения 50 проверяем достаточно ли освещена комната, если нет - включаем свет. Как только значение Max Motion упадет ниже 50 свет выключаем.

<div class="NavFrame">

   <div class="NavContent">

== Системные правила == <!--T:70-->

Многие показания, которые видны в веб-интерфейсе контроллера из коробки, тоже создаются правилами на движке wb-rules. Их код находится здесь: [https://github.com/wirenboard/wb-rules-system https://github.com/wirenboard/wb-rules-system]. Системные правила собраны в пакет <code>wb-rules-system</code>, сами файлы скриптов на контроллере находятся в папке <code>/usr/share/wb-rules-system/</code>.  

</syntaxhighlight>

Пример простого термостата из [https://support.wirenboard.com/t/novaya-versiya-dvizhka-pravil/4196/158 темы на портале поддержки].

<syntaxhighlight lang="js">

defineVirtualDevice("Termostat", {

    },.......

var hysteresis = 0.5;

function Termostat(name, temp, setpoint, TS, TS_onoff) {

}

Termostat("R01-TS16-1", "A60-M1W3/External Sensor 1", "Termostat/R01-TS16-1-setpoint", "wb-gpio/EXT4_R3A1", "Termostat/R01-TS16-1-onoff"); // Прихожая теплый пол

</syntaxhighlight>

{{Anchor|telegram}}

Сообщения отправляются с использованием [https://core.telegram.org/api#telegram-api Telegram API] через <code>curl</code>.

<syntaxhighlight lang="ecmascript">

var message = "Text"; // напишите свой текст сообщения

var command = 'curl -s -X POST https://api.telegram.org/bot{}/sendMessage -d chat_id={} -d text="{}"'.format(token, chat_id, message);

runShellCommand(command);

</syntaxhighlight>

Реализована через подписку на все топики '''meta/error'''.

<syntaxhighlight lang="ecmascript">

defineVirtualDevice("meta_error_test", {

   

trackMqtt("/devices/+/controls/+/meta/error", function(message){

   log.info("name: {}, value: {}".format(message.topic, message.value))

[[File:Sample-custom-config-1.png|300px|thumb|right|Пример конфигурации]]

[[File:Sample-custom-config-2.png|300px|thumb|right|Пример скрипта]]

Но сложную настройку с меню и вариантами так не сделать.

Правильный, но сложный способ — создать новую вкладку в разделе Configs с редактируемыми полями параметров установок .

Потребуются три файла:

1. Схема вывода html странички в разделе Configs : /usr/share/wb-mqtt-confed/schemas/test-config.schema.json

<syntaxhighlight lang="bash">

"description":"Long description configuration",

"configFile": {

"path":"/etc/test-config.conf",

},

"properties": {

"temperature_setpoint": {

},

"humidity_setpoint": {

"type":"number",

</syntaxhighlight>

2. Описание конфигурации по умолчанию (при сохранении формы в веб интерфейсе, значения запишутся в этот файл) : /etc/test-config.conf

<syntaxhighlight lang="bash">

</syntaxhighlight>

3. Скрипт, обновляющий конфиг : /mnt/data/etc/wb-rules/test-config-script.js

<syntaxhighlight lang="bash">

var config = readConfig("/etc/test-config.conf");

log("temperature setpoint is: {}".format(config.temperature_setpoint));

</syntaxhighlight>

Последний файл можно в том числе редактировать из веб-интерфейса на вкладке Scripts.

В json файлах описаны схемы вывода html странички браузером, по общепринятому стандарту отображения. Описание ключей тут: json-schema.org.

После создания файлов, нужно выполнить рестарт сервисов

<syntaxhighlight lang="bash">

service wb-mqtt-confed restart

service wb-rules restart

</syntaxhighlight>

При нажатии кнопки Save в веб-интерфейсе, будет перезапускаться сервис wb-rules, а значения установок - записываться в правила.

   });

     when: function() {

       return vegetablesTemperature < 17.8

})()

</syntaxhighlight>

* [[Wb-rules | Краткое описание wb-rules на wiki]]

* [https://github.com/wirenboard/wb-rules Полное описание wb-rules на Github]

</translate>