что такое node red
Node-RED
Low-code programming for event-driven applications
Node-RED is a programming tool for wiring together hardware devices, APIs and online services in new and interesting ways.
It provides a browser-based editor that makes it easy to wire together flows using the wide range of nodes in the palette that can be deployed to its runtime in a single-click.
Browser-based flow editing
Node-RED provides a browser-based flow editor that makes it easy to wire together flows using the wide range of nodes in the palette. Flows can be then deployed to the runtime in a single-click.
JavaScript functions can be created within the editor using a rich text editor.
A built-in library allows you to save useful functions, templates or flows for re-use.
Built on Node.js
The light-weight runtime is built on Node.js, taking full advantage of its event-driven, non-blocking model. This makes it ideal to run at the edge of the network on low-cost hardware such as the Raspberry Pi as well as in the cloud.
With over 225,000 modules in Node’s package repository, it is easy to extend the range of palette nodes to add new capabilities.
Social Development
The flows created in Node-RED are stored using JSON which can be easily imported and exported for sharing with others.
An online flow library allows you to share your best flows with the world.
Get Started
Node-RED is built on Node.js, taking full advantage of its event-driven, non-blocking model. This makes it ideal to run at the edge of the network on low-cost hardware such as the Raspberry Pi as well as in the cloud.
Run locally
On a device
In the cloud
Who’s using Node-RED?
All logos used with permission. These links do not constitute an endorsement or approval by the Node-RED project of any of the products, services or opinions of the companies listed.
Community more
On the blog more
Node-RED: Low-code programming for event-driven applications.
Copyright OpenJS Foundation and Node-RED contributors. All rights reserved. The OpenJS Foundation has registered trademarks and uses trademarks. For a list of trademarks of the OpenJS Foundation, please see our Trademark Policy and Trademark List. Trademarks and logos not indicated on the list of OpenJS Foundation trademarks are trademarks™ or registered® trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.
Материалов на эту тему не мало, но, благодаря участникам портала, Node-RED становится все легче и понятнее для новых пользователей, так как появляются новые плагины и решения.
В этой статье я опишу установку и настройку Node-RED на Raspberry Pi deCONZ и интеграцию ZigBee устройств в HomeKit.
Установка deCONZ
Установка Node-RED
Подключаемся к малине по SSH и устанавливаем Node-RED следующей командой:
Соглашаемся два раза, нажав »Y».
После успешной установки Node-RED, запускаем веб-интерфейс, вбив в браузере: IP малины:1880.
Установка необходимых нам contributions:
В данной статье мы будем использовать всего несколько нод. Существует два способа их установки:
Установим контрибьюшн для связи с HomeKit через веб-интерфейс. Для этого нужно перейти:
Теперь в нодах (раздел advanced) появилась нода HomeKit.
Вводим в строке поиска node-red-contrib-deconz и устанавливаем.
Теперь перезагрузим Node-RED и почистим кэш, выполнив следующие команды:
Как видим, у нас появились новые ноды:
Рассмотрим добавление на примере геркона от Aqara и проводного одноклавишного выключателя без нулевой линии Aqara, которые у нас уже добавлены в deCONZ. В процессе добавления первого устройства, нам потребуется добавить сервер deCONZ и мост HomeKit, но делается это единоразово.
В ноде in имеется 2 выхода(серые маленькие квадратики):
В ноде in пишем любое название, выбираем созданный нами сервер и выбираем нужное нам устройство.
Дважды нажимаем на ноду homekit, нажимаем на карандашик напротив строки Bridge.
Pin Code и Name пишем любые (Пин код должен быть строго в таком же формате ***-**-***).
Нажимаем кнопку Add, Confim. Мост настроен.
Нажимаем кнопку Deploy в правом верхнем углу.
Теперь мы можем добавить мост в приложении Дом на устройстве Apple. Вместе с мостом добавится и наш датчик касания.
У датчика касания есть батарейка, поэтому нам нужно добавить ноду батареи. Для этого перетягиваем ноду battery и homekit.
В ноде battery выбираем наш датчик и пишем любое имя в строке «название». Нажимаем Done.
В ноде homekit в строке «Service Hierarchy» выбираем Linked (т.к батарея у нас это дочерний сервис). В строке «Parent service» выбираем наше родительское устройство (т.е сам датчик касания). В строке «Service» выбираем BatteryService. Имя выбираем любое.
Возле кнопки Deploy нажимаем на треугольник и выбираем Modified Nodes.
Теперь в HomeKit мы сможем увидеть заряд батареи на нашем датчике касания.
Далее устройства добавлять гораздо проще т.к сервер и мост уже есть.
Программируем управление освещением по датчикам движения и освещения на Node-RED
В русскоязычном интернете пока мало статей о такой среде программирования как Node-RED. Данная статья приоткроет тайну завесы об этом продукте и покажет на примере создания алгоритма управления освещением по датчикам движения как просто с помощью Node-RED можно реализовать различные сценарии и правила автоматизации умного дома в полностью в графическом виде без написания какого-либо кода.
Что такое Node-RED
IBM, как и другие большие компании, пытаются занять свою нишу в развивающемся интернете вещей. Обычно это связано с выпуском open-source приложений и продуктов с целью популяризировать свои платные платформы. Например, в IBM платной платформой является Bluemix.
Node-RED – это open-source детище IBM и, как простенько написано на сайте, это инструмент, который служит для связи железа, API и сервисов новыми и интересными способами.
Способы эти основаны на использовании графических линий связи, по которым пересылаются сообщения между узлами. Таким образом связывать различные блоки можно просто мышкой без использования программирования.
Разработка в Node-RED ведется через обыкновенный браузер, само ядро можно запустить на различных платформах – PC, RPi, cloud и т.д.
Node-RED для умного дома
Я решил попробовать Node-RED для написания сценариев и правил для умного дома. То есть для автоматизации. Сама связь с различными исполнительными устройствами, веб-сервисами и датчиками у меня сделана на OpenHAB. Почему я решил не делать автоматизацию там же? Несколько причин:
— В OpenHAB сценарии и правила пишутся на своем языке. Изучать его только ради одного применения мне не захотелось.
— Сама отладка правил практически невозможна – если правило не работает, сложно разобраться почему
— Я бы хотел, чтобы мои правила были независимы от железа, каналов связи, платформ и самого ПО для коммуникации с устройствами. Чтобы я мог легко перейти на другую платформу УД, например Domoticz, MajorDomo, FHEM и взять мои правила с собой, а не переписывать их заново под новую платформу УД.
Управление Освещением по датчикам движения и освещенности
Итак приступим к реализации. Собственно оригинальная задача проста и тривиальна:
У меня в коридоре есть управляемые LED споты для освещения. Хочу, чтобы свет загорался по движению и выключался сам через 10 секунд.
Немного усложним задачу:
— Свет должен включаться только когда на улице темно
— Интенсивность света должна зависеть от времени – до 9 часов вечера свет должен включаться с полной интенсивностью, а после только на 10%, как подсветка.
Датчики, исполнители и пр. железо
Сами протоколы и варианты связи с датчиками и актуаторами я описывать здесь не буду. Достаточно сказать, что в моем умном доме все эти протоколы приводятся к одному – MQTT, а через него уже происходит общение с Node-RED.
И так какие же датчики и исполнительные устройства у меня есть?
1. Датчик движения. Публикует сообщение OPEN в топик /myhome/state/Hall_motion, когда детектирует движение и CLOSED, если в течении 2-х секунд движения нет.
2. Датчик освещенности. Он измеряет яркость уличного освещения в диапазоне 0-1000 Люкс. Публикует раз в минуту сообщение в топик /myhome/state/Lumin_Hall с уровнем текущей освещенности.
3. Диммер управления LED лампами. Он подписан на топик /myhome/command/Light_Hall/state. Если записать туда 0 – свет выключится. 100 – включится на максимальную яркость. 1-99 – будут менять интенсивность освещения. Для ночной подсветки достаточно интенсивности 1.
Описание Flow в Node-RED
Предполагается, что Node-RED у вас уже установлен. Если нет — перейдите по ссылке выше и установите любой удобный для вас вариант — на компьютер, Raspberry, clowd и т.д. В моем случае Node-RED устновлен на RPi2 (помоему, он даже входит в поставку Raspbian, так что ничего вообще не нужно устанавливать). Данный flow не требует установки каких-либо дополнительных библиотек.
Входы и выходы
В первую очередь создаем нужные входы и выходы для нашего алгоритма. Это будут MQTT клиенты, подписывающиеся на соответствующие топики. Их перетаскиваем из библиотеки слева и настраиваем.
Примечание: Отображаемые названия блоков можно изменить в их настройках.
Для датчика освещенности создаем узел Hall Light Sensor из MQTT Input:
В его настройке достаточно прописать адрес MQTT брокера и топик.
У меня брокер крутится на той же платформе, поэтому достаточно оставить localhost.
Для датчика движения создаем узел Hall Motion Sensor:
У него все то же самое, только прописываем другой топик /myhome/state/Hall_motion.
Как можно заметить адрес и параметры брокера этот узел уже перенял из предыдущего, так что по новой их вводить не надо.
Осталось добавить MQTT Output, чтобы сделать выход для LED диммера. Перетаскиваем MQTT Output и называем Hall Light Dimmer.
В параметрах надо опять же только указать нужный топик, в который будут слаться сообщения для управления диммером — /myhome/command/Light_Hall/state
В результате мы получили три узла для нашего Flow.
Не мешало бы их проверить на функциональность. Это легко.
К Input блокам подключаем Debug output.
А к выходному блоку подключаем Inject Input.
В настройках этого узла надо поменять payload на уровень желаемой яркости светильника. Например в данном случае это 100.
Мы можем путем copy-paste создать несколько идентичных Inject блоков, поменять яркость, и подключить к выходу вот так:
Так тоже будет работать. Пришло время проверить. Тыкаем кнопку Deploy:
Под MQTT узлами у вас должно появиться маленькое сообщение:
Это означает, что они подключились к MQTT брокеру. Если все прошло по плану, то в правой вкладке debug у вас должны начать появляться сообщения от датчиков, а если кликать мышкой по прямоугольникам слева от Inject узлов, должна меняться интенсивность освещения у светильника, подключенного к диммеру. Если все работает, можно идти дальше.
Цепь управления освещением по датчику движения
Для простоты я буду называть отдельные связанные между собой блоки цепями. В первую очередь попробуем сделать простую цепь, которая бы включала свет по датчику движения и отключала его спустя какое-то время. Для этого согласно концепции Node-RED нам нужно, чтобы нужное сообщение от датчика движения дошло до диммера через определенные блоки и имело определенный текст. Сначала разберемся с включением света.
В первую очередь выделим из всех сообщений от датчика движения сообщение с текстом OPEN — это значит, что движение появилось. Для этого используем блок switch. Подключим его к выходу уже созданного нами блока Hall Motion Sensor.
Настроим его так, чтобы блок пускал на выход только сообщения с текстом OPEN
Как видно из картинки, блок будет сравнивать payload с текстом OPEN и направлять сообщения на выход один, если текст совпадает.
Наш диммер требует, чтобы на вход ему подавались сообщения с нужной яркостью 0. 100. Текст OPEN он не поймет. Поэтому используем блок Change, чтобы поменять текст сообщения.
В настройках этого блока записываем требуемое изменение – message payload изменяем на 100 — требуемую интенсивность освещения.
И наконец подключаем это все ко входу нашего диммера:
Если запустить данную цепь, то можно убедиться, что она работает – свет будет включаться по движению. Осталось сделать так, чтобы он еще и выключался.
Для этого используем блок Trigger и подключим его к выходу датчика движения.
Блок триггер позволяет генерировать сообщения с задержкой, а также может быть сброшен определенным сообщением. Настроим его так:
Данная настройка означает, что при поступлении первого сообщения триггер не посылает ничего, но запускает выдержку времени в 8с и по ее истечении посылает сообщение с текстом 0. Также триггер сбрасывается, если ему на вход поступает сообщение с текстом OPEN. Что же это означает в нашем случае?
Предположим что датчик движения выдал сообщение OPEN. Данное сообщение вернет триггер к исходному состоянию без какой либо реакции. Далее через какое-то время датчик движения выдаст сообщение CLOSED. Это сообщение запустит выдержку времени и через 8 секунд после этого триггер выдаст сообщение 0.
Если в течении этой выдержки времени опять поступит сообщение OPEN, то триггер опять вернется к исходному состоянию и будет ждать следующего сообщения(которое логично будет CLOSED). При этом триггер не выдаст никаких сообщений.
То есть таким образом мы создали таймер, который будет служить нам для автоматического отключения света после заданной выдержки. Если вспомнить описание датчика движения, то становится понятным почему здесь задается 8 секунд, а не 10 – 2 секунды добавляется за счет выдержки самого датчика движения.
Осталось подключить выход триггера к диммеру и можно запускать цепь на проверку.
Замечу, что для простоты я выкладываю скриншоты уже отлаженных цепей. Вы же можете обвешать вашу цепь Debug блоками, чтобы разобраться с принципом работы и ваша цепь может выглядеть и вот так:
И в этом нет ничего страшного.
А можно сделать вообще вот так:
И тогда клацая мышкой на прямоугольниках слева от Inject блоков вы можете отладить цепь вообще без железа – на своем лаптопе во время поездки в метро или даже планшете.
Цепь включения/отключения света в зависимости от яркости уличного освещения
Теперь нам надо сделать так, чтобы свет не включался, если на улице слишком светло. Для этого нам нужно добавить еще одну цепь и слегка изменить основную цепь, чтобы учесть данный фактор.
Сначала возьмем уже знакомый нам switch блок и подключим его к выходу датчика освещенности.
Настройку этого блока сделаем таким образом, чтобы он направлял сообщения от датчика освещения на один из выходов, в зависимости от текущей освещенности.
Условие выше означает, что если освещенность меньше 10 люкс, то сообщение будет направлено на выход 1. А иначе оно пойдет на выход 2. Не забываем, что надо выбрать
Опцию, чтобы сообщение было направлено только на один из выходов.
Исходя из принципа работы логично получается, что если сообщение появилось на первом(верхнем) выходе, нам надо включить детектирование движения, а если на втором, то выключить.
Тут, конечно, возможен 1000 и 1 способ, самый простой из которых – просто блокировать сообщение на включение света от датчика движения, если на улице светло. Реализуем это.
Следует отметить, что в Node-RED механизм исполнения реализован на основе сообщений. Т.е. нет сообщения – нет события, нет и реакции. Это накладывает определенную специфику в случае, если разные сообщения приходят асинхронно, т.е в разные моменты времени. Например в данном случае сообщение от датчика освещения асинхронно по отношению к с сообщениям от датчика движения. Поэтому, чтобы учесть эффект датчика освещения, нам надо запомнить информацию, которая была в его сообщении и затем применить ее в следующий раз, когда придет сообщение от датчика движения.
На помощь в этом случае приходит контекст – поле, где можно хранить информацию во время исполнения flow. Контекст бывает глобальным по отношению ко всей среде, или локальным по отношению к конкретному flow или вообще только по отношению к конкретному блоку.
В нашем случае мы будем использовать контекст, локальный по отношению к данному flow. Т.е. переменные будут видны всем блокам в этом flow. Создадим блок change и подключим его к первому выходу Light Threshold Detector
Как мы помним, на этом выходе появляется сообщение в том случае, если датчик освещенности отрапортовал, что освещение на улице менее 10 Люкс. Рассмотрим конфигурацию блока change
В данном случае мы используем правило Set, чтобы присвоить переменной flow.Light_enabled значение Yes. Таким образом мы присвоили значение глобальной переменной, которое мы можем использовать в других блоках.
Аналогичным образом создадим второй блок change и подключим его на второй выход.
Его конфигурация будет такой:
Чтобы узнать правильно ли работает такой детектор мы можем создать простую цепь с блоками Inject и Debug.
При этом в настройках блока Inject укажем, что он должен выдавать каждую секунду значение переменной flow.Light_enabled
Тогда результат работы датчика освещенности можно легко наблюдать в вкладке Debug
Общая цепь включения/отключения света по датчику освещения будет выглядеть следующим образом
Теперь, чтобы учесть этот эффект в цепи управления по датчику движения, нам достаточно вставить switch блок в цепь пути включения света.
И настроить его так, чтобы он пропускал сообщения от датчика движения только, если наша глобальная переменная flow.Light_enabled имеет значение Yes – т.е. на улице темно.
Готово! Теперь наш flow выглядит вот так:
Изменение яркости светильника в зависимости от времени
Осталось совсем немного. Мы хотим изменять интенсивность LED светильника. Т.е. если у нас темно, но время до 9 часов вечера, свет должен включаться на полную мощность. Но после девяти – только на малую мощность, как ночная подсветка.
Для этого создадим блок Inject:
Его можно настроить таким образом, чтобы он выдавал сообщение в определенное время. Настроим его на 21:00 каждого дня.
При этом заметим, что выдавать он будет сообщение со значением 1. Это будет нашей нужной интенсивностью подсветки в ночном режиме. Чтобы использовать это значение в цепи управления светом, используем тот же трюк с глобальными переменными. Создадим блок change:
И настроим его так, чтобы переменной flow.Light_Brightness присваивалось значение из сообщения.
Чтобы возвращать первоначальную яркость по утрам, создадим второй блок inject, который будет выполняться в 6 часов утра и выдавать значение яркости 100. Подключим его туда же.
Таким образом переменной flow.Light_brightness будет присваиваться значение 1 каждый вечер в 9 часов, и значение 100 каждое утро в 6 часов. Осталось только применить это в основной цепи. Для этого у нас уже есть блок Light Brightness Adjustment:
Для которого нам только нужно изменить настройку, чтобы он присваивал не константу, а значение переменной flow.Light_brightness.
Финальный результат
Итоговый flow, очищенный от отладочных блоков выглядит опрятно и чисто. При создании мы использовали только стандартные блоки из инсталляции Node-RED. На сайте flows.nodered.org, однако, существует более 800 дополнительных блоков и библиотек, которые позволяют добавить множество различных вещей.
Для тех, кто заинтересовался повторением данного алгоритма, выкладываю flow, который я использовал для отладки:
А также его json код, который можно легко импортировать в любую версию Node-RED и протестировать.
Итоги
В данной статье я попытался продемострировать и рассказать как просто можно реализовать повседневные алгоритмы домашней автоматизации в среде Node-RED. Также я постарался показать основные преимущества данной среды программирования, такие как:
— логичное графическое представление связей и функций
— простоту программирования и легкость отладки пользовательских сценариев
— аппаратную и платформенную независимость полученных алгоритмов – данный сценарий будет одинаково хорошо работать и с OpenHAB, и с ioBroker и с любыми другими платформами умного дома, которые поддерживают протокол MQTT.
— простоту обмена готовыми алгоритмами между пользователями благодаря Copy-Paste JSON кода и наличию онлайн платформы для обмена удачными решениями.
Node-RED может и многое другое – например получать погоду из интернета, рассылать уведомления на твиттер или работать с термостатами Nest. И на основе этого можно создать множество других интересных и полезных алгоритмов автоматизации. Но это темы для следующих статей.