Fast Modbus
Нативная интеграция
1. Общее описание
Скопировано
Wiren Board - это Российский производитель оборудование автоматики. Чаще всего шлюзы ONOKOM подключаются через контроллер Wiren Board для дальнейшего управления через умный дом или системы диспетчеризации.
В новых версиях шлюзов ONOKOM поддерживается технология Fast Modbus от Wiren Board
Преимущества технологии Fast Modbus
1. Увеличивается скорость общения устройств на шине. Например, у нас на шине 5 шлюзов для кондиционеров
2. При обычном ModBus опросе обратную связь от шлюза получим в течение 5 секунд
3. С Fast Modbus ответ будет в течении 50 мс
4. По итогу мы получаем практически мгновенный отклик от кондиционера. Важный момент: сам кондиционер, если ему отправить команду с пульта, может давать обратную связь до 1 секунды
Что дает поддержка шлюзами ONOKOM технологии Fast Modbus
1. Шлюзы для кондиционеров с Fast Modbus можно добавить в линию к другим быстро опрашиваемым устройствам без потери скорости
2. Обычно это необходимо, когда есть уже готовая и проложенная шина, например, с датчиками. И надо подключить в эту шину устройства так, чтобы скорость опроса не снижалась
3. Важный момент. Все устройства на шине и контроллер должны поддерживать технологию Fast Modbus
4. Также это позволяет упростить проектирование. Потому что конечные устройства можно будет не разделять на разные линии
Стандартный ModBus
Обратная связь от устройства
- 5 секунд для 5 устройств
- 10 секунд для 10 устройств
Fast ModBus
Обратная связь от устройства
- 50 миллисекунд для 5 устройств
- 50 миллисекунд для 10 устройств
2. Список поддерживаемых шлюзов
Скопировано
Ниже представлен список шлюзов, поддерживаемых контроллером Wiren Board
| Бренд | Серия | Шлюз | Поддержка | Примечание |
| GREE | HOME |
GR-1-MB-B |
Нативная |
с версии wb-2301
|
| GREE | HOME |
GR-1-ZB-S |
Шаблон |
Скачать шаблон |
| TION | HOME |
TN-1-MB-B |
Шаблон |
Скачать шаблон |
| CHIGO | VRF |
CG-VRF-MB-B |
Нативная |
с версии wb-2505
|
| HISENSE | VRF |
HS-VRF-MB-B |
Нативная |
с версии wb-2505
|
| MDV | VRF |
MD-VRF-MB-B |
Нативная |
с версии wb-2505
|
| AUX | PRO |
AUX-1-MB-B |
Нативная |
с версии wb-2307
|
| AUX | PRO |
AUX-1-ZB-S |
Шаблон |
Скачать шаблон |
| DAIKIN | PRO |
DK-1-MB-B |
Нативная |
с версии wb-2307
|
| DAIKIN | PRO |
DK-1-ZB-S |
Шаблон |
Скачать шаблон |
| DAIKIN | PRO |
DK-5-MB-B |
Нативная |
с версии wb-2501
|
| GREE | PRO |
GR-3-MB-B |
Нативная |
с версии wb-2501
|
| GREE | PRO |
GR-3-ZB-S |
Шаблон |
Скачать шаблон |
| HAIER | PRO |
HR-1-MB-B |
Нативная |
с версии wb-2310
|
| HAIER | PRO |
HR-1-ZB-S |
Шаблон |
Скачать шаблон |
| HISENSE | PRO |
HS-3-MB-B |
Нативная |
с версии wb-2501
|
| HISENSE | PRO |
HS-3-ZB-S |
Шаблон |
Скачать шаблон |
| HISENSE | PRO |
HS-5-MB-B |
Нативная |
с версии wb-2501
|
| HISENSE | PRO |
HS-6-MB-B |
Нативная |
с версии wb-2501
|
| HITACHI | PRO |
HT-1-MB-B |
Нативная |
с версии wb-2501
|
| HITACHI | PRO |
HT-1-ZB-S |
Шаблон |
Скачать шаблон |
| MDV | PRO |
MD-1-MB-B |
Нативная |
с версии wb-2501
|
| MDV | PRO |
MD-3-MB-B |
Нативная |
с версии wb-2501
|
| MDV | PRO |
MD-3-ZB-S |
Шаблон |
Скачать шаблон |
|
MITSUBISHI ELECTRIC
|
PRO |
ME-1-MB-B |
Нативная |
с версии wb-2307
|
|
MITSUBISHI ELECTRIC
|
PRO |
ME-1-ZB-S |
Шаблон |
Скачать шаблон |
|
MITSUBISHI HEAVY
|
PRO |
MH-2-MB-B |
Нативная |
с версии wb-2501
|
|
MITSUBISHI HEAVY
|
PRO |
MH-8-MB-B |
Нативная |
с версии wb-2501
|
|
TOSHIBA
|
PRO |
TB-1-MB-B |
Шаблон |
Скачать шаблон |
| TCL | PRO |
TCL-1-MB-B |
Нативная |
с версии wb-2501
|
| TCL | PRO |
TCL-1-ZB-S |
Шаблон |
Скачать шаблон |
| TCL | PRO |
TCL-3-MB-B |
Нативная |
с версии wb-2501
|
| TCL | PRO |
TCL-3-ZB-S |
Шаблон |
Скачать шаблон |
| TCL | PRO |
TCL-6-MB-B |
Нативная |
с версии wb-2501
|
3. Схема подключения
Скопировано
Стандартная схема подключения шлюзов ONOKOM серий HOME, PRO и VRF к контроллеру Wiren Board
Схемы подключения с указанием конкретных разъемов кондиционеров можно посмотреть на страницах шлюзов
На схеме изображены следующие устройства:
- Контроллер Wiren Board 8 (1 шт.)
- Шлюз ONOKOM MD-3-MB-B (1 шт.)
- Блок питания 24В MeanWell HDR-30-24 (1 шт.)
4. Карты регистров и кластеров
СкопированоКарта регистров и карта кластеров описывают функциональность шлюза
|
GR-1-MB-B.xlsx |
HOME |
GREE |
|
GR-1-ZB-S.pdf |
HOME |
GREE |
|
TN-1-MB-B.xlsx |
HOME |
TION |
|
CG-VRF-MB-B.xlsx |
VRF |
CHIGO |
|
HS-VRF-MB-B.xlsx |
VRF |
HISENSE |
|
MD-VRF-MB-B.xlsx |
VRF |
MDV |
|
AUX-1-MB-B.xlsx |
PRO |
AUX |
|
AUX-1-ZB-S.pdf |
PRO |
AUX |
|
DK-1-MB-B.xlsx |
PRO |
DAIKIN |
|
DK-1-ZB-S.pdf |
PRO |
DAIKIN |
|
DK-5-MB-B.xlsx |
PRO |
DAIKIN |
|
GR-3-MB-B.xlsx |
PRO |
GREE |
|
GR-3-ZB-S.pdf |
PRO |
GREE |
|
HR-1-MB-B.xlsx |
PRO |
HAIER |
|
HR-1-ZB-S.pdf |
PRO |
HAIER |
|
HS-3-MB-B.xlsx |
PRO |
HISENSE |
|
HS-3-ZB-S.pdf |
PRO |
HISENSE |
|
HS-5-MB-B.xlsx |
PRO |
HISENSE |
|
HS-6-MB-B.xlsx |
PRO |
HISENSE |
|
HT-1-MB-B.xlsx |
PRO |
HITACHI |
|
HT-1-ZB-S.pdf |
PRO |
HITACHI |
|
MD-1-MB-B.xlsx |
PRO |
MDV |
|
MD-3-MB-B.xlsx |
PRO |
MDV |
|
MD-3-ZB-S.pdf |
PRO |
MDV |
|
ME-1-MB-B.xlsx |
PRO |
MITSUBISHI ELECTRIC |
|
ME-1-ZB-S.pdf |
PRO |
MITSUBISHI ELECTRIC |
|
MH-2-MB-B.xlsx |
PRO |
MITSUBISHI HEAVY |
|
MH-8-MB-B.xlsx |
PRO |
MITSUBISHI HEAVY |
|
TB-1-MB-B.xlsx |
PRO |
TOSHIBA |
|
TCL-1-MB-B.xlsx |
PRO |
TCL |
|
TCL-1-ZB-S.pdf |
PRO |
TCL |
|
TCL-3-MB-B.xlsx |
PRO |
TCL |
|
TCL-3-ZB-S.pdf |
PRO |
TCL |
|
TCL-6-MB-B.xlsx |
PRO |
TCL |
5. Шаблоны
СкопированоЕсли вы используете версию ПО на контроллере Wiren Board, в которой отсутствует нативная поддержка шлюзов ONOKOM, то вы можете скачать необходимый шаблон и установить его по этой инструкции
|
GR-1-MB-B.json |
HOME |
GREE |
|
GR-1-ZB-S.mjs |
HOME |
GREE |
|
TN-1-MB-B.json |
HOME |
TION |
|
CG-VRF-MB-B.json |
VRF |
CHIGO |
|
HS-VRF-MB-B.json |
VRF |
HISENSE |
|
MD-VRF-MB-B.json |
VRF |
MDV |
|
AUX-1-MB-B.json |
PRO |
AUX |
|
AUX-1-ZB-S.mjs |
PRO |
AUX |
|
DK-1-MB-B.json |
PRO |
DAIKIN |
|
DK-1-ZB-S.mjs |
PRO |
DAIKIN |
|
DK-5-MB-B.json |
PRO |
DAIKIN |
|
GR-3-MB-B.json |
PRO |
GREE |
|
GR-3-ZB-S.mjs |
PRO |
GREE |
|
HR-1-MB-B.json |
PRO |
HAIER |
|
HR-1-ZB-S.mjs |
PRO |
HAIER |
|
HS-3-MB-B.json |
PRO |
HISENSE |
|
HS-3-ZB-S.mjs |
PRO |
HISENSE |
|
HS-5-MB-B.json |
PRO |
HISENSE |
|
HS-6-MB-B.json |
PRO |
HISENSE |
|
HT-1-MB-B.json |
PRO |
HITACHI |
|
HT-1-ZB-S.mjs |
PRO |
HITACHI |
|
MD-1-MB-B.json |
PRO |
MDV |
|
MD-3-MB-B.json |
PRO |
MDV |
|
MD-3-ZB-S.mjs |
PRO |
MDV |
|
ME-1-MB-B.json |
PRO |
MITSUBISHI ELECTRIC |
|
ME-1-ZB-S.mjs |
PRO |
MITSUBISHI ELECTRIC |
|
MH-2-MB-B.json |
PRO |
MITSUBISHI HEAVY |
|
MH-8-MB-B.json |
PRO |
MITSUBISHI HEAVY |
|
TB-1-MB-B.json |
PRO |
TOSHIBA |
|
TCL-1-MB-B.json |
PRO |
TCL |
|
TCL-1-ZB-S.mjs |
PRO |
TCL |
|
TCL-3-MB-B.json |
PRO |
TCL |
|
TCL-3-ZB-S.mjs |
PRO |
TCL |
|
TCL-6-MB-B.json |
PRO |
TCL |
6. Подключение Modbus шлюзов
СкопированоВидеоинструкция по добавлению шлюза в контроллер Wiren Board составлена на примере бризера TION 4S. Любые другие шлюзы ONOKOM добавляются аналогично
6.1 Загрузка шаблона
СкопированоВсе дальнейшие настройки выполняются на контроллере Wiren Board 7 со следующими параметрами:
- Ревизия: 7.3.3E/11 675
- Версия ПО: wb-2404
- Ветка: Релиз
Для начала нам потребуется обновить контроллер до последней версии прошивки
Открываем приложение «Терминал»
1. Вводим протокол, имя пользователя и IP адрес контроллера в локальной сети. В нашем случае: ssh root@192.168.199.79
2. Вводим пароль. По умолчанию это wirenboard
3. Нажимаем кнопку «Enter»
Затем проверяем, есть ли обновление в репозиториях. Для этого вводим команду «apt update»
Контроллер обновлен. Переходим к следующему шагу
Следующим шагом переходим в браузер и вводим IP адрес контроллера в локальной сети. В нашем случае: «192.168.199.79»
Далее заходим в «Настройки → Права доступа → Администратор»
Ставим галочку в пункте
«Я принимаю всю ответственность за свои действия»
Нажимаем «Применить»
Теперь мы можем управлять всеми функциями контроллера
После чего мы переходим во вкладку «Конфигурационные файлы» и выбираем пункт «Настройка драйвера serial-устройств»
Ждем загрузки конфигуратора, после чего выбираем порт к которому подключен шлюз
В нашем случае это «/dev/ttyRS485-1»
Нажимаем пункт "+Устройство"
Жмем на пункт с выбором устройств и ищем в списке пункт «Кондиционеры». А в нем наш шлюз.
На данном этапе наш шлюз отсутствует, поэтому мы будем добавлять для него шаблон самостоятельно
Подключаемся к контроллеру через приложение «ForkLift» , в нашем случае она для macOS, для Windows можете использовать «WinSCP»
1. Protocol: SFTP
2. Server: 192.168.199.79
3. Username: root
4. Password: по умолчанию wirenboard
6. Нажимаем Connect
Следующим шагом переходим на веб-сервис GitHub где хранятся шаблоны ONOKOM и переходим в раздел «WirenBoard»
Выбираем шаблон WB-ONOKOM-AIR-TN-1-MB-B.json
Затем нажимаем на три точки в правом верхнем углу и нажимаем «Download»
Переходим в приложение «ForkLift»
Сейчас мы находимся в директории 192.168.199.79/mnt/data/root
Нам нужно попасть на одну директорию назад
Переходим и попадаем в 192.168.199.79/mnt/data
Переходим в директорию etc
Переходим в директорию wb-mqtt-serial.conf.d
Переходим в директорию templates
Добавляем шаблон WB-ONOKOM-AIR-TN-1-MB-B, просто перетащив его в нужное окно
Шаблон WB-ONOKOM-AIR-TN-1-MB-B загружен
6.2 Добавление устройства
Скопировано
Заходим в веб-интерфейс Wiren Board и нажимаем на «Настройки». В открывшемся списке выбираем «Конфигурационные файлы». Далее выбираем «Настройка драйвера serial-устройств»
Выбираем порт к которому подключен шлюз TION. В нашем примере он подключен в первый порт (RS485-1). Затем нажимаем «Добавить устройство»
Смотрим, что выбран первый порт, в который подключен шлюз (RS485-1) и нажимаем на выпадающий список
Далее в разделе «Кондиционеры» из списка выбираем шаблон ONOKOM-AIR-TN-1-MB-B (Адаптер для бризера TION 4S)
Нажимаем «Добавить устройство»
Вводим адрес устройства в нашем случае «1». Далее выбираем параметры, которые будут отображаться в плитке устройства. После того как выбраны все необходимые параметры, нажимаем «Сохранить настройки»
Далее переходим на вкладку «Устройства» и видим плитку управления бризером TION
6.3 Смена Modbus адреса шлюза
СкопированоПо умолчанию все шлюзы ONOKOM имеют адрес «1». Существует несколько способов смены адреса шлюза через Wiren Board
6.3.1 Смена адреса через modbus_client
Скопировано
Для изменения Modbus адреса шлюза необходимо записать новый адрес в holding-регистр 128. Перед этим останавливаем драйвер «wb-mqtt-serial»:
systemctl stop wb-mqtt-serial
Следующей командой меняем Modbus адрес шлюза на «12»:
modbus_client --debug -mrtu -b9600 -pnone -s2 /dev/ttyRS485-1 -a1 -t0x06 -r128 12
Разберем используемые параметры:
--debug — вывод отправляемых и принимаемых данных;
-mrtu — определяем тип используемого протокола, в нашем случае Modbus RTU. Должен указываться первым в командной строке или вторым если первый аргумент --debug или имя файла порта RS-485;
-b9600 — скорость передачи данных по линии, по умолчанию значение 9600;
-pnone — параметр контроля четности;
-s2 — количество стоповых битов, 1 или 2;
/dev/ttyRS485-1 — адрес serial-порта, к которому подключено опрашиваемое устройство;
-a1 — адрес устройства;
-t0x06 — адрес функции записи holding-регистра;
-r128 — адрес регистра, значение которого мы запрашиваем;
12 — новое значение, которое записываем в регистр
Эта команда означает, что при остановленном драйвере «wb-mqtt-serial» устройству с адресом «1» подключенному к порту «RS485-1» устанавливается адрес «12». Не забываем включить «wb-mqtt-serial»:
systemctl start wb-mqtt-serial
Также нужно изменить адрес на странице Wiren Board:
Переходим на страницу устройства, в строке «Адрес устройства» меняем на «12», сохраняем настройки
6.3.2 Смена адреса по серийному номеру
Скопировано
Если к одному порту подключено несколько устройств, может быть удобна смена адреса по серийному номеру устройства.
С остановленным драйвером «wb-mqtt-serial» через утилиту «wb-modbus-scanner» узнаем, какие устройства подключены к порту «RS485-1» считываем их серийные номера. В примере серийный номер устройства — 229330:
wb-modbus-scanner -d /dev/ttyRS485-1 -b 9600
Далее меняем устройству с серийным номером 229330 Modbus адрес на «12»:
wb-modbus-scanner -d /dev/ttyRS485-1 -b 9600 -s 229330 -i 12
Не забываем включить драйвер «wb-mqtt-serial».
Разберем используемые параметры:
d /dev/ttyRS485-1 — порт, к которому подключено устройство;
-b 9600 — скорость передачи данных по линии, по умолчанию значение 9600;
-s 229330 — серийный номер устройства;
-i 12 — задание нового адреса устройству
6.4 Смена скорости работы шлюза
СкопированоПо умолчанию все шлюзы ONOKOM работают на скорости 9600. Изменить скорость работы можно двумя способами:
6.4.1 Смена скорости через Wiren Board
Скопировано
Переходим в «Настройки» — «Конфигурационные файлы» — «Настройки драйвера Serial-устройств»
Переходим в данные модуля, в строке «Скорость обмена» выставляем скорость 115200, сохраняем настройки
Теперь нужно убедиться, что настройки применились, для этого переходим во вкладку «Устройства» и проверяем, что связь с устройством потеряна, значения должны окрашиваться в красный
Далее нужно выставить скорость работы 115200 на самой шине. Возвращаемся в «Настройки» — «Конфигурационные файлы» — «Настройки драйвера Serial-устройств». Переходим во вкладку RS485-1, в выпадающем меню «Скорость обмена» выставим новую скорость. Не забываем сохранить настройки
6.4.2 Смена скорости через Терминал
Скопировано
Также изменить скорость устройства можно через Терминал, перед этим остановив драйвер wb-mqtt-serial:
systemctl stop wb-mqtt-serial
modbus_client --debug -mrtu -b9600 -pnone -s2 /dev/ttyRS485-1 -a12 -t0x06 -r110 1152
Разберем используемые параметры:
--debug — вывод отправляемых и принимаемых данных;
-mrtu — определяем тип используемого протокола, в нашем случае Modbus RTU. Должен указываться первым в командной строке или вторым если первый аргумент --debug или имя файла порта RS-485;
-b9600 — скорость передачи данных по линии, по умолчанию значение 9600;
-pnone — параметр контроля четности;
-s2 — количество стоповых битов, 1 или 2;
/dev/ttyRS485-1 — адрес serial-порта, к которому подключено опрашиваемое устройство;
-a12 — адрес устройства;
-t0x06 — адрес функции записи holding-регистра;
-r110 — адрес регистра, значение которого мы запрашиваем;
1152 — новое значение, которое записываем в регистр
Эта команда означает, что при остановленном драйвере wb-mqtt-serial устройству с адресом 12, подключенному к порту RS485-1, устанавливается скорость 115200.
Также выставляем скорость 115200 на шине RS485-1, как это делали в пункте 6.4.1
7. Подключение Zigbee шлюзов
Скопировано7.1 Параметры контроллера Wiren Board
Все дальнейшие настройки выполняются на контроллере Wiren Board 7 со следующими параметрами:
- Ревизия: 7.3.3E/11 675
- Версия ПО: wb-2507
- Ветка: Релиз
- ZigBee2MQTT : 2.5.1
7.2 Загрузка шаблона в контроллер Wiren Board для Zigbee2MQTT
- Скачайте приложение для подключения по SFTP к контроллеру
- Для пользователей macOS: Скачайте приложение: ForkLift
- Для пользователей Windows: Скачайте приложение: FileZilla
- Узнайте IP адрес контроллера где установлен Zigbee2MQTT в вашей локальной сети
- Подключитесь к контроллеру по SFTP
На момент написания статьи шаблон не включен в стандартный список поддерживаемых устройств. Поэтому
добавляем собственный шаблон:
Заходим на веб-сервис GitHub, где хранятся шаблоны ONOKOM и переходим в раздел «ZigBee2MQTT»
Выбираем на каком языке мы хотим чтобы отображался шаблон "RU" или "EN"
Выбираем шаблон «onokom-dk-1-zb-s.mjs»
Затем нажимаем на кнопку «Download» правом верхнем углу окна
Открываем SFTP-менеджер и вводим данные для соединения к контроллеру:
1. Хост: IP-адрес устройства
2. Имя пользователя: root
3. Пароль: wirenboard (по умолчанию)
4. Порт: 22
5. Нажимаем кнопку «Connect»
Переходим в соответствующую директорию: /mnt/data/root/zigbee2mqtt/data/
Открываем файл configuration.yaml для редактирования удобным
редактором
В файле требуется добавить следующую конструкцию:
external_converters:
- external_converters/onokom-dk-1-zb-s.mjs
Обязательно код должен выглядеть как на картинке
Теперь требуется загрузить ранее скаченный файл
/mnt/data/root/zigbee2mqtt/data/external_converters/onokom-dk-1-zb-s.mjs, после
этого требуется перезагрузить сервер «ZigBee2MQTT»
После перезагрузки сервера переходим к подключению шлюза к контроллеру
7.3 Подключение шлюза к Wiren Board через Zigbee2MQTT
Заходим в веб-интерфейс Wiren Board
Для входа вводим IP-адрес контроллера в локальной сети
В случае если права доступа не установлены на «Администратор» нужно их поменять в соответствующем разделе интерфейса. Переходим в раздел «Настройки» — «Права доступа». Выставляем права доступа на «Администратор» и применяем настройки
В разделе «Устройства» находим устройство «Zigbee2mqtt конвертер»
Включаем переключатель «Разрешить сопряжение» в положение включено
На шлюзе зажать кнопку "Привязка" и держать ее 7 секунд
После завершения поиска устройство будет добавлено в интерфейс Wiren Board и мы сможем наблюдать изменение состояния
7.4 Установка конвертера для управления шлюзами ONOKOM из интерфейса Wiren Board
Скопировано
Для установки потребуется подключиться к контроллеру по SSH.
Для пользователей Windows можно воспользоваться «Командной стройкой» или
«PowerShell».
Для пользователей Linux и Mac OS можно воспользоваться встроенной утилитой
«Терминал».
Открываем программу и вводим следующую команду
ssh имя_пользователя@ip_адрес_контроллера
и нажимаем «Enter»
Нас попросят ввести пароль. При вводе пароля не будет видно, что вы что-то вводите, поэтому введите его и нажмите «Enter».
Если пароль был введен верно, то вы увидите приглашение на управление вашим контроллером
Для нашего конвертера подготовлен скрипт установщика, который сделает все за вас и запустит конвертер.
Вводим следующую команду в терминал:
wget -qO - https://ONOKOM.ru/software/converters/install | bash
и нажимаем «Enter»
После этого начнется установка
После удачной установки вы увидите, что ONOKOM converters установлен и запущен
Переходим в браузер и вводим адрес нашего контроллера в сети, открывается интерфейс Wiren board
Переходим в раздел «Устройства» и в интерфейсе находим устройство
«DK-1-ZB-S»
Теперь мы можем управлять шлюзом из интерфейса «Wiren board»
8. Проблемы и решения
СкопированоВ данном пункте будут описаны проблемы и решения, связанные с подключением шлюза к контроллеру Wiren Board
9. Примеры из практики
Скопировано
10. Фигуры для скачивания
СкопированоВы можете скачать фигуры для вставки в свои проекты в необходимом формате
Растровый формат
.png
.jpg
Векторный формат
.svg
11. Функции шлюзов
СкопированоОписываем функции шлюзов, доступные на контроллере Wiren Board
Скопировано
Сайт создан - тех. отделом ONOKOM