4. GPIO外设驱动

时钟，是MCU的心脏。没有时钟，芯片就是一块冰冷的硅片。CH32V203的时钟树，说实话，比我想象中要灵活得多。我第一次拿到参考手册时，看到那个时钟树图，第一反应是“有点复杂”。但当你真正用起来，会发现这种设计其实很贴心——它给了你足够多的选择，去平衡性能和功耗。

这一章，我们就来把这棵时钟树掰开揉碎，看看每个分支怎么用，怎么配，怎么切换。

4.1 时钟树整体架构

CH32V203的时钟树，核心是一个多路选择器架构。系统时钟（SYSCLK）可以从三个源头选一个：

• HSE：外部高速晶振，通常是8MHz
• HSI：内部高速RC振荡器，出厂校准到8MHz
• PLL：锁相环倍频输出，可以基于HSE或HSI

选好之后，经过AHB预分频器，得到HCLK（AHB总线时钟）。然后APB1和APB2再各自分频，给外设用。

我画了一张简化的时钟树结构图，你看一眼就明白了：

4.2 四大时钟源详解

CH32V203有四个时钟源，两高两低。我整理了一个表格，方便你对比：

这里有个坑，我提一下。LSE的启动时间特别长，能达到1秒。如果你在低功耗模式下用LSE做RTC，唤醒后别急着读时间，等它稳定再说。我曾经在这个问题上吃过亏——RTC刚唤醒时读出来的秒数跳变了好几次。

4.3 PLL倍频配置

PLL是性能的关键。CH32V203的PLL可以基于HSE或HSI，倍频系数从2到16。系统最高频率是120MHz，所以PLL输出不能超过这个值。

举个例子，如果你用8MHz HSE，想跑到120MHz：

PLL输出 = HSE频率 × 倍频系数
120MHz = 8MHz × 15

倍频系数15，正好在范围内。配置代码是这样的：

// 配置PLL，使用HSE作为时钟源，倍频到120MHz
RCC_PLLInitTypeDef pllInit = {0};
pllInit.Source = RCC_PLLSOURCE_HSE;  // PLL时钟源选择HSE
pllInit.Mul = RCC_PLL_MUL_15;        // 倍频系数15倍
RCC_PLL_Init(&pllInit);

// 使能PLL，等待就绪
RCC_PLL_Cmd(ENABLE);
while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET);

4.4 系统时钟切换实战

时钟切换，说白了就是改RCC_CFGR寄存器里的SW位。但直接改会有风险——万一新时钟没准备好，系统就“死”了。

安全的切换流程，我总结为三步：

1. 准备新时钟源：使能并等待就绪
2. 切换：写SW位，选择新时钟
3. 验证：读SWS位，确认切换成功

下面是一个从HSI切换到HSE+PLL的例子：

void SystemClock_SwitchToPLL(void)
{
    // 1. 使能HSE，等待稳定
    RCC_HSE_Config(RCC_HSE_ON);
    while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET);

    // 2. 配置并启动PLL
    RCC_PLLInitTypeDef pllInit = {0};
    pllInit.Source = RCC_PLLSOURCE_HSE;
    pllInit.Mul = RCC_PLL_MUL_15;
    RCC_PLL_Init(&pllInit);
    RCC_PLL_Cmd(ENABLE);
    while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET);

    // 3. 切换系统时钟到PLL
    RCC_SYSCLKConfig(RCC_SYSCLK_SOURCE_PLL);

    // 4. 等待切换完成
    while(RCC_GetSYSCLKSource() != RCC_SYSCLK_SOURCE_PLL);
}

4.5 各总线时钟配置

系统时钟搞定后，还要配AHB和APB的分频。CH32V203的时钟树里，AHB、APB1、APB2是串联关系：

• HCLK (AHB总线)：最高120MHz，给CPU、DMA、Flash等用
• PCLK2 (APB2)：最高120MHz，给GPIO、SPI1、USART1等高速外设
• PCLK1 (APB1)：最高60MHz，给I2C、USART2/3、定时器等

配置代码示例：

// 假设SYSCLK = 120MHz
// AHB不分频 -> HCLK = 120MHz
// APB2不分频 -> PCLK2 = 120MHz
// APB1二分频 -> PCLK1 = 60MHz

RCC_HCLKConfig(RCC_SYSCLK_Div1);    // AHB不分频
RCC_PCLK2Config(RCC_HCLK_Div1);     // APB2不分频
RCC_PCLK1Config(RCC_HCLK_Div2);     // APB1二分频

4.6 时钟安全与故障处理

CH32V203有个很实用的功能——时钟安全系统（CSS）。如果HSE突然失效，CSS会自动把系统时钟切回HSI，并产生一个中断。

我建议你在关键产品里开启这个功能：

// 使能时钟安全系统
RCC_ClockSecuritySystemCmd(ENABLE);

// 在中断中处理HSE失效
void RCC_IRQHandler(void)
{
    if(RCC_GetITStatus(RCC_IT_CSS) != RESET)
    {
        // HSE失效！系统已自动切到HSI
        // 这里可以记录错误，或者尝试重新启动HSE
        RCC_ClearITPendingBit(RCC_IT_CSS);
    }
}

4.7 实战：一键配置到120MHz

最后，我给你一个完整的系统时钟初始化函数。这是我项目里一直在用的模板，你直接拿去用：

void SystemClock_Config(void)
{
    // 先切到HSI，确保当前时钟稳定
    RCC_SYSCLKConfig(RCC_SYSCLK_SOURCE_HSI);
    while(RCC_GetSYSCLKSource() != RCC_SYSCLK_SOURCE_HSI);

    // 使能HSE
    RCC_HSE_Config(RCC_HSE_ON);
    uint32_t timeout = 100000;
    while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) == RESET)
    {
        if(--timeout == 0)
        {
            // HSE启动失败，继续用HSI
            return;
        }
    }

    // 配置PLL: HSE x15 = 120MHz
    RCC_PLLInitTypeDef pllInit = {0};
    pllInit.Source = RCC_PLLSOURCE_HSE;
    pllInit.Mul = RCC_PLL_MUL_15;
    RCC_PLL_Init(&pllInit);
    RCC_PLL_Cmd(ENABLE);
    while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET);

    // 配置总线分频
    RCC_HCLKConfig(RCC_SYSCLK_Div1);
    RCC_PCLK2Config(RCC_HCLK_Div1);
    RCC_PCLK1Config(RCC_HCLK_Div2);

    // 切换到PLL
    RCC_SYSCLKConfig(RCC_SYSCLK_SOURCE_PLL);
    while(RCC_GetSYSCLKSource() != RCC_SYSCLK_SOURCE_PLL);

    // 开启CSS
    RCC_ClockSecuritySystemCmd(ENABLE);
}

这个函数做了超时判断，即使HSE坏了，系统也不会死机。嗯，这就是我想要的健壮性。