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

Последовательности — пошаговые потоки управления

Канонические сценарии для хоста. Каждый шаг называет регистр (адрес I²C; Modbus — в скобках) и то, что проверить. Правила опроса команд, используемые здесь везде, заданы один раз в D2.

D1 — Включение / обнаружение

  1. Прочитайте 12 байт по 0x0000 одной транзакцией: ID = 'S','T' · VERSION ≥ 0x36 · CAPABILITIES (ожидайте бит 9; бит THD 2 = 0, бит банков снимков 8 = 1 при наличии банков, бит энергии на устройстве 13 = 1) · STATUS · N_VOLTAGE / N_CURRENT · VARIANT (UI1 0x11 = 1/1, 0x63 = 3/3) · HW_REV / FW_VERSION.

  2. Прочитайте UID 0x00F4 (12 B) — идентичность устройства для вашей базы; FW_VER 0x0114 (u32, версия образа); BOARD_ID 0x017C.

  3. Дождитесь живых данных: WIN_SEQ (0x0016) ≠ 0 и увеличивается, бит 1 STATUS (sensor_ok) = 1 — подождите ~1 s после загрузки (готовность после загрузки).

  4. Если бит 4 STATUS (time_valid) = 0 → задайте часы (D2, SET_TIME).

  5. Условие здоровья: cal_ok или CAL_SRC (0x0872) ∈ {1, 2}; LTA_STATUS (0x0870) ≤ 1.
  6. Заново задайте состояние ОЗУ: EVENT_MASK (0x00C1), THRESH_I/P (0x00C4/0x00C8); подтвердите загрузку, сбросив RESET_OCCURRED — запишите 0x20 в EVENT_FLAGS (0x00C0).

Modbus: тот же набор идентификации — input 0x6000–0x601F (зеркало); FW_VER holding 0x8315–16, BOARD_ID holding 0x831B–1C.

D2 — Выполнение команды

  1. Проверка простоя: CMD_STATE (0x006A; holding 0x8116) бит 0 = 0.
  2. Запишите регистры параметров команды, затем код операции в COMMAND (0x0060; holding 0x8113 — для защищённого по Modbus кода отправьте один FC16 {0x8112 = 0xA5C3, 0x8113 = opcode}; исключение 06 = занято, исключение 03 = неизвестный код операции или нет разблокировки).

  3. Опрашивайте CMD_STATE бит 0 → 0. Таймауты: ≥ 1 s для простых команд и сохранений · ≥ 0.5 s запись страницы обновления · ≥ 3 s COMMIT обновления. По I²C терпите растяжение тактов ≥ 10 ms; повторяйте NACK на чтениях; никогда не отправляйте команду COMMAND вслепую повторно (дубликат будет отброшен как OVERRUN, но вы потеряете, какая запись прошла).

  4. Прочитайте ERROR (0x0002; holding 0x8114) после BUSY = 0: 0x00 = OK, коды в Команды. По желанию проверьте, что CMD_SEQ (0x0067) вырос на 1, а OVERRUN (бит 1) = 0.

Установка времени (самая частая команда): запишите эпоху u32 LE в TIME_SET 0x08C0 (Modbus FC16 0x8100 = старшее слово, 0x8101 = младшее — при широковещании это отдельный кадр, команда идёт вторым кадром) → COMMAND 0x06 → опрос → ERROR 0xFC = эпоха ниже 1600000000. Бит 4 STATUS выставляется сразу.

D3 — Конфигурация

  1. Запишите нужные регистры CFG_* (0x0070–0x0085; holding 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (не закрыт гейтом UNLOCK) → D2. ERROR 0xFD = недопустимое значение, ничего не сохранено · 0xF9 = ограничение частоты, повторите примерно через 5 s · 0xF6 = ошибка ввода-вывода хранилища.

  3. Если изменение требует перезапуска (адрес I²C, Modbus unit/baud/frame/tx-delay, CFG_VIRTUAL_IDS): COMMAND 0x02 RESET (с UNLOCK по Modbus; ожидайте отсутствия или обрезанного ответа Modbus) и повторно опросите устройство через ~1 s.

CFG_LED и CFG_WORD_ORDER действуют сразу после записи, но откатываются при загрузке, если не сохранены. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S — сохраняемые служебные метаданные.

D4 — Смена адреса и последовательного интерфейса

Адрес I²C (известное устройство): CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 и ERROR 0 → RESET → подождите ~1 s → проверьте ID = 'S','T' по новому адресу.

Последовательный порт Modbus: holding 0x8000 unit (1–247) / 0x8001 baud (0–10) / 0x8002 frame / 0x8003 TX delay (проверяется при записи — исключение 03) → FC06 0x8113 = 0x0004 → опрос 0x8114 = 0 → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (ответ может потеряться) → переподключитесь с новыми настройками.

По UID (несколько модулей на одном адресе, оба транспорта):

  1. I²C: одна запись 0x00E0: UID (12 B) + новый I²C-адрес (0x00EC, или 0) + новый Modbus unit (0x00ED, или 0). Modbus: FC16 0x8118–0x811E (пары байтов UID + 0x811E = addr<<8 | unit) — широковещательная рассылка разрешена.

  2. COMMAND 0x16 (FC06 0x8113 = 0x0016; широковещание разрешено).

  3. Подходящий модуль сохраняет (вместе с любыми подготовленными значениями CFG_) и перезапускается; все остальные модули отвечают ERROR 0xFC. Оба новых поля адреса 0 или недопустимый адрес → 0xFD; ограничение частоты сохранения → 0xF9.

  4. Опросите модуль по новому адресу / unit; идентифицируйте по UID.

D5 — Энергия: чтение, сброс, принятие

Чтение (на каждой границе интервала, по вашим часам):

  1. Одна транзакция I²C ≤ 128 B по 0x0800–0x0843: счётчики Wh, счётчики mWh, LT_GEN (согласованный снимок). Плюс UPTIME 0x08A0. Modbus: input 0x6B00/0x6B14 + holding 0x8140. Бит возможности 15: те же счётчики с разрешением µWh — общий по 0x08D0 (3×i64; Modbus input 0x6BB0), по каналам по 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8) — тот же снимок, что и поля mWh (imp/exp mWh = floor(µWh/1000); net = imp − exp в тех же единицах), те же правила дельт / поколений / перезапусков. Модуль также публикует общий реактивный µvarh по 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, не подряд): согласованное чтение с тонким разрешением — одной транзакцией по 0x08D0–0x08F7 (40 B).

  2. Интервальная энергия = дельта счётчиков mWh (счётчики µWh, если нужна более тонкая разрешающая способность).

  3. Изменился LT_GEN → не берите дельту; заново задайте точку отсчёта (кто-то сбросил или принял счётчики — см. журнал событий).
  4. UPTIME уменьшился → модуль перезапустился: дельта = max(0, Δ) (может не хватать примерно последней секунды энергии), заново передайте время (D2).

Сброс (намеренный, записывается в журнал): LT_KEY 0x0844 = 0x4C545253 («LTRS»; Modbus FC16 0x8142–43, сначала старшее слово) → сразу COMMAND 0x0A (любая команда расходует ключ) → D2. ERROR 0xFB = ключ неверный или отсутствует · 0xFA = сбой хранилища. UNLOCK по Modbus не нужен — гейт это ключ. (Код операции семейства 0x07 ENERGY_RESET не используется: 0xFE / исключение 03.)

Приём (замена платы или миграция): подготовьте 4×i64 в LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) в порядке: импорт Wh · экспорт Wh · реактивный импорт varh · реактивный экспорт varh → LT_KEY = 0x4C544150 («LTAP») → COMMAND 0x0B. Отрицательное значение → 0xFA. И сброс, и приём увеличивают LT_GEN и попадают в журнал событий со значениями до и после.

D6 — История и журнал событий

  1. HIST_PERIOD 0x0C00 (holding 0x8160): 0 = последние 15 min (тогда HIST_BACK должен быть 0) · 1 = часовое кольцо · 2 = журнал событий.

  2. HIST_BACK 0x0C04 (holding 0x8163) = n, 0 = самая новая.

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = такой записи нет.
  4. При успехе: HIST_FLAGS 0x0C02 бит 0 = 1; читайте HIST_COUNT / HIST_RECSZ (80 история / 32 событие) / HIST_OLDEST / HIST_NEWEST, чтобы сопоставить метки времени с индексами.

  5. Прочитайте запись по 0x0C20 (HIST_RECSZ байт, одной транзакцией; Modbus holding 0x8180+ пары байтов). Структуры: Измерения и энергия.

  6. Переберите HIST_BACK = 0 … COUNT−1, чтобы прочитать записи; правила разности — по FLAGS записи.

D7 — Обновление прошивки

  1. FW_ACTIVE_BANK 0x0156 (holding 0x8301) → выберите файл релиза для другого банка.
  2. Условие: BOARD_ID 0x017C == слово платы файла; версия файла ≥ FW_VER 0x0114; прочитайте OTA_BANK_SIZE 0x014C (никогда не вписывайте его в код).

  3. (Modbus: UNLOCK) COMMAND 0x10 BEGIN → D2 → OTA_STATUS 0x0140 (holding 0x8300) = 1.

  4. По каждой непустой 256-B странице, по возрастанию, страница 0 первой: OTA_IDX 0x0144 = k · полезная нагрузка → 0x0500 (Modbus: два FC16 по 64 регистра на 0x8380/0x83C0) · необязательно OTA_PCRC_EXP 0x0170 = CRC-32 страницы · COMMAND 0x11 (не закрыто гейтом) · опрашивайте BUSY (≤ ~0.5 s) · ERROR 0xFC → переотправьте полезную нагрузку, повторите страницу · проверьте, что OTA_STATUS по-прежнему 1 (3 → читайте OTA_DIAG 0x0180, начните заново с BEGIN).

  5. (UNLOCK) COMMAND 0x12 COMMIT → опрашивайте BUSY ≥ 3 s → OTA_STATUS: 2 = взведён (FW_STAGED_VERSION 0x0150 = новая версия) · 3 = отклонён (причины 7–15 в OTA_DIAG) · 4 = более низкая версия.

  6. Только когда status = 2: (UNLOCK) COMMAND 0x13 ACTIVATE — нет ответа или обрезанный ответ Modbus; модуль возвращается примерно через ~4 s. Либо (UNLOCK) COMMAND 0x14 FW_ABORT — отбросить взведённый образ.

  7. Не сбрасывайте модуль примерно 10 s (пробный запуск и самоподтверждение), затем проверьте: переключился FW_ACTIVE_BANK · FW_VER = новая версия · SWAP_PENDING 0x011C = 0. Старый FW_VER = откат; читайте OTA_DIAG.

D8 — Разблокирование Modbus

FC06 holding 0x8112 = 0xA5C3 → действует 10 s, расходуется одной командой с ограничением; неверное значение сбрасывает активное разблокирование; отсутствует или истекло → исключение 03 на команде с ограничением. Ключ и код операции могут идти в одном FC16 на 0x8112–0x8113.

С ограничением: 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Без ограничения: 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.