高通 QRB5165 GPIO 子系统

隐身模式

于 2025-07-02 07:30:00 发布

阅读量908

点赞数 24

CC 4.0 BY-SA版权

分类专栏： Qualcomm 文章标签： linux gpio

本文链接：https://blog.csdn.net/yll7702/article/details/149041727

Qualcomm 专栏收录该内容

6 篇文章

订阅专栏

深度掌握高通 QRB5165 平台的 GPIO 子系统：原理、配置、调试与实战案例

1. 引言：GPIO 在嵌入式系统中的重要性

在嵌入式系统中，GPIO（通用输入输出）是一类极其基础但又不可或缺的资源。它是连接处理器与外部世界的桥梁，广泛用于读取传感器状态、控制 LED、驱动蜂鸣器、复位外设等。在嵌入式 Linux 系统中，GPIO 通常通过设备树进行初始化，并由内核提供统一的接口进行控制。尤其是在高通 QRB5165 这类集成度极高的平台上，GPIO 不再是简单的“引脚电平控制”，而是牵涉到 TLMM（Top Level Mode Multiplexer）配置、引脚复用、多功能子系统等复杂机制。

本文将结合 QRB5165 平台的实际开发经验，从硬件结构到驱动框架、从设备树配置到用户态调试，系统地讲解如何高效掌握 GPIO 的开发技巧与调试方法。

2. QRB5165 平台 GPIO 硬件结构概述

QRB5165 平台基于 Qualcomm 的 Snapdragon 865 SoC，内部集成了丰富的 IO 接口，GPIO 控制由 TLMM（Top Level Mode Multiplexer）模块完成。TLMM 的职责包括：

管理 GPIO 的输入输出方向
配置每个 GPIO 的功能复用（比如 SPI、UART、I2C）
设置上拉/下拉、驱动强度、中断触发方式等

GPIO 编号并不等于 SoC 的物理引脚编号，而是通过 GPIO 映射表管理。开发者通常使用设备树中的 TLMM 节点来配置 GPIO 参数，例如：

&tlmm {
    gpio_keys {
        compatible = "gpio-keys";
        pinctrl-names = "default";
        pinctrl-0 = <&gpio_key_pins>;

        key_vol_up {
            label = "volume_up";
            gpios = <&tlmm 74 GPIO_ACTIVE_LOW>;
            linux,code = <KEY_VOLUMEUP>;
        };
    };

    gpio_key_pins: gpio_key_pins {
        pins = "gpio74";
        function = "gpio";
        drive-strength = <2>;
        bias-pull-up;
    };
};

3. Linux GPIO 子系统原理解析

Linux 提供了统一的 GPIO 子系统，主要由以下几个部分组成：

GPIO controller 驱动（如 ``）：负责注册 gpiochip，管理具体引脚的控制操作。
Pin controller 驱动：用于设置引脚的复用功能和电气属性。
GPIOLib 框架：为其他子系统提供通用的 API（如 gpio_direction_output()、gpio_set_value()）。

GPIO 在系统中被抽象为 gpiochip 设备，每个 chip 拥有多个编号的 GPIO。用户空间可以通过 /sys/class/gpio/ 或 /dev/gpiochipX 接口与之交互。

TLMM 驱动的注册流程

TLMM 驱动注册过程：

platform 驱动与设备树节点匹配
初始化 qcom_pinctrl 结构体
注册 gpiochip
设置 pinmux、pinconf

驱动中最关键的操作包括：

gpiochip_add()：注册 GPIO 控制器
pinctrl_register()：注册引脚复用配置器
irq_domain_add_linear()：为 GPIO 分配中断资源

4. Device Tree 配置详解

TLMM 节点结构

在 QRB5165 的设备树中，GPIO 通常配置在 &tlmm 节点下，每个引脚都需要通过 pinctrl 子节点指定：

gpio_output_low: gpio_output_low {
    pins = "gpio45";
    function = "gpio";
    drive-strength = <2>;
    output-low;
};

常用属性说明：

function: 设为 gpio 表示通用 IO 模式
drive-strength: 输出驱动强度（单位 mA）
bias-disable: 禁用上下拉
bias-pull-up: 上拉
bias-pull-down: 下拉
output-high/output-low: 默认输出电平

gpios 属性解析

每个设备使用 GPIO 时，都需要指定 <&tlmm X FLAG>：

X：GPIO 编号（非物理编号）
FLAG：电平激活方式，如 GPIO_ACTIVE_HIGH 或 GPIO_ACTIVE_LOW

中断配置

当 GPIO 用于中断输入时，需要设置 interrupts 属性，如：

interrupt-parent = <&tlmm>;
interrupts = <74 IRQ_TYPE_EDGE_BOTH>;

5. 用户态控制 GPIO：Sysfs 与 GPIOLib

方式一：Sysfs 接口（已废弃）

echo 74 > /sys/class/gpio/export
echo out > /sys/class/gpio/gpio74/direction
echo 1 > /sys/class/gpio/gpio74/value

方式二：使用 libgpiod

推荐使用 libgpiod 提供的工具或 C 接口：

gpioinfo  # 查看所有 GPIO 信息
gpioget gpiochip0 74

示例代码：

#include <gpiod.h>

struct gpiod_chip *chip = gpiod_chip_open_by_name("gpiochip0");
struct gpiod_line *line = gpiod_chip_get_line(chip, 74);
gpiod_line_request_output(line, "myapp", 1);
gpiod_line_set_value(line, 0);
gpiod_chip_close(chip);

6. 实战场景一：LED 灯控制与状态反馈

使用 gpio-leds 子系统

leds {
    compatible = "gpio-leds";

    red {
        label = "status_red";
        gpios = <&tlmm 91 GPIO_ACTIVE_HIGH>;
        default-state = "off";
    };
};

自定义 compatible 实现拓展控制

例如：

leds-gpio-aerora {
    compatible = "gpio-leds-aerora";
    ...
};

驱动中通过 of_device_id 匹配并扩展控制逻辑。

7. 实战场景二：GPIO 中断输入调试

当接入按钮、IR 传感器等需要中断响应的外设时，GPIO 可配置为输入 + 中断：

button_int_pin: button_int_pin {
    pins = "gpio86";
    function = "gpio";
    bias-pull-down;
};

驱动中注册中断：

irq = gpio_to_irq(86);
request_irq(irq, button_irq_handler, IRQF_TRIGGER_RISING, "btn", NULL);

8. GPIO 电源管理与低功耗控制

为降低功耗，GPIO 需要在 suspend 状态正确配置：

设置为高阻输入
禁用上拉/下拉
不允许漏电流路径形成

gpio_pins_sleep: gpio_pins_sleep {
    pins = "gpio86";
    function = "gpio";
    bias-disable;
    drive-strength = <2>;
    input-enable;
};

与 wakeup 配合

wakeup-source;
wakeup-gpios = <&tlmm 86 GPIO_ACTIVE_HIGH>;

9. 常见问题与调试技巧

gpio_request 失败

GPIO 被其他设备占用（需查 DTS 冲突）
GPIO 编号配置错误（查看 SoC TRM 与 DTS 对应）

“GPIO busy” 报错

Sysfs/export 状态未清理
gpiochip 注册冲突

无法输出高电平

没有设置 drive-strength
引脚处于复用状态（非 GPIO）
上拉电阻未接或未配置 bias-pull-up

10. 总结与建议

高通 QRB5165 平台上的 GPIO 配置远不止简单的高低电平控制，它涉及设备树结构、驱动框架、Pinmux 多功能引脚配置、电源管理及中断系统的协同。掌握这些机制可以帮助开发者快速实现复杂的 IO 控制逻辑，也为系统的稳定性与低功耗设计打下基础。建议开发中多利用 libgpiod 进行测试，并编写统一的 GPIO 封装接口模块，提升可维护性。