rbAmp
ES
Tienda
Docs
Actualizado

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

  1. Seleccione. Lea FW_ACTIVE_BANK → elija el archivo de publicación para el otro banco. Compruebe BOARD_ID frente al archivo; opcionalmente, compruebe OTA_KEYID.

  2. 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.

  3. 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 en OTA_PAYLOAD → (opcional) OTA_PCRC_EXP = CRC-32 de la página → comando 0x11 → sondee BUSY hasta 0 (espere hasta ~0.5 s).

  4. 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.

  5. Tras cada comprobación de página, OTA_STATUS sigue en 1. ERROR 0xFC = 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_STATUS 3 = la sesión falló (lea OTA_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.

  6. 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.

  7. 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.

  8. 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:

  9. OTA_STATUS 2: 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).

  10. 3: rechazado; OTA_DIAG indica el motivo (abajo).

  11. 4: versión anterior a la que está en ejecución; no cambió nada.
  12. 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 y ERROR sigue 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_BANK cambiado, FW_VER = nueva versión, SWAP_PENDING 2 → 0; si sigue en ejecución la FW_VER antigua, 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.