Последовательности — пошаговые потоки управления
Канонические сценарии для хоста. Каждый шаг называет регистр (адрес I²C; Modbus — в скобках) и то, что проверить. Правила опроса команд, используемые здесь везде, заданы один раз в D2.
D1 — Включение / обнаружение
-
Прочитайте 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. -
Прочитайте
UID0x00F4 (12 B) — идентичность устройства для вашей базы;FW_VER0x0114 (u32, версия образа);BOARD_ID0x017C. -
Дождитесь живых данных:
WIN_SEQ(0x0016) ≠ 0 и увеличивается, бит 1STATUS(sensor_ok) = 1 — подождите ~1 s после загрузки (готовность после загрузки). -
Если бит 4
STATUS(time_valid) = 0 → задайте часы (D2, SET_TIME). - Условие здоровья: cal_ok или
CAL_SRC(0x0872) ∈ {1, 2};LTA_STATUS(0x0870) ≤ 1. - Заново задайте состояние ОЗУ:
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 — Выполнение команды
- Проверка простоя:
CMD_STATE(0x006A; holding 0x8116) бит 0 = 0. -
Запишите регистры параметров команды, затем код операции в
COMMAND(0x0060; holding 0x8113 — для защищённого по Modbus кода отправьте один FC16{0x8112 = 0xA5C3, 0x8113 = opcode}; исключение 06 = занято, исключение 03 = неизвестный код операции или нет разблокировки). -
Опрашивайте
CMD_STATEбит 0 → 0. Таймауты: ≥ 1 s для простых команд и сохранений · ≥ 0.5 s запись страницы обновления · ≥ 3 s COMMIT обновления. По I²C терпите растяжение тактов ≥ 10 ms; повторяйте NACK на чтениях; никогда не отправляйте команду COMMAND вслепую повторно (дубликат будет отброшен как OVERRUN, но вы потеряете, какая запись прошла). -
Прочитайте
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 — Конфигурация
- Запишите нужные регистры
CFG_*(0x0070–0x0085; holding 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (не закрыт гейтом UNLOCK) → D2.ERROR0xFD = недопустимое значение, ничего не сохранено · 0xF9 = ограничение частоты, повторите примерно через 5 s · 0xF6 = ошибка ввода-вывода хранилища. -
Если изменение требует перезапуска (адрес I²C, Modbus unit/baud/frame/tx-delay,
CFG_VIRTUAL_IDS):COMMAND0x02 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 (несколько модулей на одном адресе, оба транспорта):
-
I²C: одна запись 0x00E0: UID (12 B) + новый I²C-адрес (0x00EC, или 0) + новый Modbus unit (0x00ED, или 0). Modbus: FC16 0x8118–0x811E (пары байтов UID + 0x811E = addr<<8 | unit) — широковещательная рассылка разрешена.
-
COMMAND0x16 (FC06 0x8113 = 0x0016; широковещание разрешено). -
Подходящий модуль сохраняет (вместе с любыми подготовленными значениями CFG_) и перезапускается; все остальные модули отвечают
ERROR0xFC. Оба новых поля адреса 0 или недопустимый адрес → 0xFD; ограничение частоты сохранения → 0xF9. -
Опросите модуль по новому адресу / unit; идентифицируйте по UID.
D5 — Энергия: чтение, сброс, принятие
Чтение (на каждой границе интервала, по вашим часам):
-
Одна транзакция I²C ≤ 128 B по 0x0800–0x0843: счётчики Wh, счётчики mWh,
LT_GEN(согласованный снимок). ПлюсUPTIME0x08A0. 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). -
Интервальная энергия = дельта счётчиков mWh (счётчики µWh, если нужна более тонкая разрешающая способность).
- Изменился
LT_GEN→ не берите дельту; заново задайте точку отсчёта (кто-то сбросил или принял счётчики — см. журнал событий). 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 — История и журнал событий
-
HIST_PERIOD0x0C00 (holding 0x8160): 0 = последние 15 min (тогдаHIST_BACKдолжен быть 0) · 1 = часовое кольцо · 2 = журнал событий. -
HIST_BACK0x0C04 (holding 0x8163) = n, 0 = самая новая. COMMAND0x08 HIST_READ → D2.ERROR0xFC = такой записи нет.-
При успехе:
HIST_FLAGS0x0C02 бит 0 = 1; читайтеHIST_COUNT/HIST_RECSZ(80 история / 32 событие) /HIST_OLDEST/HIST_NEWEST, чтобы сопоставить метки времени с индексами. -
Прочитайте запись по 0x0C20 (
HIST_RECSZбайт, одной транзакцией; Modbus holding 0x8180+ пары байтов). Структуры: Измерения и энергия. -
Переберите
HIST_BACK= 0 … COUNT−1, чтобы прочитать записи; правила разности — по FLAGS записи.
D7 — Обновление прошивки
FW_ACTIVE_BANK0x0156 (holding 0x8301) → выберите файл релиза для другого банка.-
Условие:
BOARD_ID0x017C == слово платы файла; версия файла ≥FW_VER0x0114; прочитайтеOTA_BANK_SIZE0x014C (никогда не вписывайте его в код). -
(Modbus: UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (holding 0x8300) = 1. -
По каждой непустой 256-B странице, по возрастанию, страница 0 первой:
OTA_IDX0x0144 = k · полезная нагрузка → 0x0500 (Modbus: два FC16 по 64 регистра на 0x8380/0x83C0) · необязательноOTA_PCRC_EXP0x0170 = CRC-32 страницы ·COMMAND0x11 (не закрыто гейтом) · опрашивайте BUSY (≤ ~0.5 s) ·ERROR0xFC → переотправьте полезную нагрузку, повторите страницу · проверьте, чтоOTA_STATUSпо-прежнему 1 (3 → читайтеOTA_DIAG0x0180, начните заново с BEGIN). -
(UNLOCK)
COMMAND0x12 COMMIT → опрашивайте BUSY ≥ 3 s →OTA_STATUS: 2 = взведён (FW_STAGED_VERSION0x0150 = новая версия) · 3 = отклонён (причины 7–15 вOTA_DIAG) · 4 = более низкая версия. -
Только когда status = 2: (UNLOCK)
COMMAND0x13 ACTIVATE — нет ответа или обрезанный ответ Modbus; модуль возвращается примерно через ~4 s. Либо (UNLOCK)COMMAND0x14 FW_ABORT — отбросить взведённый образ. -
Не сбрасывайте модуль примерно 10 s (пробный запуск и самоподтверждение), затем проверьте: переключился
FW_ACTIVE_BANK·FW_VER= новая версия ·SWAP_PENDING0x011C = 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.