第3章 GPIO驱动开发

第1章：GPIO驱动开发 — 从硬件到用户空间的全链路解析

各位同学，今天我们来聊聊GPIO驱动开发。说实话，GPIO是嵌入式开发里最基础、也最容易踩坑的模块之一。我在座舱芯片项目里，至少有三次因为GPIO配置问题导致整机无法点亮屏幕。嗯，咱们今天就把这块彻底讲透。

1. GPIO控制器硬件原理

GPIO，全称General Purpose Input/Output，说白了就是芯片上那些可以编程控制的引脚。你可以把它理解成芯片的「手脚」——既能输出高低电平去控制外设，也能读取外部信号的状态。

一个典型的GPIO控制器内部包含以下几个关键部分：

数据寄存器（DATA）：用来读写引脚电平值
方向寄存器（DIR）：控制引脚是输入还是输出
上拉/下拉寄存器（PULL）：配置内部电阻，防止引脚悬空
中断控制寄存器（INT）：配置上升沿、下降沿或电平触发
复用功能寄存器（MUX）：选择引脚作为GPIO还是其他外设功能

核心要点：座舱芯片的GPIO控制器通常挂载在APB或AHB总线上，通过内存映射IO（MMIO）方式访问。每个GPIO bank一般管理32个引脚。

我在项目中遇到过一个问题：某款座舱芯片的GPIO bank0和bank1挂在不同的电源域上，结果bank1的引脚在休眠后电平全乱了。后来查手册才发现，bank1的电源域在休眠时会被关闭。所以啊，硬件原理不看透，后面全是坑。

2. Linux GPIO子系统框架

Linux内核的GPIO子系统，其实分成了三层：

GPIO控制器驱动层：直接操作硬件寄存器，注册到内核
GPIO核心层：提供统一的API接口，管理gpio_chip结构体
GPIO用户接口层：包括sysfs接口和libgpiod库

为什么要分层？你想想看，如果每个芯片厂商都自己搞一套接口，那上层应用代码得写成什么样？Linux内核通过gpio_chip结构体抽象了所有控制器：

struct gpio_chip {
    const char *label;
    struct device *parent;
    int base;           // GPIO编号起始值
    int ngpio;          // 本控制器管理的引脚数
    int (*direction_input)(struct gpio_chip *chip, unsigned offset);
    int (*direction_output)(struct gpio_chip *chip, unsigned offset, int value);
    int (*get)(struct gpio_chip *chip, unsigned offset);
    void (*set)(struct gpio_chip *chip, unsigned offset, int value);
    // ... 还有中断相关回调
};

我个人习惯是先看芯片手册里的GPIO寄存器描述，再对照gpio_chip的回调函数去实现。这样思路特别清晰。

避坑指南：我曾经在注册gpio_chip时忘了设置base字段为-1，导致内核自动分配编号时和别的控制器冲突。后来系统启动时GPIO编号全乱了。记住：base设为-1，让内核帮你分配。

3. 基于设备树的GPIO驱动编写

设备树（Device Tree）是描述硬件信息的配置文件。对于GPIO驱动来说，我们需要在设备树中描述：

寄存器基地址和大小
中断号（如果支持中断）
GPIO引脚数量
时钟和电源信息

一个典型的设备树节点长这样：

gpio0: gpio@ff310000 {
    compatible = "vendor,soc-gpio";
    reg = <0x0 0xff310000 0x0 0x1000>;
    interrupts = <0 64 4>;
    gpio-controller;
    #gpio-cells = <2>;
    interrupt-controller;
    #interrupt-cells = <2>;
    clocks = <&clk_gpio0>;
};

驱动代码中，我们需要在probe函数里做这几件事：

从设备树获取reg资源，并ioremap映射寄存器
获取中断号并注册中断处理函数
填充gpio_chip结构体，调用gpiochip_add_data注册
处理时钟和电源管理

这里有个细节：#gpio-cells = <2>表示每个GPIO引用需要两个参数——第一个是引脚偏移，第二个是标志位（比如高电平有效还是低电平有效）。

注意：设备树中的reg属性一定要和芯片手册里的寄存器地址一致。我见过有人把地址写错一位，结果GPIO控制的是完全不同的外设，屏幕直接花屏。这种问题查起来特别痛苦。

4. 用户空间GPIO控制

用户空间控制GPIO有两种主流方式：老牌的sysfs接口和新的libgpiod库。

4.1 sysfs接口（传统方式）

sysfs接口通过文件系统暴露GPIO控制：

# 导出GPIO
echo 128 > /sys/class/gpio/export

# 设置方向
echo out > /sys/class/gpio/gpio128/direction

# 输出高电平
echo 1 > /sys/class/gpio/gpio128/value

# 读取输入
cat /sys/class/gpio/gpio128/value

# 用完释放
echo 128 > /sys/class/gpio/unexport

sysfs的优点是简单直接，但缺点也很明显：每个操作都要打开关闭文件，性能差；而且没有中断支持。我在早期项目中用过，后来全换成libgpiod了。

4.2 libgpiod库（推荐方式）

libgpiod是内核社区推荐的新接口，通过字符设备（/dev/gpiochipX）操作GPIO。它支持批量操作、中断监听、行消费（line consumer）等高级功能。

命令行工具示例：

# 查看GPIO芯片信息
gpioinfo

# 设置输出并写值
gpioset gpiochip0 5=1

# 读取输入
gpioget gpiochip0 3

# 监听中断
gpiomon gpiochip0 4

C语言编程示例：

#include <gpiod.h>

struct gpiod_chip *chip;
struct gpiod_line *line;
int ret;

// 打开GPIO芯片
chip = gpiod_chip_open_by_name("gpiochip0");

// 获取引脚
line = gpiod_chip_get_line(chip, 5);

// 设置方向并输出
ret = gpiod_line_request_output(line, "my-app", 0);

// 写值
gpiod_line_set_value(line, 1);

// 清理
gpiod_line_release(line);
gpiod_chip_close(chip);

为什么推荐libgpiod？ 说白了，sysfs接口是历史遗留产物，内核文档已经明确标注为deprecated。libgpiod性能更好、接口更安全、支持中断事件循环。我在座舱项目中用libgpiod实现了按键唤醒功能，代码量少了一半。

5. 本章知识体系总览

下面这张图总结了GPIO驱动开发的完整链路：

我的建议：初学者可以先从用户空间的libgpiod入手，感受GPIO控制的基本流程。然后再深入内核驱动层，理解gpio_chip和设备树的配合。最后回头研究硬件手册，把寄存器级别的细节吃透。这样由浅入深，不容易被底层细节劝退。

好了，这一章的内容就到这里。GPIO看似简单，但它是所有外设驱动的基础。把GPIO玩明白了，后面的I2C、SPI、UART都会轻松很多。下一章我们聊聊I2C驱动开发，到时候见。

📚 课程目录

第1章：GPIO驱动开发 — 从硬件到用户空间的全链路解析

1. GPIO控制器硬件原理

2. Linux GPIO子系统框架

3. 基于设备树的GPIO驱动编写

4. 用户空间GPIO控制

4.1 sysfs接口（传统方式）

4.2 libgpiod库（推荐方式）

5. 本章知识体系总览