2. GPIO 外设驱动与调试：从寄存器到实战

各位好，欢迎来到第二章。上一章我们把 CH32V 的开发环境搭好了，也跑了第一个点灯程序。但说真的，那个点灯只是让芯片“动起来”，离真正理解 GPIO 还差得远。

这一章，咱们把 GPIO 的底裤扒干净。寄存器怎么配、推挽和开漏到底啥区别、上下拉电阻什么时候用、中断怎么触发。最后，我会带你把按键控制 LED 的实战走一遍。这些东西搞透了，后面所有外设驱动你都会顺手很多。

2.1 GPIO 寄存器详解——别被手册吓到

CH32V 的 GPIO 寄存器，说多不多，说少不少。每个端口有 10 来个寄存器，但常用的就那几个。我刚开始看沁恒的手册时也觉得头大，后来发现规律很简单：配置类寄存器 + 数据类寄存器 + 中断类寄存器。

咱们以 PA 口为例，核心寄存器就这几个：

CFGLR 和 CFGHR 每个引脚占 4 位，结构完全一样：

// CFGLR 中每 4 位的含义（以 PA0 为例，位 [3:0]）
// [3:2] MODE: 00=输入, 01=输出(10MHz), 10=输出(2MHz), 11=输出(50MHz)
// [1:0] CNF:  输入模式: 00=模拟, 01=浮空, 10=上拉/下拉, 11=保留
//             输出模式: 00=推挽, 01=开漏, 10=复用推挽, 11=复用开漏

嗯，这里要注意：MODE 位在输入模式下其实无效，但手册上写的是“必须配置为 00”。我踩过这个坑——有一次把输入引脚配成了 MODE=01，结果读到的电平一直不对，查了半天才发现是这里的问题。

2.2 推挽输出 vs 开漏输出——选错了会出问题

这两个概念，说白了就是输出级的结构不同。

• 推挽输出： 内部有 PMOS 和 NMOS 两个管子，输出高电平时 PMOS 导通，低电平时 NMOS 导通。速度快，驱动能力强。
• 开漏输出： 只有 NMOS，输出低电平时 NMOS 导通，输出高电平时 NMOS 截止（高阻态）。必须外接上拉电阻才能输出高电平。

我在项目中遇到过一个问题：用推挽输出驱动一个 5V 的继电器模块，结果发现高电平只有 3.3V，继电器吸合不可靠。后来换成开漏输出，外接 5V 上拉电阻，问题就解决了。说白了，开漏输出的核心价值就是电平转换和线与能力。

2.3 上下拉电阻配置——别让引脚“悬空”

GPIO 的上下拉电阻，很多人觉得无所谓。但你知道吗？浮空输入的引脚，功耗会比有确定电平的引脚高 10 倍以上。而且，浮空引脚容易受电磁干扰，读到的电平随机跳变。

CH32V 的上下拉配置在 CFGLR 的 CNF 位里：

• 上拉： CNF=10，内部约 40kΩ 电阻接到 VCC
• 下拉： CNF=10，内部约 40kΩ 电阻接到 GND
• 浮空： CNF=01，内部无上下拉

等等，你可能注意到了——上拉和下拉的 CNF 值都是 10？没错，区别在于 ODR 寄存器的值：ODR=1 时是上拉，ODR=0 时是下拉。这个设计挺巧妙的，但也很容易搞混。

// 配置 PA0 为上拉输入
GPIOA->CFGLR &= ~(0xF << 0);    // 先清空 PA0 的 4 位
GPIOA->CFGLR |= (0x8 << 0);     // MODE=00, CNF=10
GPIOA->OUTDR |= (1 << 0);       // ODR=1 选择上拉

// 配置 PA0 为下拉输入
GPIOA->CFGLR &= ~(0xF << 0);
GPIOA->CFGLR |= (0x8 << 0);     // MODE=00, CNF=10
GPIOA->OUTDR &= ~(1 << 0);      // ODR=0 选择下拉

2.4 GPIO 中断配置——别让 CPU 空转

轮询按键？那是初学者干的事。真正做产品，必须用中断。CH32V 的 GPIO 中断是通过 EXTI（外部中断控制器）实现的，每个 GPIO 引脚都可以作为中断源。

配置步骤其实就四步：

1. 配置 GPIO 模式： 输入模式，带上拉或下拉
2. 配置 EXTI 映射： 把引脚连接到 EXTI 通道
3. 配置中断触发方式： 上升沿、下降沿、双边沿
4. 使能中断并编写 ISR： 注意清中断标志

// 以 PA0 为例，配置下降沿触发中断
void GPIO_EXTI_Init(void)
{
    // 1. GPIO 配置
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IPU;  // 上拉输入
    GPIO_Init(GPIOA, &GPIO_InitStruct);
    
    // 2. EXTI 映射
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
    GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0);
    
    // 3. 配置 EXTI
    EXTI_InitTypeDef EXTI_InitStruct = {0};
    EXTI_InitStruct.EXTI_Line = EXTI_Line0;
    EXTI_InitStruct.EXTI_Mode = EXTI_Mode_Interrupt;
    EXTI_InitStruct.EXTI_Trigger = EXTI_Trigger_Falling;  // 下降沿
    EXTI_InitStruct.EXTI_LineCmd = ENABLE;
    EXTI_Init(&EXTI_InitStruct);
    
    // 4. 使能 NVIC
    NVIC_InitTypeDef NVIC_InitStruct = {0};
    NVIC_InitStruct.NVIC_IRQChannel = EXTI0_IRQn;
    NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 1;
    NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0;
    NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStruct);
}

// 中断服务函数
void EXTI0_IRQHandler(void)
{
    if(EXTI_GetITStatus(EXTI_Line0) != RESET)
    {
        // 处理按键事件
        // ... 
        EXTI_ClearITPendingBit(EXTI_Line0);  // 一定要清标志！
    }
}

2.5 实战：按键控制 LED——把知识串起来

好了，理论讲完了，咱们来点实际的。这个实战的目标很简单：按键按下时 LED 翻转状态。但我会用中断方式实现，并且加入软件消抖。

硬件连接：

• PA0 → 按键（另一端接 GND）
• PC0 → LED（串联 330Ω 电阻到 VCC）

完整代码：

#include "ch32v30x.h"

volatile uint8_t key_pressed = 0;

void GPIO_Config(void)
{
    // LED 输出
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);
    GPIO_InitTypeDef GPIO_InitStruct = {0};
    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_Out_PP;  // 推挽输出
    GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOC, &GPIO_InitStruct);
    
    // 按键输入 + 中断
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE);
    GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0;
    GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IPU;  // 上拉输入
    GPIO_Init(GPIOA, &GPIO_InitStruct);
}

void EXTI_Config(void)
{
    RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO, ENABLE);
    GPIO_EXTILineConfig(GPIO_PortSourceGPIOA, GPIO_PinSource0);
    
    EXTI_InitTypeDef EXTI_InitStruct = {0};
    EXTI_InitStruct.EXTI_Line = EXTI_Line0;
    EXTI_InitStruct.EXTI_Mode = EXTI_Mode_Interrupt;
    EXTI_InitStruct.EXTI_Trigger = EXTI_Trigger_Falling;  // 按键按下时下降沿
    EXTI_InitStruct.EXTI_LineCmd = ENABLE;
    EXTI_Init(&EXTI_InitStruct);
    
    NVIC_InitTypeDef NVIC_InitStruct = {0};
    NVIC_InitStruct.NVIC_IRQChannel = EXTI0_IRQn;
    NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 2;
    NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0;
    NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE;
    NVIC_Init(&NVIC_InitStruct);
}

void EXTI0_IRQHandler(void)
{
    if(EXTI_GetITStatus(EXTI_Line0) != RESET)
    {
        // 软件消抖：延时 10ms 再检测
        Delay_Ms(10);
        if(GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) == 0)
        {
            key_pressed = 1;  // 设标志，主循环处理
        }
        EXTI_ClearITPendingBit(EXTI_Line0);
    }
}

void Delay_Ms(uint32_t ms)
{
    uint32_t i, j;
    for(i = 0; i < ms; i++)
        for(j = 0; j < 8000; j++);  // 粗略延时，实际用 SysTick 更准
}

int main(void)
{
    SystemCoreClockUpdate();
    GPIO_Config();
    EXTI_Config();
    
    // 初始状态：LED 灭
    GPIO_SetBits(GPIOC, GPIO_Pin_0);
    
    while(1)
    {
        if(key_pressed)
        {
            key_pressed = 0;
            // 翻转 LED
            if(GPIO_ReadOutputDataBit(GPIOC, GPIO_Pin_0) == 0)
                GPIO_SetBits(GPIOC, GPIO_Pin_0);
            else
                GPIO_ResetBits(GPIOC, GPIO_Pin_0);
        }
    }
}

你想想看，这个结构其实可以扩展到很多场景。比如把按键换成传感器，把 LED 换成电机，核心逻辑是一样的。嗯，这就是 GPIO 驱动的通用框架。