Depuración de Firmware MCU: Métodos Diagnósticos

# Depuración de Firmware en Microcontroladores: Métodos Diagnósticos Comprobados

La depuración de firmware en microcontroladores comienza con verificaciones básicas de parámetros del sistema. Sin ellas, el desarrollo se convierte en adivinanzas. Cubriremos técnicas comprobadas, desde simples LEDs hasta interfaces avanzadas, centrándonos en escenarios reales para plataformas STM32 y similares.

Primer paso: sacar la señal de reloj del sistema a los pines MCO. Esto permite medir la frecuencia real de HSE o SYSCLK con un osciloscopio tras la división.

HAL_RCC_MCOConfig(RCC_MCO1, RCC_MCO1SOURCE_HSE, RCC_MCODIV_4);
HAL_RCC_MCOConfig(RCC_MCO2, RCC_MCO2SOURCE_SYSCLK, RCC_MCODIV_5);

{.pad.port=PORT_C, .pad.pin=9, .name="MCO_2",   .stm_mode=GPIO_MODE_AF_PP,      .gpio_pull=GPIO__PULL_AIR, .speed=GPIO_SPEED_FREQ_VERY_HIGH,  .alternate= GPIO_AF0_MCO,},
{.pad.port=PORT_A, .pad.pin=8, .name="MCO_1",   .stm_mode=GPIO_MODE_AF_PP,      .gpio_pull=GPIO__PULL_AIR, .speed=GPIO_SPEED_FREQ_VERY_HIGH,  .alternate= GPIO_AF0_MCO,},

Comparar las medidas con tu código revela errores en la configuración del reloj.

Indicadores de Estado y Verificaciones Básicas

Un LED de latido (heartbeat) es imprescindible en cualquier firmware. Un LED parpadeando a 1 Hz confirma que el código está ejecutándose, verifica el timing y muestra que el sistema está vivo. Añade un LED rojo separado para errores de software o hardware.

• Ventajas: Prueba visual de funcionamiento—no se necesita equipo extra.
• Implementación: Temporizador con período de 500 ms para alternar el pin.
• Extensiones: Múltiples LEDs para subsistemas (relojes, periféricos).

¿No parpadea el LED? La depuración adicional es inútil—el firmware no arrancó o está colgado.

Las funciones assert añaden verificaciones robustas. Se activan con argumentos cero:

• makeAssert: Verificaciones en tiempo de compilación desde Makefile.
• preprocAssert: Validaciones del preprocesador.
• staticAssert: Validación de configuración en tiempo de compilación.
• DynamicAssert: En tiempo de ejecución con soporte para breakpoint de GDB.

La colocación estratégica de asserts localiza fallos en todas las fases del proyecto.

Depuración Avanzada vía Interfaces

La CLI sobre UART es la herramienta más flexible. Una interfaz de texto full-duplex en Rx/Tx/GND permite:

• Leer/escribir memoria por dirección.
• Llamar funciones por puntero.
• Monitorear contadores, enviar paquetes I2C/SPI/UART.
• Interpretar registros de temporizadores.

Funcionalidades mínimas de CLI:

• Eco de entrada.
• Historial de comandos en memoria no volátil.
• Ayuda y autocompletado con TAB.
• Autenticación.
• Salida coloreada (rojo para errores, amarillo para advertencias).
• Renderizado de tablas (GPIO, ADC).

La CLI preserva el timing en tiempo real, a diferencia de JTAG/SWD. El logging en RAM con flush por UART post-inicialización diagnostica el arranque temprano, incluyendo relojes. Niveles de soporte: LOG_ERROR, LOG_WARNING, LOG_INFO, LOG_DEBUG con filtros por módulo (p. ej., ll usb debug).

Herramientas de Análisis de Señales

Para procesos en tiempo real, usa GPIO como marcadores:

• Alterna pines para contar pasos en la inicialización del sistema.
• Mapeador GPIO: Convierte números a códigos binarios en pines.

Un osciloscopio (al menos 2 canales, digital) captura flancos. Los analizadores lógicos (Saleae, 8–16 canales) destacan en buses como MII/I2S/SDIO: velocidades USB 3.0, análisis de período/frecuencia/ciclo de trabajo basado en PC.

El DAC (10–12 bits) saca valores analógicos al osciloscopio. Ideal para depurar programadores: pasos de voltaje revelan prioridades de hilos.

Limitaciones de la Depuración Paso a Paso y Alternativas

GDB sobre SWD/JTAG se detiene en breakpoints (PC/LR de HardFault). Pero altera el timing: temporizadores de hardware avanzan, WDT resetea el MCU. Las optimizaciones (-O0 -g3) consumen espacio en Flash, a menudo no disponibles.

Alternativa: arm-none-eabi-addr2line para mapear direcciones de HardFault a líneas de fuente:

set ELF_FILE=C:/ncs/v2.1.0/nrf/applications/nrf5340_audio/build/gateway_app/zephyr/zephyr.elf
set ADDR2LINE="C:\Program Files (x86)\GNU Arm Embedded Toolchain\10 2021.10\bin\arm-none-eabi-addr2line.exe"
%ADDR2LINE% -e %ELF_FILE% 0x000054cd
%ADDR2LINE% -e %ELF_FILE% 0x0000857e

Las pantallas OLED proporcionan métricas independientes: monitoreo estilo Tamagotchi sin UART. Las pruebas unitarias cubren código sin depurador, permitiendo refactorizaciones seguras.

Lecciones Clave

• LED de latido y MCO: Pruebas de funcionamiento esenciales—sáltatelas y vas a ciegas.
• CLI con niveles de logging: Control total sin alterar timing.
• GPIO/DAC + osciloscopio/analizador: Insights en señales en tiempo real.
• Asserts y addr2line: Localiza HardFaults sin depuración completa.
• GDB/SWD: Último recurso por distorsiones de timing.

— Editorial Team