WB-MAP3E Data Registers v.1: различия между версиями
Строка 3: | Строка 3: | ||
== Общая информация == | == Общая информация == | ||
{{Wbincludes:MAP Data Registers Preface}} | {{Wbincludes:MAP Data Registers Preface}} | ||
== | == Таблица Modbus-регистров == | ||
{{Modbus Registers Version FW | {{Modbus Registers Version FW | ||
| fw_this= 1.0.1 | | fw_this= 1.0.1 |
Версия 13:05, 25 марта 2022
Общая информация
Детальное описание погрешностей: Счетчики WB-MAP: измеряемые параметры и погрешности, их названия в веб-интерфейсе Wiren Board.
Обозначения в шаблонах
В таблицах регистров, описывающих измеряемые величины, используются следующие обозначения.
Для энергий (AP, AN, RP, RN, S, NP, NN): первая буква (A, R, S, N) — тип энергии, второй — направление:
- A — активная;
- R — реактивная;
- S — кажущаяся, вычисляется как URMS * IRMS;
- N — неактивная.
Направление:
- P — прямая (positive);
- N — обратная (negative).
В таблице описания регистров термин «Суммарная/суммарный» означает, что параметр вычисляется для всех трех фаз трехфазного канала. В случае с расхождением данных в таблице с шаблоном устройства, верным значением регистра считайте соответствующее значение из шаблона. Текущие версии шаблонов находятся по этой ссылке.
Примечания к названиям таблиц регистров
Таблицы регистров соответствуют шаблонам для счетчиков.
Версию прошивки счетчика можно проверить командой
echo -e `modbus_client --debug -mrtu -pnone -s2 /dev/ttyRS485-1 -a$mbusaddr -t0x03 -r250 -c 16 | grep Data | sed -e 's/0x00/\x/g' -e 's/Data://' -e 's/s//g'`| xxd -r -p && echo ''
Здесь $mbusaddr
— Modbus-адрес счетчика.
Порядок байт, широкие регистры, вычисление значения
Некоторые измеряемые счётчиками значения занимают больше 16 бит — размера одного регистра Modbus. Такие значения записываются в нескольких расположенных подряд регистрах: 32-битные в двух регистрах, а 64-битные — в четырёх. Некоторое стороннее ПО, например, ioBroker, воспринимают Signed 32 little endian, как signed 32 big endian word swap. Если у вас не сходятся расчётные результаты с показаниям в вашем софте — смените там тип.
В таблицах ниже для таких регистров указаны типы u32, u64 (без знака), s32 и s64 (со знаком). В качестве адреса в таблице указан адрес первого из идущих подряд регистров.
Порядок регистров при декодировании может быть прямым (big-endian) и обратным (little-endian). При этом порядок двух байт внутри одного 16-битного регистра всегда прямой, в соответствии со стандартом.
Пример: считываем четыре регистра 0x2200 – 0x2203:
Номер регистра |
0x2200 | 0x2201 | 0x2202 | 0x2203 |
---|---|---|---|---|
Содержимое регистра | 0хb4df | 0x0dff | 0x0000 | 0x0000 |
Смотрим в таблицу регистров:
Адрес | Параметры регистра | Описание | Значения | FW | |||
---|---|---|---|---|---|---|---|
Dec | Hex | Тип | Доступ | Формат | |||
8704 | 0x2200 | Input | RO | u64 little endian |
Ch 2 Total AP energy Суммарная прямая активная энергия для канала 2 |
х10-5, кВт·ч | 2.1 |
Порядок регистров little-endian — значит, регистры идут от младшего к старшему. Поэтому регистры объединяются в шестнадцатеричное число 0x0000 0000 0dff b4df
, оно же 234861791 в десятичной системе счисления. Для вычисления энергии нужно умножить его на число в столбце "Значения" (10-5 = 0.00001), поэтому в итоге получаем 2348.61791 кВт·ч.
Другими словами, чтобы получить итоговое число:
- 0x2200
- младшая часть — значение оставляем «как есть» : 0хb4dfhex = 46303dec
- 0x2201
- значение умножаем на 216 : 0x0dffhex = 3583dec, 3583 * 65536 = 234815488
- 0x2202
- значение умножаем на 232 : 0 * 4294967296 = 0
- 0x2203
- значение умножаем на 248 : 0 * 281474976710656 = 0
Суммируем результаты : 46303 + 234815488 + 0 + 0 = 234861791. Сумму умножаем на 0.00001 (переносим запятую на 5 знаков влево).
Таблица Modbus-регистров
Обратите внимание на версию прошивки устройства — таблицы регистров в разных версиях отличаются. На этой странице описаны регистры прошивки 1.0.1, описание регистров прошивки 2.x.
Регистр / адрес (hex) | Тип | Разрядность | Порядок регистров | Формат | Множитель | Параметр | Назначение | Единицы измерения | Прошивка |
---|---|---|---|---|---|---|---|---|---|
0x10d9 | input | u16 | big endian | (voltage) | 0.01 | Urms L1 | Напряжение (RMS) на фазе L1 | В | 1.0.1 |
0x1810 | input | s32 | little endian | (voltage) | 0.01 | Upeak L1 | Пиковое значение напряжения на фазе L1 | В | 1.0.1 |
0x10da | input | u16 | big endian | (voltage) | 0.01 | Urms L2 | Напряжение (RMS) на фазе L2 | В | 1.0.1 |
0x1812 | input | s32 | little endian | (voltage) | 0.01 | Upeak L2 | Пиковое значение напряжения на фазе L2 | В | 1.0.1 |
0x10db | input | u16 | big endian | (voltage) | 0.01 | Urms L3 | Напряжение (RMS) на фазе L3 | В | 1.0.1 |
0x1814 | input | s32 | little endian | (voltage) | 0.01 | Upeak L3 | Пиковое значение напряжения на фазе L3 | В | 1.0.1 |
0x10f8 | input | u16 | big endian | (value) | 0.01 | Frequency | Частота | Гц | 1.0.1 |
0x10fd | input | s16 | big endian | (value) | 0.1 | Voltage angle L1 | Фазовый угол сдвига напряжения между фазами (всегда 0, отсчет ведется от фазы L1) | ° | 1.0.1 |
0x10fe | input | s16 | big endian | (value) | 0.1 | Voltage angle L2 | Фазовый угол сдвига напряжения между фазами L1 и L2 | ° | 1.0.1 |
0x10ff | input | s16 | big endian | (value) | 0.1 | Voltage angle L3 | Фазовый угол сдвига напряжения между фазами L1 и L3 | ° | 1.0.1 |
0x10dd | input | u16 | big endian | (value) | 0.001 | Irms L1 | Ток (RMS) на фазе L1 | А | 1.0.1 |
0x1818 | input | s32 | little endian | (value) | 0.001 | Ipeak L1 | Пиковое значение тока на фазе L1 | А | 1.0.1 |
0x1302 | input | s32 | big endian | (power) | 0.00032 | P L1 | Активная мощность для фазы L1 | Вт | 1.0.1 |
0x130a | input | s32 | big endian | (value) | 0.00032 | Q L1 | Реактивная мощность для фазы L1 | вар | 1.0.1 |
0x1312 | input | s32 | big endian | (value) | 0.00032 | S L1 | Кажущаяся мощность для фазы L1 | В·А | 1.0.1 |
0x10bd | input | s16 | big endian | (value) | 0.001 | PF L1 | Коэффициент мощности для фазы L1 | 1.0.1 | |
0x1204 | input | u64 | little endian | (power_consumption) | 3.125e-06 | AP energy L1 | Прямая активная энергия для фазы L1 | кВт·ч | 1.0.1 |
0x1224 | input | u64 | little endian | (value) | 3.125e-06 | RP energy L1 | Прямая реактивная энергия для фазы L1 | квар·ч | 1.0.1 |
0x10de | input | u16 | big endian | (value) | 0.001 | Irms L2 | Ток (RMS) на фазе L2 | А | 1.0.1 |
0x181a | input | s32 | little endian | (value) | 0.001 | Ipeak L2 | Пиковое значение тока на фазе L2 | А | 1.0.1 |
0x1304 | input | s32 | big endian | (power) | 0.00032 | P L2 | Активная мощность для фазы L2 | Вт | 1.0.1 |
0x130c | input | s32 | big endian | (value) | 0.00032 | Q L2 | Реактивная мощность для фазы L2 | вар | 1.0.1 |
0x1314 | input | s32 | big endian | (value) | 0.00032 | S L2 | Кажущаяся мощность для фазы L2 | В·А | 1.0.1 |
0x10be | input | s16 | big endian | (value) | 0.001 | PF L2 | Коэффициент мощности для фазы L2 | 1.0.1 | |
0x1208 | input | u64 | little endian | (power_consumption) | 3.125e-06 | AP energy L2 | Прямая активная энергия для фазы L2 | кВт·ч | 1.0.1 |
0x1228 | input | u64 | little endian | (value) | 3.125e-06 | RP energy L2 | Прямая реактивная энергия для фазы L2 | квар·ч | 1.0.1 |
0x10df | input | u16 | big endian | (value) | 0.001 | Irms L3 | Ток (RMS) на фазе L3 | А | 1.0.1 |
0x181c | input | s32 | little endian | (value) | 0.001 | Ipeak L3 | Пиковое значение тока на фазе L2 | А | 1.0.1 |
0x1306 | input | s32 | big endian | (power) | 0.00032 | P L3 | Активная мощность для фазы L3 | Вт | 1.0.1 |
0x130e | input | s32 | big endian | (value) | 0.00032 | Q L3 | Реактивная мощность для фазы L3 | вар | 1.0.1 |
0x1316 | input | s32 | big endian | (value) | 0.00032 | S L3 | Кажущаяся мощность для фазы L3 | В·А | 1.0.1 |
0x10bf | input | s16 | big endian | (value) | 0.001 | PF L3 | Коэффициент мощности для фазы L3 | 1.0.1 | |
0x120c | input | u64 | little endian | (power_consumption) | 3.125e-06 | AP energy L3 | Прямая активная энергия для фазы L3 | кВт·ч | 1.0.1 |
0x122c | input | u64 | little endian | (value) | 3.125e-06 | RP energy L3 | Прямая реактивная энергия для фазы L3 | квар·ч | 1.0.1 |
0x1300 | input | s32 | big endian | (power) | 0.00032 | Total P | Суммарная активная мощность | Вт | 1.0.1 |
0x1308 | input | s32 | big endian | (value) | 0.00032 | Total Q | Суммарная реактивная мощность | вар | 1.0.1 |
0x1310 | input | s32 | big endian | (value) | 0.00032 | Total S | Суммарная кажущаяся мощность | В·А | 1.0.1 |
0x10bc | input | s16 | big endian | (value) | 0.001 | Total PF | Суммарный коэффициент мощности | 1.0.1 | |
0x1200 | input | u64 | little endian | (power_consumption) | 3.125e-06 | Total AP energy | Суммарная прямая активная энергия | кВт·ч | 1.0.1 |
0x1220 | input | u64 | little endian | (value) | 3.125e-06 | Total RP energy | Суммарная прямая реактивная энергия | квар·ч | 1.0.1 |
0x10f9 | input | s16 | big endian | (value) | 0.1 | Phase angle L1 | Угол фазового сдвига между напряжением и током для фазы L1 | ° | 1.0.1 |
0x10fa | input | s16 | big endian | (value) | 0.1 | Phase angle L2 | Угол фазового сдвига между напряжением и током для фазы L2 | ° | 1.0.1 |
0x10fb | input | s16 | big endian | (value) | 0.1 | Phase angle L3 | Угол фазового сдвига между напряжением и током для фазы L3 | ° | 1.0.1 |
Адрес | Параметры регистра | Описание | Значения | |||
---|---|---|---|---|---|---|
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.
Адрес | Параметры регистра | Описание | Значения | |||
---|---|---|---|---|---|---|
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 формате |