玩转嵌入式Linux：Pinctrl与GPIO子系统驱动详解

在嵌入式 Linux 系统开发中，pinctrl 子系统和 gpio 子系统驱动是与硬件交互的基础。它们负责管理芯片的引脚功能以及通用输入/输出口的控制。理解这两个子系统的原理和使用方法对于编写高效稳定的嵌入式驱动至关重要。不少开发者在初期面对复杂的设备树配置和驱动框架时，往往会感到无从下手，本文将深入剖析其底层原理，并结合实际代码示例，帮助大家更好地掌握这两个关键子系统。

Pinctrl 子系统：引脚复用与配置管理

什么是 Pinctrl？

pinctrl (Pin Control) 子系统主要负责管理 SoC 芯片的引脚功能。现代 SoC 芯片的引脚通常具有多种复用功能，例如可以用作 GPIO、UART、I2C 等外设的引脚。pinctrl 子系统的作用就是配置这些引脚的功能，确保它们能够按照预期的方式工作。在设备树中，我们可以使用 pinctrl 节点来描述引脚的复用情况，例如指定某个引脚用作 GPIO 输入还是 UART 发送。

Pinctrl 的核心概念

• Pin Groups (引脚组)：一组引脚的集合，通常具有相似的功能或配置。例如，可以将 UART 的 RX 和 TX 引脚定义为一个引脚组。
• Pin Configurations (引脚配置)：定义引脚的电气特性，例如上拉/下拉电阻、驱动强度、速度等。
• Pin States (引脚状态)：不同的引脚功能组合，例如 “default” 状态表示默认的引脚功能，“sleep” 状态表示睡眠状态下的引脚功能。
• Device Tree Binding (设备树绑定)：通过设备树节点来描述 pinctrl 的配置信息。

设备树配置示例

以下是一个简单的设备树 pinctrl 配置示例：

&uart0 {
 status = "okay";
 pinctrl-names = "default";
 pinctrl-0 = <&uart0_pins_a>;
};

&pinctrl {
 uart0_pins_a: uart0_pins_a {
  fsl,pins = <
   MX6UL_PAD_UART1_TXD__UART1_TX 0x1b0b0
   MX6UL_PAD_UART1_RXD__UART1_RX 0x1b0b0
  >;
 };
};

这个例子中，uart0_pins_a 定义了一个引脚组，包含了 UART1 的 TXD 和 RXD 引脚。0x1b0b0 是引脚配置参数，具体含义需要查阅芯片手册。

代码实现：驱动中的 Pinctrl 使用

在驱动代码中，可以使用 pinctrl_get() 函数获取 pinctrl 设备，然后使用 pinctrl_select_state() 函数选择特定的引脚状态。例如：

struct pinctrl *pinctrl;
struct pinctrl_state *pinctrl_state;

pinctrl = devm_pinctrl_get(&pdev->dev);
if (IS_ERR(pinctrl)) {
 dev_err(&pdev->dev, "Failed to get pinctrl\n");
 return PTR_ERR(pinctrl);
}

pinctrl_state = pinctrl_lookup_state(pinctrl, "default");
if (IS_ERR(pinctrl_state)) {
 dev_err(&pdev->dev, "Failed to get pinctrl state\n");
 return PTR_ERR(pinctrl_state);
}

ret = pinctrl_select_state(pinctrl, pinctrl_state);
if (ret) {
 dev_err(&pdev->dev, "Failed to select pinctrl state\n");
 return ret;
}

GPIO 子系统：通用输入/输出口控制

什么是 GPIO？

gpio (General Purpose Input/Output) 子系统用于控制芯片的通用输入/输出口。GPIO 可以配置为输入或输出，用于读取传感器数据、控制 LED 灯、驱动继电器等。在 Linux 系统中，GPIO 通过设备节点暴露给用户空间，用户可以使用标准的文件操作 API 来访问和控制 GPIO。

GPIO 的核心概念

• GPIO Number (GPIO 编号)：每个 GPIO 口都有一个唯一的编号，用于在软件中标识该 GPIO。
• GPIO Flags (GPIO 标志)：用于指定 GPIO 的属性，例如输入/输出方向、上下拉电阻等。
• GPIO Device (GPIO 设备)：表示 GPIO 控制器的设备节点。

设备树配置示例

以下是一个简单的设备树 gpio 配置示例：

led {
 compatible = "gpio-leds";
 gpios = <&gpio1 1 GPIO_ACTIVE_HIGH>;
 label = "my_led";
 default-state = "off";
};

这个例子中，gpios 属性指定了 LED 连接的 GPIO 口为 gpio1 的 1 号引脚，并且是高电平有效。

代码实现：驱动中的 GPIO 使用

在驱动代码中，可以使用 gpio_request() 函数申请 GPIO，使用 gpio_direction_output() 函数设置 GPIO 方向，使用 gpio_set_value() 函数设置 GPIO 输出值。例如：

int gpio_pin = of_get_named_gpio(np, "gpios", 0);
if (gpio_pin < 0) {
 dev_err(&pdev->dev, "Failed to get GPIO\n");
 return gpio_pin;
}

ret = gpio_request(gpio_pin, "my_led");
if (ret < 0) {
 dev_err(&pdev->dev, "Failed to request GPIO\n");
 return ret;
}

ret = gpio_direction_output(gpio_pin, 0); // Set to output and initialize to low
if (ret < 0) {
 dev_err(&pdev->dev, "Failed to set GPIO direction\n");
 gpio_free(gpio_pin);
 return ret;
}

gpio_set_value(gpio_pin, 1); // Turn on the LED

//Don't forget to free the gpio when exit
gpio_free(gpio_pin);

实战避坑经验总结

1. 设备树配置的正确性至关重要：仔细查阅芯片手册，确保 pinctrl 和 gpio 的配置参数正确无误。错误的配置可能导致硬件无法正常工作。
2. 注意引脚复用冲突：在配置 pinctrl 时，要避免不同外设使用相同的引脚。可以使用 pinctrl 的 debug 功能来检查引脚复用情况。
3. GPIO 申请和释放：在使用 GPIO 之前，必须先使用 gpio_request() 申请 GPIO。在驱动退出时，必须使用 gpio_free() 释放 GPIO。否则可能导致资源泄漏或其他驱动无法使用该 GPIO。
4. 中断处理：如果 GPIO 用于中断输入，需要注册中断处理函数。注意中断处理函数的执行时间要尽量短，避免影响系统性能。
5. 用户空间访问：可以使用 sysfs 接口或 libgpiod 库从用户空间访问 GPIO。注意权限控制，避免用户误操作。

掌握 pinctrl 子系统和 gpio 子系统是嵌入式 Linux 驱动开发的基础。通过深入理解其原理和使用方法，结合实际项目经验，可以编写出高效稳定的嵌入式驱动程序。希望本文能帮助你更好地理解这两个关键子系统，并在实际项目中应用它们。