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

Обновление прошивки (протокол на стороне хоста)

Обновление прошивки идёт по рабочей шине — 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.

Последовательность

  1. Выбор. Прочитайте FW_ACTIVE_BANK → выберите файл релиза для другого банка. Проверьте BOARD_ID по файлу; при желании проверьте OTA_KEYID.

  2. BEGIN (0x10). Открывает сессию; OTA_STATUS = 1 сразу. Ничего не стирается заранее — секторы флеша стираются при поступлении их первой страницы, поэтому шина и учёт продолжают работать. BEGIN при взведённом образе сначала его разоружает.

  3. BLOCK_WR (0x11) по страницам, по возрастанию. Для каждой непустой 256-B страницы k файла: OTA_IDX = k → 256 B в OTA_PAYLOAD → (необязательно) OTA_PCRC_EXP = CRC-32 страницы → команда 0x11 → опрашивайте BUSY до 0 (ждите до ~0.5 s).

  4. Отправляйте страницы по возрастанию; страница 0 должна быть первой страницей сессии (иначе COMMIT отклоняет с причиной 13); пропускайте страницы, полностью состоящие из 0xFF. Заголовочная страница (OTA_BANK_SIZE/256 − 1) не обязана быть последней — возрастающий порядок отправляет её последней естественным образом.

  5. После каждой страницы проверьте, что OTA_STATUS по-прежнему 1. ERROR 0xFC = полезная нагрузка пришла повреждённой → перезапишите полезную нагрузку и повторите страницу (идентичная повторная отправка уже записанной страницы принимается). OTA_STATUS 3 = сессия провалилась (читайте OTA_DIAG; другие данные для уже записанной страницы — одна из причин); последующие записи страниц игнорируются; начинайте заново с BEGIN.

  6. Ограничение: устройство программирует не более одной страницы за ~250 ms (команда просто остаётся BUSY до своего слота) — учёт имеет приоритет. Полный образ занимает ~1–3 minutes.

  7. По I²C ожидайте растяжение тактов до ~9 ms и терпите NACK в окне записи (транспорт I²C). Modbus не затрагивается.

  8. COMMIT (0x12). Опрашивайте BUSY с таймаутом ≥ 3 s: устройство стирает секторы, которых не коснулась ни одна страница, затем проверяет образ — целостность, подлинность, версию, ID платы. Результат:

  9. OTA_STATUS 2 — проверено и взведено; FW_STAGED_VERSION = новая версия. Модуль всё ещё работает со старым образом. Потеря питания после COMMIT загружает взведённый образ (это безопасно — он и есть целевой).

  10. 3 — отклонено; OTA_DIAG объясняет почему (ниже).

  11. 4 — версия старше работающей; ничего не изменено.
  12. ACTIVATE (0x13), когда установка готова к перезапуску — сначала проверьте OTA_STATUS = 2 (не взведён → команда ничего не делает, ERROR остаётся 0). Энергия сбрасывается, модуль перезагружается и снова появляется примерно через 4 s (по Modbus ответ на ACTIVATE может отсутствовать или быть усечён). Новый образ загружается пробным под аппаратным сторожевым таймером и подтверждает себя после ~8 s исправного учёта. Любой сброс до подтверждения откатывает — не сбрасывайте модуль примерно 10 s после активации. Проверка после: переключился FW_ACTIVE_BANK, FW_VER = новая версия, SWAP_PENDING 2 → 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 взведённый образ — намеченный; неудачная пробная версия откатывается.

  • Калибровка, конфигурация, счётчики энергии, история, журнал событий и идентичность устройства хранятся вне банков прошивки — обновление их никогда не затрагивает.

  • Фиксация прошивки записывается в журнал событий вместе с переходом версии.