Программирование контроллера Wiren Board с помощью MasterSCADA 4D
Описание
MasterPLC можно установить на контроллеры Wiren Board 7. Поддержка новых версий контроллера Wiren Board прекращена разработчиком платформы. MasterSCADA 4D — программная платформа для создания АСУТП, MES, решения задач учета и диспетчеризации объектов промышленности, ЖКХ и автоматизации зданий.
В этой статье описывается Runtime-интеграция MasterPLC — такой способ использования позволяет программировать логику с помощью языков МЭК 61131-3 и запускать интерактивные дашборды прямо на контроллере.
Для этого нужно установить на контроллер исполнительную систему MasterPLC, добавить в проект библиотеку для контроллера Wiren Board и настроить связь с MQTT-брокером на контроллере. Ещё есть Стандартная интеграция через MQTT или OPC UA.
Если вы собираетесь использовать встроенный в MasterPLC драйвер Modbus RTU — выключите опрос портов в wb-mqtt-serial.
Установка исполнительной системы на Wiren Board 7
Для установки исполнительной системы MasterPLC на контроллер Wiren Board 7 с релизом ПО wb-2307 и новее подключитесь к контроллеру по SSH и выполните обновление:
apt update && apt upgrade
Затем запустите команду для установки:
apt install mplc4-wirenboard7
Изменение порта MasterPLC с 8043 на 80
Если требуется поменять порт MasterPLC на 80, то сперва надо изменить порт для веб-интерфейса Wiren Board и потом изменить порт для сервера MasterPLC.
Изменение порта для веб-интерфейса Wiren Board 7
В релизах до wb-2507 редактировать файл /mnt/data/etc/nginx/sites-enabled/default и раскомментировать строки, выставить порт на приём 8039.
Начиная с релиза wb-2507 редактировать /etc/nginx/includes/default.wb.d/listen.conf.
listen 8039; ## listen for ipv4; this line is default and implied
listen [::]:8039 default_server ipv6only=on; ## listen for ipv6
Далее команда:
service nginx restart
Изменить порт для веб-интерфейса MasterPLC
Редактируем файл /opt/mplc4/nginx/conf/nginx-mplc.conf.
Находим строку:
server {
listen 8043 default_server;
и меняем 8043 на 80.
Далее в командной строке:
/etc/init.d/mplc4 restart
Создание проекта
Создание первого проекта хорошо показано в видео MasterSCADA 4D. Быстрый старт. Часть 1, наш пример можно взять на Github, а MasterSCADA 4D на официальном сайте.
Отличия от видеоинструкции:
- Прежде чем добавлять контроллер, подключите библиотеку Wiren Board. Это позволит выбрать тип контроллера Wirenboard6 или Wirenboard7.
- После добавления контроллера, справа на панели укажите:
- фактический IP-адрес вашего контроллера, например, 192.168.2.22
- Порт для Web-сервера — 8043, его мы указывали при установке исполнительной системы.
- Далее добавьте в Контроллер → Встроенные модули канал DIO, и заполните поля так:
- Имя — Buzzer
- Topic —
/devices/buzzer/controls/enabled. Адреса топиков можно узнать в стандартном веб-интерфейсе контроллера, раздел MQTT Channels.
Если вы используете Mоdbus TCP сервер в проекте (выполняемый runtime) отключите сервис wb-mqtt-mbgate контроллера, так как по умолчанию он использует тот же 502 порт.
В остальном видеоинструкция актуальна и для работы на контроллерах Wiren Board.
- Добавление библиотеки, контроллера, канала
Добавление библиотеки
Добавление контроллера
Добавление канала
Загрузка проекта в контроллер
Чтобы запустить загрузить программу в контроллер и запустить её, выберите режим Исполнение и нажмите кнопку Подключить выбранный узел (с загрузкой конфигурации).
- Загрузка программы в контроллер
Загрузка проекта в контроллер и пуск
Интерфейс прикладной программы, вывод состояния в среду разработки
Веб-интерфейс прикладной программы
Работа с последовательными портами
Для того чтобы понять какой номер порта использовать при работе с ними непосредственно из runtime можно выполнить следующую команду:
# ls -l /dev/ |grep tty[A-Z]
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyCONSOLE -> ttyS0
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyMOD1 -> ttyS7
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyMOD2 -> ttyS6
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyMOD3 -> ttyS5
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyMOD4 -> ttyS3
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyRS485-1 -> ttyS2
lrwxrwxrwx 1 root root 5 Oct 18 13:02 ttyRS485-2 -> ttyS4
Например, нам нужно обратиться к порту ttyRS485-1, мы видим, что симлинк указывает на порт ttyS2.
В MasterPLC нумерация портов начинается с 1, а в Linux с 0, поэтому нам надо увеличить номер найденного порта ttyS* на 1. Получается, чтобы обратиться из MasterPLC к порту ttyRS485-1, надо использовать порт 2+1=3.
Если вам нужно использовать модули WBE2-I-RS485-ISO или WBE2-I-RS232, то из-за того, что в среде разработке MasterSCADA 4D используется шаблон имен для последовательных портов /dev/ttyRS485-%d нужно:
- Создать файл
/etc/udev/rules.d/99-RS485ISO-uart.rulesс правамиrw-r--r--; - Записать в него:
KERNEL=="ttyS7", SUBSYSTEM=="tty", SYMLINK+="ttyRS485-10", GROUP="dialout" KERNEL=="ttyS6", SUBSYSTEM=="tty", SYMLINK+="ttyRS485-11", GROUP="dialout" KERNEL=="ttyS5", SUBSYSTEM=="tty", SYMLINK+="ttyRS485-12", GROUP="dialout"
- Перезапустить контроллер.
Это действие приведёт к тому, что в мастерскаде будет mod1 на порте 11, mod2 на порте 12, mod3 на порте 13. Далее вы выбираете тот порт в который у вас вставлен модуль. При этом вы не должны их использовать в других приложениях.
Отправка смс через модуль 4G-модема напрямую из MasterPLC
Для работы с модемом из MasterPLC нужно настроить модем в веб-интерфейсе и отключить штатный ModemManager:
- Включить модем в стандартном веб-интерфейсе контроллера.
- Подключиться к контроллеру по SSH.
- Выбрать активную симку, например 1:
mmcli -m wbc --set-primary-sim-slot=1
- Удалить сервис ModemManager из автозапуска
systemctl disable ModemManager
- Остановить ModemManager
systemctl stop ModemManager
- Добавить wb-gsm в автозапуск:
systemctl enable wb-gsm
- Перезапустить wb-gsm:
restart_if_broken; dmesg | tail
Создайте файл:
- Откройте файл в редакторе:
nano /usr/lib/udev/rules.d/99-RS485-to-USB.rules
- Добавьте в него строки:
KERNEL=="ttyUSB1", SUBSYSTEM=="tty", SYMLINK+="ttyRS485-4", GROUP="dialout"
- Перезагрузите контроллер.
- Подключитесь к консоли контроллера по SSH.
- Откройте AT-терминал модема:
minicom -D /dev/ttyUSB1 -b 115200 -8 -a off
- Введите модему команды:
AAAAAAAAAT AT+IPR=115200 ATE0 AT&W
- Выйдите из терминала minicom: нажмите на клавиатуре клавиши CTRL+A, отпустите нажмите клавишу и X, а потом Enter.
Залейте проект и проверьте работу (если у вас MasterPLC на порту 8043 то в демо-проекте сделайте 8043), при запуске в контроллере будет создан файл /temp/sms.txt если туда что-то записать то отправится смс. Скачать пример проекта.
Решение проблем
Если проект не загружается
Иногда после установке, среда разработки не дает загрузить проект т.к. версия среды исполнения проекта и контроллера отличаются.
Если при обновлении среды исполнении вышла ошибка то требуется удалить среду исполнения.
Но перед этим нужно скачать требуемую среду исполнения
https://download.mps-soft.ru/support/Updates/Installation/MasterSCADA_4D/RunTime/wirenboard7/
Логин: ftpGuestSupport
Пароль: 21B74F6E
Если в предыдущей ссылки нет нужной версии (mplc4-wirenboard7-ХХХХХХХХХХХХ-armhf.deb), то переходим
https://download.mps-soft.ru/support/Updates/Installation/MasterSCADA_4D/Archive/
Проходим в нужную версию и выбираем контроллер с нужной релизом
Например
Скачиваем и открываем 7-zip. Проваливаемся до
\mplc4-wirenboard7-1.3.4.18803-armhf.deb\data.tar\.\opt\
Далее выделяем mplc4_installer и извлекаем.
Открываем WinSCP, подключаемся к контроллеру.
Проходим в каталог opt и удаляем mplc4_installer.
Затем копируем наш распакованный файл, вместо удаленного.
Проходим opt/mplc4_installer.
Даем права на запуска install.sh -rwxr-xr-x Далее можно закрыть WinSCP.
Подключимся через консоль вводим команду:
/etc/init.d/mplc4 stop
Далее переходим cd opt/mplc4/
Запускаем скрип удаления среды:
./uninstall.sh
После удачного удаления переходимым в консоли cd opt/mplc4_installer
Запускаем команду установки
./install.sh
Если все прошло нормально то будет предложено ознакомиться с хелпом :
Help for MasterPLC:
Вводим в консоль :
/etc/init.d/mplc4 start
Если среда стартовала то вы увидите такое сообщение:
Starting MasterPLC... OK
Далее пробуете загружать свой проект.
Если если желание перед установкой изменить порт среды исполнения то открываем opt/mplc4_installer/cfg и меняем
NGINX_HTTP_POTR=8043
на нужные циферки.
Полезные ссылки
- Сайт MasterSCADA
- Пример проекта
- Создание базовой настройки для множественного копирования проекта на Wiren Board 7 для среды разработки MasterSCADA 4D
| Адаптеры протоколов | HDL KNX-DALI Gateway M/DALI.1 |
| Датчики климата | RLDA NL-3DPAS-M • RLDA NL-1S111 • Рэлсиб ДВТ-05 • XY-MD03/XY-MD04 |
| Диммеры | РД DDL84R-V |
| Источники питания и ИБП | ИБП Импульс Мультиплекс |
| Конвекторы | Varmann QTherm |
| Рекуператоры / вентиляция | Рекуператор VAKIO Base Smart • ПВУ Royal Clima Soffio Primo RCS-350-P • Royal Clima VENTO • Systemair Corrigo |
| Метеостанции | Netatmo Urban Weather Station |
| Коллекторы датчиков | R4DCB08 |
| Контроллеры вентиляции и климата | Mautomatics JL204C5 (Breezart 550 Lux) • GTC (General Thermo Controllers) Syberia 5.0 • SystemAir VR 300 |
| Модули реле | R4D3C32 |
| Счётчики воды | Элехант СВД-15 • Элехант СВД-20 |
| Счётчики электроэнергии | Меркурий 204 • Меркурий 208 • Меркурий 238 • ABB SCU100 |
| Счетчики тепла | ВИС.Т2-ТС |
| Термостаты | Hessway |
| Увлажнители | CAREL Humisonic • Xiaomi Humidifier |
| Прочее | DIY • Shelly UNI |