📚 课程目录第3章 GPIO驱动开发

第3章 GPIO驱动开发：从寄存器到RTOS封装

GPIO，说白了就是芯片的“手脚”。你要让LED亮、检测按键、控制外设使能，都得靠它。在RTOS环境下，GPIO驱动怎么写才够“专业”？我踩过不少坑，今天把经验摊开来讲。

本章核心脉络：寄存器映射 → 输出模式（推挽/开漏） → 输入模式（上拉/下拉） → 中断配置 → RTOS驱动封装

3.1 GPIO寄存器映射——别被地址搞晕

做驱动开发，第一件事就是找到寄存器的“门牌号”。不同MCU的GPIO寄存器布局差异很大，但套路差不多。

以STM32为例，GPIO外设挂载在AHB总线上，基地址从0x40020000开始。每个GPIO端口占用1KB空间，里面塞了十几个寄存器。我个人习惯把寄存器映射定义成结构体，这样代码可读性高很多。

// GPIO寄存器映射结构体（以STM32为例）
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
    volatile uint32_t LCKR;     // 锁定寄存器  偏移0x1C
    volatile uint32_t AFR[2];   // 复用功能    偏移0x20-0x24
} GPIO_TypeDef;

// 基地址宏定义
#define GPIOA_BASE      0x40020000UL
#define GPIOA           ((GPIO_TypeDef *)GPIOA_BASE)

我的习惯：所有寄存器都用 volatile 修饰，防止编译器优化掉你的读写操作。曾经有人忘了加，调试了一整天——嗯，血泪教训。

3.2 输出模式：推挽 vs 开漏

输出模式选不对，电路可能直接冒烟。我见过新手把开漏当推挽用，结果IO口拉不到高电平，一脸懵。

特性	推挽输出	开漏输出
输出高电平	由VDD提供，直接输出高	需要外部上拉电阻
输出低电平	NMOS导通，拉低到GND	NMOS导通，拉低到GND
驱动能力	强，可驱动LED、蜂鸣器	弱，取决于上拉电阻
多设备共用	不能线与	支持线与（I2C总线）
电平转换	需要额外电路	天然支持不同电压域

什么时候用推挽？驱动LED、控制继电器、普通数字信号输出。说白了，大多数场景都用推挽。

什么时候用开漏？I2C总线、多个设备共享一根信号线、需要电平转换的场合。我曾经在一个项目里用开漏实现了3.3V和5V系统的无缝对接，省了一个电平转换芯片。

// 配置推挽输出
GPIOA->MODER &= ~(0x3 << (5 * 2));   // 清零PA5模式位
GPIOA->MODER |= (0x1 << (5 * 2));    // 设为输出模式
GPIOA->OTYPER &= ~(0x1 << 5);        // 推挽输出（0=推挽）

// 配置开漏输出
GPIOA->MODER |= (0x1 << (6 * 2));    // 输出模式
GPIOA->OTYPER |= (0x1 << 6);         // 开漏输出（1=开漏）
// 别忘了外部上拉电阻！

注意：开漏输出如果不接上拉电阻，高电平状态是“高阻”，不是“高电平”。用万用表量出来可能是浮空电压，别以为是芯片坏了。

3.3 输入模式：上拉、下拉与浮空

输入模式看似简单，但“抖动”和“不确定态”是两大杀手。你想想看，按键按下时电平跳来跳去，不加处理的话，一次按下可能被识别成十次。

GPIO输入有三种配置：

浮空输入：内部无上下拉，电平由外部决定。适合外部已经有明确驱动的情况。
上拉输入：内部接VDD，默认高电平。按键接地时常用。
下拉输入：内部接GND，默认低电平。按键接VDD时常用。

// 配置上拉输入（按键检测）
GPIOA->MODER &= ~(0x3 << (0 * 2));   // 输入模式（00）
GPIOA->PUPDR |= (0x1 << (0 * 2));    // 上拉（01）

// 配置下拉输入
GPIOB->MODER &= ~(0x3 << (3 * 2));   // 输入模式
GPIOB->PUPDR |= (0x2 << (3 * 2));    // 下拉（10）

避坑指南：我曾经在低功耗项目里用了外部上拉电阻，结果休眠时电流多了几十微安。后来换成内部上拉，功耗直接降下来。内部上拉电阻一般在40-50kΩ，外部可以根据需要选更小的值。

3.4 中断配置——别让CPU空转

轮询？那是裸机时代的玩法。RTOS下，中断才是王道。但中断配置有讲究，配置不好就是“中断风暴”，系统直接卡死。

GPIO中断的典型流程：

配置GPIO为输入模式
配置中断触发边沿（上升沿、下降沿、双边沿）
使能NVIC中的对应中断线
编写中断服务函数（ISR）
在ISR中清除中断标志位

// 配置PA0为下降沿中断
GPIOA->MODER &= ~(0x3 << (0 * 2));   // 输入模式

// 配置中断触发边沿
EXTI->IMR |= (1 << 0);                // 不屏蔽中断线0
EXTI->FTSR |= (1 << 0);              // 下降沿触发

// 使能NVIC
NVIC_EnableIRQ(EXTI0_IRQn);
NVIC_SetPriority(EXTI0_IRQn, 2);      // 优先级设低一点

// 中断服务函数
void EXTI0_IRQHandler(void) {
    if (EXTI->PR & (1 << 0)) {
        // 处理中断事件
        // ... 
        EXTI->PR = (1 << 0);          // 清除标志位
    }
}

重要：中断服务函数里不要做耗时操作！我曾经见过有人在ISR里调用printf，结果系统直接死机。ISR应该只做“标记事件+唤醒任务”，具体处理交给任务去干。

3.5 RTOS下的GPIO驱动封装

裸机写GPIO驱动很简单，但到了RTOS环境，事情就复杂了。多个任务可能同时操作同一个GPIO，不加保护的话，资源竞争分分钟教你做人。

我一般这样封装RTOS下的GPIO驱动：

封装层	职责	关键点
硬件抽象层	直接操作寄存器	volatile、位操作宏
驱动接口层	提供统一API	GPIO_Init、GPIO_Write、GPIO_Read
RTOS适配层	互斥锁、任务通知	信号量、队列、中断延迟处理

// RTOS GPIO驱动接口示例
typedef struct {
    GPIO_TypeDef *port;
    uint16_t pin;
    uint8_t mode;       // 输入/输出/中断
    uint8_t pull;       // 上拉/下拉/浮空
    SemaphoreHandle_t lock;  // 互斥锁
} GPIO_Device_t;

// 初始化GPIO设备
int GPIO_DeviceInit(GPIO_Device_t *dev) {
    // 配置寄存器...
    dev->lock = xSemaphoreCreateMutex();
    if (dev->lock == NULL) {
        return -1;  // 创建失败
    }
    return 0;
}

// 线程安全的GPIO写操作
void GPIO_DeviceWrite(GPIO_Device_t *dev, uint8_t level) {
    if (xSemaphoreTake(dev->lock, portMAX_DELAY) == pdTRUE) {
        if (level) {
            dev->port->BSRR = (1 << dev->pin);  // 置位
        } else {
            dev->port->BSRR = (1 << (dev->pin + 16)); // 复位
        }
        xSemaphoreGive(dev->lock);
    }
}

// 中断回调注册
typedef void (*GPIO_ISR_Callback_t)(void *arg);
int GPIO_DeviceRegisterISR(GPIO_Device_t *dev, 
                           GPIO_ISR_Callback_t cb, 
                           void *arg) {
    // 保存回调函数指针
    // 配置中断...
    return 0;
}

核心思想：RTOS下的驱动封装，本质上是把“裸机函数”包装成“线程安全+中断友好”的接口。互斥锁保护共享资源，队列或信号量实现中断到任务的通信。

3.6 实战经验：一个GPIO中断驱动的按键检测任务

说了这么多，来个完整的例子。假设我们要用按键触发一个事件，在RTOS下怎么做？

// 按键任务
void KeyTask(void *pvParameters) {
    GPIO_Device_t keyDev = {
        .port = GPIOA,
        .pin = 0,
        .mode = GPIO_MODE_IT_FALLING,
        .pull = GPIO_PULLUP
    };
    
    // 初始化
    GPIO_DeviceInit(&keyDev);
    
    // 注册中断回调（在ISR中发送信号量）
    GPIO_DeviceRegisterISR(&keyDev, KeyISRCallback, &keySem);
    
    while (1) {
        // 等待信号量（超时设为最大）
        if (xSemaphoreTake(keySem, portMAX_DELAY) == pdTRUE) {
            // 消抖处理（延时20ms）
            vTaskDelay(pdMS_TO_TICKS(20));
            
            // 再次确认电平
            if (GPIO_DeviceRead(&keyDev) == 0) {
                // 执行按键动作
                printf("Key pressed!\n");
            }
        }
    }
}

我的经验：中断里只做“give信号量”这一个动作，消抖和业务逻辑全放在任务里。这样既保证了中断的快速响应，又避免了ISR里做复杂操作带来的风险。

嗯，GPIO驱动开发的核心就是这些。从寄存器映射到RTOS封装，每一步都有它的道理。你写驱动的时候，多想想“这个操作在RTOS环境下会不会出问题”，慢慢就能形成自己的套路了。