Node-RED: различия между версиями

Node-RED (просмотреть исходный код)

Версия 18:47, 18 апреля 2024

2917 байт добавлено ,  1 месяц назад
Нет описания правки
 
(не показано 39 промежуточных версий 4 участников)
Строка 1: Строка 1:
<languages/><translate>
<!--T:19-->
{{DISPLAYTITLE:Установка Node-RED на контроллер Wiren Board}}
{{DISPLAYTITLE:Установка Node-RED на контроллер Wiren Board}}
[[Файл:Node-red.PNG|500px|thumb|right| Node-RED на WB6]]
[[Файл:Node-red.PNG|500px|thumb|right| Node-RED на контроллере Wiren Board]]


== Описание ==  
== Описание == <!--T:20-->
{{YouTube
|link= https://youtu.be/cKQmU4LZo4c
|text= Видеоурок по Node-RED на Wiren Board от SetPoint
}}
Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом.
Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом.


<!--T:21-->
Подробное описание, инструкции и примеры использования можно найти на сайте [https://nodered.org/ nodered.org], а поддержку сообщества в телеграм-канале [https://t.me/SprutAI_NodeRED Node-RED].
Подробное описание, инструкции и примеры использования можно найти на сайте [https://nodered.org/ nodered.org], а поддержку сообщества в телеграм-канале [https://t.me/SprutAI_NodeRED Node-RED].


<!--T:22-->
{{Wbincludes:Installing Software In Console}}
{{Wbincludes:Installing Software In Console}}


== Установка ==  
== Установка == <!--T:23-->
{{note|info|Из-за того, что свежий Node-RED 3.0 требует NodeJS 14, а в репозитории все пакеты зависят от NodeJS 12, то сейчас установить можно только версию 2.2. Нам нужно время, чтобы повысить версию NodeJS в репозитории.}}


Для установки Node-RED на контроллер Wiren Board подключитесь к нему по [[SSH]] и введите в консоль несколько команд.
{{Wbincludes:Installing Software In Console Catalog And Update}}


{{Wbincludes:Installing Software In Console}}
<!--T:24-->
Установите необходимые компоненты:
Установите необходимые компоненты:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
Строка 19: Строка 29:
</syntaxhighlight>
</syntaxhighlight>


<!--T:25-->
Запустите установку Node-RED:
Запустите установку Node-RED:
<syntaxhighlight lang="bash">
:<syntaxhighlight lang="bash">
npm install -g --unsafe-perm node-red@2.2
npm install -g --unsafe-perm node-red
</syntaxhighlight>
</syntaxhighlight>


<!--T:26-->
Если потребуется обновить версию Node-RED, выполните команду установки ещё раз.
Если потребуется обновить версию Node-RED, выполните команду установки ещё раз.


== Создание сервиса ==  
В релизах wb-2207 и старее устаревшая версия NodeJS, поэтому свежий Node-RED можно поставить только в docker — [[Node-RED_docker|инструкция по установке Node-RED в docker]].
Также в docker следует устанавливать если требуется версия более новая чем из пакетов.
 
== Создание сервиса == <!--T:27-->


<!--T:28-->
Для автозапуска Node-RED необходимо настроить сервис. Для этого в папке <code>/etc/systemd/system/</code> создайте файл <code>nodered.service</code>:
Для автозапуска Node-RED необходимо настроить сервис. Для этого в папке <code>/etc/systemd/system/</code> создайте файл <code>nodered.service</code>:


<!--T:29-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
mcedit /etc/systemd/system/nodered.service
nano /etc/systemd/system/nodered.service
</syntaxhighlight>
</syntaxhighlight>


<!--T:30-->
Затем вставьте в этот файл строки:
Затем вставьте в этот файл строки:
<pre>
<pre>
Строка 40: Строка 58:
Wants=network.target
Wants=network.target


<!--T:31-->
[Service]
[Service]
Type=simple
Type=simple
Строка 46: Строка 65:
WorkingDirectory=/home
WorkingDirectory=/home


<!--T:32-->
Nice=5
Nice=5
Environment="NODE_OPTIONS=--max_old_space_size=256"
Environment="NODE_OPTIONS=--max_old_space_size=256"
Строка 53: Строка 73:
SyslogIdentifier=Node-RED
SyslogIdentifier=Node-RED


<!--T:33-->
[Install]
[Install]
WantedBy=multi-user.target
WantedBy=multi-user.target
</pre>
</pre>


<!--T:34-->
Сохраните изменения и закройте файл. Теперь включите сервис и запустите его командой:
Сохраните изменения и закройте файл. Теперь включите сервис и запустите его командой:


<!--T:35-->
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash">
systemctl enable nodered && systemctl start nodered
systemctl enable nodered && systemctl start nodered
</syntaxhighlight>
</syntaxhighlight>


<!--T:36-->
Проверьте статус сервиса командой, в выводе должна быть строчка <code>Active: active (running)</code>:
Проверьте статус сервиса командой, в выводе должна быть строчка <code>Active: active (running)</code>:
<syntaxhighlight lang="console">
<syntaxhighlight lang="console">
Строка 73: Строка 97:
           └─2757 node /usr/bin/node-red --max_old_space_size=256
           └─2757 node /usr/bin/node-red --max_old_space_size=256


<!--T:37-->
Dec 03 06:32:25 wirenboard-AWQBNTYP systemd[1]: Started Node-RED graphical event wiring tool.
Dec 03 06:32:25 wirenboard-AWQBNTYP systemd[1]: Started Node-RED graphical event wiring tool.
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:36 - [info]
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:36 - [info]
Строка 83: Строка 108:
</syntaxhighlight>
</syntaxhighlight>


== Удаление ==
== Удаление == <!--T:38-->
Если вам больше не нужен Node-RED, то его можно удалить:
Если вам больше не нужен Node-RED, то его можно удалить:
# Остановите, отключите и удалите сервис:
# Остановите, отключите и удалите сервис:
Строка 94: Строка 119:
</syntaxhighlight>
</syntaxhighlight>


<!--T:39-->
Node.js, тоже можно удалить, но убедитесь, что у вас не установлены другие програмы, которые его используют, например, zigbee2mqtt. Чтобы удалить node.js, выполните команду:
Node.js, тоже можно удалить, но убедитесь, что у вас не установлены другие програмы, которые его используют, например, zigbee2mqtt. Чтобы удалить node.js, выполните команду:
:<syntaxhighlight lang="bash">
:<syntaxhighlight lang="bash">
Строка 99: Строка 125:
</syntaxhighlight>
</syntaxhighlight>


==Веб-интерфейс Node-RED==
==Веб-интерфейс Node-RED== <!--T:40-->
После запуска сервиса откройте браузер и введите адрес своего контроллера в сети и порт 1880.  
После запуска сервиса откройте браузер и введите адрес своего контроллера в сети и порт 1880.  
Например: http://192.168.42.1:1880
Например: http://192.168.42.1:1880


<!--T:41-->
Инструкции по работе c Node-RED можно найти на [https://nodered.org/docs/getting-started/ сайте nodered.org]
Инструкции по работе c Node-RED можно найти на [https://nodered.org/docs/getting-started/ сайте nodered.org]


== WB Nodes ==  
== Ноды ''mqtt in'' и ''mqtt out'' (рекомендуется) == <!--T:49-->
=== Настройка подключения ===
[[Image: NodeRed_mqtt_nodes.jpg |300px|thumb|right| Ноды MQTT в Node-Red ]]
Для работы по MQTT используются ноды '''mqtt in''' и  '''mqtt out'''. Также вам понадобятся адреса топиков, взять их можно в веб-интерфейсе контроллера на странице [[Wiren Board Web Interface#mqtt-channels |MQTT-каналы]].
 
<!--T:50-->
Для настройки MQTT-соединения в Node-RED выполните следующие действия:
#Перетащите ноду '''mqtt in''' в рабочую область.
#Войдите в конфигурацию ноды и нажмите на '''Карандаш''' напротив поля '''Server'''.
#На вкладке '''Connecting''' задайте адрес брокера и номер порта.
#:В поле '''Name''' введите любое имя сервера.
#:На вкладке '''Security''' можно указать Имя пользователя и Пароль для подключения к брокеру. Если в качестве брокера выступает контроллер Wiren Board, это поле нужно оставить пустым.
#После заполнения всех полей нажмите кнопку '''Update'''. Созданный брокер теперь можно использовать для настройки всех подключений.
#Выберите созданные брокер из списка в поле '''Server'''.
#Введите адрес mqtt-топика в поле '''Topic'''.
#Нажмите кнопку '''Done'''.
 
<!--T:51-->
По такому же принципу настраивается нода '''mqtt out'''.
<gallery mode="packed" heights="150px" caption="Настройка MQTT-брокера (Server)>
Image: NodeRed_mqtt2.jpg | Вкладка ''Connecting''
Image: NodeRed_mqtt3.jpg  | Вкладка ''Security''
</gallery>
 
=== Отправка команд === <!--T:52-->
Для отправки команды контроллеру по MQTT используется нода '''mqtt out'''. При этом в поле '''Topic''' указывается адрес mqtt-топика контроллера, в который необходимо записать параметр. Нужно учитывать, что в конце адреса ноды '''mqtt out''' нужно написать <code>/on</code>, иначе параметр в топик не запишется. Например, <code>/devices/wb-mrgbw-d-fw3_129/controls/RGB Strip/on</code>. Подробнее читайте на странице [[MQTT | MQTT]].
<gallery mode="packed" heights="150px" caption="Настройка нод для работы с MQTT">
Image: NodeRed_mqtt4.jpg | Пример настройки ноды '''mqtt in'''
Image: mqtt_out_no.jpg  | Пример настройки ноды '''mqtt out'''
Image: NodeRed_mqtt1.jpg | Обмен данными через MQTT в Node-Red
</gallery>
Для отправки параметра в ноду '''mqtt out'''  можно использовать ноду '''inject'''.
#Перетащите ноду '''inject''' в рабочую область.
#Подключите ее ко входу ноды '''mqtt out'''.
#Зайдите в настройки ноды '''inject''' и задайте ''Имя'' ноды, ''Тип переменной'' и ее ''Значение''. Нажмите кнопку '''Done'''.
<gallery mode="packed" heights="130px">
Image: Inject1.jpg | Пример настроек ноды '''inject''' для управления дискретным параметром
Image: Inject2.jpg | Поле настройки периодов повторения отправки ноды '''inject'''
</gallery>
<gallery mode="packed" heights="100px">
Image: Node_inject.jpg | Пример использования ноды '''inject'''
</gallery>
 
<!--T:53-->
После настройки ввода и вывода можно обрабатывать данные внутри Node-RED и настроить использование сторонних сервисов, например, [[Node-RED_Alice | Умный дом с Алисой]].
 
<!--T:54-->
<gallery mode="packed" heights="150px">
Image: NodeRed_mqtt5.jpg | Пример управления с помощью Алисы
</gallery>
 
== WB Nodes (решение сообщества) == <!--T:42-->
 
[[Файл:Installing node-red-contrib-wirenboard.PNG|500px|thumb|right| Установка WB Nodes на контроллер Wiren Board]]
[[Файл:Installing node-red-contrib-wirenboard.PNG|500px|thumb|right| Установка WB Nodes на контроллер Wiren Board]]
[[Image: nr+wb-settings.png |600px|thumb|right|Настройка соединения с контроллером Wiren Board]]
[[Image: nr+wb-settings.png |600px|thumb|right|Настройка соединения с контроллером Wiren Board]]
Чтобы упростить взаимодействие Node-RED с контроллером Wiren Board, пользователь [https://support.wirenboard.com/t/node-red-contrib-wirenboard/2019 Andrej_Popov] написал модуль <code>node-red-contrib-wirenboard</code>.
Чтобы упростить взаимодействие Node-RED с контроллером Wiren Board, пользователь [https://support.wirenboard.com/t/node-red-contrib-wirenboard/2019 Andrej_Popov] написал модуль <code>node-red-contrib-wirenboard</code>.


=== Установка ===
=== Установка === <!--T:43-->
Установим его через [[#Веб-интерфейс Node-RED | веб-интерфейс Node-RED]]:
Установим его через веб-интерфейс Node-RED:
{{Node-RED Installing plugin
{{Node-RED Installing plugin
|search= wirenboard
|search= wirenboard
Строка 118: Строка 197:


После установки, в левой панели появится секция Wiren Board.
После установки, в левой панели появится секция Wiren Board.
=== Настройка ===
 
=== Настройка === <!--T:44-->
После того как вы установили WB Nodes, вам нужно настроить соединение с MQTT-брокером контроллера Wiren Board:
После того как вы установили WB Nodes, вам нужно настроить соединение с MQTT-брокером контроллера Wiren Board:
# Добавьте в рабочую область ноду '''WB-input''', которая находится в левой панели, в секции '''Wiren Board'''.
# Добавьте в рабочую область ноду '''WB-input''', которая находится в левой панели, в секции '''Wiren Board'''.
Строка 128: Строка 208:
{{note|info| После настройки подключения, примените настройку сервера нажатием кнопки '''Deploy''' справа вверху. Только после этого будет доступен список каналов контроллера Wiren Board.}}
{{note|info| После настройки подключения, примените настройку сервера нажатием кнопки '''Deploy''' справа вверху. Только после этого будет доступен список каналов контроллера Wiren Board.}}


<!--T:45-->
Вы настроили WB Nodes и можете писать автоматизации с использованием Node-RED.
Вы настроили WB Nodes и можете писать автоматизации с использованием Node-RED.


=== Проверка настроек ===
=== Проверка настроек === <!--T:46-->
Чтобы проверить правильность настроек:
Чтобы проверить правильность настроек:
# Добавьте в рабочую область любую ноду из группы Wiren Board, например, '''WB-input'''.
# Добавьте в рабочую область любую ноду из группы Wiren Board, например, '''WB-input'''.
Строка 136: Строка 217:
# В окне '''Edit in node''' нажмите кнопку '''Refresh Device List'''.
# В окне '''Edit in node''' нажмите кнопку '''Refresh Device List'''.


<!--T:47-->
Если соединение настроено верно, то в выпадающем списке поля '''Сhannel''' появится список доступных для использования каналов.
Если соединение настроено верно, то в выпадающем списке поля '''Сhannel''' появится список доступных для использования каналов.


=== Примеры ===
=== Примеры === <!--T:48-->
В комплекте с WB-Nodes есть примеры для [[Node-RED Apple HomeKit | Apple HomeKit]] и Яндекс.Алисы, найти их можно в '''Menu''' → '''Import''' → '''Examples'''.
В комплекте с WB-Nodes есть примеры для [[Node-RED Apple HomeKit | Apple HomeKit]] и Яндекс.Алисы, найти их можно в '''Menu''' → '''Import''' → '''Examples'''.
<gallery mode="packed" heights="200px" caption="Примеры из комплекта WB-Nodes">
<gallery mode="packed" heights="200px" caption="Примеры из комплекта WB-Nodes">
Строка 145: Строка 227:
</gallery>
</gallery>


== Использование нод ''mqtt in'' и ''mqtt out'' для взаимодействия с Wiren Board ==
=== Решение проблем ===
=== Настройка подключения ===
Иногда, если во флоу есть ошибка, то веб-интерфейс Node-RED может перестать загружаться, в этом случае нужно проверить  логи сервиса nodered.
Для обмена данными между Node-RED и контроллером Wiren Board можно использовать ноды '''mqtt in''' для получения данных и  '''mqtt out''' для отправки.
<gallery mode="packed" heights="150px">
Image: NodeRed_mqtt1.jpg | Обмен данными через MQTT в Node-Red
Image: NodeRed_mqtt_nodes.jpg | Ноды MQTT в Node-Red
</gallery>
Для настройки [[MQTT | MQTT-соединения]] в Node-RED выполните следующие действия:
#Перетащите ноду '''mqtt in''' в рабочую область.
#Войдите в конфигурацию ноды и нажмите на '''Карандаш''' напротив поля '''Server'''.
#На вкладке '''Connecting''' задайте адрес брокера и номер порта.
#:В поле '''Name''' введите любое имя сервера.
#:На вкладке '''Security''' можно указать Имя пользователя и Пароль для подключения к брокеру. Если в качестве брокера выступает контроллер Wiren Board, это поле нужно оставить пустым.
#После заполнения всех полей нажмите кнопку '''Update'''. Созданный брокер теперь можно использовать для настройки всех подключений.
#Выберите созданные брокер из списка в поле '''Server'''.
#Введите адрес mqtt-топика в поле '''Topic'''.
#Нажмите кнопку '''Done'''.
По такому же принципу настраивается нода '''mqtt out'''.
<gallery mode="packed" heights="150px" caption="Настройка  MQTT подключения в Node-RED">
Image: NodeRed_mqtt4.jpg | Окно настройки MQTT ноды
Image: NodeRed_mqtt2.jpg | Окно настройки MQTT-брокера, вкладка ''Connecting''
Image: NodeRed_mqtt3.jpg  | Окно настройки MQTT-брокера, вкладка ''Security''
</gallery>
 
=== Отправка команд ===
После настройки mqtt-ноды в нее можно отправлять команды управления. При этом значение параметра будет записываться в соответствующий mqtt-топик.
Для отправки команды можно использовать ноду '''inject'''.
#Перетащите ноду '''inject''' в рабочую область.
#Подключите ее ко входу ноды '''mqtt in'''.
#Зайдите в настройки ноды '''inject''' и задайте ''Имя'' ноды, ''Тип переменной'' и ее ''Значение''. Нажмите кнопку '''Done'''.
<gallery mode="packed" heights="130px">
Image: Inject1.jpg | Пример настроек ноды '''inject''' для управления дискретным параметром
Image: Inject2.jpg | Поле настройки периодов повторения отправки ноды '''inject'''
</gallery>
<gallery mode="packed" heights="100px">
Image: Node_inject.jpg | Пример использования ноды '''inject'''
</gallery>


После настройки ввода и вывода можно обрабатывать данные внутри Node-RED и настроить использование сторонних сервисов, например, [[Node-RED_Alice | Умный дом с Алисой]].
Если в логах будет видна ошибка во флоу, то:
# Подключиться к контроллеру по [[SSH]].
# Остановить службу, если она запущена:
#: <syntaxhighlight lang="bash">
systemctl stop nodered
</syntaxhighlight>
# Запустить Node-RED в безопасном режиме:
#: <syntaxhighlight lang="bash">
node-red --safe
</syntaxhighlight>
# Установить проблему и остановить запущенный в безопасном режиме Node-RED.
# Снова запустить сервис:
#: <syntaxhighlight lang="bash">
systemctl start nodered
</syntaxhighlight>


<gallery mode="packed" heights="150px">
Если вы ставили Node-RED в docker, воспользуйтесь инструкцией на странице [[Node-RED_docker|Установка Node-RED в docker]].
Image: NodeRed_mqtt5.jpg | Пример управления с помощью Алисы
</gallery>


== Примеры использования ==
== Примеры использования == <!--T:55-->
Примеры использования Node-RED с WB-Nodes на контроллерах Wiren Board:
Примеры использования Node-RED с WB-Nodes на контроллерах Wiren Board:
* [[Node-RED_Telegram | Настройка Telegram-бота]].
* [[Node-RED_Telegram | Настройка Telegram-бота]].
* [[Node-RED_Alice | Настройка Алисы на контроллере Wiren Board]].
* [[Node-RED_Alice | Настройка Алисы на контроллере Wiren Board]].
* [[Node-RED Apple HomeKit | Настройка Apple HomeKit на контроллере Wiren Board]].
* [[Node-RED Apple HomeKit | Настройка Apple HomeKit на контроллере Wiren Board]].
* [https://youtu.be/cKQmU4LZo4c Видео от нашего партнёра: WIRENBOARD + NODERED]
* [[Node-RED Dashboards|Создание панелей (Dashboards) в Node-RED]].
* [https://youtu.be/cKQmU4LZo4c Видео от нашего партнёра: Wiren Board + Node-RED]
</translate>
* [https://habr.com/ru/company/wirenboard/blog/689098/ Умный дом на Wiren Board и Node-RED: четыре полезных сценария без программирования]
* [https://habr.com/ru/company/wirenboard/blog/689826/ Умный дом на Wiren Board и Node-RED: ещё три полезных сценария без программирования]
* [https://habr.com/ru/company/wirenboard/blog/713274/ Работаем с Zigbee-устройствами через Zigbee2mqtt и Node-RED]
Brainroot
wb_editors
890

правок

Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/66015...80448