Идентификация и обнаружение
Как хост распознаёт модуль STD, что это за модуль и что он умеет. Все регистры этой главы только для чтения, если не указано иное. Адреса I²C; зеркала обнаружения Modbus перечислены в конце.
Последовательность обнаружения
При первом контакте мастер читает блок идентификации по 0x0000 и по нему открывает всё остальное:
ID(0x0000, 2 байта) должен читаться как'S','T'(0x53, 0x54) — иначе это не модуль STD.-
VERSION(0x0003) — это версия раскладки карты регистров (текущая:0x36). Новые функции повышают её; мастер ограничивает функции карты по ней. -
CAPABILITIES(0x0004, u16) — битовая карта возможностей, см. ниже. Бит 9 (адресация 16 бит) всегда установлен на STD. -
N_VOLTAGE(0x0007) /N_CURRENT(0x0008) — сколько каналов заполнено. Блоки каналов с индексом ≥ N зарезервированы; их значение не определено. -
VARIANT(0x0009) — код члена семейства. -
UID(0x00F4, 12 байт) — уникальный id чипа. Адреса можно менять; UID — нельзя: используйте его как идентичность устройства в любой базе данных. -
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.