Команды
Все действия устройства проходят через регистр COMMAND (0x0060, u8) — по Modbus это holding 0x8113 (только для записи). Запись ставит код операции в очередь; выполнение происходит в главном цикле устройства (миллисекунды для большинства команд; команды, работающие с флеш, занимают дольше).
Завершение и семантика результата
-
Занят:
CMD_STATE(0x006A) бит 0 = BUSY, пока выполняется команда. BUSY — сигнал завершения — опрашивайте его до 0 перед чтением результата. Новая команда, записанная при BUSY, отбрасывается (бит 1 OVERRUN выставляется; выполняющаяся команда не портится; OVERRUN сбрасывается, когда принимается следующая команда). По Modbus запись COMMAND при занятости → исключение 06. -
Результат:
ERROR(0x0002; readback Modbus holding 0x8114) содержит результат после завершения (0x00 = OK).ERRORчитается как 0xF0 (Modbus 0xFFFF) на всё время выполнения и записывается вместе с завершением; судите о завершении по BUSY, а результат читайте из ERROR после него. -
Свежесть:
CMD_SEQ(0x0067) увеличивается на единицу за каждую завершённую команду — опрашивайте его, чтобы отличить свежий результат от устаревшего. -
Шаблон: проверьте BUSY = 0 → запишите параметры, затем COMMAND → опрашивайте BUSY → 0 (таймауты: ≥1 s для простых команд и сохранений, ≥0.5 s для записи страницы обновления, ≥3 s для COMMIT обновления; на I²C терпите растяжение тактов ≥10 ms и повторяйте NACK-нутые чтения — никогда слепо не переотправляйте запись COMMAND) → читайте
ERROR. Полный разбор: Последовательности D2. -
Команды, перезапускающие модуль (0x02 RESET, 0x13 ACTIVATE, 0x16 ADDR_BY_UID у совпавшего модуля): по Modbus ответ может быть усечён или отсутствовать (а настроенная задержка TX может его подавить); подтвердите, повторно опросив устройство после перезапуска.
Коды ошибок (ERROR 0x0002)
| Код | Имя | Значение |
|---|---|---|
| 0x00 | OK | принято / завершено |
| 0xF0 | PENDING | команда ещё выполняется (с BUSY = 1) |
| 0xF6 | NVM_IO | ошибка записи на постоянное хранение (SAVE_CAL / SAVE_CONFIG / импорт истории) |
| 0xF7 | NO_KEY | аттестация отклонена — ключ устройства не выдан |
| 0xF8 | — | операция отклонена политикой обслуживания |
| 0xF9 | NVM_RATE_LIMIT | перезапись сохранения ограничена по частоте (минимум ~5 s между сохранениями) — повторите позже |
| 0xFA | OP_RETRY | операция уже выполняется · отклонено в текущем состоянии (например, хранилище энергии в FAULT, отрицательное значение приёма) |
| 0xFB | KEY_GATE | команда с ключом без действительного одноразового ключа (LT_KEY) |
| 0xFC | VALUE_CRC | несовпадение CRC страницы обновления (отправьте страницу повторно) · эпоха времени ниже 1600000000 · несовпадение UID (ADDR_BY_UID) · нет такой записи истории (HIST_READ) |
| 0xFD | PARAM | недопустимый параметр / значение конфигурации — ничего не сохранено |
| 0xFE | UNKNOWN_CMD | код операции не поддерживается |
Набор команд
Команды семейства
| Код | Имя | Эффект |
|---|---|---|
| 0x01 | SAVE_CAL | сохранить регистры калибровки (сервис/завод; с UNLOCK по Modbus; ограничено по частоте → 0xF9) |
| 0x02 | RESET | тёплый сброс (с UNLOCK по Modbus; ожидайте отсутствия ответа или обрезанного ответа Modbus) |
| 0x03 | LATCH_PERIOD | на следующей границе окна сделать снимок банка, выбранного LATCH_BANK (0..7; ≥ 8 → 0xFD), и начать его накопление заново — бит возможности 8; иначе 0xFE |
| 0x04 | SAVE_CONFIG | сохранить конфигурацию (чтение-модификация-запись; калибровка не трогается; не с UNLOCK). Значения проверяются по таблице допустимых; недопустимое → 0xFD, ничего не сохраняется; ограничено по частоте → 0xF9; неизменённое сохранение — безопасная операция без изменений (всё равно выставляет CONFIG_CHANGED) |
| 0x06 | SET_TIME | применить эпоху, записанную в TIME_SET/RTC_EPOCH; эпоха < 1600000000 → 0xFC; бит 4 STATUS выставляется сразу |
| 0x07 | ENERGY_RESET | код семейства, закрыт гейтом UNLOCK. Не используется (0xFE / исключение 03) — сброс счётчика выполняется защищённым ключом LT_RESET ниже |
| 0x0E | IDENTIFY | мигать светодиодами 10 s — найти модуль в шкафу. Не закрыто гейтом |
| 0x0F | ATTEST | подписать вызов 32-B по адресу 0x0B80 (карта регистров); ~55 ms; 0xF7 = нет ключа |
| 0x10 | OTA_BEGIN | открыть сессию обновления (Обновление прошивки) |
| 0x11 | OTA_BLOCK_WR | запись одной 256-B страницы (ограничена одной страницей / ~250 ms — BUSY до своего слота) |
| 0x12 | OTA_COMMIT | проверка и взведение подготовленного образа (без сброса); опрашивайте BUSY ≥ 3 s |
| 0x13 | OTA_ACTIVATE | сброс в активированный образ (только когда OTA_STATUS = 2; ~4 s до повторного появления) |
| 0x14 | FW_ABORT | закрыть сессию обновления или снять взведённый образ |
| 0x15 | — | зарезервировано (заводское/сервисное) |
| 0x16 | ADDR_BY_UID | модуль, чей UID совпадает с ADDR_UID, получает подготовленный адрес (адреса), сохраняет их вместе с любыми другими ожидающими изменениями CFG_ и перезапускается; другие модули отвечают 0xFC. Оба новых поля адреса нулевые → 0xFD; недопустимый адрес → 0xFD; ограничение частоты сохранения → 0xF9. Работает при широковещательной рассылке Modbus. Без ограничения доступа |
Защищённые ключом команды (счётчики за весь срок службы и история)
Эти команды меняют состояние, влияющее на учёт, поэтому каждая требует записи соответствующего одноразового ключа в LT_KEY (0x0844 / Modbus holding 0x8142–43, старшее слово первым) непосредственно перед командой. Ключ расходуется любой следующей командой; неверный или отсутствующий ключ → ERROR 0xFB. Это защита от непреднамеренного действия поверх транспорта (не то же, что Modbus UNLOCK).
| Код | Имя | Ключ (u32) | Эффект |
|---|---|---|---|
| 0x08 | HIST_READ | — (без ключа) | прочитать запись, выбранную HIST_PERIOD/HIST_BACK, в HIST_REC; такой записи нет → 0xFC |
| 0x09 | HIST_FLUSH | — (без ключа) | сохранить энергию сейчас: копия удержания всегда; запись NVM только если прошло ≥ 10 s с её последней записи (также подразумевается при RESET и активации обновления) |
| 0x0A | LT_RESET | 0x4C545253 «LTRS» |
обнуляет счётчик полной энергии; счётчик поколений ++ (фиксируется в журнале). Ошибка хранилища FAULT → 0xFA |
| 0x0B | LT_ADOPT | 0x4C544150 «LTAP» |
принять промежуточные значения счётчиков (замена платы / миграция); поколение ++ (фиксируется). Порядок постановки: импорт Wh · экспорт Wh · реактивный импорт varh · реактивный экспорт varh (4×i64); отрицательное значение → 0xFA |
| 0x0C | HIST_WRITE | 0x48494D50 «HIMP» |
импорт 80-B записи из HIST_REC в почасовое кольцо (HIST_PERIOD должен быть 1, иначе 0xFC); метка времени не новее → 0xFD; ошибка NVM I/O → 0xF6 |
| 0x0D | HIST_CLEAR | 0x48434C52 «HCLR» |
пошаговое стирание почасового кольца; повтор во время работы → 0xFA (записывается в журнал) |
Сбросы и принятия счётчиков за весь срок службы и записи истории фиксируются в журнале событий со значениями до и после — они не могут происходить молча.
Сводка по ограничениям доступа (gating)
| Механизм | Область действия | Как |
|---|---|---|
| Modbus UNLOCK | 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15 | ключ 0xA5C3 → holding 0x8112; окно 10 s, одна команда; может идти в одном FC16 с кодом операции (Modbus) |
| LT_KEY | 0x0A–0x0D, оба транспорта | магическое значение команды, одноразовое |
| Белый список широковещательной рассылки | Modbus unit 0 | только установка времени, снимок, адрес по UID (Modbus) |
Без ограничения доступа на обоих транспортах: 0x04, 0x06, 0x08, 0x09, 0x0E, 0x0F, 0x11, 0x16. У I²C нет шага UNLOCK: физический доступ к шине I²C платы — граница доверия установки; команды с ключом всё равно ограничены на обоих транспортах.