WB Dimmers Modbus Registers Map: различия между версиями

Версия 17:10, 8 декабря 2021

Регистры устройства

Прошивка 3.0

Версия 3.0 пока в разработке, подробнее читайте на форуме.

Регистры состояния входов и счетчики нажатий: Wbincludes:Header Relay Registers |- | class ="text-right" | 0 | 0x0000 | class="nowrap"| Вход 1 | rowspan="4" | Состояние | rowspan="4" | Discrete Input | rowspan="4" | RO | rowspan="4" | bool | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 - неактивен
1 - активен | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 1 | 0x0001 | Вход 2 |- | class ="text-right" | 2 | 0x0002 | Вход 3 |- | class ="text-right" | 3 | 0x0003 | Вход 4 |- | class ="text-right" | 32 | 0x0020 | Вход 1 | rowspan="4" | Счётчик замыканий | rowspan="4" | Input register | rowspan="4" | RO | rowspan="4" | u16 | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 − 65535
по кругу | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 33 | 0x0021 | Вход 2 |- | class ="text-right" | 34 | 0x0022 | Вход 3 |- | class ="text-right" | 35 | 0x0023 | Вход 4 |- | class ="text-right" | 464 | 0x01D0 | Вход 1 | rowspan="4" | Счётчик нажатий | rowspan="4" | Input register | rowspan="4" | RO | rowspan="4" | u16 | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 − 65535
по кругу | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 465 | 0x01D1 | Вход 2 |- | class ="text-right" | 466 | 0x01D2 | Вход 3 |- | class ="text-right" | 467 | 0x01D3 | Вход 4 |- | class ="text-right" | 480 | 0x01E0 | Вход 1 | rowspan="4" | Счётчик долгого нажатия | rowspan="4" | Input register | rowspan="4" | RO | rowspan="4" | u16 | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 − 65535
по кругу | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 481 | 0x01E1 | Вход 2 |- | class ="text-right" | 482 | 0x01E2 | Вход 3 |- | class ="text-right" | 483 | 0x01E3 | Вход 4 |- | class ="text-right" | 496 | 0x01F0 | Вход 1 | rowspan="4" | Счётчик двойного нажатия | rowspan="4" | Input register | rowspan="4" | RO | rowspan="4" | u16 | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 − 65535
по кругу | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 497 | 0x01F1 | Вход 2 |- | class ="text-right" | 498 | 0x01F2 | Вход 3 |- | class ="text-right" | 499 | 0x01F3 | Вход 4 |- | class ="text-right" | 512 | 0x0200 | Вход 1 | rowspan="4" | Счётчик короткого нажатия | rowspan="4" | Input register | rowspan="4" | RO | rowspan="4" | u16 | rowspan="4" | | rowspan="4" | | rowspan="4" | 0 − 65535
по кругу | rowspan="4" | | rowspan="4" class ="text-center" | 0 | rowspan="4" | |- | class ="text-right" | 513 | 0x0201 | Вход 2 |- | class ="text-right" | 514 | 0x0202 | Вход 3 |- | class ="text-right" | 515 | 0x0203 | Вход 4 |- | class="text-right" | 0 | 0x0000 | Канал 1 | rowspan="3" | Состояние при независимой работе | rowspan="3" | coil | rowspan="3" | RW | rowspan="3" | bool | rowspan="3" | | rowspan="3" | | rowspan="3" | 0 - включён
1- выключен | rowspan="3" class="text-center" | 0 | rowspan="3" | | rowspan="3" | |- | class="text-right" | 1 | 0x0001 | Канал 2 |- | class="text-right" | 2 | 0x0002 | Канал 3 |- | class="text-right" | 3 | 0x0003 | Канал 4 | Состояние при независимой работе или в режиме RGB+W | coil
| RW | bool | | | 0 - включён
1- выключен | class="text-center" | 0 | | |- | class="text-right" | 4 | 0x0004 | Каналы 1 и 2 | rowspan="3" | Состояние при параллельной работе | rowspan="3" | coil
| rowspan="3" | RW | rowspan="3" | bool | rowspan="3" | | rowspan="3" | | rowspan="3" | 0 - включён
1- выключен | rowspan="3" class="text-center" | 0 | rowspan="3" | | rowspan="3" | |- | class="text-right" | 5 | 0x0005 | Каналы 3 и 4 |- | class="text-right" | 6 | 0x0006 | Каналы 1, 2, 3, 4 |- | class="text-right" | 7 | 0x0007 | Каналы 1 и 2 | rowspan="2" | Состояние каналов при работе с CCT лентой | rowspan="2" | coil
| rowspan="2" | RW | rowspan="2" | bool | rowspan="2" | | rowspan="2" | | rowspan="2" | 0 - включён
1- выключен | rowspan="2" class="text-center" | 0 | rowspan="2" | | rowspan="2" | |- | class="text-right" | 8 | 0x0008 | Каналы 3 и 4 |- | class="text-right" | 9 | 0x0009 | Каналы 1, 2, 3 | Состояние каналов при работе с RGB лентой | coil
| RW | bool | | | 0 - включён
1- выключен | class="text-center" | 0 | | |- | class="text-right" | 10 | 0x000A | Каналы 1, 2, 3, 4 | Непрерывная смена цвета RGB ленты | coil

| RW | bool | | | 0 - включён
1- выключен | class="text-center" | 0 | | |}

Регистры управления каналами: Wbincludes:Header Registers | 2000 | 0x07D0
| Яркость канала 1 в режиме его независимой работы | rowspan="18" | holding | rowspan="18" | RW | rowspan="18" | u16 | rowspan="18" | 1 | rowspan="11" | % | rowspan="11" | 0 - 100 | rowspan="11" | 50 | rowspan="18" | 0xFFFF | rowspan="18" | |- | 2001 | 0x07D1 | Яркость канала 2 в режиме его независимой работы |- | 2002 | 0x07D2 | Яркость канала 3 в режиме его независимой работы |- | 2003 | 0x07D3 | Яркость канала 4 в режиме его независимой работы или в режиме RGB+W |- | 2004 | 0x07D4 | Яркость каналов 1 и 2 в режиме их параллельного соединения |- | 2005 | 0x07D5 | Яркость каналов 3 и 4 в режиме их параллельного соединения |- | 2006 | 0x07D6 | Яркость каналов 1, 2, 3, 4 в режиме их параллельного соединения |- | 2007 | 0x07D7 | Цветовая температура CCT ленты, подключенной к каналам 1 и 2
0% - максимально теплый цвет
100 % - максимально холодный цвет |- | 2008 | 0x07D8 | Яркость CCT ленты, подключенной к каналам 1 и 2 |- | 2009 | 0x07D9 | Цветовая температура CCT ленты, подключенной к каналам 3 и 4
0% - максимально теплый цвет
100 % - максимально холодный цвет |- | 2010 | 0x07DA | Яркость CCT ленты, подключенной к каналам 3 и 4 |- | 2011 | 0x07DB | Компонент R цвета RGB ленты в RGB палитре | rowspan="3" | - | rowspan="3" | 0 - 255 | rowspan="3" | 127 |- | 2012 | 0x07DC | Компонент G цвета RGB ленты в RGB палитре |- | 2013 | 0x07DD | Компонент B цвета RGB ленты в RGB палитре |- | 2014 | 0x07DE | Компонент H цвета RGB ленты в HSV палитре | ° | 0 - 360 | 0 |- | 2015 | 0x07DF | Компонент S цвета RGB ленты в HSV палитре | rowspan="2" | % | rowspan="2" | 0 - 100 | 0 |- | 2016 | 0x07E0 | Компонент V цвета RGB ленты в HSV палитре | 50 |- | 2017 | 0x07E1 | Скорость непрерывного изменения цвета RGB ленты, период увеличения Hue на 1 | мс | 3 - 10000 | 30 |}

Регистры настройки выходов и прямого управления ШИМ выходов: Wbincludes:Header Registers | 70 | 0x0046 | rowspan="4" | Минимальный ШИМ для выходов 1 - 4 | rowspan="12" | holding | rowspan="12" | RW | rowspan="12" | u16 | rowspan="12" | 1 | rowspan="12" | - | rowspan="12" | 0 - 2048 | rowspan="4" | 6 | rowspan="12" | - | rowspan="12" | |- | 71 | 0x0047 |- | 72 | 0x0048 |- | 73 | 0x0049 |- | 80 | 0x0050 | rowspan="4" | Максимальный ШИМ для выходов 1 - 4 | rowspan="4" | 2048 |- | 81 | 0x0051 |- | 82 | 0x0052 |- | 83 | 0x0053 |- | 90 | 0x005A | rowspan="4" | Прямое управление ШИМ выходов 1 - 4 | rowspan="4" | 0 |- | 91 | 0x005B |- | 92 | 0x005C |- | 93 | 0x005D |}

Регистры настройки действий по типам нажатий: Wbincludes:Header Registers | 1000 | 0x03E8 | rowspan="4" | Настройка действия при коротком нажатии для входов 1 - 4 | rowspan="16" | holding | rowspan="16" | RW | rowspan="16" | u16 | rowspan="16" | - | rowspan="16" | - | rowspan="16" | См. описание действий | rowspan="16" | 0 | rowspan="16" | - | rowspan="3" | |- | 1001 | 0x03E9 |- | 1002 | 0x03EA |- | 1003 | 0x03EB | HW > ??? |- | 1020 | 0x03FC | rowspan="4" | Настройка действия при долгом нажатии для входов 1 - 4 | rowspan="3" | |- | 1021 | 0x03FD |- | 1022 | 0x03FE |- | 1023 | 0x03FF | HW > ??? |- | 1040 | 0x0410 | rowspan="4" | Настройка действия при двойном нажатии для входов 1 - 4 | rowspan="3" | |- | 1041 | 0x0411 |- | 1042 | 0x0412 |- | 1043 | 0x0413 | HW > ??? |- | 1060 | 0x0424 | rowspan="4" | Настройка действия при коротком, затем долгом нажатии для входов 1 - 4 | rowspan="3" | |- | 1061 | 0x0425 |- | 1062 | 0x0426 |- | 1063 | 0x0427 | HW > ??? |}

Регистры настройки обработки типов нажатий: Wbincludes:Header Registers | 1100 | 0x044C | rowspan="4" | Настройка времени удержания входа в замкнутом состоянии для фиксации долгого нажатия для входов 1 - 4 | rowspan="16" | holding | rowspan="16" | RW | rowspan="16" | u16 | rowspan="16" | 1 | rowspan="16" | мс | rowspan="4" | 500 - 5000 | rowspan="4" | 2000 | rowspan="16" | - | rowspan="3" | |- | 1101 | 0x044D |- | 1102 | 0x044E |- | 1103 | 0x044F | HW > ??? |- | 1120 | 0x0460 | rowspan="4" | Настройка периода генерации событий при удержании кнопки после фиксации долгого нажатия для входов 1 - 4 | rowspan="4" | 5 - 500 | rowspan="4" | 20 | rowspan="3" | |- | 1121 | 0x0461 |- | 1122 | 0x0462 |- | 1123 | 0x0463 | HW > ??? |- | 1140 | 0x0474 | rowspan="4" | Настройка времени двойного нажатия для входов 1 - 4 | rowspan="4" | 100 - 2000 | rowspan="4" | 500 | rowspan="3" | |- | 1141 | 0x0475 |- | 1142 | 0x0476 |- | 1143 | 0x0477 | HW > ??? |- | 1160 | 0x0488 | rowspan="4" | Настройка времени подавления дребезга для входов 1 - 4 | rowspan="4" | 5 - 200 | rowspan="4" | 50 | rowspan="3" | |- | 1161 | 0x0489 |- | 1162 | 0x048A |- | 1163 | 0x048B | HW > ??? |}

Регистры настройки времени плавного изменения параметров. В таблице указаны адреса регистров для настройки времени изменения в сторону увеличения параметра. Для настройки времени изменения в сторону уменьшения параметра к адресу регистра нужно прибавить 100 (таблица начнется с адреса 3100). Wbincludes:Header Registers | 3000 | 0x0BB8 | Время плавного изменения яркости канала 1 в режиме его независимой работы | rowspan="14" | holding | rowspan="14" | RW | rowspan="14" | u16 | rowspan="14" | 1 | rowspan="14" | мс | rowspan="14" | 0 - 30000 | rowspan="14" | 1000 | rowspan="14" | - | rowspan="14" | |- | 3001 | 0x0BB9 | Время плавного изменения яркости канала 2 в режиме его независимой работы |- | 3002 | 0x0BBA | Время плавного изменения яркости канала 3 в режиме его независимой работы |- | 3003 | 0x0BBB | Время плавного изменения яркости канала 4 в режиме его независимой работы |- | 3004 | 0x0BBC | Время плавного изменения яркости каналов 1 и 2 в режиме их параллельного соединения |- | 3005 | 0x0BBD | Время плавного изменения яркости каналов 3 и 4 в режиме их параллельного соединения |- | 3006 | 0x0BBE | Время плавного изменения яркости каналов 1, 2, 3, 4 в режиме их параллельного соединения |- | 3007 | 0x0BBF | Время плавного изменения цветовой температуры CCT ленты, подключенной к выходам 1 и 2 |- | 3008 | 0x0BC0 | Время плавного изменения яркости CCT ленты, подключенной к выходам 1 и 2 |- | 3009 | 0x0BC1 | Время плавного изменения цветовой температуры CCT ленты, подключенной к выходам 3 и 4 |- | 3010 | 0x0BC2 | Время плавного изменения яркости CCT ленты, подключенной к выходам 3 и 4 |- | 3011 | 0x0BC3 | Время плавного изменения цвета RGB ленты (HSV-H) |- | 3012 | 0x0BC4 | Время плавного изменения насыщенности цвета RGB ленты (HSV-S) |- | 3013 | 0x0BC5 | Время плавного изменения яркости RGB ленты (HSV-V) |}

Регистры общих настроек Wbincludes:Header Registers | 9 | 0x0009 | Настройка частоты ШИМ выходов. F = 24 kHz / value | rowspan="2" | holding | rowspan="2" | RW | rowspan="2" | u16 | 1 | rowspan="2" | - | 1 - 240 | 8 | rowspan="2" | - | rowspan="2" | |- | 4000 | 0x0FA0 | Настройка режима работы диммера. См. таблицу режимов работы | - | См. таблицу | 0 |}

Прошивка 1.0

Текущая серийная версия прошивки.

Регистр / адрес	тип	чтение/запись	значение по умолчанию	формат	назначение	Примечание
0	holding	RW	-	0-255	Уровень канала G, логарифмическая кривая
1	holding	RW	-	0-255	Уровень канала R, логарифмическая кривая
2	holding	RW	-	0-255	Уровень канала B, логарифмическая кривая
3	holding	RW	-	0-255	Уровень канала W, логарифмическая кривая	WB-MRGBW-D

5	holding	RW	0	0: стандартный режим, 1: отключить управление	режим работы кнопок
6	input	R		1 - нажата, 0 - отпущена	состояние кнопки 1
7	input	R		1 - нажата, 0 - отпущена	состояние кнопки 2
8	input	R		1 - нажата, 0 - отпущена	состояние кнопки 3 (WB-MRGBW-D)
9	holding	RW	0	freq = 24 кГц / (value + 1) (0 - 239)	частота ШИМ *
13	holding	RW	100	x 10ms (2 - 500)	Время плавного изменения яркости во время включения и выключения

32	input	R	0	0 - 65535 и дальше снова 0	количество нажатий кнопки 1	с версии 1.1.1
33	input	R	0	0 - 65535 и дальше снова 0	количество нажатий кнопки 2	с версии 1.1.1
34	input	R	0	0 - 65535 и дальше снова 0	количество нажатий кнопки 3	с версии 1.1.1

* Для регистра 9 приведена формула расчёта частоты.
Значение регистра считается так: value=24кГц/freq−1, где freq — нужная частота.
По умолчанию в регистр записано 0 — это 24 кГц: 24/24−1=0
В регистр пишется только целое число, возможные значения:
0 - 24 кГц
1 - 12 кГц
2 - 8 кГц
3 - 6 кГц
4 - 5.4 кГц
5 - 4 кГц

Условные обозначения
RO / RW	Read only / Read/Write
Выделено жирным	Значение регистра по умолчанию
xN	Множитель, на который надо умножить число из регистра, чтобы получить значение в единицах измерения. Не указан — считать равным 1
⚡	Регистр поддерживает отправку данных с помощью событий Быстрого Modbus.
FW	Версия прошивки устройства, с которой появился регистр. Пусто — регистр был всегда.
Error:	Значение при ошибке
Серый цвет ячейки	Служебный регистр: назначение, формат и содержимое может измениться в новых версиях прошивки

Общие для всех Modbus-устройств Wiren Board регистры
Адрес		Параметры регистра			Описание	Значения
Dec	Hex	Тип	Доступ	Формат	Описание	Значения
104-105	0x0068 - 0x0069	Input	RO	u32	Время работы с момента загрузки	секунды
121	0x0079	Input	RO	u16	Текущее напряжение питания	мВ
110	0x006E	Holding	RW	u16	Скорость порта RS-485. Настройка параметров подключения по RS-485	x100, Боды 12 — 1200 бит/с, 24 — 2400 бит/с, 48 — 4800 бит/с, 96 — 9600 бит/с, 192 — 19 200 бит/с, 384 — 38 400 бит/с, 576 — 57 600 бит/с, 1152 — 115 200 Кбит/с
111	0x006F	Holding	RW	u16	Настройка бита чётности порта RS-485	0 — нет бита чётности (none), 1 — нечётный, 2 — чётный
112	0x0070	Holding	RW	u16	Количество стоп-битов порта RS-485	1, 2
113	0x0071	Holding	RW	u16	Время перед отправкой ответа на modbus запрос	0 - 254 мс
114	0x0072	Holding	RW	u16	Режим непрерывного чтения регистров с зазором	0 - отключен 1 - включен 2 - включение сохраняется после перезагрузки
128	0x0080	Holding	RW	u16	Modbus-адрес устройства (подробнее)
120	0x0078	Holding	RW	u16	Перезагрузка устройства без сохранения состояния	любое, отличное от 0 перезагружает устройство
129	0x0081	Holding	RW	u16	Перевод в режим обновления прошивки на 2 минуты	любое, отличное от 0 переводит устройство в режим обновления прошивки
130	0x0082	Holding	RW	u8	Отключение индикатора состояния	0 - активен, 1 - отключен
123	0x007B	Input	RO	u16	Напряжение на микроконтроллере	мВ
124	0x007C	Input	RO	u16	Внутренняя температура микроконтроллера	x0.1, °C
200-205	0x00C8 - 0x00CD	Input	RO	string	Модель устройства
206-219	0x00CE - 0x00DB	Input	RO	string	Расширение модели устройства. Для новых устройств WB-LED и WB-MAI6 поле поддерживается изначально, для остальных - в прошивках с "быстрым Modbus". Для чтения модели устройства нужно читать диапазон из 20 регистров (200 - 219). Если устройство возвращает ошибку Illegal Data Address - читать 6 регистров (200 - 205).
220-248	0x00DC - 0x00F8	Input	RO	string	Хэш коммита и название ветки откуда собрана прошивка (2 символа в регистре)
250-265	0x00FA - 0x0109	Input	RO	string	Версия прошивки
266-269	0x010A - 0x010D	Input	RO	u64	Расширение серийного номера
270-271	0x010E - 0x010F	Input	RO	u32	Серийный номер
290-301	0x0122 - 0x012D	Holding	RO	string	Сигнатура прошивки
330-336	0x014A - 0x0150	Holding	RO	string	Версия загрузчика

Версия прошивки в устройствах с «Быстрым Modbus»

В устройствах, поддерживающих Быстрый Modbus, используется другой формат обозначения версии прошивки.

Диапазон регистров «Модель устройства» расширен до 20 регистров.
Версия формируется согласно semver и имеет формат MAJOR.MINOR.PATCH с опциональным суффиксом (-rc|+wb)SUFFIX:
суффикс -rc означает, что прошивка предназначена для тестирования и может быть нестабильной. Хранится в регистре с отрицательным знаком;

суффикс +wb добавляется, когда к прошивке, зафиксированной в релизе, требуется выпустить фикс. Хранится в регистре с положительным знаком.
Цифры версии доступны по отдельности в формате u16 (для суффикса - s16), регистры 320-323.
Доступно число u32, содержащее комбинацию цифр версии и позволяющее за одно сравнение понять, увеличилась или уменьшилась версия прошивки:
число рассчитывается по формуле
```
if (SUFFIX >= 0) {
    SUFFIX = SUFFIX + 128;
} else {
    SUFFIX = -1 - SUFFIX;
}
VERSION = (MAJOR << 24) + (MINOR << 16) + (PATCH << 8) + SUFFIX;
```
число доступно для чтения в little-endian и big-endian форматах;

число для более свежей версии всегда будет больше, чем для предыдущей, в том числе, когда прошивка переходит из тестовой в стабильную.

Таким образом обеспечивается корректное сравнение версий:
```
1.2.3-rc1 < 1.2.3-rc10 < 1.2.3 < 1.2.3+wb1 < 1.2.3+wb10.
```

Условные обозначения
RO / RW	Read only / Read/Write
Выделено жирным	Значение регистра по умолчанию
xN	Множитель, на который надо умножить число из регистра, чтобы получить значение в единицах измерения. Не указан — считать равным 1
⚡	Регистр поддерживает отправку данных с помощью событий Быстрого Modbus.
FW	Версия прошивки устройства, с которой появился регистр. Пусто — регистр был всегда.
Error:	Значение при ошибке
Серый цвет ячейки	Служебный регистр: назначение, формат и содержимое может измениться в новых версиях прошивки

Регистры для хранения версии прошивки в устройствах с быстрым Modbus
Адрес		Параметры регистра			Описание	Значения
Dec	Hex	Тип	Доступ	Формат	Описание	Значения
200-219	0x00C8 - 0x00DB	Input	RO	string	Модель устройства
320	0x0140	Input	RO	u16	Версия прошивки в числовом формате	MAJOR
321	0x0141					MINOR
322	0x0142					PATCH
323	0x0143			s16		SUFFIX
324-325	0x0144 - 0x0145	Input	RO	u32	Версия прошивки в числовом формате
326-327	0x0146 - 0x0147	Input	RO	u32	Версия прошивки в Big Endian формате

Навигация