ARM Linux如何使用GPIO？

在嵌入式系统中,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）中定义引脚复用和控制器信息，这是硬件与内核通信的桥梁，设备树中需包含以下关键内容：

1. 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> */
   };

2. 引脚复用配置：通过pinctrl子系统设置引脚功能（如GPIO、UART、I2C等），例如在板级设备树中：

   pinctrl_led: ledgrp {
       fsl,pins = <
           MX6ULL_PAD_GPIO1_IO01__GPIO1_IO01 0x10b0 /* LED引脚配置 */
       >;
   };

3. 设备节点引用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控制接口,操作流程如下：

注意事项：

• 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;
}

注意事项

1. GPIO编号：Linux中GPIO编号为gpiochip索引+引脚偏移（如GPIO1_IO01=32=1*32+0），可通过/sys/kernel/debug/gpio查看编号映射。
2. 权限管理：建议将用户加入gpio组（sudo usermod -a -G gpio $USER），避免频繁使用sudo。
3. 电平匹配：确保GPIO输出电平与外设兼容（如3.3V/5V），避免烧毁设备。
4. 并发控制：多进程操作时，通过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的已知问题。