1. GPIO 基础概念
GPIO（General Purpose Input/Output，通用输入输出）是嵌入式系统中最基础、最灵活的硬件接口。理解 GPIO 的引脚功能、电气特性、上下拉电阻和驱动能力，是编写稳定、可靠驱动程序的先决条件。本节从硬件原理出发，建立 GPIO 驱动开发的底层认知。
1.1 GPIO 引脚功能
GPIO 引脚通常可配置为以下三种基本模式：
| 模式 | 方向 | 典型应用 | 驱动内部逻辑 |
|---|---|---|---|
| 输出模式 | SoC → 外部 | LED 控制、继电器驱动、蜂鸣器 | 写寄存器设置高低电平 |
| 输入模式 | 外部 → SoC | 按键检测、传感器状态读取 | 读寄存器获取电平值 |
| 复用功能 | 双向/专用 | I2C、SPI、UART 等外设接口 | 引脚交由内部外设模块控制 |
开发提示： 在 Linux 设备树中，GPIO 的功能通过
pinctrl 子系统配置。例如 pinctrl-0 = <&gpio_led_pins> 将引脚设置为 GPIO 输出模式，而非默认的复用功能。
1.2 电气特性
GPIO 引脚的电气特性决定了信号的质量和兼容性。核心参数包括：
- 工作电压（VDD）： 常见 1.8V、2.5V、3.3V、5V。驱动电路必须与 SoC 的 GPIO 电压域匹配。
- 逻辑电平阈值： 输入高电平（VIH）和输入低电平（VIL）决定了外部信号的有效范围。
- 输出高电平（VOH）和输出低电平（VOL）： 在指定负载电流下，输出能保证的电压值。
- 最大灌电流/拉电流： 引脚能安全吸收或提供的电流上限，通常为 4mA~20mA。
关键指标对比： 以 STM32MP1 系列为例，GPIO 在 3.3V 供电时，VIH 最小为 2.0V，VIL 最大为 0.8V；输出驱动能力可配置为 2mA、4mA、6mA、8mA 四档。
1.3 上下拉电阻
上下拉电阻用于在引脚悬空时确定一个稳定的逻辑电平，防止引脚电平浮动导致误触发或额外功耗。
| 类型 | 连接方式 | 默认电平 | 适用场景 |
|---|---|---|---|
| 上拉电阻 | 引脚 → VDD | 高电平（1） | 按键输入（按下为低）、开漏输出 |
| 下拉电阻 | 引脚 → GND | 低电平（0） | 按键输入（按下为高）、防止浮空 |
| 浮空（无上下拉） | — | 不确定 | 外部已有强驱动信号 |
常见陷阱： 在 Linux 设备树中，上下拉配置通过
bias-pull-up 或 bias-pull-down 属性设置。如果外部电路已经包含上拉/下拉电阻，SoC 内部再使能上下拉会导致分压，改变逻辑阈值。务必确认硬件原理图后再配置。
1.4 驱动能力
驱动能力指 GPIO 引脚在输出模式下能提供的最大电流。驱动能力不足会导致信号上升/下降沿变缓、逻辑电平不达标；驱动能力过强则可能引起电磁干扰（EMI）或损坏引脚。
- 驱动强度（Drive Strength）： 通常以 mA 为单位，可编程配置为 2mA、4mA、6mA、8mA 等档位。
- 负载电容： 驱动能力与负载电容共同决定信号边沿速率。大电容需要更高驱动电流才能保持快速翻转。
- 多引脚同时翻转： 当多个 GPIO 同时切换时，总电流不能超过 SoC 的电源域限值（如 VDD 最大 150mA）。
驱动能力选择原则：
- 查阅芯片数据手册，确认 GPIO 引脚的最大额定电流。
- 根据负载类型选择：LED 通常 2~4mA，继电器或 MOSFET 栅极可能需要 8mA 以上。
- 在 Linux 设备树中，通过
drive-strength属性设置，例如drive-strength = <4>;表示 4mA。 - 高速信号（如 SPI CLK）建议使用较高驱动强度以保证信号完整性。
1.5 设备树中的 GPIO 基础配置示例
以下是一个典型的 Linux 设备树节点，展示了 GPIO 引脚的功能、上下拉和驱动能力配置：
/* 设备树中 GPIO 引脚配置示例 */
&gpio1 {
led_pins: led-pins {
pins = "GPIO1_IO03";
function = "gpio"; /* 设置为 GPIO 功能 */
bias-pull-down; /* 内部下拉，确保默认低电平 */
drive-strength = <4>; /* 驱动能力 4mA */
output-low; /* 初始状态输出低电平 */
};
button_pins: button-pins {
pins = "GPIO1_IO04";
function = "gpio";
bias-pull-up; /* 内部上拉，按键按下为低 */
input-enable; /* 设置为输入模式 */
};
};
调试技巧： 使用
cat /sys/kernel/debug/gpio 可以查看当前所有 GPIO 的配置状态，包括方向、电平和上下拉设置。这是排查硬件配置问题的第一站。