Notas de diseño de OTA de firmware y bootloader

EN BREVE: La vía de actualización del firmware se diseña junto con el bootloader, antes de enviar la primera unidad. Decida el mapa de flash, cómo se firman y verifican las imágenes, cómo vuelve atrás una actualización fallida y qué ocurre si la alimentación cae a mitad de proceso. Pruebe cada caso de fallo en hardware real. Cambiar estas decisiones con unidades ya en campo sale caro.

Diagrama de bloques de una actualización de firmware con dos slots: el cliente de actualización escribe una imagen firmada en el slot secundario, el bootloader verifica la firma y la versión, intercambia o arranca la nueva imagen, y la aplicación la confirma; una imagen sin confirmar se revierte en el siguiente reset.
Figura 1. Flujo de actualización con dos slots. Los mismos pasos se describen en la sección 3.

1.0 Por qué la vía de actualización es una decisión de diseño

Un mecanismo de actualización parece una función que se puede añadir más tarde. En la práctica condiciona casi todo lo demás: cuánta flash puede usar la aplicación, cómo se organiza el mapa de memoria, qué claves existen y dónde se guardan, y cómo programa la línea de producción la primera imagen. Una vez enviadas unidades con un bootloader determinado, ese bootloader suele ser la única pieza de código que no se puede sustituir con seguridad. Lo que no admita el primer día, probablemente no lo admitirá nunca.

Por eso tratamos la vía de actualización como parte de la arquitectura, escrita en el mismo documento que el mapa de memoria y el protocolo de comunicación, y revisada antes de que el trabajo en la aplicación avance mucho.

2.0 Preguntas que hay que responder primero

PreguntaPor qué importaOpciones habituales
¿Cómo llega una imagen nueva al dispositivo?Define el transporte, la división en bloques y la lógica de reanudaciónBLE, USB, UART, Wi-Fi/celular, tarjeta SD, solo depurador
¿Dónde se guarda la imagen nueva mientras se descarga?Determina el presupuesto de flashSegundo slot interno, flash externa, RAM (solo imágenes pequeñas)
¿Cómo se autentica la imagen?Impide ejecutar código que usted no ha compiladoFirma sobre imagen y cabecera; un hash solo da integridad, no autenticidad
¿Se puede volver a instalar una imagen anterior?Ataques de degradación y política de soporteContador de versión monótono, lista de permitidas o indicador explícito de degradación
¿Qué pasa si la imagen nueva falla?Unidades en campo que dejan de funcionarArranque de prueba y luego confirmación, reversión por watchdog
¿Quién guarda la clave de firma?Proceso de publicación y control de accesoHSM o máquina sin conexión; nunca la copia de trabajo del servidor de compilación
¿Qué graba la fábrica?Programación en línea y primer arranqueBootloader + aplicación firmada + datos de aprovisionamiento

Si aún no se conocen las respuestas, regístrelas como decisiones abiertas con un responsable. No envíe un bootloader escrito para «aceptar cualquier cosa por ahora»; en campo ya no se puede endurecer.

3.0 Un mapa de dos slots que tolera cortes de alimentación

Si, después de reservar el bootloader, la aplicación cabe en menos de la mitad de la flash interna, use dos slots más un área de trabajo (scratch). El bootloader nunca ejecuta código de un slot que no haya verificado.

3.1 Mapa de flash

RegiónContenidoQuién la escribe
BootloaderCódigo de primera etapa inmutable, clave pública de verificaciónSolo la fábrica
Slot 0 (primario)La imagen que se ejecutaEl bootloader durante el intercambio, o la fábrica
Slot 1 (secundario)La imagen candidata descargadaEl cliente de actualización de la aplicación
Scratch / estado del intercambioMarcas de progreso para reanudar un intercambio tras un resetBootloader
Ajustes / datosCalibración, claves de emparejamiento, datos de usuarioLa aplicación; deben sobrevivir a las actualizaciones

Mantenga la región de datos fuera de ambos slots y dele un formato con versión. Una actualización que cambie la disposición de los datos necesita un paso de migración, y la imagen anterior debe poder leer los datos si se revierte.

3.2 Secuencia de actualización

  1. El cliente de actualización recibe la imagen por bloques y la escribe en el slot 1. Verifica la longitud y el hash antes de marcar el slot como pendiente.
  2. En el siguiente reset, el bootloader comprueba la cabecera, la versión y la firma de la imagen del slot 1.
  3. Si es válida, el bootloader intercambia los slots (o, en componentes que lo permiten, arranca directamente el slot 1), registrando el progreso en el área scratch después de cada sector para que un intercambio interrumpido continúe en el siguiente arranque.
  4. La imagen nueva se ejecuta en estado de prueba y hace sus autocomprobaciones: los periféricos se inicializan, el enlace de comunicación se establece, la región de datos se puede leer.
  5. Si las comprobaciones pasan, la aplicación marca la imagen como confirmada. Si se produce un reset antes de confirmar, o salta el watchdog, el bootloader vuelve a la imagen anterior.

Es el modelo que usan bootloaders de código abierto como MCUboot, cuya documentación de diseño es una buena referencia para los detalles del intercambio y la reversión. No exigimos un bootloader concreto; en algunos componentes encaja mejor el del fabricante o uno pequeño propio. La secuencia anterior es lo que comprobamos, sea cual sea la implementación.

3.3 Variantes de un solo slot y con flash externa

Cuando la flash interna no da para dos slots, la imagen candidata puede ir a una flash externa, y el bootloader la copia después. Funciona, pero el paso de copia debe poder reanudarse y el contenido de la flash externa debe verificarse de nuevo antes de copiar, porque el chip externo es más fácil de manipular. Un diseño de un solo slot sin imagen de respaldo solo debería aceptarse cuando el dispositivo siempre puede recuperarse por una interfaz cableada y ese procedimiento está documentado.

4.0 Firma y claves

Las comprobaciones de integridad (CRC, SHA-256) detectan corrupción. No dicen quién compiló la imagen. Para eso hace falta una firma sobre la imagen y su cabecera, verificada con una clave pública que el bootloader guarda en una región que la aplicación no puede sobrescribir.

Puntos prácticos que dejamos escritos en el diseño:

  • La clave privada de firma vive fuera del entorno de compilación habitual. Las versiones de producción se firman en un paso aparte y registrado.
  • Prever la rotación de claves. O el bootloader guarda más de una clave pública, o existe un procedimiento documentado para actualizar la clave de confianza con una imagen firmada.
  • Separar claves de desarrollo y de producción. Las placas de desarrollo no deberían aceptar por accidente imágenes firmadas para producción, y las unidades de producción nunca deberían aceptar imágenes firmadas para desarrollo.
  • Números de versión en la cabecera firmada, no solo en la aplicación, para que el bootloader pueda aplicar una política antirretroceso.

NIST SP 800-193 describe la resiliencia del firmware de plataforma en términos de protección, detección y recuperación, y sirve como lista de comprobación incluso para dispositivos pequeños. El RFC 9019 del IETF describe una arquitectura de actualización de firmware para dispositivos IoT y los roles que intervienen.

5.0 Transporte y reanudación

Sea cual sea el transporte, el protocolo de actualización necesita las mismas propiedades:

  • Transferencia por bloques con desplazamiento, para que un enlace caído se reanude en lugar de empezar de nuevo.
  • Un hash de la imagen completa enviado al principio y comprobado tras el último bloque.
  • Un paso explícito de «imagen completa», separado de «reiniciar ahora», para que el host decida cuándo reiniciar.
  • Códigos de error claros para el host: tipo de imagen incorrecto, versión rechazada, espacio insuficiente, verificación fallida.

En BLE, el caudal depende de los parámetros de conexión y de la MTU negociados con el teléfono, y ambos varían según el modelo. Diseñe para el peor caso que pueda probar y muestre el progreso al usuario. Para el diseño de protocolos de dispositivo en general, véase la nota complementaria sobre comunicación de dispositivos por BLE y USB.

6.0 Casos de prueba antes de enviar

CasoResultado esperado
Corte de alimentación durante la descargaLa imagen antigua sigue funcionando; la descarga se reanuda o reinicia limpiamente
Corte de alimentación durante el intercambio (varios puntos)El intercambio se reanuda en el siguiente arranque; el dispositivo termina con una imagen válida
Imagen corrupta (un byte cambiado)Rechazada antes del intercambio; error comunicado al host
Imagen firmada con una clave incorrectaRechazada
Imagen de versión anteriorRechazada, o aceptada solo según la regla de degradación documentada
Imagen nueva que nunca confirmaRevertida tras un reset o el watchdog
Imagen nueva con formato de datos cambiadoDatos migrados; tras una reversión los datos siguen siendo legibles
Unidad programada en fábrica, primera actualizaciónFunciona con la imagen y el aprovisionamiento de la línea

Las pruebas de corte de alimentación necesitan una fuente controlable o un relé en la línea de alimentación, y un script que corte la alimentación en cada límite de fase de la descarga y del intercambio, repita cada punto en bucle y registre qué imagen arrancó tras cada ciclo. Los puntos de corte y el número de ciclos van al registro de pruebas junto con los resultados.

7.0 Qué incluye la entrega

  • Tabla del mapa de flash y el razonamiento detrás del tamaño de los slots.
  • Formato de la cabecera de imagen, procedimiento de firma y notas sobre la custodia de claves.
  • Descripción del protocolo de actualización con formatos de mensaje y códigos de error.
  • La lista de pruebas anterior con los resultados del hardware en que se ejecutó.
  • Pasos de programación en fábrica del bootloader y de la primera imagen.

Si está planificando el firmware de un dispositivo nuevo o necesita añadir una vía de actualización a uno existente, la página Firmware embebido explica cómo trabajamos, y Web, nube y gestión de dispositivos trata el lado servidor de la distribución de actualizaciones. Puede describir su proyecto en el formulario Hablar de un proyecto.

Referencias

Preguntas frecuentes

¿Se pueden añadir actualizaciones OTA a un producto ya enviado?

Depende del bootloader que ya llevan esas unidades. Si puede aceptar una nueva imagen de aplicación por alguna interfaz, normalmente se puede añadir un cliente de actualización a la aplicación y distribuirlo por esa vía. Si no puede, las unidades en campo solo se pueden actualizar por cable, y el diseño mejorado se aplica a la producción nueva.

¿Necesitamos dos slots completos de aplicación?

Dos slots dan la recuperación más sencilla, pero reducen a la mitad el espacio disponible para la aplicación. Una flash externa para la imagen candidata o una imagen comprimida son alternativas habituales. La elección debe salir de un presupuesto de flash escrito pronto, no descubrirse cuando la aplicación ya no cabe en su slot.

¿Basta un CRC para proteger la actualización?

Un CRC o un hash detecta corrupción en el tránsito. No demuestra que la imagen venga de usted, así que cualquiera que llegue a la interfaz de actualización podría instalar su propio código. Una firma verificada por el bootloader cierra ese hueco, y la gestión de claves a su alrededor importa tanto como el algoritmo.

¿Cómo prueban un corte de alimentación durante una actualización?

Con un script: una fuente controlable o un relé corta la alimentación en distintos puntos de la descarga y del intercambio, muchas veces seguidas, y una comprobación tras cada ciclo confirma que el dispositivo arranca con una imagen válida. Los resultados van a la entrega para que el siguiente ingeniero pueda repetirlos.

¿Qué bootloader recomiendan?

El que encaje con el componente, el presupuesto de flash y sus necesidades de seguridad. MCUboot es una opción de código abierto bien documentada para muchos microcontroladores; a veces encaja mejor el bootloader del fabricante. Los comparamos con las preguntas de la sección 2.0 y dejamos por escrito por qué se eligió uno.