STM32CubeMX를 활용한 클럭 트리(Clock Tree) 설정 완벽 이해하기
STM32 마이크로컨트롤러 개발에서 클럭 시스템 설정은 시스템 전체의 성능과 전력 소모를 결정하는 핵심 단계입니다. STM32CubeMX의 그래픽 클럭 트리를 활용하면 복잡한 내부 레지스터 조작 없이도 내부 및 외부 클럭 소스를 안전하게 구성할 수 있습니다. 이 글에서는 클럭 트리의 구조적 원리부터 STM32CubeMX를 통한 설정 방법과 주의점을 살펴봅니다.
클럭 트리의 구조와 동작 원리
STM32의 클럭 트리는 여러 입력 신호원(Clock Source)을 받아 동작 주파수를 신중하게 조합하는 계층 구조로 이루어져 있습니다.
- 클럭 소스: 내부 고속 발진기(HSI), 외부 고속 발진기(HSE), 내부 저속 발진기(LSI), 외부 저속 발진기(LSE) 등이 있습니다.
- PLL(Phase-Locked Loop): 입력된 클럭 주파수를 곱하거나 나누어 코어가 필요로 하는 높은 주파수(SYSCLK)를 생성합니다.
- 시스템 버스(AHB/APB): 생성된 시스템 클럭은 AHB(Advanced High-performance Bus)를 거쳐 CPU 코어와 메모리(Flash, RAM)로 공급되며, 다시 APB1, APB2(Advanced Peripheral Bus) 분주기를 거쳐 주변장치로 전달됩니다.
고성능 메모리와 코어는 빠른 AHB 버스에 직접 연결되어 높은 속도로 동작하지만, 상대적으로 낮은 속도를 요구하는 일반 주변장치(UART, SPI, I2C 등)는 APB 버스를 통해 공급받습니다.
STM32CubeMX에서 클럭 트리 설정하기
STM32CubeMX를 사용하면 입력 핀 설정부터 최종 버스 주파수 계산까지 직관적인 그래픽 UI로 구성할 수 있습니다.
- Pinout & Configuration 탭 설정: System Core의 RCC 항목에서 External Clock(HSE)을 Crystal/Ceramic Resonator로 변경하여 외부 발진기를 활성화합니다.
- Clock Configuration 탭 이동: 화면에 표시되는 전체 클럭 트리 다이어그램을 확인합니다.
- 입력 주파수 지정: 사용 중인 보드에 탑재된 외부 크리스탈 주파수(예: 8 MHz)를 Input Frequency 항목에 입력합니다.
- 목표 주파수 입력: HCLK(MHz) 입력 상자에 마이크로컨트롤러가 지원하는 목표 주파수(예: 72 MHz 또는 168 MHz)를 직접 입력하고 엔터를 누르면, CubeMX가 PLL 분주비(M, N, P, Q 등)를 자동으로 계산하여 적용합니다.
클럭 설정 예제 코드 이해
STM32CubeMX에서 코드를 생성하면 main.c 파일에 SystemClock_Config() 함수가 생성됩니다. HAL 라이브러리를 사용해 클럭을 초기화하는 대표적인 예제 코드는 다음과 같습니다.
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
// 1. HSE 및 PLL 초기화 설정
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON; // 외부 크리스탈 활성화
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; // PLL 활성화
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; // PLL 입력으로 HSE 선택
RCC_OscInitStruct.PLL.PLLM = 8; // 입력 분주비 설정
RCC_OscInitStruct.PLL.PLLN = 336; // 배율 설정
RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2; // main PLL 분주비 설정
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler(); // 설정 실패 시 에러 처리
}
// 2. CPU, AHB 및 APB 버스 클럭 분주비 설정
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK
| RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_CLOCKTYPE_SYSCLK_PLLCLK; // SYSCLK 소스로 PLL 선택
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // HCLK 분주비 (1분주)
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV4; // PCLK1 분주비 (4분주)
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV2; // PCLK2 분주비 (2분주)
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_5) != HAL_OK)
{
Error_Handler(); // 설정 실패 시 에러 처리
}
}자주 겪는 문제
- 증상: 프로그램 동작 중
Error_Handler()로 진입하며 무한 루프에 빠짐 - 원인: Hardware 크리스탈이 미부착되어 있거나 CubeMX의 RCC 설정에서 HSE 동작 방식을 잘못 선택하여 외부 클럭 신호를 찾지 못함
- 해결: 회로상의 외부 크리스탈 탑재 여부를 확인하고, Crystal/Ceramic Resonator 또는 Bypass Clock Source 설정을 올바르게 재선택함
- 증상: UART 통신 속도(Baudrate)가 맞지 않아 데이터가 깨짐
- 원인: APB 버스의 분주비가 잘못되어 UART 모듈에 공급되는 실제 클럭 주파수가 소스 코드 상의 설정값과 불일치함
- 해결: STM32CubeMX의 Clock Configuration 탭에서 해당 UART가 연결된 APB1 또는 APB2 버스의 최종 PCLK 주파수를 정확히 확인하고 코드를 재생성함
- 증상: 높은 주파수로 클럭 설정 후 CPU가 비정상 동작하거나 리셋됨
- 원인: 높은 코어 주파수 설정에 따라 Flash 대기 시간(Flash Latency / Wait State)을 늘려주지 않아 메모리 읽기 오류 발생
- 해결: STM32CubeMX의 자동 계산 기능을 사용하여 동작 주파수에 맞는 Flash Latency가 설정되도록 구성하거나 데이터시트를 참고하여 대기 주기를 조정함
정리
STM32의 클럭 트리는 외부 발진기와 PLL을 조합해 시스템 코어 및 주변장치 버스(AHB, APB)에 최적화된 주파수를 공급하는 구조입니다.
STM32CubeMX를 활용하면 원하는 목표 주파수를 입력하는 것만으로 안전하고 정확하게 분주비와 계수를 설정할 수 있습니다.
클럭 설정 변경 시에는 통신속도 오류나 메모리 대기시간(Flash Latency) 문제가 발생하지 않도록 각 버스별 최종 주파수를 세심하게 검증해야 합니다.
참고 자료
- Does it take longer to read memory-mapped IO than regular memory on a microcontroller? — Stack Exchange stackoverflow · CC BY-SA
공개한 자료는 무료이며, 사용에 따른 결과는 보증하지 않습니다. 상업적 이용이나 재배포 전에는 한 번 문의해 주시면 감사하겠습니다.
댓글 · 문의 0
댓글은 로그인 후 남기실 수 있습니다. 가입은 무료입니다.
로그인 · 회원가입아직 댓글이 없습니다. 첫 질문을 남겨 주세요.