Обновление прошивки (протокол на стороне хоста)
Обновление прошивки идёт по рабочей шине — I²C или Modbus RTU — без программатора и без демонтажа (OTA). Версия прошивки показывается как major.minor от FW_VER (0x0114), например прошивка STD 1.126. Устройство хранит два банка прошивки: хост записывает новый образ в неактивный банк, устройство проверяет его и взводит, а отдельная активация перезагружает в него. Неудачный или зависающий новый образ откатывается автоматически к предыдущему рабочему.
Измерение продолжается во время обновления. Обновление уступает измерению (не более одной записи страницы примерно за ~250 ms); несколько кадров измерения, потерянных при каждой записи во флеш, компенсируются в счётчиках энергии.
Файлы релиза
Релиз поставляется с подготовленными образами банков — подписанными и зашифрованными на сборочной машине. Хост передачи передаёт файл как есть; он никогда не собирает, не правит и не переупаковывает образ:
-
Два файла на релиз, по одному на банк (A / B). Прочитайте
FW_ACTIVE_BANK(0x0156): 0 = работает A → отправьте файл B, и наоборот. -
Сравните ID платы релиза с
BOARD_ID(0x017C) в первую очередь — образ, собранный для другой платы, отклоняется при проверке (причина 15). -
Версия строго ниже работающей отклоняется (защита от понижения, статус 4); та же версия принимается. Возврат к более старой версии возможен только через собственный путь отката устройства, а не отправкой старого образа.
Регистры
I²C (Modbus holding в скобках; u32 = 2 регистра, старшее слово первым):
| Рег | Адрес | Значение |
|---|---|---|
| OTA_STATUS | 0x0140 (0x8300) | 0 простой · 1 готов / сессия открыта · 2 взведён · 3 ошибка · 4 понижение отклонено |
| OTA_IDX | 0x0144 (0x8302–03, rw) | 256-B индекс страницы для следующей записи страницы |
| OTA_ACTIVE | 0x0148 (0x8306–07) | база текущего банка (непрозрачная) |
| OTA_BANK_SIZE | 0x014C (0x8304–05) | размер банка — сообщается устройством; индекс страницы заголовка = size/256 − 1 |
| FW_STAGED_VERSION | 0x0150 (0x8308–09) | версия взведённого образа (0 = нет) |
| FW_ACTIVE_BANK | 0x0156 (0x8301) | 0 = A · 1 = B |
| OTA_PCRC_EXP | 0x0170 (0x8310–11, w) | необязательный ожидаемый CRC-32 следующей страницы |
| OTA_PCRC_RX | 0x0174 (0x8312–13) | CRC-32 страницы в том виде, как она получена |
| OTA_KEYID | 0x0178 (0x8319–1A) | id ключа образа, который принимает эта прошивка |
| OTA_DIAG | 0x0180 (0x8314: причина | статус<<8) | диагностика отказов |
| OTA_PAYLOAD | 0x0500, 256 B (пары байт 0x8380–0x83FF) | буфер страницы |
| FW_VER / SWAP_PENDING | 0x0114 / 0x011C (0x8315–16 / 0x8317–18) | версия работающего образа / состояние переключения: 0 подтверждён · 1 взведён · 2 пробный |
Команды (COMMAND 0x0060 / holding 0x8113): 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. По Modbus BEGIN/COMMIT/ACTIVATE/FW_ABORT закрыты гейтом UNLOCK; BLOCK_WR — нет. После каждой команды опрашивайте CMD_STATE (0x006A / 0x8116), пока BUSY не станет 0, затем читайте OTA_STATUS / ERROR.
Последовательность
-
Выбор. Прочитайте
FW_ACTIVE_BANK→ выберите файл релиза для другого банка. ПроверьтеBOARD_IDпо файлу; при желании проверьтеOTA_KEYID. -
BEGIN (0x10). Открывает сессию;
OTA_STATUS= 1 сразу. Ничего не стирается заранее — секторы флеша стираются при поступлении их первой страницы, поэтому шина и учёт продолжают работать. BEGIN при взведённом образе сначала его разоружает. -
BLOCK_WR (0x11) по страницам, по возрастанию. Для каждой непустой 256-B страницы k файла:
OTA_IDX= k → 256 B вOTA_PAYLOAD→ (необязательно)OTA_PCRC_EXP= CRC-32 страницы → команда 0x11 → опрашивайте BUSY до 0 (ждите до ~0.5 s). -
Отправляйте страницы по возрастанию; страница 0 должна быть первой страницей сессии (иначе COMMIT отклоняет с причиной 13); пропускайте страницы, полностью состоящие из 0xFF. Заголовочная страница (
OTA_BANK_SIZE/256 − 1) не обязана быть последней — возрастающий порядок отправляет её последней естественным образом. -
После каждой страницы проверьте, что
OTA_STATUSпо-прежнему 1.ERROR0xFC = полезная нагрузка пришла повреждённой → перезапишите полезную нагрузку и повторите страницу (идентичная повторная отправка уже записанной страницы принимается).OTA_STATUS3 = сессия провалилась (читайтеOTA_DIAG; другие данные для уже записанной страницы — одна из причин); последующие записи страниц игнорируются; начинайте заново с BEGIN. -
Ограничение: устройство программирует не более одной страницы за ~250 ms (команда просто остаётся BUSY до своего слота) — учёт имеет приоритет. Полный образ занимает ~1–3 minutes.
-
По I²C ожидайте растяжение тактов до ~9 ms и терпите NACK в окне записи (транспорт I²C). Modbus не затрагивается.
-
COMMIT (0x12). Опрашивайте BUSY с таймаутом ≥ 3 s: устройство стирает секторы, которых не коснулась ни одна страница, затем проверяет образ — целостность, подлинность, версию, ID платы. Результат:
-
OTA_STATUS2 — проверено и взведено;FW_STAGED_VERSION= новая версия. Модуль всё ещё работает со старым образом. Потеря питания после COMMIT загружает взведённый образ (это безопасно — он и есть целевой). -
3 — отклонено;
OTA_DIAGобъясняет почему (ниже). - 4 — версия старше работающей; ничего не изменено.
- ACTIVATE (0x13), когда установка готова к перезапуску — сначала проверьте
OTA_STATUS= 2 (не взведён → команда ничего не делает,ERRORостаётся 0). Энергия сбрасывается, модуль перезагружается и снова появляется примерно через 4 s (по Modbus ответ на ACTIVATE может отсутствовать или быть усечён). Новый образ загружается пробным под аппаратным сторожевым таймером и подтверждает себя после ~8 s исправного учёта. Любой сброс до подтверждения откатывает — не сбрасывайте модуль примерно 10 s после активации. Проверка после: переключилсяFW_ACTIVE_BANK,FW_VER= новая версия,SWAP_PENDING2 → 0; если работает старыйFW_VER— произошёл откат. FW_ABORT (0x14) вместо ACTIVATE отбрасывает взведённый образ и закрывает сессию.
Диагностика отказов (OTA_DIAG 0x0180)
Байт 0 = причина · байт 1 = внутренний статус · затем смещение, страница/длина и контрольные значения.
| Причина | Значение | Причина | Значение |
|---|---|---|---|
| 1 | индекс страницы вне диапазона | 9 | проверка целостности образа не пройдена |
| 2/3 | ошибка стирания / проверка стирания не пройдена | 10 | аутентификация не пройдена |
| 4 | другие данные для уже записанной страницы (сессия прервалась — начните заново с BEGIN) | 11 | понижение версии |
| 5/6 | программа завершилась с ошибкой / проверка не пройдена | 12 | ошибка записи подмены |
| 7 | неверный заголовок образа | 13 | образ не запечатан / неполный (например, не пришли страница 0 или страница заголовка) |
| 8 | заголовочная страница так и не пришла | 14 | подпись недействительна |
| 15 | образ собран для другой платы (контрольное значение = слово платы образа) |
Все отказы аутентификации сообщаются как OTA_STATUS 3 с причиной здесь — отдельных значений статуса обрабатывать не нужно. По Modbus зеркалируются только причина и внутренний статус (holding 0x8314); детали смещения, страницы и контрольной суммы OTA_DIAG доступны по I²C.
Свойства безопасности (на что может опираться хост)
- Двухфазное: COMMIT никогда не перезагружает; момент перезапуска выбирает хост (окно обслуживания).
-
Отключение питания в любой момент безопасно: до COMMIT работает старый образ; после COMMIT взведённый образ — намеченный; неудачная пробная версия откатывается.
-
Калибровка, конфигурация, счётчики энергии, история, журнал событий и идентичность устройства хранятся вне банков прошивки — обновление их никогда не затрагивает.
-
Фиксация прошивки записывается в журнал событий вместе с переходом версии.