📚 课程目录第3章 GPIO驱动基础

3. GPIO 驱动基础：寄存器映射与模式配置

GPIO（General Purpose Input/Output）是蓝牙芯片与外界交互的最基本接口。在驱动开发中，GPIO 的寄存器映射、输入输出模式配置以及上下拉/驱动能力的理解，直接决定了中断响应、外设控制、功耗管理等关键功能的正确性。本章从硬件寄存器模型出发，逐步拆解 GPIO 的完整驱动框架。

3.1 GPIO 寄存器映射模型

现代蓝牙 SoC（如 Nordic nRF5x、TI CC13xx、Dialog DA145xx）的 GPIO 控制器通常采用 内存映射 I/O（MMIO） 方式。每个 GPIO 端口（Port）对应一组连续的寄存器地址，驱动通过指针或结构体直接访问这些地址。

  关键概念： GPIO 寄存器通常包括：输出寄存器（OUT）、输入寄存器（IN）、方向寄存器（DIR）、配置寄存器（CNF/PIN_CNF）、中断触发寄存器（SENSE/DETECT）等。

实战提示： 在 Nordic nRF52840 中，每个 GPIO 引脚有独立的 PIN_CNF 寄存器（地址偏移 0x700 + 引脚号×4），而非传统 32 位端口寄存器。这种“每引脚独立配置”的设计简化了多任务下的引脚管理。

3.2 输入输出模式配置

GPIO 的方向配置是驱动开发的第一步。不同芯片的配置方式略有差异，但核心逻辑一致：通过方向寄存器（DIR）或每引脚配置寄存器中的方向位，控制引脚为输入或输出。

方向	寄存器操作	典型应用场景	注意事项
输出	DIR 对应位置 1，或 PIN_CNF.DIR=Output	LED 控制、外设使能、SPI/I2C 时钟	输出前先设置初始电平，避免毛刺
输入	DIR 对应位清 0，或 PIN_CNF.DIR=Input	按键检测、中断触发、ADC 采样	输入模式下必须配置上下拉，防止浮空
高阻/三态	输入 + 禁止上下拉 + 禁止输入缓冲	共享总线、模拟输入、省电模式	高阻状态下引脚电平由外部电路决定

常见陷阱： 许多蓝牙芯片在复位后 GPIO 默认为输入模式且无上下拉。如果外部电路未驱动，引脚处于“浮空”状态，会导致漏电、误触发中断甚至芯片锁死。务必在初始化阶段明确配置每个引脚的上下拉状态。

3.3 推挽、开漏、上拉、下拉详解

GPIO 的输出驱动结构和内部上下拉电阻是嵌入式驱动中最容易混淆的概念。下面从电路模型和驱动配置两个维度进行拆解。

3.3.1 推挽输出（Push-Pull）

推挽输出使用两个互补的 MOSFET（P-MOS 和 N-MOS）分别负责输出高电平和低电平。输出高时 P-MOS 导通，输出低时 N-MOS 导通。特点是驱动能力强、电平切换速度快，适合驱动 LED、蜂鸣器、SPI 时钟等。

3.3.2 开漏输出（Open-Drain）

开漏输出只有 N-MOS 负责拉低，高电平由外部上拉电阻提供。多个开漏输出可以“线与”连接，实现多设备共享总线（如 I2C 的 SDA/SCL）。开漏模式下，引脚不能主动输出高电平，必须依赖外部上拉。

3.3.3 上拉与下拉（Pull-Up / Pull-Down）

内部上拉/下拉电阻用于在输入模式或开漏输出高阻态时，将引脚电平钳位到 VDD 或 GND，防止浮空。上拉电阻典型值 10kΩ~100kΩ，下拉电阻类似。配置时需注意：上拉/下拉仅在输入模式或开漏输出时生效，推挽输出时内部上下拉通常被旁路。

配置模式	输出高电平	输出低电平	高阻态	典型应用
推挽	P-MOS 导通，VDD	N-MOS 导通，GND	不支持	LED、SPI、UART TX
开漏	外部上拉电阻	N-MOS 导通，GND	支持（N-MOS 关断）	I2C、中断共享线
上拉输入	—	—	内部上拉至 VDD	按键检测（默认高）
下拉输入	—	—	内部下拉至 GND	按键检测（默认低）

_PU OUT N-MOS GND 推挽：P-MOS + N-MOS 互补驱动，输出高低电平均由芯片内部提供开漏：仅 N-MOS 拉低，高电平依赖外部上拉电阻，支持线与

3.4 驱动框架中的 GPIO 抽象层

在实际的蓝牙芯片适配中，GPIO 驱动通常不直接操作寄存器，而是通过 硬件抽象层（HAL） 或 驱动框架（如 Zephyr GPIO API、Nordic nrfx） 进行封装。下面是一个典型的 GPIO 驱动接口设计：

/* gpio_hal.h — GPIO 硬件抽象层接口 */
#ifndef GPIO_HAL_H
#define GPIO_HAL_H

#include <stdint.h>
#include <stdbool.h>

/* GPIO 引脚配置结构体 */
typedef struct {
    uint8_t  pin;          /* 引脚号 */
    uint8_t  port;         /* 端口号（多端口芯片使用） */
    bool     dir_output;   /* true=输出, false=输入 */
    bool     pull_up;      /* 内部上拉使能 */
    bool     pull_down;    /* 内部下拉使能 */
    bool     open_drain;   /* 开漏模式使能（仅输出有效） */
    uint8_t  drive_strength; /* 驱动强度（0=标准, 1=高, 2=极高） */
} gpio_cfg_t;

/* 初始化 GPIO 引脚 */
int gpio_init(const gpio_cfg_t *cfg);

/* 设置输出电平 */
void gpio_set(uint8_t pin, bool level);

/* 读取输入电平 */
bool gpio_get(uint8_t pin);

/* 配置中断触发方式（后续章节详解） */
int gpio_int_config(uint8_t pin, uint8_t trigger_type);

#endif /* GPIO_HAL_H */

框架设计要点：

使用结构体封装配置参数，避免函数参数过多
返回 int 错误码（0 成功，负值表示错误），便于调试
将芯片相关的寄存器操作隐藏在 .c 文件中，上层代码只依赖接口
驱动强度（Drive Strength）在蓝牙芯片中常见：标准 0.5mA、高 2mA、极高 8mA，需根据负载选择

3.5 实战：配置一个按键输入 + LED 输出

下面以 Nordic nRF52840 为例，展示完整的 GPIO 初始化代码，包含推挽输出和上拉输入配置：

/* main.c — 按键输入 + LED 输出示例 */
#include "nrf_gpio.h"
#include "nrf_delay.h"

#define LED_PIN     13   /* P0.13, 推挽输出 */
#define BUTTON_PIN  11   /* P0.11, 上拉输入 */

void gpio_example_init(void)
{
    nrf_gpio_cfg_output(LED_PIN);
    nrf_gpio_pin_set(LED_PIN);  /* 初始关闭 LED（低电平驱动） */

    nrf_gpio_cfg_input(BUTTON_PIN, NRF_GPIO_PIN_PULLUP);
}

int main(void)
{
    gpio_example_init();

    while (1) {
        if (nrf_gpio_pin_read(BUTTON_PIN) == 0) {
            /* 按键按下（低电平），点亮 LED */
            nrf_gpio_pin_clear(LED_PIN);
        } else {
            nrf_gpio_pin_set(LED_PIN);
        }
        nrf_delay_ms(10);  /* 简单消抖 */
    }
}

硬件设计检查清单：

LED 是否串联限流电阻（典型 1kΩ~10kΩ）？
按键是否外部上拉/下拉？如果使用内部上拉，确认芯片内部上拉电阻值是否满足需求（nRF52 内部上拉约 13kΩ）
引脚电压是否在芯片允许范围内（通常 VDD ± 0.3V）？
多个开漏输出连接同一总线时，外部上拉电阻值是否合适（I2C 通常 4.7kΩ）？

3.6 本章小结

寄存器映射： GPIO 寄存器通过 MMIO 方式访问，每引脚独立配置（PIN_CNF）是现代蓝牙 SoC 的主流设计。
输入输出模式： 方向寄存器决定引脚功能，输入模式必须配置上下拉，输出模式需注意初始电平。
推挽 vs 开漏： 推挽驱动能力强，适合点对点；开漏支持线与，适合总线共享。
上下拉电阻： 防止浮空，输入模式下必须明确配置，输出模式下通常被旁路。
驱动框架： 使用 HAL 抽象层隔离硬件差异，提高代码可移植性。