📚 课程目录第3章开发环境搭建

3. 开发环境搭建

GPIO 驱动，说白了就是让芯片的引脚听话。你想让它输出高电平就高电平，想让它检测按键就检测按键。听起来简单，但实际项目中翻车最多的往往就是 GPIO。我刚开始做 BSP 的时候，就因为在中断里没做防抖，结果产品被客户投诉“按键乱跳”。嗯，今天咱们就把 GPIO 的这几个关键点彻底讲透。

本章核心脉络：寄存器映射 → 输入/输出模式配置 → 中断配置与 ISR 编写 → 防抖与电平检测。一条线走下来，你就能写出健壮的 GPIO 驱动。

3.1 GPIO寄存器映射——找到那个“开关”

每个 GPIO 引脚背后都有一组寄存器在控制它。你想想看，芯片厂商不可能给每个引脚单独拉一根控制线，那样芯片得做成刺猬。所以它们用寄存器来统一管理。

以 STM32 为例，GPIO 的寄存器基地址通常是 0x40020000（GPIOA）。每个端口有 10 个左右的寄存器，比如：

寄存器	偏移地址	功能
GPIOx_MODER	0x00	模式选择（输入/输出/复用/模拟）
GPIOx_OTYPER	0x04	输出类型（推挽/开漏）
GPIOx_OSPEEDR	0x08	输出速度
GPIOx_PUPDR	0x0C	上拉/下拉配置
GPIOx_IDR	0x10	输入数据寄存器（读引脚电平）
GPIOx_ODR	0x14	输出数据寄存器（写引脚电平）
GPIOx_BSRR	0x18	位设置/复位寄存器（原子操作）

我个人习惯用结构体指针来映射寄存器，这样代码可读性高，也方便移植。比如这样：

typedef struct {
    volatile uint32_t MODER;    // 0x00
    volatile uint32_t OTYPER;   // 0x04
    volatile uint32_t OSPEEDR;  // 0x08
    volatile uint32_t PUPDR;    // 0x0C
    volatile uint32_t IDR;      // 0x10
    volatile uint32_t ODR;      // 0x14
    volatile uint32_t BSRR;     // 0x18
} GPIO_TypeDef;

#define GPIOA_BASE      0x40020000
#define GPIOA           ((GPIO_TypeDef *)GPIOA_BASE)

小技巧：用 volatile 关键字告诉编译器“这个寄存器的值可能被硬件改变”，防止优化时把读操作给跳过了。我见过有人没加 volatile，结果调试了一整天。

3.2 输入输出模式配置——让引脚“听话”

配置 GPIO 模式，核心就是操作 MODER 寄存器。每个引脚占 2 位：

00：输入模式
01：输出模式
10：复用功能模式
11：模拟模式

举个例子，把 PA5 配置成推挽输出：

// 先清除 PA5 对应的两位（bit10-11）
GPIOA->MODER &= ~(0x3 << 10);
// 设置为输出模式（01）
GPIOA->MODER |= (0x1 << 10);

// 配置推挽输出（默认就是推挽，OTYPER 对应位为 0）
GPIOA->OTYPER &= ~(0x1 << 5);

// 配置输出速度（一般用 50MHz 就够）
GPIOA->OSPEEDR &= ~(0x3 << 10);
GPIOA->OSPEEDR |= (0x2 << 10);  // 50MHz

// 配置无上拉无下拉
GPIOA->PUPDR &= ~(0x3 << 10);

输出电平就简单了，写 ODR 或者用 BSRR：

// 写 ODR（非原子操作，可能被中断打断）
GPIOA->ODR |= (1 << 5);   // 高电平
GPIOA->ODR &= ~(1 << 5);  // 低电平

// 用 BSRR（原子操作，推荐）
GPIOA->BSRR = (1 << 5);   // 置位（高电平）
GPIOA->BSRR = (1 << 21);  // 复位（低电平，高16位对应复位）

注意：ODR 的“读-改-写”操作在多任务或中断环境下可能出问题。比如你读回来是 0x20，改完写回去，中间被中断改了其他位，那就覆盖了。BSRR 是硬件原子操作，我建议你养成用 BSRR 的习惯。

3.3 中断配置与ISR编写——别让CPU空转

轮询读引脚？那是初学者干的事。真正做产品，必须用中断。GPIO 中断的配置流程大致如下：

使能 SYSCFG 时钟（用于外部中断配置）
配置 GPIO 为输入模式（带上拉或下拉）
选择中断线（EXTI 线号与引脚号对应）
配置触发边沿（上升沿、下降沿或双边沿）
使能中断线（EXTI_IMR）
配置 NVIC（设置优先级并使能）
编写 ISR（中断服务函数）

以 PA0 引脚（EXTI0）为例：

// 1. 使能 SYSCFG 时钟
RCC->APB2ENR |= RCC_APB2ENR_SYSCFGEN;

// 2. 配置 PA0 为输入，带上拉
GPIOA->MODER &= ~(0x3 << 0);  // 输入模式
GPIOA->PUPDR |= (0x1 << 0);   // 上拉

// 3. 选择 EXTI0 的输入源为 PA0
SYSCFG->EXTICR[0] &= ~SYSCFG_EXTICR1_EXTI0;
SYSCFG->EXTICR[0] |= SYSCFG_EXTICR1_EXTI0_PA;

// 4. 配置下降沿触发（按键按下）
EXTI->FTSR |= EXTI_FTSR_TR0;

// 5. 使能 EXTI0 中断线
EXTI->IMR |= EXTI_IMR_MR0;

// 6. 配置 NVIC
NVIC_SetPriority(EXTI0_IRQn, 2);
NVIC_EnableIRQ(EXTI0_IRQn);

ISR 怎么写？记住一个原则：快进快出。不要在中断里做延时、打印、复杂计算。我一般只做两件事：清中断标志位 + 设置一个标志位或发一个信号量。

void EXTI0_IRQHandler(void) {
    // 检查中断标志位
    if (EXTI->PR & EXTI_PR_PR0) {
        // 清标志位（写1清除）
        EXTI->PR = EXTI_PR_PR0;

        // 设置标志位，通知主循环处理
        g_button_pressed = 1;

        // 或者用 RTOS 的信号量
        // xSemaphoreGiveFromISR(xButtonSem, NULL);
    }
}

核心原则：ISR 里只做“最小必要操作”。真正的工作（比如处理按键逻辑）放到主循环或任务里去做。这样系统响应快，也不容易出死锁。

3.4 防抖与电平检测技巧——别让按键“乱跳”

机械按键按下和释放的瞬间，电平会抖动几十毫秒。如果不做防抖，一次按下可能触发几十次中断。我曾经在一个项目中没做防抖，结果按一次按键，串口打印了 47 次“按键按下”……

防抖有两种主流做法：

方法	原理	优点	缺点
硬件防抖	RC 低通滤波 + 施密特触发器	不占 CPU，响应快	增加 BOM 成本
软件防抖	延时采样或定时器轮询	零成本，灵活	占用 CPU 时间

嵌入式产品里，软件防抖更常见。我推荐用“定时器轮询 + 状态机”的方式，比简单的 delay(20ms) 靠谱得多。

下面是一个简单的状态机防抖实现：

typedef enum {
    KEY_STATE_IDLE,      // 空闲
    KEY_STATE_DEBOUNCE,  // 防抖中
    KEY_STATE_PRESSED,   // 确认按下
    KEY_STATE_RELEASE    // 释放中
} KeyState_t;

KeyState_t key_state = KEY_STATE_IDLE;
uint8_t key_pin_level;

void Key_Scan(void) {
    // 每 5ms 调用一次（由定时器触发）
    key_pin_level = (GPIOA->IDR & (1 << 0)) ? 1 : 0;

    switch (key_state) {
        case KEY_STATE_IDLE:
            if (key_pin_level == 0) {  // 检测到低电平（按下）
                key_state = KEY_STATE_DEBOUNCE;
            }
            break;

        case KEY_STATE_DEBOUNCE:
            if (key_pin_level == 0) {
                // 连续两次采样都是低电平，确认按下
                key_state = KEY_STATE_PRESSED;
                // 通知应用层：按键按下
                Key_EventCallback(KEY_EVENT_PRESSED);
            } else {
                // 抖动，回到空闲
                key_state = KEY_STATE_IDLE;
            }
            break;

        case KEY_STATE_PRESSED:
            if (key_pin_level == 1) {  // 检测到高电平（释放）
                key_state = KEY_STATE_RELEASE;
            }
            break;

        case KEY_STATE_RELEASE:
            if (key_pin_level == 1) {
                key_state = KEY_STATE_IDLE;
                // 通知应用层：按键释放
                Key_EventCallback(KEY_EVENT_RELEASED);
            } else {
                key_state = KEY_STATE_PRESSED;
            }
            break;
    }
}

经验之谈：采样间隔 5-10ms 比较合适。太短了防不住抖动，太长了响应迟钝。另外，如果按键用于唤醒系统，那必须用中断触发，然后在中断里启动一个定时器来做防抖。

3.5 本章知识体系总览

下面这张图把 GPIO 驱动的核心流程串起来了。你可以把它当作一个检查清单，写驱动时对照着来。

嗯，到这里 GPIO 驱动的核心内容就讲完了。从寄存器映射到防抖，每一步都有坑，但只要你按照这个流程走，基本不会出大问题。我当年第一次写 GPIO 驱动时，漏了使能 SYSCFG 时钟，结果中断死活不触发，查了两天才发现……希望你别踩这个坑。