rbAmp STD — технический справочник
Полный технический справочник по линейке модулей rbAmp STD: карта регистров, транспорты, команды, модель измерений и энергии, обновление прошивки, диагностика и интеграция с хостом.
Версия карты регистров 0x36.
Этот справочник описывает ядро прошивки, общее для каждого модуля STD. Члены семейства: STD-UI1 (1 канал напряжения + 1 токовый) и STD-U3I3 (3 канала напряжения + 3 токовых, трёхфазный). Они используют одну карту и различаются только N_VOLTAGE / N_CURRENT и кодом варианта, поэтому всё здесь написано обобщённо по числу каналов.
Содержание
| # | Файл | Охватывает |
|---|---|---|
| 1 | Идентификация и обнаружение | магическое значение, версии, возможности, коды вариантов, число каналов, UID, ID платы |
| 2 | Транспорт I²C | 16-битный указатель, последовательности чтения/записи, растяжение тактов, смена адреса |
| 3 | Транспорт Modbus RTU | кадрирование, профили, пространства регистров, исключения, UNLOCK, правила поведения |
| 4 | Карта регистров | каждый блок с адресом, типом, единицами, масштабом и доступом |
| 5 | Команды | регистр команд, семантика busy и результата, коды ошибок, ограничения доступа |
| 6 | Выход готовности данных и события | контракт DRDY, WIN_SEQ, флаги событий, пороги, тревога |
| 7 | Модель измерения и энергии | окна, единицы, счётчики энергии, история, журнал событий, время |
| 8 | Конфигурация, сохранение и калибровка | что переживает сброс / выключение питания, как сохранять, видимая пользователю калибровка |
| 9 | Обновление прошивки | протокол OTA на стороне хоста по I²C и Modbus |
| 10 | Диагностика | флаги статуса, причина сброса, счётчики, чек-лист здоровья, светодиоды |
| 11 | Аппаратный интерфейс | сигналы, проводка, переключатель режима интерфейса, DRDY, сброс |
| 12 | Интеграция с хостом | последовательности сырых регистров без наших библиотек; указатели на библиотеки |
| 13 | Последовательности | канонические пошаговые потоки: инициализация, команды, конфигурация, смена адреса, энергия, история, OTA, разблокирование |
Принятые соглашения
-
Адреса. Адреса регистров I²C 16-битные, записываются как
0xNNNN. Адреса регистров Modbus — отдельное пространство (см. Транспорт Modbus); адрес Modbus никогда не равен «адресу I²C того же значения» — таблицы соответствия даны явно. -
Порядок байт. Многобайтовые значения по I²C — little-endian. По Modbus нативный профиль использует порядок слов big-endian ABCD (настраивается), профиль float32 всегда ABCD.
-
Единицы (целые с фиксированным масштабом, никогда float, по I²C и нативному профилю Modbus):
| Величина | Единица | В SI |
|---|---|---|
| Напряжение | mV | ÷1000 → V |
| Ток | µA | ÷1 000 000 → A |
| Активная мощность | mW (со знаком) | ÷1000 → W |
| Реактивная мощность | mvar (со знаком) | ÷1000 → var |
| Полная мощность | mVA | ÷1000 → VA |
| Коэффициент мощности | Q10 (со знаком) | ÷1024 → PF |
| Частота | cHz | ÷100 → Hz |
| Накопленная энергия | Wh / varh (i64, со знаком) и mWh (i64); счётчики µWh (i64) и µvarh (i64) | — |
| Фазовый угол напряжения | сотые градуса (i16, со знаком) | ÷100 → ° |
| Энергия по окнам | mW·отсчёты (i64, со знаком) | см. модель измерений |
| THD | сотые процента | ÷100 → % |
-
Знаки. P > 0 = импорт (потребление); экспорт отрицательный. Q следует IEC 62053-23 (Q > 0 индуктивный). Знак PF совпадает со знаком P. Энергия импорта и экспорта ведётся в отдельных счётчиках.
-
Sentinels — по транспортам. Поле, которое данная сборка не предлагает, на нативном профиле Modbus читается как sentinel:
0x8000(i16),0x80000000(i32),0xFFFF(u16); в профиле float32 читается как 0; по I²C такие поля просто читаются как 0, а неотображённые адреса I²C читаются как0xFF. -
Правило доступа. Мастер должен ограничивать доступ к каналам по
N_VOLTAGE/N_CURRENT, а доступ к функциям — поCAPABILITIES: регистры каналов ≥ N и отсутствующих функций не содержат данных.