2. HAL库时钟树配置：深入理解HAL_RCC_xxx函数，配置系统时钟、外设时钟，降低运行功耗

时钟，是MCU的心脏。心跳多快，功耗就有多高。很多新手拿到STM32，第一件事就是把HSE配到最高，然后不管三七二十一，所有外设时钟全开。结果呢？功耗直接起飞。

我刚开始做低功耗项目时也犯过这错。一块电池供电的传感器节点，满打满算能用三个月，结果两周就趴窝了。查来查去，问题就出在时钟配置上——外设时钟没关，系统时钟跑在最高频，休眠模式也没切到位。

这一章，我们就来把HAL库的RCC函数彻底讲透。说白了，就是让你知道：什么时候该开，什么时候该关，什么时候该降频。

2.1 时钟树的基本结构

STM32的时钟树，其实不复杂。几个关键节点：

• 时钟源：HSI（内部高速）、HSE（外部高速）、LSI（内部低速）、LSE（外部低速）
• PLL：锁相环，用来倍频
• 系统时钟（SYSCLK）：CPU核心的时钟
• AHB/APB总线时钟：外设和内存的时钟
• 外设时钟使能：每个外设独立的时钟门控

你想想看，从时钟源到外设，中间经过了好几级分频和门控。每一级，都是我们控制功耗的切入点。

2.2 HAL_RCC_xxx 函数族详解

HAL库把RCC操作封装成了几个关键函数。我习惯把它们分成三类：

函数类别	典型函数	作用	低功耗关注点
时钟源配置	HAL_RCC_OscConfig()	配置HSI/HSE/LSI/LSE及PLL	选择低速源、关闭未用振荡器
系统时钟配置	HAL_RCC_ClockConfig()	设置SYSCLK、AHB、APB分频	降低总线频率、调整Flash等待周期
外设时钟使能	__HAL_RCC_xxx_CLK_ENABLE()	开启/关闭外设时钟	按需开关，用完即关

2.3 配置系统时钟：从高速到低速的切换

实际项目中，系统时钟很少固定不变。比如一个数据采集器：采集时跑80MHz，处理完数据进入休眠前降到2MHz，然后切到LSI做RTC唤醒。

这个切换过程，我建议分三步走：

1. 配置目标时钟源：用 HAL_RCC_OscConfig() 初始化低速时钟源
2. 切换系统时钟：用 HAL_RCC_ClockConfig() 切换到新时钟
3. 关闭原时钟源：用 HAL_RCC_OscConfig() 关闭高速振荡器

// 示例：从HSE+PLL 80MHz切换到HSI 16MHz
void SystemClock_SwitchToHSI(void)
{
    RCC_OscInitTypeDef RCC_OscInitStruct = {0};
    RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};

    // 第一步：配置HSI为目标时钟源
    RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
    RCC_OscInitStruct.HSIState = RCC_HSI_ON;
    RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
    RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE;
    HAL_RCC_OscConfig(&RCC_OscInitStruct);

    // 第二步：切换系统时钟到HSI，AHB不分频
    RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_HCLK;
    RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_HSI;
    RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
    HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_0);

    // 第三步：关闭HSE和PLL
    RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
    RCC_OscInitStruct.HSEState = RCC_HSE_OFF;
    RCC_OscInitStruct.PLL.PLLState = RCC_PLL_OFF;
    HAL_RCC_OscConfig(&RCC_OscInitStruct);
}

2.4 外设时钟使能：精细化的功耗控制

外设时钟使能，是低功耗设计中最容易被忽视的环节。很多人只会在初始化时开时钟，但从来不知道关。

我曾经接手过一个项目，代码里所有外设时钟在main函数开头一次性全开了，然后整个运行周期都没关过。即使外设闲置，时钟还在跑，功耗白白浪费。

正确的做法是：用前开，用完关。

// 正确做法：按需开关外设时钟
void Read_Sensor_Data(void)
{
    // 开时钟
    __HAL_RCC_GPIOA_CLK_ENABLE();
    __HAL_RCC_ADC1_CLK_ENABLE();

    // 配置并读取ADC
    // ...

    // 关时钟
    __HAL_RCC_ADC1_CLK_DISABLE();
    // GPIO如果后续不用，也关掉
    __HAL_RCC_GPIOA_CLK_DISABLE();
}

2.5 降低运行功耗的实战技巧

结合时钟配置，我总结了几个降低运行功耗的实用方法：

• 降频运行：不需要高性能时，切到HSI或降低PLL倍频。比如从80MHz降到16MHz，功耗能降一半以上。
• 关闭未用外设时钟：用 __HAL_RCC_xxx_CLK_DISABLE() 关掉所有不用的外设。
• 调整Flash等待周期：频率降低后，等待周期也可以减少，进一步省电。
• 使用低速时钟源：RTC、看门狗等用LSE/LSI，别用HSE。

2.6 避坑指南

最后，分享几个我实际项目中遇到的坑：

• 时钟切换失败：切换前没检查目标时钟是否稳定。用 HAL_RCC_GetOscConfig() 确认状态。
• 外设时钟未关导致休眠失败：进入Stop模式前，必须关掉所有外设时钟，否则MCU无法进入低功耗状态。
• PLL配置错误：PLL倍频超出芯片规格，导致系统不稳定。查手册确认VCO范围。