MCU 펌웨어 디버깅: 진단 방법

마이크로컨트롤러 펌웨어 디버깅: 검증된 진단 기법

마이크로컨트롤러 펌웨어 진단은 기본 시스템 파라미터 확인부터 시작합니다. 이를 생략하면 개발이 추측에 의존하게 됩니다. 간단한 LED부터 고급 인터페이스까지 실전에서 검증된 기법을 다루며, STM32 및 유사 플랫폼에 초점을 맞춥니다.

첫 번째 단계: MCO 핀으로 시스템 클럭 출력. 이를 통해 분주 후 오실로스코프로 실제 HSE 또는 SYSCLK 주파수를 측정할 수 있습니다.

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,},

측정값과 코드 비교로 클럭 설정 오류를 드러낼 수 있습니다.

상태 표시기와 기본 확인

하트비트 LED는 모든 펌웨어에 필수입니다. 1Hz 깜빡임으로 코드 실행, 타이밍 확인, 시스템 생존 여부를 알립니다. 소프트웨어/하드웨어 오류용 별도 빨간 LED를 추가하세요.

• 장점: 육안 스모크 테스트—추가 장비 불필요.
• 구현: 핀 토글을 위한 500ms 주기 타이머.
• 확장: 클럭, 주변장치 등 서브시스템별 다중 LED.

LED가 깜빡이지 않으면? 추가 디버깅은 무의미—펌웨어가 시작되지 않았거나 멈췄습니다.

Assert 함수로 견고한 확인 추가. 인자 0으로 트리거:

• makeAssert: 빌드 타임 Makefile 확인.
• preprocAssert: 전처리기 검증.
• staticAssert: 컴파일 타임 설정 검증.
• DynamicAssert: 런타임 GDB 브레이크포인트 지원.

전략적 assert 배치로 프로젝트 전 단계 실패 지점 파악.

인터페이스를 통한 고급 디버깅

UART 기반 CLI가 가장 유연한 도구입니다. Rx/Tx/GND 풀 듀플렉스 텍스트 인터페이스로 가능:

• 주소별 메모리 읽기/쓰기.
• 포인터로 함수 호출.
• 카운터 모니터링, I2C/SPI/UART 패킷 송수신.
• 타이머 레지스터 해석.

최소 CLI 기능:

• 입력 에코.
• 비휘발성 메모리 명령 히스토리.
• 도움말 및 TAB 자동완성.
• 인증.
• 색상 출력 (오류: 빨강, 경고: 노랑).
• 테이블 렌더링 (GPIO, ADC).

CLI는 JTAG/SWD와 달리 실시간 타이밍 보존. 초기화 후 UART 플러시 RAM 로깅으로 부트 초기(클럭 포함) 진단. 지원 레벨: LOG_ERROR, LOG_WARNING, LOG_INFO, LOG_DEBUG + 모듈 필터 (예: ll usb debug).

신호 분석 도구

실시간 프로세스에는 GPIO 마커 활용:

• 시스템 초기화 단계 카운팅용 핀 토글.
• GPIO 맵퍼: 숫자를 핀 간 바이너리 코드 변환.

오실로스코프(최소 2채널, 디지털)로 에지 캡처. 로직 분석기(Saleae, 8–16채널)는 MII/I2S/SDIO 버스에 최적: USB 3.0 속도, PC 기반 주기/주파수/듀티 사이클 분석.

DAC(10–12비트)로 아날로그 값 스코프 출력. 스케줄러 디버깅에 유용: 전압 스텝으로 스레드 우선순위 드러냄.

스텝 디버깅 한계와 대안

SWD/JTAG GDB는 브레이크포인트에서 정지(PC/LR HardFault 추출). 하지만 타이밍 왜곡: 하드웨어 타이머 앞서가고, WDT MCU 리셋. 최적화(-O0 -g3)는 플래시 공간 소모, 종종 불가.

대안: arm-none-eabi-addr2line으로 HardFault 주소 소스 라인 매핑:

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

OLED 디스플레이로 UART 없이 독립 메트릭: 타마고치 스타일 모니터링. 유닛 테스트로 디버거 없이 코드 커버, 안전 리팩토링 가능.

핵심 요약

• 하트비트 LED와 MCO: 필수 스모크 테스트—생략 시 맹목 비행.
• 로깅 레벨 CLI: 타이밍 방해 없이 완전 제어.
• GPIO/DAC + 스코프/분석기: 실시간 신호 통찰.
• Assert와 addr2line: 풀 디버그 없이 HardFault 정확 파악.
• GDB/SWD: 타이밍 왜곡으로 최후 수단.

— Editorial Team