Олександр ПУПЕНА

Довідник з Node-RED

Вступ

Довідник створений з метою спрощення вивчення Node-RED студентам та спеціалістам з автоматизації та комп’ютерно-інтегрованих технологій. Зокрема даний довідник призначений для використання в лабораторних роботах в курсі «Технології індустрії 4.0».

Нова версія на сайті Github за посиалнням

Стара версія посібника доступна за посиланням.

Якщо Ви хочете пришвидшити вивчення Node-RED а також багатьох інших технологій Інтернету речей та Індустрії 4.0, ви можете записатися на онлайн-курс «Технології індустрії 4.0»

1. Загальні основи користування Node-RED та основні компоненти

2. Розширення

3. Dashboard (node-red-dashboard) та сумісні з ним вузли

4. Вбудовані вузли для роботи з файлами

5. Базові операції з файлами: бібліотека fs-ops

6. Бібліотека MODBUS

7. Бібліотека MQTT

8. Бібліотека HTTP

9. Бібліотека WebSocket

10. Бібліотека PARSING

11. Робота з JSONata

12. Бібліотека Storage Cloudant

13. Бібліотека Storage COS (node-red-contrib-cos)

14. Робота з Watson IoT Device/Gateway (node-red-contrib-ibm-watson-iot)

15. Бібліотека IBM IoT APP (node-red-contrib-scx-ibmiotapp)

16. Бібліотека OPC UA (node-red-contrib-opcua)

17. Робота з Базами даних

18. Робота з ОС

19. Взаємодія з сервісами Google

20. Боти

21. TCP та UDP

22. Протоколи S7

23. InfluxDB

24. uibuilder - альтернатива Dashboard

Перелік вузлів

У полі примітка вказується дата останньої редакції розділу довідника, або "to do" - для відсутнього опису.

Стандартна комплектація

Загальні (common)

Вузол	Призначення	Примітка
	Inject для ініціювання потоку (відправки повідомлення) користувачем, автоматично при запуску, періодично або за розкладом.	07.2020
	Debug використовуватися для відображення повідомлень на бічній панелі Debug у редакторі.	07.2020
	Complete запускає потік, коли інший вузол завершує оброблення повідомлення.	07.2020
	Catch ловить помилки виконання інших вузлів у тому самому потоці (вкладці) і формує повідомлення з інформацією про них.	07.2020
	Status показує стан (status message) вказаних або усіх вузлів в потоці.	07.2020
	Link in вхідне з'єднання з іншого потоку	07.2020
	Link out вихідне з'єднання до іншого потоку	07.2020
	Comment для добавлення коментарів в потік.	07.2020
	Unknown вузол невідомого типу для встановленого Node-RED	07.2020

Функціональні (function)

Вузол	Призначення	Примітка
	Function дозволяє виконувати код JavaScript для обробки повідомлень, що передаються через нього.	07.2020
	Switch дозволяє передавати повідомлення до різних гілок потоку, оцінюючи набір правил для кожного повідомлення	07.2020
	Change для зміни властивостей повідомлення та контекстів (потоку і глобального) без необхідності вдаватися до вузла Function	07.2020
	Range масштабує числові значення відповідно до вказаних вхідних та вихідних діапазонів	07.2020
	Template використовується для створення тексту з властивостей повідомлення з використанням означеного шаблону Mustache	07.2020
	Delay робить затримку для кожного повідомлення, що проходить через вузол, або обмежує швидкість, з якою вони можуть пройти.	07.2020
	Trigger відправляє повідомлення з вказаним інтервалом	07.2020
	Exec запускає системну команду.	07.2020
	Rbe пропускає повідомлення лише у випадку зміни корисного навантаження	07.2020

Мережні (network)

Вузол	Призначення	Примітка
	Mqtt in - підключається до брокера MQTT та підписується на повідомлення з зазначеної теми	2019
	Mqtt out підключається до брокера MQTT та публікує повідомлення	2019
	Mqtt-broker конфігураційний вузол для Mqtt-broker	2019
	Http-in HTTP-сервер - обробка вхідного повідомлення	2019
	Http response HTTP-сервер - формування вихідного повідомлення	2019
	Http request робота з клієнтськими запитами до HTTP-серверів	07.2020
	Http proxy параметри конфігурації для HTTP-проксі	07.2020
	Tls-config конфігураційні опції для TLS підключень	07.2020
	Websocket in вхідний вузол WebSocket	2019
	Websocket out вихідний вузол WebSocket	2019
	Websocket-listener для налаштування серверного ресурсу WebSocket	2019
	Websocket-client для налаштування з’єднання клієнтського вузлу WebSocket	2019
	TCP in забезпечує отримання вхідних даних з порта TCP	07.2020
	TCP out забезпечує відправлення вихідного повідомлення на TCP-порт.	07.2020
	TCP request для відправки клієнтського запиту TCP та очікування відповіді	07.2020
	UDP in для отримання повідомлень по UDP	07.2020
	UPD out для відправки повідомлень по UDP	07.2020

Послідовності (sequence)

Вузол	Призначення	Примітка
	Split розділює одне повідомлення в послідовність повідомлень.	07.2020
	Join об'єднує послідовність повідомлень у єдине повідомлення	07.2020
	Sort сортує масив або послідовність повідомлень на основі значення властивості або результату вираження JSONata	07.2020
	Batch створює нові послідовності згрупованих повідомлень з отриманих.	07.2020

Парсери (parser)

Вузол	Призначення	Примітка
	CSV перетворює рядки, відформатовані CSV в об’єкти JavaScript та навпаки	07.2020
	HTML витягує елементи з HTML-документа, що міститься у вказаній властивості msg за допомогою селекторів CSS	07.2020
	JSON перетворює рядки JSON в об’єкти JavaScript та в зворотному напрямку	07.2020
	XML перетворює рядок XML в об’єкт JavaScript та в зворотному напрямку напрямку.	07.2020
	YAML перетворює рядок, відформатований в форматі YAML у об'єкт JavaScript та в зворотному напрямку	07.2020

Сховища (storage)

Вузол	Призначення	Примітка
	File записує дані у файл, додавши його до кінця або замінюючи існуючий вміст	07.2020
	File in читає вміст файлу у вигляді рядку або бінарного буферу	07.2020
	Watch відслідковує зміни в каталозі або у файлі.	07.2020
	Tail стежить за тим, що було додано у вказаний файл	07.2020

Dashboard

Вузол	Призначення	Примітка
	Button додає до інтерфейсу користувача кнопку	2019
	Dropdown додає до інтерфейсу користувача спадне меню вибору	2019
	Switch додає до інтерфейсу користувача перемикач.	2019
	Slider додає до інтерфейсу користувача віджет повзунка.	2019
	Numeric додає до інтерфейсу користувача віджет зміни числового значення кнопками «більше» та «менше».	2019
	Text input додає до інтерфейсу користувача поле введення тексту, електронної пошти або вибору кольорів.	2019
	Date picker додає до інтерфейсу користувача віджет вибору дати.	2019
	Color picker додає до інтерфейсу користувача панель вибору кольору.	2019
	Form додає до інтерфейсу користувача форму (кілька полів введення).	2019
	Text додає до інтерфейсу користувача поле для виведення тексту.	2019
	Gauge додає до інтерфейсу користувача віджет приладового показчика	2019
	Chart додає до інтерфейсу користувача діаграму з відображенням значень, що надходять на вхід у вигляді різного типу діаграм	2019
	Audio відтворює аудіо або текст в мову (text to speech TTS).	2019
	Notification показує msg.payload як спливаюче сповіщення або діалогове повідомлення з кнопками OK/Cancel	2019
	Ui control дозволяє динамічно керувати Dashboard.	2019
	Template шаблонний віджет (template widget) може містити будь-які дійсні директиви html та Angular/Angular-Material.	2019
	Link	to do
	Spacer	to do
	Tab	to do
	Base	to do
	Group	to do

Додаткові вузли:

Вузол	Призначення	Примітка
	SVG graphics для розміщення графіки SVG на сторінках Node-RED dashboard	05.2021
	Table UI widget node for Node-RED Dashboard	05.2021

Альтернатива:

Вузол	Призначення	Примітка
	uibuilder - альтернатива Dashboard

Базові операції з файлами: бібліотека fs-ops

Вузол	Призначення	Примітка
	Access перевірка наявності та доступності файлу або каталогу	to do
	Copy копіювання або посилання на файли	to do
	Delete видалення файлів або каталогів	to do
	Dir показує список файлів в каталозі файлової системи хоста.	2019
	Mkdir створює новий каталог	to do
	Mktmpdir створює новий каталог із випадковим унікальним ім'ям	to do
	Move переміщує або перейменовує файли в локальній файловій системі	2019
	Size отримання розміру файлу або каталогу в байтах	to do
	Stats повертає статистику файлу в хостовій файловій системі	to do
	Type визначає тип файлу - звичайний, каталог, символ або спеціальний	to do
	Link визначає, чи є файл посиланням і повертає файл, на який він посилається.	to do

Робота з ОС

Operating Systems (node-red-contrib-os)

Вузол	Призначення	Примітка
	OS отримання інформації про операційну систему	2019
	Drives інформація про жорсткі диски	2019
	Uptime повертає системний час роботи в секундах	2019
	CPUs повертає масив об'єктів, що містить інформацію про кожен встановлений процесор/ядро	2019
	Loadavg повертає масив, що містить середнє значення для завантаження	2019
	Memory дає інформацію про пам'ять	2019
	NetworkIntf дає список мережних інтерфейсів у системі	2019

Моніторинг використання ресурсів CPU (node-red-contrib-cpu)

Вузол	Призначення	Примітка
	CPU моніторить використання CPU, базується на Node.js OS Library.	2019

Промислові мережі

Modbus

node-red-contrib-modbustcp

Вузол	Призначення	Примітка
	Read підключається до Modbus TCP server для зчитування змінних з вказаною періодичністю	2019
	Write підключається до TCP server для запису msg.payload в coil або register	2019
	Server для вказівки серверу, з якого буде відбуватися читання/запис	2019

Інтегрування з хмарними сервісами та застосунками

Storage IBM Cloudant (node-red-node-cf-cloudant)

Вузол	Призначення	Примітка
	Cloudant config для налаштування серверу та бази даних	to do
	Cloudant in дає отримати документи з IBM Cloudant	2019
	Cloudant out дає можливість зберегти в документ IBM Cloudant	2019

Storage IBM COS (node-red-contrib-cos)

Вузол	Призначення	Примітка
	Cos config конфігурування сховища IBM COS	2019
	Cos get отримати об’єкт з IBM COS	2019
	Cos put зберегти об’єкт в IBM COS	2019
	Cos del видалення об’єкту з COS	2019
	Cos qry запит на отримання списку об’єктів COS	2019

IBM Watson IoT Device/Gateway (node-red-contrib-ibm-watson-iot)

Вузол	Призначення	Примітка
	Wiotp credentionals конфігураційний вузол означення повноважень доступу	2019
	Wiotp in вхід команди для IoT	2019
	Wiotp out вихід повідомлення від IoT	2019

IBM IoT APP (node-red-contrib-scx-ibmiotapp)

Вузол	Призначення	Примітка
	Ibmiot config точка доступу до API	2019
	Ibmiot in отримання подій від Watson IoT Platform	2019
	Ibmiot out надсилання команд на Watson IoT Platform	2019

Читання та запис Google Sheet (node-red-contrib-google-sheets)

Вузол	Призначення	Примітка
	Gauth для налаштування доступу до Google sheets	2020
	GSheet	2020

Вузол для роботи з Google API (node-red-contrib-google)

Вузол	Призначення	Примітка
	Google conn вузол конфігурації, створений для підтримки зв’язку з сервісами Google API	To do
	Google забезпечує можливість виклику будь-якого методу будь-якого API, відкритого через офіційний клієнт Node.js Google	To do

Бібліотека для роботи з Telegram-ботом (node-red-contrib-telegrambot)

Вузол	Призначення	Примітка
	Telegram bot вузол конфігурації, який спілкується з сервером Telegram	2020
	Telegram receiver отримує всі повідомлення з чату.	2020
	Telegram command для ініціювання передачі message при отриманні заданої команди	2020
	Telegram event отримує події від бота	2020
	Telegram sender відправляє повідомлення в чат	2020
	Telegram reply чекає відповіді на вказане повідомлення	2020

Інтеграція з Proficloud від Phoenix Contact

Вузол	Призначення	Примітка
	Phoenix Device для роботи з Profi Cloud	2022

Бібліотеки OPC UA

node-red-contrib-opcua

Вузол	Призначення	Примітка
	OPCUA Endpoint налаштовується кінцева точка (Endpoint) до серверу OPC UA	2020
	OPCUA Item означує OPC UA item, тип і значення у зручному вигляді	2020
	OPCUA Client призначений для взаємодії з Server, з’єднаним з вказаною кінцевою точкою	2020
	OPCUA Browser	To Do
	OPCUA Server створює OPC UA server зі своїми змінними, структурами об’єктів і методами	2020
	OPCUA Event означує події OPC UA, які будуть підписані з сервера.	2020

node-red-contrib-iiot-opcua

Вузол	Призначення	Примітка
		2022

Робота з Базами даних

node-red-contrib-sqldbs

бібліотека node-red-contrib-sqldbs з новими версіями Node-RED не працює

node-red-node-mysql

Вузол	Призначення	Примітка
	MySQL Database конфігурування з'єднання з базою даних MySQL	2020
	MySQL Database формування запитів до СКБД MySQL	2020