在嵌入式系统中,GPIO(通用输入输出)是最基础的外设接口之一,ARM Linux通过完善的GPIO子系统实现对GPIO引脚的控制,使用GPIO通常涉及硬件抽象层配置、驱动加载及用户空间操作,本文将详细介绍ARM Linux中GPIO的使用流程及关键注意事项。

GPIO子系统基础
ARM Linux的GPIO子系统由内核驱动框架和用户空间接口组成,核心目标是统一不同SoC的GPIO操作方式,内核通过gpio_chip结构抽象GPIO控制器,提供申请(request)、释放(free)、方向设置(direction)、值读写(value)等基础操作,用户空间可通过两种主要方式操作GPIO:sysfs接口(传统方式)和libgpiod库(现代推荐方式)。
设备树配置
GPIO使用前需在设备树(Device Tree)中定义引脚复用和控制器信息,这是硬件与内核通信的桥梁,设备树中需包含以下关键内容:
-
GPIO控制器节点:定义GPIO控制器的地址范围、中断号等信息,例如在
arch/arm/boot/dts/imx6ull.dtsi中:gpio1: gpio@30200000 { compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio"; reg = <0x30200000 0x10000>; interrupts = <0 66 IRQ_TYPE_LEVEL_HIGH>; gpio-controller; #gpio-cells = <2>; /* <bank offset> */ }; -
引脚复用配置:通过
pinctrl子系统设置引脚功能(如GPIO、UART、I2C等),例如在板级设备树中:pinctrl_led: ledgrp { fsl,pins = < MX6ULL_PAD_GPIO1_IO01__GPIO1_IO01 0x10b0 /* LED引脚配置 */ >; }; -
设备节点引用GPIO:外设节点需通过
gpios属性指定使用的GPIO,led { compatible = "led-gpio"; gpios = <&gpio1 1 GPIO_ACTIVE_HIGH>; /* GPIO1_IO01,高电平点亮 */ pinctrl-names = "default"; pinctrl-0 = <&pinctrl_led>; };
设备树修改后需重新编译为.dtb文件并烧录到设备,可通过fdt addr命令加载或直接替换设备树分区。

GPIO驱动加载
内核启动时会自动解析设备树,加载对应的GPIO控制器驱动(如imx-gpio、gpio-sx150x等),可通过以下命令检查驱动状态:
ls /sys/class/gpio/ # 查看已导出的GPIO ls /sys/bus/platform/devices/ | grep gpio # 查看GPIO控制器设备 dmesg | grep "gpio" # 查看内核启动时的GPIO加载日志
若驱动未加载,可手动加载模块(如modprobe imx-gpio),或检查设备树中compatible属性是否匹配内核驱动。
用户空间操作GPIO
通过sysfs接口操作(传统方式)
sysfs通过文件系统暴露GPIO控制接口,操作流程如下:
| 步骤 | 命令/操作 | 说明 |
|---|---|---|
| 导出GPIO | echo 32 > /sys/class/gpio/export |
将GPIO编号(如GPIO1_IO01=32)导出到用户空间,生成/sys/class/gpio/gpio32目录 |
| 配置方向 | echo out > /sys/class/gpio/gpio32/direction |
设置为输出(in为输入) |
| 读写值 | echo 1 > /sys/class/gpio/gpio32/value(输出)cat /sys/class/gpio/gpio32/value(输入) |
写1/0控制电平,读取输入引脚状态 |
| 释放GPIO | echo 32 > /sys/class/gpio/unexport |
卸载GPIO,释放资源 |
注意事项:
- sysfs接口存在并发安全问题,多进程同时操作可能导致数据竞争;
- 需root权限操作,可通过
chmod调整权限; - 内核5.4+版本已逐步废弃sysfs,推荐使用libgpiod。
通过libgpiod库操作(现代推荐方式)
libgpiod是Linux官方推荐的GPIO用户空间库,支持并发控制、事件检测等功能,需先安装工具包:
sudo apt-get install gpiod libgpiod-dev libgpiocfg1 # 安装库和工具
常用工具及示例:

gpiodetect:列出所有GPIO控制器gpiodetect # 输出:gpiochip0 [pinctrl-bus] (32 lines)
gpioinfo:查看控制器引脚信息gpioinfo gpiochip0 # 输出:line 12: "LED" output active-high [used]
gpioset/gpioget:设置/读取GPIO值gpioset gpiochip0 12=1 # 设置gpiochip0的第12引脚为高电平 gpioget gpiochip0 12 # 读取第12引脚值
monitor:监控GPIO电平变化gpiomon gpiochip0 12 --edges both # 监控第12引脚上升/下降沿
编程接口:使用C语言调用libgpiod API,示例代码片段:
#include <gpiod.h>
#include <stdio.h>
int main() {
struct gpiod_chip *chip;
struct gpiod_line *line;
int ret;
chip = gpiod_chip_open_by_name("gpiochip0");
line = gpiod_chip_get_line(chip, 12);
gpiod_line_request_output(line, "led", 0);
gpiod_line_set_value(line, 1);
gpiod_line_release(line);
gpiod_chip_close(chip);
return 0;
}
注意事项
- GPIO编号:Linux中GPIO编号为
gpiochip索引+引脚偏移(如GPIO1_IO01=32=1*32+0),可通过/sys/kernel/debug/gpio查看编号映射。 - 权限管理:建议将用户加入
gpio组(sudo usermod -a -G gpio $USER),避免频繁使用sudo。 - 电平匹配:确保GPIO输出电平与外设兼容(如3.3V/5V),避免烧毁设备。
- 并发控制:多进程操作时,通过
fcntl或flock对GPIO文件描述符加锁,避免冲突。
FAQs
Q1:为什么我的GPIO导出后无法读写?
A:可能原因包括:①GPIO编号错误(需通过/sys/kernel/debug/gpio确认);②权限不足(检查用户是否在gpio组);③引脚被其他外设占用(如设备树中未配置为GPIO功能);④内核未加载对应GPIO驱动(检查dmesg日志)。
Q2:sysfs和libgpiod如何选择?
A:若使用较老内核(如Linux 4.x)或简单控制,sysfs足够;若需并发操作、事件检测或使用新内核(5.4+),推荐libgpiod,其设计更安全且功能完善,对于生产环境,优先选择libgpiod以避免sysfs的已知问题。
原创文章,发布者:酷番叔,转转请注明出处:https://cloud.kd.cn/ask/31590.html