3. GPIO驱动与板级适配

GPIO 是 MCX 系列 MCU 上最基础、也最容易被低估的外设。它看似只是“读引脚、写引脚”，但在实际板级适配中，GPIO 驱动要同时处理寄存器映射、方向与电气模式配置、中断触发方式选择、按键与 LED 的板级差异，以及机械按键抖动带来的误触发问题。本节以 MCX 的 GPIO 模块为对象，把这几件事串成一条可落地的实现路径。

寄存器映射：从端口到引脚

MCX 的 GPIO 通常按端口（PORT）组织，每个端口包含若干引脚，端口与引脚共同决定一个唯一的物理引脚。驱动层需要建立“端口基地址 + 引脚号”的映射关系。以常见的 MCX 端口结构为例，每个端口有一组控制寄存器：数据方向寄存器（PDDR）决定输入/输出，数据寄存器（PDOR）保存输出值，置位/清零寄存器（PSOR/PCOR）用于无读改写地修改输出，输入数据寄存器（PDIR）读取引脚电平，此外还有引脚控制寄存器（PCR）负责复用功能、上下拉、驱动强度和中断配置。

在驱动中，建议把端口基地址和引脚号封装成句柄，例如 gpio_port_t 与 gpio_pin_t，避免在业务代码里直接出现裸地址。下面是一段示意性的寄存器访问代码，用于说明映射关系：

typedef struct {
    volatile uint32_t PDOR;   // 输出数据
    volatile uint32_t PSOR;   // 置位
    volatile uint32_t PCOR;   // 清零
    volatile uint32_t PTOR;   // 翻转
    volatile uint32_t PDIR;   // 输入数据
    volatile uint32_t PDDR;   // 方向
    volatile uint32_t PIDR;   // 输入禁用
    volatile uint32_t PCR[32];// 引脚控制
} GPIO_Type;

#define GPIOA ((GPIO_Type *)0x400FF000u)

// 将 PA3 配置为输出
GPIOA->PDDR |= (1u << 3);
// 输出高电平，使用置位寄存器避免读改写
GPIOA->PSOR = (1u << 3);

这里的关键点是：输出置位/清零优先使用 PSOR/PCOR，而不是对 PDOR 做“读—改—写”，因为后者在多任务或中断环境下可能丢失其他引脚的修改。输入读取则统一走 PDIR，不要依赖 PDOR 的残留值。

输入输出模式与电气配置

方向只是第一步。一个引脚要真正可用，还要配置 PCR 中的复用选择（MUX）、上拉/下拉、驱动强度和开漏/推挽。对于 LED 输出，通常选择 GPIO 复用、推挽输出、适当驱动强度；对于按键输入，通常选择 GPIO 复用、使能内部上拉或下拉，并打开输入缓冲。若按键一端接地，则使能内部上拉，按下时读到低电平；若按键一端接电源，则使能内部下拉，按下时读到高电平。这个“按下电平”必须在驱动和板级配置中保持一致，否则后续中断触发沿会完全相反。

中断触发方式

GPIO 中断的触发方式由 PCR 中的中断配置位决定，常见选项包括：低电平触发、高电平触发、上升沿触发、下降沿触发以及双边沿触发。选择依据是信号行为和抗干扰需求。按键按下通常产生一个边沿，若按键为“按下接地”，则按下瞬间是下降沿，释放瞬间是上升沿；如果只关心按下动作，选下降沿即可。对于电平触发，只要电平保持有效就会持续请求中断，适合需要持续响应的信号，但容易在中断服务函数未及时清除时反复进入。

在 MCX 上，GPIO 中断通常还需要在 NVIC 中使能对应端口中断，并在中断服务函数中读取中断标志、执行处理、清除标志。清除标志的顺序很重要：先读状态、再清标志，避免在清除过程中丢失新的边沿。

按键与 LED 的板级适配

板级适配的核心是把“原理图上的连接”翻译成“驱动可用的配置”。以一块典型 MCX 开发板为例：LED 阳极通过限流电阻接 3.3V，阴极接 PA3，则 PA3 输出低电平时 LED 点亮，属于低有效；按键一端接 PTC6，另一端接地，则 PTC6 需要内部上拉，按下读到低电平，属于低有效。驱动层应提供 board_led_on()、board_led_off()、board_key_pressed() 这类接口，内部根据有效电平做取反，业务层不需要关心“高有效还是低有效”。

下面这张图把端口、引脚、寄存器、板级对象和中断路径放在同一张关系图中，便于对照理解：

去抖动处理

机械按键在按下和释放瞬间会产生数毫秒到十几毫秒的抖动，表现为电平快速跳变。如果直接以边沿触发中断，一次按下可能产生多次中断。常见处理方式有两种：硬件上在按键两端并联 0.1μF 电容并配合上拉电阻，形成 RC 低通；软件上在检测到边沿后启动一个 10~20ms 的定时器，定时到达后再读取引脚电平，若仍为有效电平才确认按键事件。软件去抖动更适合 MCX 这类资源有限的 MCU，因为它不增加物料成本，且时间窗可调。

在中断方式下，推荐的做法是：ISR 中只记录“发生了边沿”并启动去抖动定时器，真正的按键处理放到主循环或任务中执行。这样既保证响应速度，又避免在 ISR 中做长延时或复杂逻辑。

轮询与中断的对比与选择

轮询方式在主循环中周期性读取 PDIR，判断按键是否按下。它的优点是逻辑直观、不需要配置 NVIC，也不存在中断嵌套问题；缺点是 CPU 需要持续投入，且响应延迟取决于轮询周期。若主循环周期为 5ms，按键最短按下时间为 50ms，则轮询可以可靠捕获；但若主循环中还有耗时任务，轮询周期可能被拉长到几十毫秒，此时就可能漏掉短按。

中断方式则把“等待”交给硬件，CPU 只在事件发生时响应。对于按键、限位开关、编码器脉冲等异步事件，中断更合适。但中断也带来新的问题：抖动会放大为多次中断，多个引脚共享端口中断时需要软件区分来源，ISR 中不能调用可能阻塞的接口。因此，实际项目中常见的组合是：按键使用下降沿中断 + 10ms 软件去抖动 + 主循环处理事件；LED 使用普通输出，不需要中断。

把以上内容落到工程上，可以形成一份简明的板级适配检查清单：确认每个 LED 和按键的端口、引脚、有效电平；确认 PCR 的复用、上下拉和驱动强度；确认按键中断触发沿与有效电平匹配；确认去抖动时间窗；确认 ISR 只做标记、主循环做处理。完成这些之后，GPIO 驱动就不再是“点灯和读键”的临时代码，而是可复用、可移植的板级基础层。