📚 课程目录第3章 GPIO与引脚复用实战

3. GPIO与引脚复用实战

在MCX系列MCU中，GPIO并不是一个孤立的模块，而是由GPIO外设与PORT外设协同完成引脚控制。理解这一分工，是后续做按键唤醒、低功耗指示等实战任务的基础。简单来说：PORT负责引脚级配置（复用功能选择、方向、上下拉、驱动强度、输入滤波、中断触发方式），GPIO负责数据级操作（读取引脚电平、输出高低电平、置位/清零/翻转）。两者通过同一组物理引脚关联，但寄存器是分开的。

以MCX常用的寄存器命名为例，PORT侧关键寄存器包括：PCRn（Pin Control Register，每个引脚一个，配置MUX、PE、PS、ODE、DSE、IBE等）、ISFR（Interrupt Status Flag Register，记录引脚中断标志）、DFER/DFCR/DFWR（数字滤波相关）。GPIO侧关键寄存器包括：PDOR（输出数据）、PSOR（置位）、PCOR（清零）、PTOR（翻转）、PDIR（输入数据）、PDDR（方向）、PIDR（输入禁用）。

关键认知：配置一个引脚为GPIO输入并开启中断，需要“先PORT后GPIO”——先在PCR中把MUX设为GPIO、使能输入与上拉、设置中断触发方式，再在GPIO中把PDDR对应位清0设为输入。顺序颠倒会导致配置被覆盖或读不到正确电平。

下面这张图展示了从“物理引脚”到“GPIO数据操作”再到“中断与唤醒”的完整信号链，以及按键唤醒LED指示任务中各模块的连接关系。图中左侧为外部按键与LED，中间为PORT/GPIO寄存器层，右侧为NVIC与低功耗唤醒控制。

接下来按任务顺序展开。第一个任务是把PTC3配置为带中断的输入。假设使用MCUXpresso SDK，但这里直接给出寄存器级操作，便于理解底层。先使能PORT C和GPIO C的时钟（在SIM_SCGC5中置位），然后写PCR3：

// 1. 使能时钟
SIM->SCGC5 |= SIM_SCGC5_PORTC_MASK | SIM_SCGC5_GPIOC_MASK;

// 2. 配置 PTC3：MUX=001(GPIO), PE=1(上拉使能), PS=1(上拉), IRQC=1010(下降沿中断)
PORTC->PCR[3] = PORT_PCR_MUX(1) | PORT_PCR_PE_MASK | PORT_PCR_PS_MASK
              | PORT_PCR_IRQC(0xA);

// 3. 配置 GPIO 方向为输入
GPIOC->PDDR &= ~(1u << 3);

// 4. 清除可能存在的旧中断标志
PORTC->ISFR = (1u << 3);

// 5. 使能 NVIC 中 PORTC 中断
NVIC_EnableIRQ(PORTC_IRQn);
NVIC_SetPriority(PORTC_IRQn, 2);

这里IRQC=1010表示下降沿触发，因为按键按下时引脚被拉低。如果按键接法不同（例如按下拉高），则应改为上升沿1001或任意边沿1011。上拉使能后，按键未按下时PTC3为高电平，按下时被按键拉到低电平，产生下降沿。

第二个任务是把PTC5配置为推挽输出驱动LED。同样先写PCR5，再写PDDR：

PORTC->PCR[5] = PORT_PCR_MUX(1) | PORT_PCR_DSE_MASK; // GPIO, 高驱动强度
GPIOC->PDDR |= (1u << 5);   // 输出方向
GPIOC->PCOR = (1u << 5);    // 初始熄灭（低电平）

注意这里用PCOR而不是直接写PDOR，因为PSOR/PCOR/PTOR是“写1生效”的原子操作，不会影响同端口其他引脚，在多任务或中断中更安全。点亮LED用GPIOC->PSOR = (1u << 5);，熄灭用GPIOC->PCOR = (1u << 5);，翻转用GPIOC->PTOR = (1u << 5);。

第三个任务是编写PORTC中断服务函数。中断中必须做两件事：清除ISFR标志，以及执行用户逻辑（翻转LED）。如果忘记清标志，中断会反复进入。

void PORTC_IRQHandler(void) {
    uint32_t flags = PORTC->ISFR;
    if (flags & (1u << 3)) {
        PORTC->ISFR = (1u << 3);   // 写1清标志
        GPIOC->PTOR = (1u << 5);   // 翻转LED
    }
}

第四个任务是低功耗唤醒引脚配置。在MCX中，进入STOP模式后普通GPIO中断可能无法唤醒，需要把PTC3同时配置为LLWU（低功耗唤醒单元）的唤醒源。典型做法是：在LLWU的PE寄存器中使能对应引脚，并选择边沿类型；同时保持PCR3的IRQC配置不变。进入低功耗前，建议把LED引脚PTC5设为输出低电平以降低功耗，并考虑用PIDR禁用未使用引脚的输入缓冲，避免浮空输入造成额外漏电。

低功耗唤醒引脚选择原则：优先选择带LLWU功能的引脚；唤醒边沿要与按键实际电平变化一致；唤醒后要重新初始化时钟和GPIO，因为STOP模式可能关闭部分外设时钟。

第五个任务是按键唤醒LED指示的完整任务闭环。整体流程是：系统初始化 → 配置PTC3为中断输入、PTC5为输出 → 进入STOP低功耗模式 → 按键按下产生下降沿 → LLWU唤醒 → 执行PORTC中断 → 翻转LED → 返回主循环。判断是否成功，可以观察两个现象：一是按键按下后LED状态翻转；二是用调试器或串口打印确认系统确实从STOP模式退出，而不是一直停留在低功耗。

下面给出一个可直接参考的配置检查表，用于排查“按键无反应”或“无法唤醒”的常见问题：

检查项	正确状态	常见错误
PCR3 MUX	001（GPIO）	仍为默认复用功能，读不到按键
PCR3 PE/PS	PE=1, PS=1（上拉）	未使能上拉，引脚浮空误触发
PCR3 IRQC	1010（下降沿）	设为0000，无中断产生
GPIO PDDR bit3	0（输入）	误设为1，输出与按键冲突
ISFR 清除	中断中写1清除	未清除，反复进中断
NVIC 使能	PORTC_IRQn 已使能	忘记调用 NVIC_EnableIRQ
LLWU 唤醒源	PTC3 已使能	只配了GPIO中断，未配LLWU
LED 引脚 PCR5	MUX=001, DSE=1	驱动强度不足，LED偏暗

最后补充一个实际调试技巧：如果按键按下后LED翻转但系统无法再次进入低功耗，通常是ISFR标志未彻底清除，或者LLWU的唤醒标志未清除。LLWU通常有独立的标志寄存器，唤醒后需要读取并写1清除，否则下一次进入STOP会立即被“旧事件”唤醒。建议在唤醒处理中同时清除PORTC->ISFR和LLWU->F寄存器中对应位，形成完整的“唤醒—处理—清标志—再入睡”闭环。

通过本节五个任务的串联，可以看到GPIO与PORT的分工并不是理论概念，而是直接决定代码能否正确运行的关键。PORT负责“这个引脚是什么、怎么触发”，GPIO负责“这个引脚现在读什么、写什么”。把这两层分清，再叠加NVIC和LLWU，就能稳定实现按键唤醒LED指示这一典型低功耗交互任务。