Actualización de firmware (protocolo del lado del host)
Las actualizaciones de firmware se hacen por el bus de trabajo — I²C o Modbus RTU — sin programador y sin desmontaje (OTA). La versión del firmware se muestra como major.minor de FW_VER (0x0114), por ejemplo, firmware STD 1.126. El dispositivo guarda dos bancos de firmware; el host escribe la imagen nueva en el banco inactivo, el dispositivo la verifica y la arma, y una activación independiente reinicia en ella. Una imagen nueva defectuosa o que se bloquea vuelve atrás automáticamente a la anterior que funcionaba.
La medida continúa durante la actualización. La actualización cede el paso a la medida (como máximo una escritura de página cada ~250 ms); los pocos tramas de medida perdidas en cada escritura en memoria flash se compensan en los contadores de energía.
Archivos de publicación
Una versión incluye imágenes de banco preparadas, firmadas y cifradas en el equipo de compilación. El equipo de transporte envía el archivo tal cual; nunca compila, edita ni vuelve a envolver una imagen:
-
Dos archivos por versión, uno por banco (A / B). Lea
FW_ACTIVE_BANK(0x0156): 0 = A en ejecución → envíe el archivo B, y viceversa. -
Compare primero el id de placa de la versión con
BOARD_ID(0x017C): una imagen construida para otra placa se rechaza en la verificación (motivo 15). -
Una versión estrictamente inferior a la que está en ejecución se rechaza (protección contra degradación, estado 4); la misma versión se acepta. Volver a una versión anterior solo es posible por la vía de reversión propia del dispositivo, no enviando una imagen antigua.
Registros
I²C (retenido de Modbus entre corchetes; u32 = 2 registros, palabra alta primero):
| Reg | Dir. | Significado |
|---|---|---|
| OTA_STATUS | 0x0140 (0x8300) | 0 inactivo · 1 listo / sesión abierta · 2 armado · 3 error · 4 degradación rechazada |
| OTA_IDX | 0x0144 (0x8302–03, lectura/escritura) | índice de página de 256 B para la siguiente escritura de página |
| OTA_ACTIVE | 0x0148 (0x8306–07) | base del banco en ejecución (opaco) |
| OTA_BANK_SIZE | 0x014C (0x8304–05) | tamaño del banco: informado por el dispositivo; índice de la página de cabecera = tamaño/256 − 1 |
| FW_STAGED_VERSION | 0x0150 (0x8308–09) | versión de la imagen armada (0 = ninguna) |
| FW_ACTIVE_BANK | 0x0156 (0x8301) | 0 = A · 1 = B |
| OTA_PCRC_EXP | 0x0170 (0x8310–11, w) | CRC-32 esperado opcional de la siguiente página |
| OTA_PCRC_RX | 0x0174 (0x8312–13) | CRC-32 de la página tal como se recibió |
| OTA_KEYID | 0x0178 (0x8319–1A) | id de clave de imagen que acepta este firmware |
| OTA_DIAG | 0x0180 (0x8314: motivo | estado<<8) | diagnóstico de fallos |
| OTA_PAYLOAD | 0x0500, 256 B (0x8380–0x83FF pares de bytes) | búfer de página |
| FW_VER / SWAP_PENDING | 0x0114 / 0x011C (0x8315–16 / 0x8317–18) | versión en ejecución / estado de conmutación 0 confirmado · 1 armado · 2 de prueba |
Comandos (COMMAND 0x0060 / retenido 0x8113): 0x10 BEGIN · 0x11 BLOCK_WR · 0x12 COMMIT · 0x13 ACTIVATE · 0x14 FW_ABORT. Por Modbus, BEGIN/COMMIT/ACTIVATE/FW_ABORT están condicionados a UNLOCK; BLOCK_WR no lo está. Tras cada comando sondee CMD_STATE (0x006A / 0x8116) hasta BUSY = 0, y después lea OTA_STATUS / ERROR.
Secuencia
-
Seleccione. Lea
FW_ACTIVE_BANK→ elija el archivo de publicación para el otro banco. CompruebeBOARD_IDfrente al archivo; opcionalmente, compruebeOTA_KEYID. -
BEGIN (0x10). Abre la sesión;
OTA_STATUS= 1 de inmediato. No se borra nada por adelantado: los sectores de flash se borran al llegar su primera página, así que el bus y la medición siguen en marcha. Un BEGIN con una imagen armada la desarma primero. -
BLOCK_WR (0x11) por página, en orden ascendente. Para cada página k de 256 B no vacía del archivo:
OTA_IDX= k → 256 B enOTA_PAYLOAD→ (opcional)OTA_PCRC_EXP= CRC-32 de la página → comando 0x11 → sondee BUSY hasta 0 (espere hasta ~0.5 s). -
Envíe las páginas en orden ascendente; la página 0 debe ser la primera de la sesión (si no, COMMIT rechaza con el motivo 13); omita las páginas que son todas 0xFF. La página de cabecera (
OTA_BANK_SIZE/256 − 1) no tiene que ser la última — el orden ascendente la envía en último lugar de forma natural. -
Tras cada comprobación de página,
OTA_STATUSsigue en 1.ERROR0xFC = la carga útil llegó corrupta → reescriba la carga útil y repita la página (un reenvío idéntico de una página ya escrita se acepta).OTA_STATUS3 = la sesión falló (leaOTA_DIAG; datos distintos para una página ya escrita son una de las causas): las escrituras de páginas posteriores se ignoran; empiece de nuevo con BEGIN. -
Limitación: el dispositivo programa como máximo una página cada ~250 ms (el comando simplemente sigue en BUSY hasta su turno); la medición tiene prioridad. Una imagen completa tarda ~1–3 minutos.
-
En I²C, espere estiramiento de reloj de hasta ~9 ms y tolere NACK durante la ventana de escritura (transporte I²C). Modbus no se ve afectado.
-
COMMIT (0x12). Sondee BUSY con un tiempo límite de ≥ 3 s: el dispositivo borra los sectores que ninguna página tocó y después verifica la imagen: integridad, autenticidad, versión e id de placa. Resultado:
-
OTA_STATUS2: verificada y armada;FW_STAGED_VERSION= nueva versión. El módulo sigue ejecutando la imagen anterior. Una pérdida de alimentación tras COMMIT arranca la imagen armada (seguro: es la prevista). -
3: rechazado;
OTA_DIAGindica el motivo (abajo). - 4: versión anterior a la que está en ejecución; no cambió nada.
- ACTIVATE (0x13) cuando la instalación está lista para un reinicio: compruebe antes que
OTA_STATUS= 2 (si no está armada, el comando no hace nada yERRORsigue en 0). Se vuelca la energía, el módulo se reinicia y reaparece en ~4 s (por Modbus, la respuesta a ACTIVATE puede faltar o estar truncada). La nueva imagen arranca en modo de prueba bajo un watchdog de hardware y se confirma sola tras ~8 s de medición correcta. Cualquier reinicio antes de la confirmación revierte: no reinicie el módulo durante ~10 s tras la activación. Verifique después:FW_ACTIVE_BANKcambiado,FW_VER= nueva versión,SWAP_PENDING2 → 0; si sigue en ejecución laFW_VERantigua, se revirtió. FW_ABORT (0x14) en lugar de ACTIVATE descarta la imagen armada y cierra la sesión.
Diagnóstico de fallos (OTA_DIAG 0x0180)
Byte 0 = motivo · byte 1 = estado interno · después desplazamiento, página/longitud y valores de comprobación.
| Motivo | Significado | Motivo | Significado |
|---|---|---|---|
| 1 | índice de página fuera de rango | 9 | falló la comprobación de integridad de la imagen |
| 2/3 | falló el borrado / falló la verificación del borrado | 10 | fallo de autenticación |
| 4 | datos distintos para una página ya escrita (la sesión falló — reinicie desde BEGIN) | 11 | degradación de versión |
| 5/6 | falló la programación / falló la verificación | 12 | error de registro de intercambio |
| 7 | cabecera de imagen incorrecta | 13 | imagen no sellada / incompleta (p. ej., no llegó la página 0 ni la página de cabecera) |
| 8 | la página de cabecera nunca llegó | 14 | firma no válida |
| 15 | imagen construida para otra placa (el valor de comprobación es la palabra de placa de la imagen) |
Todos los fallos de autenticación se informan como OTA_STATUS 3 con el motivo indicado aquí; no hay valores de estado separados que gestionar. Por Modbus solo se reflejan el motivo y el estado interno (retenido 0x8314); los detalles de desplazamiento, página y comprobación de OTA_DIAG se leen por I²C.
Propiedades de seguridad (en qué puede confiar el host)
- En dos fases: COMMIT nunca reinicia; el momento del reinicio lo decide el host (ventana de mantenimiento).
-
Un corte de alimentación en cualquier punto es seguro: antes de COMMIT se ejecuta la imagen antigua; tras COMMIT, la imagen armada es la prevista; una prueba fallida vuelve atrás.
-
La calibración, la configuración, los contadores de energía, el historial, el registro de eventos y la identidad del dispositivo se guardan fuera de los bancos de firmware: una actualización nunca los toca.
-
Una confirmación de firmware queda registrada en el registro de eventos con la transición de versión.