Node-RED: различия между версиями
Vvzvlad (обсуждение | вклад) |
Vvzvlad (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
<languages/><translate> | <languages/><translate> | ||
<!--T:19--> | <!--T:19--> | ||
Строка 16: | Строка 17: | ||
<!--T:22--> | <!--T:22--> | ||
{{Wbincludes:Installing Software In Console}} | {{Wbincludes:Installing Software In Console}} | ||
== Установка == <!--T:23--> | == Установка == <!--T:23--> | ||
Для установки Node-RED 2.2 на контроллер Wiren Board подключитесь к нему по [[SSH]] и введите в консоль несколько команд. | Для установки Node-RED 2.2 на контроллер Wiren Board подключитесь к нему по [[SSH]] и введите в консоль несколько команд. | ||
# Установите docker по [[docker | инструкции]]. | |||
Установите | # Создайте каталог под служебные файлы: | ||
# | |||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
mkdir /mnt/data/root/nodered | |||
chown -R 1000:1000 /mnt/data/root/nodered | |||
chmod -R 777 /mnt/data/root/nodered | |||
</syntaxhighlight> | </syntaxhighlight> | ||
# | # Запустите образ nodered — docker автоматически загрузит его из интернет и запустит: | ||
#:<syntaxhighlight lang="bash"> | #:<syntaxhighlight lang="bash"> | ||
docker run -d --name nodered --privileged --restart=unless-stopped -e TZ=Europe/Moscow -v /mnt/data/root/nodered:/data -e NODE_OPTIONS="--max_old_space_size=256" --network=host nodered/node-red | |||
</syntaxhighlight> | </syntaxhighlight> | ||
После установки и запуска, откройте браузер и введите [[How_to_find_IP_address | адрес своего контроллера]] в сети и порт 1880. Например: http://192.168.42.1:1880 Консоль можно закрыть. | |||
==Веб-интерфейс Node-RED== <!--T:40--> | ==Веб-интерфейс Node-RED== <!--T:40--> |
Версия 17:29, 26 марта 2023
Описание
Node-RED — это инструмент визуального программирования, основанный на Node.js и который разрабатывается и поддерживается открытым сообществом.
Подробное описание, инструкции и примеры использования можно найти на сайте nodered.org, а поддержку сообщества в телеграм-канале Node-RED.
Копируйте команды из инструкции, вставляйте их в консоль контроллера с помощью клавиш Shift+Insert и запускайте клавишей Enter. В случае ошибок, внимательно читайте вывод, там будут инструкции и подсказки.
Установка
Для установки Node-RED 2.2 на контроллер Wiren Board подключитесь к нему по SSH и введите в консоль несколько команд.
- Установите docker по инструкции.
- Создайте каталог под служебные файлы:
mkdir /mnt/data/root/nodered chown -R 1000:1000 /mnt/data/root/nodered chmod -R 777 /mnt/data/root/nodered
- Запустите образ nodered — docker автоматически загрузит его из интернет и запустит:
docker run -d --name nodered --privileged --restart=unless-stopped -e TZ=Europe/Moscow -v /mnt/data/root/nodered:/data -e NODE_OPTIONS="--max_old_space_size=256" --network=host nodered/node-red
После установки и запуска, откройте браузер и введите адрес своего контроллера в сети и порт 1880. Например: http://192.168.42.1:1880 Консоль можно закрыть.
Веб-интерфейс 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
. В поле Name укажите произвольное имя, а в поле MQTT Port — 1883. - Сохраните настройки сервера нажатием на кнопку 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.
Решение проблем
Иногда, если во флоу есть ошибка, то веб-интерфейс Node-RED может перестать загружаться, в этом случае нужно проверить логи сервиса nodered.
Если в логах будет видна ошибка во флоу, то:
- Подключиться к контроллеру по SSH.
- Остановить службу, если она запущена:
systemctl stop nodered
- Запустить Node-RED в безопасном режиме:
node-red --safe
- Установить проблему и остановить запущенный в безопасном режиме Node-RED.
- Снова запустить сервис:
systemctl start nodered
Использование нод mqtt in и mqtt out для взаимодействия с Wiren Board
Настройка подключения
Альтернативный вариант — использовать ноды mqtt in и mqtt out. Для этого вам понадобятся адреса топиков, взять их можно в веб-интерфейсе контроллера на странице MQTT-каналы.
Для настройки MQTT-соединения в Node-RED выполните следующие действия:
- Перетащите ноду mqtt in в рабочую область.
- Войдите в конфигурацию ноды и нажмите на Карандаш напротив поля Server.
- На вкладке Connecting задайте адрес брокера и номер порта.
- В поле Name введите любое имя сервера.
- На вкладке Security можно указать Имя пользователя и Пароль для подключения к брокеру. Если в качестве брокера выступает контроллер Wiren Board, это поле нужно оставить пустым.
- После заполнения всех полей нажмите кнопку Update. Созданный брокер теперь можно использовать для настройки всех подключений.
- Выберите созданные брокер из списка в поле Server.
- Введите адрес mqtt-топика в поле Topic.
- Нажмите кнопку Done.
По такому же принципу настраивается нода mqtt out.
Отправка команд
Для отправки команды контроллеру по MQTT используется нода mqtt out. При этом в поле Topic указывается адрес mqtt-топика контроллера, в который необходимо записать параметр. Нужно учитывать, что в конце адреса ноды mqtt out нужно написать /on
, иначе параметр в топик не запишется. Например, /devices/wb-mrgbw-d-fw3_129/controls/RGB Strip/on
. Подробнее читайте на странице MQTT.
Для отправки параметра в ноду mqtt out можно использовать ноду inject.
- Перетащите ноду inject в рабочую область.
- Подключите ее ко входу ноды mqtt out.
- Зайдите в настройки ноды inject и задайте Имя ноды, Тип переменной и ее Значение. Нажмите кнопку Done.
После настройки ввода и вывода можно обрабатывать данные внутри Node-RED и настроить использование сторонних сервисов, например, Умный дом с Алисой.
Примеры использования
Примеры использования Node-RED с WB-Nodes на контроллерах Wiren Board:
- Настройка Telegram-бота.
- Настройка Алисы на контроллере Wiren Board.
- Настройка Apple HomeKit на контроллере Wiren Board.
- Создание панелей (Dashboards) в Node-RED.
- Видео от нашего партнёра: Wiren Board + Node-RED
- Умный дом на Wiren Board и Node-RED: четыре полезных сценария без программирования
- Умный дом на Wiren Board и Node-RED: ещё три полезных сценария без программирования
- Работаем с Zigbee-устройствами через Zigbee2mqtt и Node-RED