카드뉴스
HAL 함수만 보면 동작 조건이 가려진다
STM32 HAL은 복잡한 레지스터 설정을 함수와 구조체로 묶어 개발을 빠르게 시작하게 해 준다. 다만 `HAL_UART_Transmit()` 한 줄만 봐서는 UART 클럭이 켜졌는지, TX 핀이 올바른 Alternate Function으로 연결됐는지 알 수 없다. 함수가 정상 반환해도 외부 배선과 전압 레벨까지 확인된 것은 아니다.
문제가 생겼을 때는 호출한 함수 뒤에 어떤 설정이 필요한지 펼쳐 봐야 한다. GPIO 모드와 pull-up/down, 주변장치 클럭, 핀 멀티플렉싱, enable 조건을 따라가면 HAL 코드와 실제 신호 사이의 빈칸이 드러난다.
클럭과 핀을 주변장치 설정에 연결한다
UART, Timer, PWM, ADC는 모두 클럭에 묶여 있다. HSI/HSE와 PLL, 시스템 클럭, APB 분주를 거쳐 해당 주변장치에 어떤 주파수가 들어가는지 알아야 baud rate와 PWM 주기, Timer period, ADC sampling time을 판단할 수 있다. 핀 설정도 별개가 아니다. 같은 핀이라도 GPIO, UART, ADC, PWM 가운데 선택한 기능과 AF 번호가 맞아야 신호 경로가 열린다.
따라서 설정을 바꿀 때는 HAL 파라미터 하나만 보지 말고 클럭 소스와 핀 기능, 연결된 회로를 함께 확인한다. 코드가 같아도 보드 배선이나 MCU 모델이 다르면 결과가 달라질 수 있다.
상태 비트와 공식 문서가 원인을 좁혀 준다
동작이 멈췄다면 송신 데이터 레지스터가 비었는지, 수신 데이터가 들어왔는지, ADC 변환이 끝났는지, Timer 또는 인터럽트 플래그가 올라왔는지 상태 레지스터에서 확인한다. HAL 반환값은 함수의 처리 결과이고, 레지스터는 주변장치 내부 상태를 보여 준다. 핀의 실제 파형은 다시 그 바깥의 증거다.
데이터시트에서는 패키지별 핀 기능과 전기적 조건을 찾고, 레퍼런스 매뉴얼에서는 클럭 구조와 주변장치 동작, 레지스터 비트를 확인한다. 모든 문서를 처음부터 읽기보다 현재 다루는 GPIO, UART, Timer/PWM, ADC, NVIC, Clock Tree의 표와 절차부터 찾아보는 편이 현실적이다.
함수에서 설정과 상태로 한 단계씩 내려간다
예제 코드나 CubeMX로 먼저 기능을 동작시킨 뒤, 사용한 핀을 데이터시트에서 확인한다. 다음으로 주변장치의 클럭 소스와 분주 설정을 보고, 관련 레지스터와 플래그를 디버거에서 읽는다. 마지막에 설정값 하나를 바꿔 로그나 파형이 예상대로 달라지는지 측정한다.
모든 코드를 레지스터 방식으로 다시 작성할 필요는 없다. HAL은 개발에 사용하는 계층이고 레지스터와 문서는 문제가 난 위치를 찾는 도구다. 함수 → 설정 → 상태 → 실제 신호 순서가 연결되면 예제를 다른 핀과 요구사항으로 옮길 때도 수정할 지점을 분명히 잡을 수 있다.
