Difference between revisions of "Sensors Modbus Management"

From Wiren Board
Jump to navigation Jump to search
(Отметить эту версию для перевода)
(5 intermediate revisions by the same user not shown)
Line 201: Line 201:
 
|
 
|
 
|-
 
|-
 +
 
|91||holding||RW||20 (200 ms)||× 10 ms
 
|91||holding||RW||20 (200 ms)||× 10 ms
 
||Время усреднения шума
 
||Время усреднения шума
Line 208: Line 209:
 
|S
 
|S
 
|S
 
|S
|
+
|-
 +
 
 +
|92
 +
||holding
 +
||RW||0||x0.0625||Служебный регистр HOLD_REG_SPL_RAW_OFFSET - сдвиг значения АЦП
 +
|<nowiki>-</nowiki>
 +
|<nowiki>-</nowiki>
 +
|S
 +
|S
 +
|S
 +
|4.9.0
 +
|-
 +
 
 +
|93
 +
||holding
 +
||RW||0||x0.1dB||Служебный регистр HOLD_REG_SPL_OFFSET - поправка к значению уровня шума
 +
|<nowiki>-</nowiki>
 +
|<nowiki>-</nowiki>
 +
|S
 +
|S
 +
|S
 +
|4.9.0
 +
|-
 +
 
 +
 
 +
 
 +
 
 
|-
 
|-
 
|95
 
|95
Line 272: Line 299:
  
  
 +
 +
|100
 +
||input
 +
||R||||||Служебный регистр HOLD_REG_SPL_RAW_INT
 +
|<nowiki>-</nowiki>
 +
|<nowiki>-</nowiki>
 +
|S
 +
|S
 +
|S
 +
|
 +
|-
  
  
Line 287: Line 325:
 
||R||||||Служебный регистр HOLD_REG_TH_ERRORS
 
||R||||||Служебный регистр HOLD_REG_TH_ERRORS
 
|colspan="5"|все
 
|colspan="5"|все
 +
|
 +
|-
 +
 +
 +
|103
 +
||holding
 +
||RW||||||Служебный регистр HOLD_REG_ILLUMINANCE_MODE
 +
|<nowiki>+</nowiki>
 +
|<nowiki>+</nowiki>
 +
|<nowiki>+</nowiki>
 +
|<nowiki>-</nowiki>
 +
|<nowiki>-</nowiki>
 
|
 
|
 
|-
 
|-
Line 449: Line 499:
 
|3
 
|3
 
|1
 
|1
|Включение датчика CO2
+
| style="text-align:left"|Включение датчика CO2 (1-вкл, 0-выкл)
 
|WB-MSW v.3
 
|WB-MSW v.3
 
|4.1.0
 
|4.1.0

Revision as of 15:21, 20 November 2019

Other languages:
English • ‎русский


Параметры Modbus

Modbus-адрес

Modbus-адрес устройств Wiren Board легко определить — он нанесен на наклейке (адрес указан в десятичном формате). Новый адрес устройства записывается командой WRITE_SINGLE_REGISTER в регистр хранения (holding register) с адресом 128 (0x80). Подробно о том, как определить (если адрес был изменен) или изменить Modbus-адрес модуля, написано на странице Определение и изменение Modbus-адреса устройств Wirenboard.

Команды Modbus, поддерживаемые устройством

Датчики Wirenboard поддерживают все основные команды Modbus. Подробнее смотрите здесь: Коды функций чтения и записи регистров.

Карта регистров хранения (Holding Registers)

Регистр/ адрес Тип Чтение/ запись Значение по умолчанию или при ошибке Формат Назначение Поддерживается в С версии

прошивки

WB-MS (код модели) WB-MS v2 (код модели) WB-MSW WB-MSW2 WB-MSW v.3
0 input R 0x7FFF °C × 10 (signed) Температура с встроенного датчика T - - + +
1 input R 0xFFFF

%RH × 10 (signed)

Относительная влажность с встроенного датчика H - + + +
2 input R - лк (регистр не используется в датчиках WB-MSW, вместо него регистры 9 и 10)
Освещённость с встроенного датчика
L Lux - - -
3 input R - дБ × 100 Уровень шума, умноженный на 100 S - + S S
4 input R 0x7FFF °C × 100 (signed) Температура с встроенного датчика + + - - + 4.2
5 input R - %RH × 100 (signed) Относительная влажность с встроенного датчика + + - - + 4.2
6 input R 0x7FFF °C × 16 (signed) Температура с внешнего датчика D + - - -
7 input R 0x7FFF °C × 16 (signed) Температура с внешнего датчика D + - - -
8 input R 0xFFFF PPM Концентрация CO2 - - С C
9-10 input R лк Освещенность, умноженная на 100 (9 - старший разряд, 10 — младший разряд значения освещенности) - - + L
11 input R 0xFFFF PPM Качество воздуха - VOC - - +
88 holding RW 0 ppm (400-1500) Ручная калибровка датчика CO2. Для калибровки запишите сюда текущее значение концентрации CO2, измеренное другим прибором - - - C C 3.12
89 holding RW 0xFF дней Длительность цикла для алгоритма самокалибровки датчика CO (ABC) - - - C C 3.12
90 holding RW 20 (200 ms) × 10 ms Время усреднения освещённости

L, B

- - - -
91 holding RW 20 (200 ms) × 10 ms Время усреднения шума S - + S S
92 holding RW 0 x0.0625 Служебный регистр HOLD_REG_SPL_RAW_OFFSET - сдвиг значения АЦП - - S S S 4.9.0
93 holding RW 0 x0.1dB Служебный регистр HOLD_REG_SPL_OFFSET - поправка к значению уровня шума - - S S S 4.9.0
95 holding RW 1 1 or 0 Режим автокалибровки датчика CO2 (ABC) на атмосферный уровень CO2 - - - С C
96 holding R 2000 / 5000 ppm (доступно с версии прошивки 3.5.0) Диапазон измерения концентрации CO2. Допустимые значения: 2000, 5000, 10000. - - - C C 3.5.0
97 holding RW 0 — 10 c Период между вспышками сигнальных светодиодов - - - - + 3.13.0
98 holding RW 0 — 50 мс Длительность вспышки светодиодов - - - - + 3.13.0
99 holding RW 16 1 = 0.0625C (доступно с версии прошивки 3.10.0) Фильтр подозрительных значений для датчиков 1-Wire (85.000C, 127.937C). Значения отбрасываются, если предыдущее отличается от подозрительного больше, чем на значение регистра*0.0625C. Запишите 0, чтобы отключить фильтр. D + - - - 3.10.0
100 input R Служебный регистр HOLD_REG_SPL_RAW_INT - - S S S
101 input R Служебный регистр HOLD_REG_TH_READS все
102 input R Служебный регистр HOLD_REG_TH_ERRORS все
103 holding RW Служебный регистр HOLD_REG_ILLUMINANCE_MODE + + + - -
104-105 input R 32-bit unsigned int Время работы устройства (uptime counter) в секундах все
106 input R Служебный регистр INPUT_REG_SGPC3_BASELINE - - - - +
107 input R Служебный регистр INPUT_REG_SGPC3_RAW_SIGNAL - - - - +
108 input R 0xFFFF Служебный регистр SGPC3 VERSION - - - - + 4.2
110 holding RW 96 baud rate / 100 скорость порта RS-485, делённая на 100. Допустимые скорости: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
(Настройка параметров обмена данными по RS-485 для modbus-устройств Wiren Board)
все >3.1.0
111 holding RW 0 настройка бита чётности порта RS-485. Допустимые значения: 0 - нет бита чётности (none), 1 - нечётный (odd), 2 - чётный (even) все
112 holding RW 2 количество стоп-битов порта RS-485. Допустимые значения: 1, 2 все
120 (0x78) holding RW 0 отличное от 0 запись в регистр вызывает перезагрузку модуля без сохранения состояния все
121 (0x79) input R - mV текущее напряжение питания модуля все
128 (0x80) holding RW 1 Modbus-адрес устройства все
129 (0x81) holding RW 0 0 или 1 Переход в режим загрузчика все 4.5.0
200-206 input R см. Сигнатура устройства сигнатура все
220-241 input R __date__ __time__ дата сборки прошивки все
245 holding RW 0 °C × 100 (signed) Температурная компенсация самонагрева для датчика температуры и влажности (значение вычитается из измереной температуры) + - - - + 4.2
250-269 input R строка, null-terminated версия прошивки все
270-271 input R 32-bit unsigned int уникальный идентификатор (S/N) все
280 input R Максимальное значение датчика движения с АЦП - - - - +
281 input R Значение датчика движения с АЦП - - - - +
282 holding RW 10 с Ширина временного окна для вычисления максимального усредненного значения датчика движения (от 1 до 60 секунд) - - - - +
283 input R Текущее усредненное значение движения в условных единицах - - - - +

Карта регистров флагов (Coils)

Регистры, связанные с ИК-управлением, описаны в статье WB-MSx_Consumer_IR_Manual.

Начальный адрес Количество Назначение В модификациях С версии прошивки
0 1 Включение пищалки (buzzer) WB-MSW2, WB-MSW v.3
1 1 Принудительная калибровка встроенного датчика CO2. Включать после 20 минут работы при уровне CO2, равном 400 ppm WB-MSW2
2 1 Включение подогрева (heater) в микросхеме сенсора температуры и влажности HDC1080 WB-MS (в серии 2017 г.), WB-MSW2, WB-MSW v.3 3.2.0
3 1 Включение датчика CO2 (1-вкл, 0-выкл) WB-MSW v.3 4.1.0
10 1 Включение зеленого светодиода WB-MSW v.3
11 1 Включение красного светодиода WB-MSW v.3

Сигнатура устройства

По адресу 200 хранится сигнатура модуля длиной 6 байт. Сигнатура уникальна для каждой модели устройств Wiren Board и позволяет идентифицировать модель по Modbus:

Модуль Сигнатура
WB-MS WBMS,'0x00','0x00'
WB-MSW WBMSW,'0x00'
WB-MSW2 WBMSW2
WB-MSW v.3 WBMSW3

Для получения сигнатуры устройства нужно выполнить команду READ_HOLDING_REGISTERS по адресу 200 (длина 6 регистров). Запись в эту область памяти не поддерживается, при попытке записи в недопустимое место возвращается ошибка 3. Пустые места в тексте сигнатуры забиваются значением 0x00. Начиная с регистра 220 записана дата сборки прошивки, в формате "числоx00времяx00" в виде строки (пример: 'Jan 27 2017 17:01:13'). Длина записи — 21 регистр.

Управление модулем из командной строки

Программное обеспечение контроллера Wiren Board включает в себя утилиту modbus_client для работы с устройствами, подключенными к выходам RS-485, по протоколу Modbus, подробное описание команды находится на странице Modbus-client. Доступ к командной строке описан в статье SSH.

Пример чтения регистров

Проверим, верно ли, что мы подключились именно к модулю нужного типа. (Модуль wb-mqtt-serial должен быть предварительно остановлен). По адресу 200 хранится уникальная сигнатура длиной в 6 регистров. Прочтем 6 регистров, начиная с адреса 200, и преобразуем полученный шестнадцатеричный ответ в символьную строку:

echo  -e `modbus_client --debug -mrtu -pnone -s2 /dev/ttyAPP1 \
-a1 -t0x03 -r200 -c 6 | \
grep Data | sed -e 's/0x00/\\\x/g' -e 's/Data://' -e 's/\s//g'`

В результате выполнения команды получаем строку, например WBMS. Модуль WB-MS в примере имеет Modbus-адрес 1.