Азы Node Red: Создаем HomeKit устройства в Node-Red, часть 2

02 октября 2020, 11:24

Вместо предисловия

Уважаемые читатели, я конечно задержал выход второй части, но теперь у меня есть четкое понимание, о чем писать. Если Вы не читали первую часть, то есть возможность перейти по ссылке и прочесть ее заново. Статья была больше обзорной, но там есть ссылки на ресурсы, хоть и англоязычные, которые дают полноценно понять, как работать с HomeKit.

С чего начать?

Чтобы что-то добавить в HomeKit, надо понять, к какому типу устройств оно относится, а это строго регламентировано у компании Apple. И если вы захотите добавить датчик давления, то увы, Apple пока его в свою экосистему не добавила и Вам остается только ждать, когда он появится, или лепить костыли и отправлять данные, как что-то другое. Поскольку мы не можем в данный момент повлиять на Apple, то мы либо ждем, либо посылаем данные под другим именем (например, давление - как освещенность в люксах) или воспользуемся альтернативным продуктом "Sprut.hub" и приложением "Sprut.home", где все уже давно сделано, как надо.

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

Как получить данные?

Если вы уже используете Node-Red, то конечно, вам знакома нода Debag, ну а если нет, то обратитесь к статье на нашем портале Sprut.ai. Цепляем ее к источнику данных и при изменении событий смотрим, что же меняется. Для примера вот простое флоу wi-fi розетки, которая была прошита на Tasmota по статье, и общается с Node-red по mqtt протоколу.

Данная статья не направлена на изучение mqtt протокола, но, думаю, идея понятна. 

  • Есть данные, которые приходят от исполнительного устройства при изменении его статуса. 
  • Есть данные, которые надо отправить в исполнительное устройство для смены его состояния. 

Конечно, мы хотим, чтобы это устройство управлялось через HomeKit. Ну что, приступим!

Правила HomeKit

Apple HomeKit протокол имеет свой свод правил, которым необходимо следовать. Если взглянуть на картинку сверху, то вы можете увидеть, что необходимо поставить что-то в качестве функций, либо набора кубиков из Node-Red, для согласования правил, по которым общается Apple HomeKit и ваши устройства. В идеале, конечно, соединить все напрямую, но реально все немного сложнее, хотя в предыдущей статье описаны плагины для Node-red, где именно так можно сделать. Если ничего не подходит, то читаем входную ноду с данными и заодно ищем способ отправить правильные данные для управления вашим устройством. 

На первой картинке видно, что в payload мы получаем значения "OFF" или "ON" при смене статуса устройства. На втором изображении мы видим другие значения - это "off" и "on". Если значения с первой картинки вы можете прочитать нодой debag, то значения, которые посылаются на выходную ноду управления, вы должны взять из документации, в данном случае - это описание mqtt команд по управлению этим устройством. Не подумайте, что я усложняю, в конечном итоге, чтобы включить нужное устройство физически, вы сами себе даете команду дойти именно до этого устройства и нажать именно эту кнопку. Также и в Node-Red.

HomeKit

В первой части я описывал плагин для Node-Red node-red-contrib-homekit-bridged и, думаю, вы его уже установили. Добавляем ноду HomeKit во флоу и немного ее редактируем. Выглядит это так. На первой картинке надо кликнуть на карандашик, чтобы задать имя Homkit-Bridge, pin-code и проверить статус "Allow Message Passtrough". Галочка в квадратике на этом сообщении разрешит сквозное прохождение сообщений через HomeKit ноду. Если нужна только обратная связь по входу, то надо обязательно снять галочку, а вот если хотите еще и управлять через вход китовой ноды, то она нужна, но будьте осторожны, возможно зацикливание. Я стараюсь не использовать сквозной проход сообщений.

С названием моста мы определились и, соответственно, в первом экране мы должны написать название устройства и определиться с его сервисом. Поскольку это розетка, то название сервиса будет Outlet. В первой части статьи я давал полезные ссылки на описание сервисов и характеристик HomeKit устройств и поэтому, воспользовавшись этими знаниями, мы видим, какие характеристики необходимы для работы розетки. 

Можно узнать необходимые характеристики для входной Китовой ноды, послав сообщение в JSON формате, которое не может быть характеристикой для данного устройства. В описании к HomeKit ноды, автор предлагает  послать следующее сообщение.

В окошке отладки появится сообщение об ошибке с подсказкой, какие характеристики ждет HomeKit нода на входе. На картинке мы видим это отладочное окно.  Если у Вас это окошко появилось и при этом все работает, то знайте - на вход приходят какие-то дополнительные данные, которые HomeKit не может классифицировать для этого сервиса.

Почему функции проще для меня?

Вот мы и подошли к самому ответственному шагу. Есть набор данных, причем они с большой вероятностью не подходят для перенаправления в HomeKit ноду. Задача состоит в том, чтобы HomeKit получил их в том виде, в котором он их ожидает. А ожидает он их как две характеристики: On и OutletInUse в формате JSON. Для совместимости форматов необходимо написать простенькую функцию, которая преобразует один формат данных в другой. С целью упрощения задачи, характеристику OutletInUse (Розетка используется) я включаю при включении розетки, хотя по логике она должна активироваться при изменении потребления вышеопределенного порога. Все это легче реализовать в функции, особенно, если чуть-чуть знаком с любым языком программирования. Будет всего один кубик и функция пошлет только те данные, которые нужны HomeKit ноде. Конечно, как альтернативу функции можно использовать ноды switch и change и это прекрасная практика в освоении Node-red. Я так, собственно, и делал, пока не понял, что это немного громоздко. К тому же, функция может отображать сформированный статус, что бывает необходимо при отладке. Код функций для преобразования данных от розетки и в розетку на картинках снизу. Принцип прост: объявляем переменную типа object, сравниваем приходящие данные с нужным статусом и преобразовываем в необходимый формат для HomeKit ноды. Этот же принцип используется и для формирования данных с помощью нод switch и change. Чуть больше узнать о ноде можно из моей статьи и, конечно же, на сайте Node-Red.

Код функций выглядит как на картинке сверху, а тестовое флоу можно найти по ссылке.

Продолжение следует ...

Конечно, раскрыть тему полностью не получилось, есть еще много тонкостей и подводных камней. Задача данной статьи - показать возможность создания HomeKit устройств самим, и изучая возможности плагина  HomeKit по мануалам, вы станете тем, кем я вам обещал в первой части. А раз тема не раскрыта, то всегда есть возможность возвращаться к ней еще и еще..


Все новости мира умных домов - t.me/SprutAI_News или Instagram
Остались вопросы? Мы в Telegram - @SprutAI

Хочешь умный дом но нет времени разбираться?
Посмотри примеры работ и выбери себе интегратора.
  1. Евгений Олейник (permadm)
    Евгений Олейник (permadm) 7 месяцев назад

    Нет такой ноды - debag, поправь

К списку статей

Скидки для сообщества

Интернет-магазин yourhomekit.ru

+7 914 550-51-11
Промокод:
SPRUT-BLG
Размер скидки:
8%
Cамый большой ассортимент в России аксессуаров Apple HomeKit

Тематические чаты

Похожие статьи

09 ноября 2018, 20:54
Кейс создания умного дома без каких либо прокладок в виде Raspberry pi
04 сентября 2018, 12:14
Интеграция RGB ленты на ESP8266 с прошивкой tasmota в систему HomeBridge (HomeKit)
15 октября 2018, 09:05
Прошивка для Sonoff c нативным HomeKit
15 ноября 2018, 09:42
Способы автоматизации механических ворот
27 октября 2018, 12:20
Нативный Термостат для котла на ESP8266 с поддержкой Apple HomeKit
01 октября 2018, 07:43
Нативный HomeKit на ESP8266
25 сентября 2020, 11:49
Сенсорный монитор для управления умным домом. Настройка и использование.
15 ноября 2018, 13:11
Xiaomi Mi Remote 360 добавляем Apple HomeKit
28 августа 2018, 09:48
От голого Raspbian до веб-интерфейса homebridge за четыре команды в терминале.
18 февраля 2020, 17:06
В данной статье описывается сборка слаботочного эл. щита на базе Wiren Board 6, а так же силового щита для небольшой квартиры.