rbAmp
RU
Магазин
Документация
Обновлено

Идентификация и обнаружение

Как хост распознаёт модуль STD, что это за модуль и что он умеет. Все регистры этой главы только для чтения, если не указано иное. Адреса I²C; зеркала обнаружения Modbus перечислены в конце.

Последовательность обнаружения

При первом контакте мастер читает блок идентификации по 0x0000 и по нему открывает всё остальное:

  1. ID (0x0000, 2 байта) должен читаться как 'S','T' (0x53, 0x54) — иначе это не модуль STD.
  2. VERSION (0x0003) — это версия раскладки карты регистров (текущая: 0x36). Новые функции повышают её; мастер ограничивает функции карты по ней.

  3. CAPABILITIES (0x0004, u16) — битовая карта возможностей, см. ниже. Бит 9 (адресация 16 бит) всегда установлен на STD.

  4. N_VOLTAGE (0x0007) / N_CURRENT (0x0008) — сколько каналов заполнено. Блоки каналов с индексом ≥ N зарезервированы; их значение не определено.

  5. VARIANT (0x0009) — код члена семейства.

  6. UID (0x00F4, 12 байт) — уникальный id чипа. Адреса можно менять; UID — нельзя: используйте его как идентичность устройства в любой базе данных.

  7. FW_VER (0x0114, u32) — версия работающей прошивки (используйте для учёта и решений об обновлении). Читайте её как major.minor: старшее слово и младшее слово в десятичной записи. Значение 0x0001007E отображается как прошивка STD 1.126. Версия карты регистров (VERSION, 0x0003) — отдельная величина.

Регистры идентификации

Адрес Имя Тип Значение
0x0000 ID 2×u8 'S','T'
0x0002 ERROR u8 результат последней команды (см. Команды)
0x0003 VERSION u8 версия карты регистров (0x36)
0x0004 CAPABILITIES u16 битовая карта возможностей
0x0006 STATUS u8 биты текущего статуса (см. Диагностика)
0x0007 N_VOLTAGE u8 каналы напряжения, 0..8
0x0008 N_CURRENT u8 токовые каналы, 1..64
0x0009 VARIANT u8 код члена семейства
0x000A HW_REV u8 ревизия аппаратуры
0x000B FW_VERSION u16 маркер линейки прошивки — не версия образа
0x00F4 UID 12×u8 уникальный id чипа
0x0114 FW_VER u32 версия работающей прошивки: старшее слово . младшее слово, десятичная запись (0x0001007E = 1.126)
0x017C BOARD_ID u32 id платы работающего образа (см. ниже)
Безопасность

⚠ Есть два регистра «версия прошивки» по историческим причинам. FW_VERSION (0x000B, u16) только обозначает линейку прошивки. Фактическая монотонно растущая версия — FW_VER (0x0114, u32), показывается как major.minor — используйте её для учёта и решений об обновлении.

BOARD_ID (0x017C)

BOARD_ID определяет плату, для которой собран работающий образ: ("BD" << 16) | channel-count << 8 | VARIANT = 0x4244nnvv — например, 0x42440211 для STD-UI1. Каждый релизный образ несёт то же слово, покрытое проверками целостности и подписи образа; обновление прошивки с другим id платы отклоняется (см. Обновление прошивки). Сверьте BOARD_ID с файлом релиза перед отправкой обновления.

Битовая карта CAPABILITIES (0x0004)

Бит Имя Значение
0 SIGNED мощность и энергия со знаком (импорт/экспорт)
1 REACTIVE Q и S публикуются
2 THD поля THD и смещения-PF работают (0 → эти поля читаются как 0 по I²C, sentinel по нативному Modbus)
3 HARMONICS спектры по гармоникам (промышленный уровень)
4 INDUSTRIAL сборка промышленного уровня
5 HUB_IFACE интерфейс на стороне хаба
6 OTA обновление прошивки по шине
7 ENERGY накопители энергии за окно
8 MULTI_LATCH восемь банков снимков присутствуют — см. Банки снимков
9 ADDR16 адресация 16-битных регистров (всегда 1 у STD)
10 MULTI_CHANNEL более одного токового канала
11 MODBUS_IFACE Транспорт Modbus RTU присутствует
12 RTC батарейные часы на устройстве (0 — время приходит от мастера)
13 ONDEVICE_ENERGY накопленные счётчики энергии, сохранённые на устройстве
14 CHMAP_PERSIST карта модели ТТ по каналам сохраняется (зарезервировано; 0 до реализации)
15 ENERGY_UWH опубликованы счётчики энергии с разрешением µWh (активные µWh и реактивные µvarh) — см. Измерение и энергия

Мастер трактует неизвестные биты как «функция отсутствует» и никогда не полагается на зарезервированные поля.

Правило честных возможностей: модуль сообщает только то, что реально даёт работающая сборка. Например, прошивка трёхфазного модуля сообщает THD = 0 и RTC = 0 (часы подаёт мастер); модули без банков снимков сообщают MULTI_LATCH = 0 (энергия читается из накопительных счётчиков).

Коды VARIANT (0x0009)

Код Член семейства Каналы
0x11 STD-UI1 1 V + 1 I
0x63 STD-U3I3 3 V + 3 I (трёхфазный)

Прочие коды в пространстве перечисления зарезервированы и не должны считаться отсутствующими навсегда; мастер решает по N_VOLTAGE / N_CURRENT и CAPABILITIES, а не по зашитым кодам варианта.

Зеркало обнаружения Modbus

Тот же набор идентификации читается по Modbus как входные регистры по адресу 0x6000: MAGIC 0x6000 · MAP_VERSION 0x6001 · FW_VERSION 0x6002 · HW_REV 0x6003 · CAPABILITIES 0x6004 · N_VOLTAGE 0x6005 · N_CURRENT 0x6006 · VARIANT 0x6007 · TIER 0x6008 · STATUS 0x6009 · ERROR 0x600A · UID 0x600B–0x6010 (12 байт, big-endian по регистрам) · FRAME_CNT 0x6011–12 · FREQ 0x6013 · WINDOW_MS 0x6014 · CMD_SEQ 0x6015 · RING_DROP 0x6016 · WIN_NSAMP 0x6017 · WIN_PERIOD 0x6018 · диагностика CPU 0x6019–0x601C · LOST_FRAMES 0x601D–1E · WIN_SEQ 0x601F. BOARD_ID — holding 0x831B–1C; FW_VER — holding 0x8315–16.