STM32CubeIDE에서 라이브 워치(Live Watch)로 실시간 변수 모니터링하기
STM32 마이크로컨트롤러 개발 중 펌웨어 내부의 변수 변화를 확인하기 위해 중단점(Breakpoint)을 걸거나 시리얼 통신으로 매번 출력하는 방식은 동작 흐름을 방해할 수 있습니다. STM32CubeIDE에서 제공하는 라이브 워치(Live Watch) 기능을 사용하면 코드가 멈추지 않고 정상 작동하는 상태에서 RAM에 저장된 변수 값을 실시간으로 관찰할 수 있습니다. 이 글에서는 라이브 워치의 작동 원리부터 실제 설정 방법과 모니터링 실패 시 조치 방법을 다룹니다.
라이브 워치의 작동 원리와 volatile의 중요성
라이브 워치는 디버거(ST-LINK)가 SWD(Serial Wire Debug) 인터페이스를 통해 MCU의 동작을 중단시키지 않고 SRAM 주소에 직접 접근하여 데이터를 읽어오는 방식으로 동작합니다. 따라서 시리얼 통신 코드나 시뮬레이션용 프린트 구문을 별도로 작성하지 않고도 메모리 값을 실시간 모니터링할 수 있습니다.
라이브 워치를 정확하게 사용하려면 컴파일러 최적화 동작을 이해해야 합니다. 컴파일러는 코드 최적화 과정에서 반복 사용하는 변수를 CPU 레지스터에만 할당하고 메모리 쓰기를 생략할 수 있습니다. 이러한 상황을 방지하려면 변수 선언 시 volatile 키워드를 붙여야 합니다. volatile 키워드는 컴파일러가 해당 변수를 최적화 대상에서 제외하고, 읽기나 쓰기 작업이 일어날 때마다 항상 실제 메모리 주소에 직접 접근하도록 보장합니다.
또한 코드 내에서 한 번도 참조되지 않는 전역 변수는 링커가 최적화 시 림보 영역으로 판단하여 제거할 수 있습니다. 이 경우 변수가 빌드 결과물에서 사라지므로 링커 속성을 변경하거나 변수를 코드 내부에서 최소 한 번 이상 활용하도록 작성해야 합니다.
STM32CubeIDE에서 라이브 워치 설정 및 실습
라이브 워치 모니터링을 진행하기 위한 완전한 예제 코드입니다. main.c 파일 내부의 전역 변수 영역에 다음과 같이 작성합니다.
#include "main.h"
/* 실시간 모니터링을 위해 volatile 키워드로 전역 변수 선언 */
volatile uint32_t g_counter = 0;
volatile uint8_t g_flag = 0;
int main(void)
{
/* MCU 초기화 작업 */
HAL_Init();
SystemClock_Config();
while (1)
{
/* 카운터 변수 1씩 증가 */
g_counter++;
/* 카운터 조건에 따라 플래그 토글 */
if (g_counter % 100000 == 0)
{
g_flag = !g_flag;
}
}
}작성한 코드를 바탕으로 라이브 워치를 설정하는 순서는 다음과 같습니다.
- 상단 메뉴의 Debug 버튼을 눌러 디버그 세션 진입(Debug Perspective)을 시작합니다.
- 디버그 화면 상단 메뉴에서 Window -> Show View -> Live Watch를 선택해 창을 엽니다.
- Live Watch 창 내부의
Add new expression항목을 클릭하고 모니터링할 변수 이름(g_counter,g_flag)을 입력합니다. - Resume (F8) 버튼을 눌러 코드를 실행하면, 프로그램이 멈추지 않은 상태에서 변수 값이 실시간으로 변경되는 것을 관찰할 수 있습니다.
자주 겪는 문제
- 증상: Live Watch 창에 변수를 추가해도 값이 변하지 않거나 이전 값이 고정되어 출력됨
- 원인: 변수가 레지스터에만 할당되어 RAM 메모리 값이 실제 코드 변경 사항을 반영하지 못함
- 해결: 변수 선언부에
volatile키워드를 명시하여 매번 메모리에 직접 접근하도록 수정함
- 증상: Live Watch 창에 변수 이름을 입력하면
Symbol not found오류가 발생함 - 원인: 사용되지 않은 전역 변수로 판단되어 링커 최적화 과정에서 변수가 삭제됨
- 해결: 코드 내에서 해당 변수를 읽거나 쓰는 구문을 추가하거나, 변수 정의 뒤에
__attribute__((used))속성을 붙여 링커가 변수를 유지하도록 함
- 증상: 코드가 실행되는 동안 변수 값이 주기를 놓치거나 디버그 화면 업데이트가 매우 둔함
- 원인: SWD 통신 클록 속도가 너무 낮거나 모니터링 항목이 지나치게 많음
- 해결: Debug Configurations 메뉴의 Target Setup 탭에서 SWD 통신 클록(Clock) 속도를 적절히 올려 통신 대역폭을 확보함
정리
STM32CubeIDE의 라이브 워치 기능은 MCU 동작 중단 없이 메모리 변수를 관찰할 수 있는 강력한 디버깅 도구입니다. 모니터링 대상 변수에는 반드시 volatile 키워드를 사용하여 컴파일러 최적화에 의한 메모리 생략 현상을 막아야 합니다. 전역 변수 최적화 및 SWD 설정만 올바르게 구성하면 펌웨어의 실시간 상태 변화를 안정적으로 모니터링할 수 있습니다.
참고 자료
- Debug stm32 in real time — Stack Exchange stackoverflow · CC BY-SA
- Volatile is not preventing a variable from being optimized — Stack Exchange stackoverflow · CC BY-SA
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.