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

Команды

Все действия устройства проходят через регистр 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 платы — граница доверия установки; команды с ключом всё равно ограничены на обоих транспортах.