Работа WiFi-модулей «Мастер Кит» в системе управления домашней автоматизацией OpenHAB. Часть 1: Подключение и настройка

/* Страница для работы с MP3500 WiFi-реле, 2 канала */

Switch MP3500_R1 «MP3500_Реле 1» (WIFI_3500) { udp=">[ON:192.168.2.109:7777:MAP(MP3500_R1.map)], >[OFF:192.168.2.109:7777:MAP(MP3500_R1.map)]" }

Switch MP3500_R2 «MP3500_Реле 2» (WIFI_3500) { udp=">[ON:192.168.2.109:7777:MAP(MP3500_R2.map)], >[OFF:192.168.2.109:7777:MAP(MP3500_R2.map)]" }

Switch MP3500_R2_Button «MP3500_Реле 2 Импульс» (WIFI_3500) { udp=">[ON:192.168.2.109:7777:MAP(MP3500_R2_Pulse.map)]" }

Switch MP3500_Request «MP3500 Запросить состояние» (WIFI_3500) { udp=">[ON:192.168.2.109:7777:MAP(MP3500_Info.map)]" }

String MP3500_Stat «Получен ответ:[:%s]» (WIFI_3500) { udp="<[192.168.2.109:*:’REGEX((.*))])’]" }

/* NTP binding demo item */
DateTime Date «Сегодня: [%1$tA, %1$td.%1$tm.%1$tY]» {ntp=«Europe/Moscow:en_EN»}
DateTime Time «Московское время: [%tT]» { ntp=«Europe/Moscow:en_EN» }

Файл с таким содержимым формирует на экране приведенную ниже страницу.

Внимание! В файле текст, относящийся к одному элементу (Item), должен быть написан в одну строчку. На странице данной публикации этот текст в одну строчку не умещается; смотрите исходный файл testdrive.items.

Элементы Group отвечают за группировку элементов управления и за переходы к ним по странице. Элементы DateTime обеспечивают отображение даты и времени на главной странице. За страницу управления самим модулем МР3500 отвечают 4 элемента типа Switch и один типа String.

Для примера я сделал выключатели для каждого из выходов. Это MP3500_Реле 1 и MP3500_Реле 2. Включенная лампочка и синий цвет движка выключателя говорят о включенном состоянии реле и, соответственно, наоборот. Это самый распространенный способ управления реле.

Третий сверху элемент MP3500_Реле 2 Импульс демонстрирует возможности WiFi-реле работать в импульсном режиме, то есть по нажатию на кнопку реле включается на заданный вами в программе промежуток времени, например, 2 секунды. После этого реле возвращается в выключенное состояние, а выключатель на экране вместе с лампочкой переходят так же в выключенное состояние.

Я не нашел в описании OpenHAB элемента типа КНОПКА, поэтому сброс выключателя в выключенное состояние пришлось делать самому с помощью инструмента ПРАВИЛА (Rules), но об этом ниже.

Кнопка MP3500 Запросить состояние позволяет считать информацию с модуля о его состоянии, а именно: включено или выключено каждое реле и время работы каждого реле в минутах – счетчик мото-часов. Иногда это полезно, например, для анализа расходов на отопление. Можно узнать сколько часов в день работает нагреватель для поддержания заданной температуры.

И строка Получен ответ, собственно говоря, отображается ответ модуля. На рисунке выше видно, что включен канал 1.

Теперь разберем структуру команды, которая управляет реле через запущенный нами TCP/UDP Binding. Общий шаблон команды выглядит так:

udp="[:::], [:::], …"

(еще раз напомню – текст пишется в одну строку). Подробнее здесь.

Из шаблона видно:

• можно выбрать протокол, в нашем случае это udp;
• можно указать направление передачи, входящее или исходящее;
• привязаться к событию – команде OpenHAB;
• указать IP-адрес и порт;
• и… самое интересное, указать правило трансформации или преобразования, поскольку в явном виде передать в порт команду – сочетание символов типа !SetR0_1 не получится.

Подробнее о правилах трансформации (это важно)! Для хранения правил трансформации используются файлы с расширением .map. Они хранятся в папке C:\OpenHab\configurations\transform. Как обычно это простые текстовые файлы с содержимым вида:

ON=!StartPulseR2,2\r
OFF=!SetR0_2\r

То есть, вы описываете соответствие между командой OpenHAB и командой самого модуля. В первой строке, например, по команде ON, которая сгенерируется внутри OpenHAB при нажатии на изображение выключателя, в сам порт передается символьная строка !StartPulseR2,2\r, которая и заставит модуль МР3500 отработать. У такого подхода есть некоторое неудобство в том, что для каждого элемента управления приходится создавать свой файл, но если им дать понятные наименование, то жить можно. У меня папка с файлами получилась такая:

Теперь рассмотрим конкретную строку, например:

Switch MP3500_R1 «MP3500_Реле 1» (WIFI_3500) { udp=">[ON:192.168.2.109:7777:MAP(MP3500_R1.map)], >[OFF:192.168.2.109:7777:MAP(MP3500_R1.map)]" }

На человеческий язык она переводится так:

— Switch MP3500_R1 – элемент типа Switch с наименованием по системе MP3500_R1;
— «MP3500_Реле 1» – наименование, которое мы видим на экране;
— (WIFI_3500) – принадлежит группе WIFI_3500;
— udp=">[ON:192.168.2.109:7777:MAP(MP3500_R1.map)] – читается так: в случае появления команды ON установить исходящее соединение с адресом в сети 192.168.2.109* и через порт 7777 по протоколу UDP передать символы, которые находятся в файле MP3500_R1.map;
— >[OFF:192.168.2.109:7777:MAP(MP3500_R1.map)]"} – аналогично для команды OFF. Если были бы другие команды, то их можно было написать аналогично, через запятую.
*конкретный адрес, который присвоил именно мой роутер именно моему модулю, у вас будет свой адрес. Если будут трудности – обратитесь в службу техподдержки Мастер Кит.

Весь текст пишется все в одну строку. Нельзя забывать или пропускать круглые, квадратные и просто скобки, кавычки и запятые – все имеет значение. Часто именно по этой причине устройство и не работает.

Вот эта команда считывает ответ модуля и отображает его в строке «Получен ответ».

String MP3500_Stat «Получен ответ:[:%s]» (WIFI_3500) { udp="<[192.168.2.109:*:’REGEX((.*))’]" }

Обратите внимание – здесь уже входящее соединение и я использовал маску (*) для того, чтобы сигнал считывался с любого порта. Если указать порт 7777, то ничего читаться не будет. Об это я «убил» пару вечеров. Но вам это теперь не грозит. Рассмотрим новые и непонятные части команды:

‘REGEX((.*))’ – это функция «Регулярное выражение», с помощью которой в считанной строке можно найти и выделить нужные части текста. Применяется во многих языках программирования. Подробнее здесь.

Я буду объяснять, как пользоваться этим механизмом по мере необходимости при подключении следующих модулей (еще та заморочка!), а данный, самый простой случай, расшифровывается так: считать (захватить) любое количество любых символов во входящей строке кроме знака окончания .

[:%s] – эта часть команды выводит считанное значение на экран.

4. Работа. Это минимум, который необходим для того чтобы начать управлять Wi-Fi-реле MP3500. Подаем питание, ждем регистрации в сети и начинаем нажимать кнопки.

Предварительно можно посмотреть небольшой видеоролик:

5. И в заключение, несколько слов о том, как на экране заставить выключатель автоматически перейти в состоянии OFF в режиме КНОПКА. Для этого находим в папке C:\OpenHab\configurations\rules файл testdrive.rules. Используем возможности внутреннего таймера системы.

Если не рассматривать стандартное подключение нужных библиотек и объявление переменных, то основной элемент кода вот этот:

if(receivedCommand==ON) {
if(timer==null) {
timer = createTimer(now.plusSeconds(2)) [|
sendCommand(MP3500_R2_Button, OFF)

Если полученная команда равна ON и таймер сброшен, запускаем новый цикл таймера до момента «от сейчас» до «плюс N» секунд и после этого шлем команду OFF нужному элементу. 2 – это как раз количество секунд, которое я использую для управления реле в команде ON=!StartPulseR2,2\r, то есть включить реле 2 на 2 секунды.

Это была вступительная часть, дальше будет короче и интересней, поскольку не придется говорить о базовых вещах, таких как расположение папок. Зима не за горами, будем подключать WiFi – термостат MP3502 к OpenHAB.

Надеюсь, что вы установите OpenHAB на свой компьютер и тоже начнете эксперименты по управлению своим жилищем.