BHT-6000 Series: различия между версиями

Материал из Wiren Board
м (→‎Шаблон устройства: Добавил текст шаблона)
 
(не показаны 42 промежуточные версии 3 участников)
Строка 1: Строка 1:
{{DISPLAYTITLE: Термостат BHT-6000 Series}}
{{DISPLAYTITLE: Термостат BHT-6000 Series}}
[[Image: BHT-6000 Series.png|300px|thumb|right| Термостат BHT-6000 Series, белый]]
[[Image: BHT-6000 Series.png|300px|thumb|right| Термостат BHT-6000 Series, белый]]
== Работа по Modbus ==
Термостатом можно управлять по протоколу [[Протокол_Modbus|Modbus RTU]]. На физическом уровне он подключается через интерфейс [[RS-485]].


Настраивать термостат можно с помощью утилиты [[Modbus-client|modbus_client]], использовать [[Working with WB devices without a controller|приложение для компьютера на ОС Windows]] или из веб-интерфейса контроллера Wiren Board.
== Подключение к контроллеру ==
Подключите устройство к шине [[RS-485]] с соблюдением распиновки.


В этой статье мы будем использовать утилиту <code>modbus_client</code>, а подключаться к контроллеру через [[SSH]]. Синтаксис и параметры командной строки можно посмотреть на странице утилиты в разделе [[Modbus-client#Аргументы командной строки|Аргументы командной строки]].
{| class="wikitable noclear"
|+Распиновка разъёма
!Номер клеммы !!Описание
|-
|AC24V_L
| +24 В
|-
|AC24V_N
|GND
|-
|Red
|A
|-
|White
|B
|}
== Представление в веб-интерфейсе ==
=== Выбор шаблона ===
{{SupportedSinceRelease
| release= wb-2110
| deb= wb-mqtt-serial
| version= 2.28.1
}}{{WebUIAddDevice
| template=BHT-6000 Series
}}


== Подготовка к работе ==
<gallery mode="traditional" widths ="340px" heights="200px">
{{Wbincludes:Modbus: Preparing for work}}
Image: Devices View BHT-6000 Series.png| Представление BHT-6000 Series в веб-интерфейсе контроллера Wiren Board
Image: BHT-6000 Series, Connecting to the web interface.png| Выбор шаблона и установка параметров подключения в WebUI 2.0
</gallery>


== Настройка для работы с ПО ==
{{Wbincludes:Modbus Aliens}}
[[Image: Devices View BHT-6000 Series.png |300px|thumb|right| Представление BHT-6000 Series в веб-интерфейсе]]


=== Установка параметров подключения ===
=== Параметры порта ===
Вы можете перед началом работы с термостатом назначить ему modbus-адрес, но параметры подключения изменить нельзя.
По умолчанию устройство имеет настройки:
* Baud rate — 9600 бит/с,  
* Parity — None,
* Data bits — 8,
* Stop bits — 1.


По умолчанию в термостате заданы параметры: Адрес — 1, Скорость — 9600 бит/с, Четность — Even, Бит — 1.
Производитель не предоставил возможности их изменять.


Так как у всех устройств Wiren Board параметры интерфейса по умолчанию: Скорость 9600 бит/с, Четность — None, Бит — 2, то мы не сможем использовать термостат на одной линии с ними без перенастройки устройств Wiren Board.
=== Modbus-адрес ===
По умолчанию в термостате задан modbus-адрес 1,  


Изменить modbus-адрес можно из сервисного меню. Настройка делается нажатием кнопок на корпусе термостата:
# Выключите термостат нажатием на кнопку <code>ON/OFF</code>.
# Зажмите одновременно кнопки <code>M</code> и <code>Clock</code> на 5 секунд — термостат войдет в сервисный режим.
# Кратким нажатием на кнопку <code>M</code> выберите параметр <code>C</code>.
# Кнопками <code>вверх ↑</code> и <code>вниз ↓</code> установите новый адрес термостата.
# После установки адреса подождите 5 секунд, термостат применит новые настройки и выйдет из сервисного режима.
# Включите термостат нажатием на кнопку <code>ON/OFF</code>.


=== Шаблон устройства ===
Теперь вы можете подключиться к термостату по-новому modbus-адресу.
'''ВНИМАНИЕ:''' шаблон для термостата BHT-6000 Series включен в поставку драйвера [[Драйвер wb-mqtt-serial|wb-mqtt-serial]], начиная с версии 2.7.0. Также текст шаблона доступен ниже в этом разделе.


Выберите шаблон термостата в разделе «Serial Device Driver Configuration» веб-интерфейса:
=== Карта регистров ===
# Откройте веб-интерфейс и перейдите '''Configs''' → '''Serial Device Driver Configuration'''.
Таблица регистров термостата BHT-6000GALN. Значения температуры при чтении нужно умножить на <code>0.1</code>, а при записи разделить.
# Выберите один из двух интерфейсов связи и установите параметры интерфейса: Baud rate — 9600 бит/с, Parity — N, Data bits — 8, Stop bits — 1.
# Нажмите на кнопку '''+ Device''' и в поле '''Device N''' выберите '''BHT-6000 Series''', где N — порядковый номер устройства.
# В поле '''Slave id''' укажите modbus-адрес термостата.
# Сохраните настройки нажатием на кнопку '''Save'''.


Теперь устройство будет доступно на вкладке '''Devices'''.
{|class="wikitable sortable" style="text-align:center;"
! Регистр/ адрес
! '''Тип'''
! Чтение/ запись
! '''Формат'''
! Назначение
|-
| 0
| holding
| RW
| 0 ­- 1
| style="text-align:left;" | Power<br>0 — OFF, 1 — ON
|-
| 1
| holding
| R
| u16
| style="text-align:left;" | Temperature from internal sensor
|-
| 2
| holding
| RW
| 0 ­- 1
| style="text-align:left;" | Manual mode<br>0 — Auto, 1 — Manual
|-
| 3
| holding
| R
| 0 ­- 1
| style="text-align:left;" | Heating status<br>0 — Not heating, 1 — Heating
|-
| 4
| holding
| RW
| u16
| style="text-align:left;" | Setting temperature
|-
| 5
| holding
| RW
| u16
| style="text-align:left;" | Weekly program setting temperature
|-
| 6
| holding
| RW
| 0 ­- 1
| style="text-align:left;" | Lock buttons<br>0 — Unlock, 1 — Lock
|}


Вы можете изменить шаблон по своему усмотрению — смотрите описание шаблонов в статье [[Драйвер wb-mqtt-serial:Примеры написания шаблонов | Драйвер wb-mqtt-serial]].
== Полезные ссылки ==
[https://www.manualslib.com/manual/1420786/Welquic-Bht-6000-Series.html Описание термостата и руководство по настройке]


Текст шаблона '''config-bht-6000-series.json''':
{{Wbincludes:Device Page Footer}}
<syntaxhighlight lang="json">
{
"device_type": "BHT-6000 Series",
"device": {
  "name": "BHT-6000 Series",
  "id": "bht-6000-series",
  "channels": [
  {
    "name": "Power",
    "reg_type": "holding",
    "address": "0x00",
    "type": "switch",
    "format": "s16"
  },
  {
    "name": "Lock buttons",
    "reg_type": "holding",
    "address": "0x06",
    "type": "wo-switch",
    "format": "s16"
  },
  {
    "name": "Temperature for internal sensor",
    "reg_type": "holding",
    "address": "0x01",
    "type": "temperature",
    "format": "s16",
    "scale": 0.1
  },
  {
    "name": "Weekly program setting temperature",
    "reg_type": "holding",
    "address": "0x05",
    "type": "temperature",
    "format": "s16",
    "scale": 0.1
  },
  {
    "name": "Heating status",
    "reg_type": "holding",
    "address": "0x03",
    "type": "switch",
    "format": "s16",
    "readonly": true
  },
  {
    "name": "Manual mode",
    "reg_type": "holding",
    "address": "0x02",
    "type": "switch",
    "format": "s16"
  },
  {
    "name": "Setting temperature",
    "reg_type": "holding",
    "address": "0x04",
    "type": "range",
    "format": "s16",
    "scale": 0.1,
    "max": 35
  }
  ]
}
}
</syntaxhighlight>
 
== Изменение настроек термостата ==
Все настройки термостала выведены в веб-интерфейс, но вы можете изменять их и из командной строки. Для этого нужно записать требуемые значения в [[#Таблица modbus-регистров | регистры термостата]].
 
В примерах термостат у подключен к интерфейсу <code>/dev/ttyRS485-1</code>, имеет настройки интерфейса <code>9600/None/1/8</code> и доступен по адресу <code>2</code>.
 
=== Общий алгоритм настройки ===
# Ищете адрес регистра и функцию записи.
# Смотрите возможные значения.
# Записываете в регистр значение, которое попадает в диапазон возможных.
 
=== Блокировка кнопок ===
 
Мы хотим заблокировать все физические кнопки на термостате:
# Состояние блокировки хранится в регистре '''Lock buttons''' с адресом <code>0x06</code>. Функция записи — <code>0x06</code>.
# Возможные значения: 0 — Unlock, 1 — Lock.
# Теперь запишите значение '''1''' в регистр '''Lock buttons''':
#:<syntaxhighlight lang="bash">
~#  modbus_client --debug -mrtu -pnone -s1 /dev/ttyRS485-1 -a2 -t0x06 -r0x06 1
Data to write: 0x1
Opening /dev/ttyRS485-1 at 9600 bauds (N, 8, 1)
[02][06][00][06][00][01][A8][38]
Waiting for a confirmation...
<02><06><00><06><00><01><A8><38>
SUCCESS: written 1 elements!
</syntaxhighlight>
 
Кнопки термостата заблокированы. Для разблокировки запишите в регистр '''Lock buttons''' значение 0 — Unlock.
 
===Чтение и запись значений температуры===
Значение температуры нужно конвертировать перед записью или после чтения.
 
Прочитаем значение текущей уставки из регистра '''Setting temperature''', 0x04 — получим:
<syntaxhighlight lang="bash">
~#  modbus_client --debug -mrtu -pnone -s1 /dev/ttyRS485-1 -a2 -t0x03 -r0x04
Opening /dev/ttyRS485-1 at 9600 bauds (N, 8, 1)
[02][03][00][04][00][01][C5][F8]
Waiting for a confirmation...
<02><03><02><01><2C><FC><09>
SUCCESS: read 1 of elements:
        Data: 0x012c
</syntaxhighlight>
 
В документации к термостату указан '''коэффициент конвертации — 0.1'''. Это значит, что при чтении мы должны умножить полученное значение на коэффициент, а при записи разделить.
 
Нами было считано значение <code>0x012с</code> — это число 300, умножим его на коэффициент: <code>300 × 0.1 = 30 °С</code>
 
Теперь запишем в регистр значение 12°C: <code>12 / 0.1 = 120</code>:
<syntaxhighlight lang="bash">
~#  modbus_client --debug -mrtu -pnone -s1 /dev/ttyRS485-1 -a2 -t0x06 -r0x04 120
Data to write: 0x78
Opening /dev/ttyRS485-1 at 9600 bauds (N, 8, 1)
[02][06][00][04][00][78][C8][1A]
Waiting for a confirmation...
<02><06><00><04><00><78><C8><1A>
SUCCESS: written 1 elements!
</syntaxhighlight>
 
== Таблица modbus-регистров==

Текущая версия на 14:43, 4 августа 2022

Термостат BHT-6000 Series, белый

Подключение к контроллеру

Подключите устройство к шине RS-485 с соблюдением распиновки.

Распиновка разъёма
Номер клеммы Описание
AC24V_L +24 В
AC24V_N GND
Red A
White B

Представление в веб-интерфейсе

Выбор шаблона

Чтобы устройство появилось на вкладке Устройства в веб-интерфейсе контроллера Wiren Board, добавьте новое serial-устройство и выберите шаблон BHT-6000 Series.

Параметры подключения

Устройством можно управлять по протоколу Modbus RTU. На физическом уровне оно подключается через интерфейс RS-485. Вы можете автоматизировать работу с устройством с помощью сценариев.

Параметры порта

По умолчанию устройство имеет настройки:

  • Baud rate — 9600 бит/с,
  • Parity — None,
  • Data bits — 8,
  • Stop bits — 1.

Производитель не предоставил возможности их изменять.

Modbus-адрес

По умолчанию в термостате задан modbus-адрес — 1,

Изменить modbus-адрес можно из сервисного меню. Настройка делается нажатием кнопок на корпусе термостата:

  1. Выключите термостат нажатием на кнопку ON/OFF.
  2. Зажмите одновременно кнопки M и Clock на 5 секунд — термостат войдет в сервисный режим.
  3. Кратким нажатием на кнопку M выберите параметр C.
  4. Кнопками вверх ↑ и вниз ↓ установите новый адрес термостата.
  5. После установки адреса подождите 5 секунд, термостат применит новые настройки и выйдет из сервисного режима.
  6. Включите термостат нажатием на кнопку ON/OFF.

Теперь вы можете подключиться к термостату по-новому modbus-адресу.

Карта регистров

Таблица регистров термостата BHT-6000GALN. Значения температуры при чтении нужно умножить на 0.1, а при записи разделить.

Регистр/ адрес Тип Чтение/ запись Формат Назначение
0 holding RW 0 ­- 1 Power
0 — OFF, 1 — ON
1 holding R u16 Temperature from internal sensor
2 holding RW 0 ­- 1 Manual mode
0 — Auto, 1 — Manual
3 holding R 0 ­- 1 Heating status
0 — Not heating, 1 — Heating
4 holding RW u16 Setting temperature
5 holding RW u16 Weekly program setting temperature
6 holding RW 0 ­- 1 Lock buttons
0 — Unlock, 1 — Lock

Полезные ссылки

Описание термостата и руководство по настройке


Поддерживаемые контроллером Wiren Board системы верхнего уровня, приложения, способы программирования, протоколы и устройства
Протоколы
Опрос датчиков и работа с устройствами (в базовой комплектации) 1-WireDLMS/COSEM Modbus RTU/TCP Master ГОСТ МЭК 61107 СПОДЭС (ГОСТ Р 58940-2020)
Опрос датчиков и работа с устройствами (с помощью модулей расширения) KNXeBUSOpenThermZ-WaveZigbee
Опрос контроллера из систем верхнего уровня и с других устройств KNX Modbus RTU/TCP SlaveMQTTOPC UASNMPZabbix МЭК 104SmartWeb (Гидролого)
Системы верхнего уровня
Системы мониторинга и SCADA GrafanaHome Assistant IntraHouse IntraSCADASprut.hubMasterSCADANagiosSimpLight SCADARapid SCADASAYMONZabbix iRidium Server
Приложения
Управление с телефона MQTT DashiRidiumHome Assistant Apple HomeДом с АлисойСалют! Умный дом
Голосовые помощники Siri Салют Алиса
Способы программирования
Языки программирования ПЛК FBD, ST, LD, SFC (МЭК 61131-3)
Визуальное программирование Node-RED
Упрощённый текстовый движок правил wb-rules
Стандартное программирование Python C++ Go Node.js
Протестированные устройства сторонних производителей
Адаптеры протоколов ECODim DALI GW2 HDL KNX-DALI Gateway M/DALI.1 Arlight DALI-LOGIC-LITE-PS-x1
Аудиоресиверы сетевые URRI A1
Датчики климата DS18B20 и клоныKvadro 1WIRE-RS485 RLDA NL-3DPAS-M RLDA NL-1S111Wellpro WP3066ADAMДаджет MT8057/MT8057SРД MSU21РД MSU24РД MSU34+TLPРД MSU34+THLPЭксис ИВТМ-7 М 3
Датчики уровня ЭСКОРТ ДБ-2
Универсальные датчики TESLiOT (BLE)
Диммеры DALI Philio PAD07-RU Uniel UCH-M131RC/0808 Uniel UCH-M141RC/0808 РД DDL04R РД DDL24 РД DDL84R-V РД DDM845R
Домофоны VIZIT (ВИЗИТ), Элтис, Цифрал, Техком, Метаком, Beward и другие координатного типа
Конвекторы Varmann QTherm
Кондиционеры Haier YCJ-A002 Z-Wave ИК-передатчик PAR01-RUGREE (ONOKOM-AIR-GR-1-MB-B) AUX (ONOKOM-AIR-AUX-1-MB-B) Mitsubishi Electric (ONOKOM-AIR-ME-1-MB-B) Daikin (ONOKOM-AIR-DK-1-MB-B) Hisense (ONOKOM-AIR-HS-3-MB-B) Haier (ONOKOM-AIR-HR-1-MB-B)
Рекуператоры / вентиляция Рекуператор VAKIO Base Smart ПВУ Royal Clima Soffio Primo RCS-350-PВентиляционная установка KomfoventRoyal Clima VENTO
Контроллеры вентиляции и климата Mautomatics JL204C5 (Breezart 550 Lux) GTC (General Thermo Controllers) Syberia 5.0 SystemAir VR 300Тепломаш КЭВ-БЛОК-МК
Контроллеры холодильного оборудования Carel BASIC(PYEZ)/EASY(PJEZ) Danfoss EKC 204A1/AK-CC 210 Danfoss EKC 202B Danfoss EKC 202D Danfoss ERC 211/ERC 213/ERC 214 Eliwell IDPlus 974
Метеостанции Netatmo Urban Weather Station Сокол-М
Модули ввода-вывода Wellpro WP8026ADAM Wellpro WP8027ADAM Wellpro WP8028ADAM Wellpro WP9038ADAM
Модули реле РД DRB88 Rubetek TZ78 ICP DAS tM-P3R3 ICP DAS LC-103 Uniel UCH-M111RX/0808 Uniel UCH-M121RX/0808
Моторы для штор/Электрокарнизы Akko AM82 Dooya DM35EQ Dooya DT82 WinDeco Somfy SDN SunFlower KT82TV Somfy RS485 RTS transmitter Беспроводные Dooya/Somfy Dauerhaft CM5 Dauerhaft Roll 35/45 A-OK AM68 (LM100)
Панели управления Cityron ПУ-3 (Modbus) Sonoff NSPanel (fw NXPanel) EKF PRO-Screen Skirell Panel
Счётчики воды Пульсар Пульсар-М Элехант СВД-15 Элехант СВД-20 Счётчики с импульсным выходом
Счётчики тепла Пульсар
Счётчики электроэнергии CSQ PD561Z-9SY Peacefair PZEM-016 Eastron SDM120M Eastron SDM220M Меркурий 200 Меркурий 201 Меркурий 203.2T Меркурий 204 Меркурий 206 Меркурий 208 Меркурий 230 Меркурий 231 Меркурий 234 Меркурий 236 Меркурий 238 Милур 104 Милур 105 Милур 107 Милур 305 Милур 307 Нева МТ 113 Нева МТ 123 Нева МТ 124 Нева МТ 323 Нева МТ 324 Энергомера CE301 Энергомера CE102M Энергомера CE303 Энергомера CE308
Термостаты BAC-002ALN BAC-6000ALN BAC-6000ELNW BHT-6000 Series Heatit Z-TEMP2 Hessway Siemens RDF302 Ridan Greencon-R
Увлажнители CAREL Humisonic
Управление двигателями (преобразователи частоты) Vacon/Danfoss 10 Danfoss VLT Microdrive FC51 T13-400W-12-H/T13-750W-12-H
Прочее DIYShelly UNITasmotaESPHome
Устройства с аналоговым или цифровым выходом
Низковольтная нагрузка Реле с управляющим напряжением 12–24 В Светодиоды Низковольтные вентиляторы Низковольтные сигнальные лампы
Датчики с аналоговым выходом Датчики температуры, давления и другие, имеющие на выходе ток или напряжение
Счётчики с импульсным выходом Счётчики электроэнергии, воды, тепла и другие с импульсным выходом
Устройства с выходом «открытый коллектор» Устройства с выходом «открытый коллектор»
Устройства с питанием 220 В Лампы Контакторы и другое оборудование с питанием от 220 В