第8章 GPIO与LED驱动实战

课程目录第8章 GPIO与LED驱动实战

8、GPIO与LED驱动实战：QNX GPIO驱动框架、Android GPIO HAL实现、GPIO控制LED示例、调试与验证方法

好，咱们今天聊点实在的。GPIO 和 LED，听起来简单吧？但说实话，在车载系统里，这玩意儿坑不少。我见过不少新手，上来就对着寄存器一顿操作，结果系统直接挂掉。嗯，咱们今天就把这块彻底捋清楚。

8.1 QNX GPIO 驱动框架

QNX 的 GPIO 驱动，说白了就是一套标准的资源管理框架。它不像 Linux 那样有复杂的 pinmux 子系统，QNX 更直接——你写一个资源管理器，注册一堆设备路径，然后上层通过 open/read/write 来操作。

我个人习惯把 GPIO 驱动分成三层：

硬件抽象层：直接操作 GPIO 控制器寄存器，比如设置方向、读取电平。
资源管理器层：实现 io_open、io_read、io_write 等回调，把硬件操作封装成文件接口。
客户端层：用户态程序通过 /dev/gpio0 这样的路径来访问。

来看一个典型的 QNX GPIO 驱动框架代码片段：

#include <sys/iofunc.h>
#include <sys/dispatch.h>

typedef struct {
    uintptr_t base_addr;  // GPIO 寄存器基地址
    int       irq;        // 中断号
} gpio_dev_t;

// 初始化硬件
int gpio_hw_init(gpio_dev_t *dev) {
    // 映射物理地址到虚拟地址
    dev->base_addr = mmap_device_io(0x100, GPIO_BASE_PHYS);
    if (dev->base_addr == MAP_DEVICE_FAILED) {
        return -1;
    }
    // 设置默认方向为输入
    out32(dev->base_addr + GPIO_DIR_OFFSET, 0x00000000);
    return 0;
}

// 设置引脚方向
void gpio_set_dir(uintptr_t base, int pin, int dir) {
    uint32_t val = in32(base + GPIO_DIR_OFFSET);
    if (dir == GPIO_OUTPUT) {
        val |= (1 << pin);
    } else {
        val &= ~(1 << pin);
    }
    out32(base + GPIO_DIR_OFFSET, val);
}

关键点：QNX 下操作硬件寄存器，一定要用 mmap_device_io 或者 mmap_device_memory，千万别直接用物理地址。我曾经见过有人直接写物理地址，结果系统崩溃，查了半天才发现是地址映射没做。

8.2 Android GPIO HAL 实现

到了 Android 这边，事情就复杂一些了。Android 的 GPIO HAL 要遵循标准的 HAL 架构，实现一个 hardware_module_t 结构体，然后提供 open、close、set_value、get_value 这些接口。

我建议你按照这个步骤来：

定义 HAL 模块 ID，比如 "gpio_led"
实现 hw_module_methods_t 中的 open 函数
在 open 函数里创建设备结构体，填充 gpio_device_t 的接口函数指针
在 set_value 里调用底层的 QNX 驱动接口

代码示例：

#include <hardware/hardware.h>
#include <hardware/gpio_led.h>

static int gpio_led_open(const struct hw_module_t* module,
                         const char* id,
                         struct hw_device_t** device) {
    gpio_led_device_t *dev = calloc(1, sizeof(gpio_led_device_t));
    dev->common.tag = HARDWARE_DEVICE_TAG;
    dev->common.module = (hw_module_t*)module;
    dev->common.close = gpio_led_close;

    // 打开 QNX 下的 GPIO 设备
    dev->fd = open("/dev/gpio0", O_RDWR);
    if (dev->fd < 0) {
        free(dev);
        return -1;
    }

    dev->set_value = gpio_led_set_value;
    dev->get_value = gpio_led_get_value;

    *device = (struct hw_device_t*)dev;
    return 0;
}

static int gpio_led_set_value(gpio_led_device_t *dev, int pin, int value) {
    char buf[32];
    snprintf(buf, sizeof(buf), "%d %d", pin, value);
    return write(dev->fd, buf, strlen(buf));
}

小技巧：Android HAL 层和 QNX 驱动层之间，我建议用字符串协议通信。比如 "set 12 1" 表示设置引脚12为高电平。这样调试起来特别方便，你直接用 echo 命令就能测试。

8.3 GPIO 控制 LED 示例

好了，理论说完了，咱们动手写个完整的 LED 控制示例。这个例子会跑在 QNX 侧，通过资源管理器暴露给 Android 上层。

先看驱动侧的核心逻辑：

// 资源管理器回调
int io_write(resmgr_context_t *ctp, io_write_t *msg, RESMGR_OCB_T *ocb) {
    char buffer[64];
    int nbytes = msg->iov[0].iov_len;
    memcpy(buffer, msg->iov[0].iov_base, nbytes);
    buffer[nbytes] = '\0';

    int pin, value;
    if (sscanf(buffer, "%d %d", &pin, &value) == 2) {
        if (value) {
            out32(gpio_base + GPIO_SET_OFFSET, (1 << pin));
        } else {
            out32(gpio_base + GPIO_CLR_OFFSET, (1 << pin));
        }
    }
    return _RESMGR_PTR(ctp, &msg->iov[0], nbytes);
}

然后在 Android 上层，写个简单的 JNI 接口：

// JNI 函数
JNIEXPORT jboolean JNICALL
Java_com_example_led_LedService_setLed(JNIEnv *env, jobject thiz,
                                       jint pin, jboolean on) {
    gpio_led_device_t *dev = get_led_device();
    if (!dev) return JNI_FALSE;

    int ret = dev->set_value(dev, pin, on ? 1 : 0);
    return (ret == 0) ? JNI_TRUE : JNI_FALSE;
}

注意：在车载项目中，LED 控制往往不是单纯的亮灭。比如背光调节、状态指示灯，这些都有时序要求。我曾经遇到过一个 bug，LED 闪烁频率太快，导致 PWM 控制器过热。后来加了延时控制才解决。

8.4 调试与验证方法

调试 GPIO 驱动，我有一套自己的三板斧：

第一板斧：示波器。别光看代码，拿示波器量一下引脚电平。我遇到过寄存器写对了，但 pinmux 配置错了的情况，示波器一量就现原形。
第二板斧：QNX 的 ioctl 调试。在驱动里加一个调试 ioctl，可以实时读取寄存器状态。比如：

#define GPIO_IOC_GET_REG _IOW('g', 1, gpio_reg_info_t)
static int io_devctl(resmgr_context_t *ctp, io_devctl_t *msg, ...) {
    switch (msg->i.dcmd) {
        case GPIO_IOC_GET_REG: {
            gpio_reg_info_t *info = (gpio_reg_info_t*)_DEVCTL_DATA(msg->i);
            info->dir_reg = in32(gpio_base + GPIO_DIR_OFFSET);
            info->data_reg = in32(gpio_base + GPIO_DATA_OFFSET);
            break;
        }
    }
}

第三板斧：压力测试。写个脚本，每秒切换 LED 状态 1000 次，跑一晚上。看看系统会不会死锁，内存会不会泄漏。

验证方法也很简单：

测试项	方法	预期结果
基本功能	echo "12 1" > /dev/gpio0	LED 点亮
边界测试	设置不存在的引脚号	返回错误，不崩溃
并发测试	两个进程同时写同一个引脚	最终状态一致
休眠唤醒	系统休眠后唤醒，检查 GPIO 状态	状态保持

避坑指南：我曾经在调试时发现，系统休眠后 GPIO 状态丢失了。查了半天，原来是电源管理域没配置好，GPIO 控制器在休眠时被断电了。解决方案是在驱动里实现 suspend/resume 回调，保存和恢复寄存器状态。

8.5 知识体系总览

下面这张图，是我自己总结的 GPIO 驱动开发全链路。你照着这个思路走，基本不会跑偏。

嗯，这张图把整个链路串起来了。从硬件寄存器，到 QNX 资源管理器，再到 Android HAL，最后到调试验证。你开发的时候，就按这个顺序一步步来，不会漏掉什么。

最后说一句，GPIO 驱动看着简单，但它是整个车载系统的地基。地基不稳，上层再花哨的功能都是白搭。所以，多花点时间在调试和验证上，绝对值得。

📚 课程目录

8、GPIO与LED驱动实战：QNX GPIO驱动框架、Android GPIO HAL实现、GPIO控制LED示例、调试与验证方法

8.1 QNX GPIO 驱动框架

8.2 Android GPIO HAL 实现

8.3 GPIO 控制 LED 示例

8.4 调试与验证方法

8.5 知识体系总览