2. 系统时钟配置实战：使用HAL库配置SYSCLK、AHB、APB1、APB2总线时钟
时钟，是STM32的“心跳”。
我见过不少新手，代码逻辑写得挺顺，但一上电就是跑不起来。查了半天，最后发现是时钟没配对。说白了，时钟配错了，外设根本没法正常工作。
这一章，我们就来亲手配置系统时钟。我会带着你用HAL库，把SYSCLK、AHB、APB1、APB2这些总线时钟一个个搞定。
2.1 时钟树的核心脉络
先别急着写代码。你得先搞清楚STM32的时钟是怎么“流”过来的。
我个人习惯把时钟树想象成一条供水管道：
- 水源：HSE（外部高速晶振）、HSI（内部RC振荡器）、PLL（锁相环）
- 主管道：SYSCLK（系统时钟）
- 分支管道：AHB总线、APB1总线、APB2总线
每个分支上还挂着水龙头——那就是各个外设的时钟使能位。
关键点：APB1最高只能跑到36MHz（对于F1系列），APB2可以跑到72MHz。如果你把APB1上的外设时钟配高了，它就直接罢工。
下面这张图，是我自己画的一个简化版时钟树结构，帮你理清关系：
2.2 用HAL库配置时钟的步骤
HAL库帮我们封装好了底层寄存器操作。你只需要调用几个函数就行。但前提是——你得知道调用的顺序。
2.2.1 第一步：配置时钟源
我一般用外部晶振（HSE），因为它比内部RC振荡器（HSI）更准。温度一变，HSI的频偏能到1%~2%，对于串口通信这种场合，那就是灾难。
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9; // 8MHz * 9 = 72MHz
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}我的经验：PLL倍频系数别乱设。8MHz晶振配9倍频得到72MHz，这是标准玩法。如果你用25MHz晶振，倍频系数就得重新算。我曾经见过有人把倍频设成16，结果芯片直接过热——虽然没烧，但跑起来各种诡异。
2.2.2 第二步：配置系统时钟与总线分频
时钟源搞定之后，就该配置SYSCLK和各个总线了。
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK
| RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1; // AHB = 72MHz
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2; // APB1 = 36MHz
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1; // APB2 = 72MHz
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
{
Error_Handler();
}这里有个细节——FLASH_LATENCY_2。当SYSCLK超过48MHz时，Flash读取必须插入等待周期。72MHz需要2个等待周期。少了这个，程序会跑飞。
⚠ 避坑指南：我曾经在调试一个项目时，忘了配Flash等待周期。结果代码在调试器里单步跑没问题，一全速运行就死机。查了整整两天，最后发现是Flash跟不上CPU的速度。所以，配时钟时一定别忘了这个参数。
2.3 验证时钟配置是否正确
配完了，怎么知道对不对？
最简单的方法——用HAL_RCC_GetSysClockFreq()读回来看看。
uint32_t sysclk = HAL_RCC_GetSysClockFreq();
uint32_t hclk = HAL_RCC_GetHCLKFreq();
uint32_t pclk1 = HAL_RCC_GetPCLK1Freq();
uint32_t pclk2 = HAL_RCC_GetPCLK2Freq();
printf("SYSCLK: %lu Hz\r\n", sysclk);
printf("HCLK: %lu Hz\r\n", hclk);
printf("PCLK1: %lu Hz\r\n", pclk1);
printf("PCLK2: %lu Hz\r\n", pclk2);如果打印出来是72000000、72000000、36000000、72000000，那就对了。
2.4 常见配置参数速查表
为了方便你快速查阅，我把常用的配置组合整理成了表格：
| HSE频率 | PLL倍频 | SYSCLK | AHB分频 | APB1分频 | APB2分频 | Flash等待 |
|---|---|---|---|---|---|---|
| 8 MHz | x9 | 72 MHz | /1 | /2 | /1 | 2 |
| 8 MHz | x6 | 48 MHz | /1 | /1 | /1 | 1 |
| 12 MHz | x6 | 72 MHz | /1 | /2 | /1 | 2 |
| 25 MHz | x3 | 75 MHz | /1 | /2 | /1 | 2 |
注意：表格里最后一行75MHz其实已经超了STM32F103的72MHz上限。我放进来是想提醒你——别以为晶振高就能跑得快。超频虽然有时候能跑，但稳定性没保证。工业产品千万别这么干。
2.5 调试时的小技巧
嗯，这里再分享几个我常用的调试方法：
- 用MCO引脚输出时钟：把SYSCLK或HSE通过MCO引脚引出来，用示波器看波形。频率对不对，一眼就知道。
- 检查RCC寄存器：在调试器里打开RCC->CFGR寄存器，看看SW位是不是已经切到了PLL。有时候配置函数返回成功，但实际切换没生效。
- 注意HSE起振时间：外部晶振起振需要时间，大概几毫秒。如果HAL_RCC_OscConfig返回超时，先检查晶振电路——电容配没配？晶振有没有焊好？
时钟配置说难不难，说简单也不简单。关键是理清脉络，按步骤来。配好之后，用示波器或者printf验证一下，心里就踏实了。