Node-RED: различия между версиями
(Прибил гвоздями версию 3.1.11) |
|||
(не показано 57 промежуточных версий 6 участников) | |||
Строка 1: | Строка 1: | ||
{{DISPLAYTITLE:Установка Node-RED на контроллер Wiren Board}} | {{DISPLAYTITLE:Установка Node-RED на контроллер Wiren Board}} | ||
[[Файл:Node-red.PNG|500px|thumb|right| Node-RED на | [[Файл:Node-red.PNG|500px|thumb|right| Node-RED на WB6]] | ||
== Описание == | == Описание == | ||
Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом. | Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом. | ||
Подробное описание, инструкции и примеры использования можно найти на сайте [https://nodered.org/ nodered.org], а поддержку сообщества в телеграм-канале [https://t.me/SprutAI_NodeRED Node-RED]. | Подробное описание, инструкции и примеры использования можно найти на сайте [https://nodered.org/ nodered.org], а поддержку сообщества в телеграм-канале [https://t.me/SprutAI_NodeRED Node-RED]. | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
== Установка == | == Установка == | ||
Для установки Node-RED на Wiren board 6 подключитесь к контроллеру по [[SSH]] и введите в консоль несколько команд. | |||
Установите необходимые компоненты: | Установите необходимые компоненты: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
apt install -y nodejs git make g++ gcc build-essential | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Запустите установку Node-RED: | Запустите установку Node-RED: | ||
<syntaxhighlight lang="bash"> | |||
npm install -g --unsafe-perm node-red | npm install -g --unsafe-perm node-red | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Если потребуется обновить версию Node-RED, выполните команду установки ещё раз. | Если потребуется обновить версию Node-RED, выполните команду установки ещё раз. | ||
== Создание сервиса == | |||
Для автозапуска Node-RED необходимо настроить сервис. Для этого в папке <code>/etc/systemd/system/</code> создайте файл <code>nodered.service</code>: | Для автозапуска Node-RED необходимо настроить сервис. Для этого в папке <code>/etc/systemd/system/</code> создайте файл <code>nodered.service</code>: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
mcedit /etc/systemd/system/nodered.service | |||
</syntaxhighlight> | </syntaxhighlight> | ||
Затем вставьте в этот файл строки: | Затем вставьте в этот файл строки: | ||
<pre> | <pre> | ||
Строка 58: | Строка 38: | ||
Wants=network.target | Wants=network.target | ||
[Service] | [Service] | ||
Type=simple | Type=simple | ||
Строка 65: | Строка 44: | ||
WorkingDirectory=/home | WorkingDirectory=/home | ||
Nice=5 | Nice=5 | ||
Environment="NODE_OPTIONS=--max_old_space_size=256" | Environment="NODE_OPTIONS=--max_old_space_size=256" | ||
Строка 73: | Строка 51: | ||
SyslogIdentifier=Node-RED | SyslogIdentifier=Node-RED | ||
[Install] | [Install] | ||
WantedBy=multi-user.target | WantedBy=multi-user.target | ||
</pre> | </pre> | ||
Сохраните изменения и закройте файл. Теперь включите сервис и запустите его командой: | Сохраните изменения и закройте файл. Теперь включите сервис и запустите его командой: | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
systemctl enable nodered && systemctl start nodered | systemctl enable nodered && systemctl start nodered | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Проверьте статус сервиса командой, в выводе должна быть строчка <code>Active: active (running)</code>: | Проверьте статус сервиса командой, в выводе должна быть строчка <code>Active: active (running)</code>: | ||
<syntaxhighlight lang="console"> | <syntaxhighlight lang="console"> | ||
Строка 97: | Строка 71: | ||
└─2757 node /usr/bin/node-red --max_old_space_size=256 | └─2757 node /usr/bin/node-red --max_old_space_size=256 | ||
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] | ||
Строка 108: | Строка 81: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== Удаление == | == Удаление == | ||
Если вам больше не нужен Node-RED, то его можно удалить: | Если вам больше не нужен Node-RED, то его можно удалить: | ||
# Остановите, отключите и удалите сервис: | # Остановите, отключите и удалите сервис: | ||
Строка 119: | Строка 92: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Node.js, тоже можно удалить, но убедитесь, что у вас не установлены другие програмы, которые его используют, например, zigbee2mqtt. Чтобы удалить node.js, выполните команду: | Node.js, тоже можно удалить, но убедитесь, что у вас не установлены другие програмы, которые его используют, например, zigbee2mqtt. Чтобы удалить node.js, выполните команду: | ||
:<syntaxhighlight lang="bash"> | :<syntaxhighlight lang="bash"> | ||
Строка 125: | Строка 97: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==Веб-интерфейс Node-RED== | ==Веб-интерфейс Node-RED== | ||
После запуска сервиса откройте браузер и введите адрес своего контроллера в сети и порт 1880. | После запуска сервиса откройте браузер и введите адрес своего контроллера в сети и порт 1880. | ||
Например: http://192.168.42.1:1880 | Например: http://192.168.42.1:1880 | ||
Инструкции по работе c Node-RED можно найти на [https://nodered.org/docs/getting-started/ сайте nodered.org] | Инструкции по работе c Node-RED можно найти на [https://nodered.org/docs/getting-started/ сайте nodered.org] | ||
== WB Nodes == | |||
== WB Nodes | |||
[[Файл: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>. | ||
=== Установка === | === Установка === | ||
Установим его через веб-интерфейс Node-RED: | Установим его через [[#Веб-интерфейс Node-RED | веб-интерфейс Node-RED]]: | ||
{{Node-RED Installing plugin | {{Node-RED Installing plugin | ||
|search= wirenboard | |search= wirenboard | ||
Строка 197: | Строка 116: | ||
После установки, в левой панели появится секция Wiren Board. | После установки, в левой панели появится секция Wiren Board. | ||
=== Настройка === | |||
=== Настройка === | |||
После того как вы установили WB Nodes, вам нужно настроить соединение с MQTT-брокером контроллера Wiren Board: | После того как вы установили WB Nodes, вам нужно настроить соединение с MQTT-брокером контроллера Wiren Board: | ||
# Добавьте в рабочую область ноду '''WB-input''', которая находится в левой панели, в секции '''Wiren Board'''. | # Добавьте в рабочую область ноду '''WB-input''', которая находится в левой панели, в секции '''Wiren Board'''. | ||
# Дважды кликните на ней, откроется окно '''Edit in node'''. | # Дважды кликните на ней, откроется окно '''Edit in node'''. | ||
# Найдите в нём поле '''Server''' и нажмите на кнопку с карандашом. Откроется окно '''Add new wirenboard-server config node'''. | # Найдите в нём поле '''Server''' и нажмите на кнопку с карандашом. Откроется окно '''Add new wirenboard-server config node'''. | ||
# Заполните поля '''Name''', '''Host''' и '''MQTT Port'''. Если Node-RED установлен на контроллере — в поле Host пропишите <code>localhost</code> | # Заполните поля '''Name''', '''Host''' и '''MQTT Port'''. Если Node-RED установлен на контроллере — в поле Host пропишите <code>localhost</code>. | ||
# Сохраните настройки сервера нажатием на кнопку '''Done'''. | # Сохраните настройки сервера нажатием на кнопку '''Done'''. | ||
# Закройте окно '''Edit in node''' нажатием на '''Cancel'''. | # Закройте окно '''Edit in node''' нажатием на '''Cancel'''. | ||
{{note|info| После настройки подключения, примените настройку сервера нажатием кнопки '''Deploy''' справа вверху. Только после этого будет доступен список каналов контроллера Wiren Board.}} | {{note|info| После настройки подключения, примените настройку сервера нажатием кнопки '''Deploy''' справа вверху. Только после этого будет доступен список каналов контроллера Wiren Board.}} | ||
Вы настроили WB Nodes и можете писать автоматизации с использованием Node-RED. | Вы настроили WB Nodes и можете писать автоматизации с использованием Node-RED. | ||
=== Проверка настроек === | === Проверка настроек === | ||
Чтобы проверить правильность настроек: | Чтобы проверить правильность настроек: | ||
# Добавьте в рабочую область любую ноду из группы Wiren Board, например, '''WB-input'''. | # Добавьте в рабочую область любую ноду из группы Wiren Board, например, '''WB-input'''. | ||
Строка 217: | Строка 134: | ||
# В окне '''Edit in node''' нажмите кнопку '''Refresh Device List'''. | # В окне '''Edit in node''' нажмите кнопку '''Refresh Device List'''. | ||
Если соединение настроено верно, то в выпадающем списке поля '''Сhannel''' появится список доступных для использования каналов. | Если соединение настроено верно, то в выпадающем списке поля '''Сhannel''' появится список доступных для использования каналов. | ||
=== Примеры === | === Примеры === | ||
В комплекте с 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=" | <gallery mode="packed" heights="250px" caption="Примеры из комплекта WB-Nodes"> | ||
Image: WB-Nodes Examples 1.png | Список примеров | Image: WB-Nodes Examples 1.png | Список примеров | ||
Image: WB-Nodes Examples 2.png | Пример в рабочей области | Image: WB-Nodes Examples 2.png | Пример в рабочей области | ||
</gallery> | </gallery> | ||
== Примеры использования == | |||
== Примеры использования == | |||
Примеры использования 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] | |||
* [https://youtu.be/cKQmU4LZo4c Видео от нашего партнёра: | |||
Версия 16:00, 27 мая 2022
Описание
Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом.
Подробное описание, инструкции и примеры использования можно найти на сайте nodered.org, а поддержку сообщества в телеграм-канале Node-RED.
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.
Установка
Для установки Node-RED на Wiren board 6 подключитесь к контроллеру по SSH и введите в консоль несколько команд.
Установите необходимые компоненты:
apt install -y nodejs git make g++ gcc build-essential
Запустите установку Node-RED:
npm install -g --unsafe-perm node-red
Если потребуется обновить версию Node-RED, выполните команду установки ещё раз.
Создание сервиса
Для автозапуска Node-RED необходимо настроить сервис. Для этого в папке /etc/systemd/system/
создайте файл nodered.service
:
mcedit /etc/systemd/system/nodered.service
Затем вставьте в этот файл строки:
[Unit] Description=Node-RED graphical event wiring tool Wants=network.target [Service] Type=simple User=root Group=root WorkingDirectory=/home Nice=5 Environment="NODE_OPTIONS=--max_old_space_size=256" ExecStart=/usr/bin/env node-red $NODE_OPTIONS $NODE_RED_OPTIONS KillSignal=SIGINT Restart=on-failure SyslogIdentifier=Node-RED [Install] WantedBy=multi-user.target
Сохраните изменения и закройте файл. Теперь включите сервис и запустите его командой:
systemctl enable nodered && systemctl start nodered
Проверьте статус сервиса командой, в выводе должна быть строчка Active: active (running)
:
# systemctl status nodered
● nodered.service - Node-RED graphical event wiring tool
Loaded: loaded (/etc/systemd/system/nodered.service; enabled; vendor preset: enabled)
Active: active (running) since Fri 2021-12-03 06:32:25 UTC; 24s ago
Main PID: 2757 (node)
CGroup: /system.slice/nodered.service
└─2757 node /usr/bin/node-red --max_old_space_size=256
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]: Welcome to Node-RED
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: ===================
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:36 - [info] Node-RED version: v2.1.4
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:36 - [info] Node.js version: v12.19.0
Dec 03 06:32:36 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:36 - [info] Linux 5.10.35-wb6 arm LE
Dec 03 06:32:41 wirenboard-AWQBNTYP Node-RED[2757]: 3 Dec 06:32:41 - [info] Loading palette nodes
Удаление
Если вам больше не нужен Node-RED, то его можно удалить:
- Остановите, отключите и удалите сервис:
systemctl stop nodered && systemctl disable nodered && rm /etc/systemd/system/nodered.service
- Удалите сам Node-RED:
npm -g remove node-red && npm -g remove node-red-admin && rm -R ~/.node-red
Node.js, тоже можно удалить, но убедитесь, что у вас не установлены другие програмы, которые его используют, например, zigbee2mqtt. Чтобы удалить node.js, выполните команду:
apt remove nodejs
Веб-интерфейс Node-RED
После запуска сервиса откройте браузер и введите адрес своего контроллера в сети и порт 1880. Например: http://192.168.42.1:1880
Инструкции по работе c Node-RED можно найти на сайте nodered.org
WB Nodes
Чтобы упростить взаимодействие Node-RED с контроллером Wiren Board, пользователь Andrej_Popov написал модуль node-red-contrib-wirenboard
.
Установка
Установим его через веб-интерфейс Node-RED:
- Зайдите в веб-интерфейс Node-RED.
- В правом верхнем углу вызовите меню.
- В открывшемся окне выберите вкладку Управление палитрой (Manager palette).
- Перейдите на вкладку Установка (Install), введите в поле поиска wirenboard и нажмите на клавиатуре Enter.
- Установите пакет с названием node-red-contrib-wirenboard.
- Закройте окно с настройками. Установка модуля завершена.
После установки, в левой панели появится секция Wiren Board.
Настройка
После того как вы установили WB Nodes, вам нужно настроить соединение с MQTT-брокером контроллера Wiren Board:
- Добавьте в рабочую область ноду WB-input, которая находится в левой панели, в секции Wiren Board.
- Дважды кликните на ней, откроется окно Edit in node.
- Найдите в нём поле Server и нажмите на кнопку с карандашом. Откроется окно Add new wirenboard-server config node.
- Заполните поля Name, Host и MQTT Port. Если Node-RED установлен на контроллере — в поле Host пропишите
localhost
. - Сохраните настройки сервера нажатием на кнопку Done.
- Закройте окно Edit in node нажатием на Cancel.
После настройки подключения, примените настройку сервера нажатием кнопки Deploy справа вверху. Только после этого будет доступен список каналов контроллера Wiren Board.
Вы настроили WB Nodes и можете писать автоматизации с использованием Node-RED.
Проверка настроек
Чтобы проверить правильность настроек:
- Добавьте в рабочую область любую ноду из группы Wiren Board, например, WB-input.
- Дважды кликните на ноде WB-input, откроется окно Edit in node.
- В окне Edit in node нажмите кнопку Refresh Device List.
Если соединение настроено верно, то в выпадающем списке поля Сhannel появится список доступных для использования каналов.
Примеры
В комплекте с WB-Nodes есть примеры для Apple HomeKit и Яндекс.Алисы, найти их можно в Menu → Import → Examples.
- Примеры из комплекта WB-Nodes
Примеры использования
Примеры использования Node-RED с WB-Nodes на контроллерах Wiren Board: