RV1106平台下基于设备树的GPIO驱动开发实战

1. RV1106平台GPIO驱动开发入门指南刚拿到RV1106开发板的时候我最头疼的就是怎么控制那些GPIO引脚。作为嵌入式Linux开发者GPIO控制可以说是最基础也最常用的功能。不同于单片机直接操作寄存器的方式Linux系统下需要通过设备树和驱动框架来管理GPIO这对新手来说确实有点门槛。RV1106是瑞芯微推出的一款高性能嵌入式处理器广泛应用于智能硬件和物联网设备。它的GPIO控制器采用标准的Linux GPIO子系统架构这意味着我们可以使用成熟的设备树配置和驱动开发模式。在实际项目中我经常用GPIO来控制LED指示灯、读取按键状态或者与简单的外设通信。为什么要用设备树简单来说设备树就像硬件的身份证它把硬件配置信息从内核代码中分离出来。这样同一个内核镜像就能适配不同硬件配置的开发板大大提高了灵活性。在RV1106上每个GPIO引脚都需要在设备树中明确定义包括引脚编号、电气特性等参数。2. 设备树节点配置详解2.1 基础节点定义在RV1106上配置GPIO1_PC7引脚首先要在设备树中添加节点定义。我通常会创建一个独立的dtsi文件来管理所有GPIO配置这样主设备树文件能保持整洁。下面是我常用的模板/ { model Luckfox Pico Max; compatible rockchip,rv1103g-38x38-ipc-v10, rockchip,rv1106; gpio1pc7: gpio1pc7 { compatible regulator-fixed; pinctrl-names default; status okay; pinctrl-0 gpio1_pc7; gpios gpio1 RK_PC7 GPIO_ACTIVE_HIGH; regulator-name gpio1_pc7; regulator-always-on; }; };这里有几个关键点需要注意compatible属性必须与内核驱动匹配pinctrl-0指定了引脚控制配置gpios属性定义了具体的GPIO编号和有效电平regulator-always-on确保GPIO在系统休眠时仍能工作2.2 引脚控制配置光有上面的节点还不够我们还需要在pinctrl节点中定义引脚的电气特性pinctrl { gpio1-pc7 { gpio1_pc7: gpio1-pc7 { rockchip,pins 1 RK_PC7 RK_FUNC_GPIO pcfg_pull_none; }; }; };这段配置决定了GPIO1_PC7的工作模式RK_FUNC_GPIO表示引脚用作通用GPIOpcfg_pull_none表示不使用上拉或下拉电阻根据实际需求你可以调整这些参数。比如需要内部上拉时可以用pcfg_pull_up驱动能力不足时可以改用pcfg_output_high。3. Linux驱动开发实战3.1 驱动框架搭建有了设备树配置接下来就可以编写驱动代码了。我习惯从定义设备结构体开始#include linux/module.h #include linux/fs.h #include linux/gpio.h #include linux/of_gpio.h #define GPIO_CNT 1 #define GPIO_NAME gpio1_pc7 struct gpio1_pc7_dev { dev_t devid; struct cdev cdev; struct class *class; struct device *device; int major; int minor; struct device_node *nd; int gpio1_pc7; }; static struct gpio1_pc7_dev gpio1_pc7;这个结构体包含了驱动需要的所有资源设备号用于字符设备注册cdev实现文件操作接口GPIO编号保存从设备树获取的引脚信息3.2 文件操作实现为了让用户空间能控制GPIO我们需要实现文件操作接口static struct file_operations gpio1_pc7_fops { .owner THIS_MODULE, .open gpio1_pc7_open, .read gpio1_pc7_read, .write gpio1_pc7_write, .release gpio1_pc7_release, }; static int gpio1_pc7_open(struct inode *inode, struct file *filp) { filp-private_data gpio1_pc7; return 0; } static ssize_t gpio1_pc7_write(struct file *filp, const char __user *buf, size_t cnt, loff_t *offt) { int ret; unsigned char databuf[1]; struct gpio1_pc7_dev *dev filp-private_data; ret copy_from_user(databuf, buf, cnt); if(ret 0) { printk(copy from user failed\n); return -EFAULT; } gpio_set_value(dev-gpio1_pc7, databuf[0]); return 0; }这个实现允许用户通过write系统调用控制GPIO状态。比如写入1设置高电平写入0设置低电平。3.3 驱动初始化和退出驱动的核心逻辑在probe和remove函数中static int gpio1_pc7_probe(void) { int ret; // 1. 获取设备树节点 gpio1_pc7.nd of_find_node_by_path(/gpio1pc7); if(!gpio1_pc7.nd) { printk(find node failed\n); return -EINVAL; } // 2. 获取GPIO编号 gpio1_pc7.gpio1_pc7 of_get_named_gpio(gpio1_pc7.nd, gpios, 0); if(gpio1_pc7.gpio1_pc7 0) { printk(get gpio failed\n); return -EINVAL; } // 3. 申请GPIO ret gpio_request(gpio1_pc7.gpio1_pc7, GPIO_NAME); if(ret) { printk(gpio request failed\n); return ret; } // 4. 设置为输出模式 ret gpio_direction_output(gpio1_pc7.gpio1_pc7, 0); if(ret) { printk(set output failed\n); goto free_gpio; } // 5. 注册字符设备 if(gpio1_pc7.major) { gpio1_pc7.devid MKDEV(gpio1_pc7.major, 0); ret register_chrdev_region(gpio1_pc7.devid, GPIO_CNT, GPIO_NAME); } else { ret alloc_chrdev_region(gpio1_pc7.devid, 0, GPIO_CNT, GPIO_NAME); gpio1_pc7.major MAJOR(gpio1_pc7.devid); } // 6. 初始化cdev cdev_init(gpio1_pc7.cdev, gpio1_pc7_fops); ret cdev_add(gpio1_pc7.cdev, gpio1_pc7.devid, GPIO_CNT); // 7. 创建设备节点 gpio1_pc7.class class_create(THIS_MODULE, GPIO_NAME); device_create(gpio1_pc7.class, NULL, gpio1_pc7.devid, NULL, GPIO_NAME); return 0; free_gpio: gpio_free(gpio1_pc7.gpio1_pc7); return ret; }这个probe函数完成了从设备树获取配置到字符设备注册的全过程。注意错误处理要完善确保资源申请失败时能正确释放已分配的资源。4. 用户空间交互实现4.1 测试应用程序开发驱动写好之后我们需要一个简单的测试程序来验证功能#include stdio.h #include fcntl.h #include unistd.h int main(int argc, char **argv) { int fd; char value; if(argc ! 3) { printf(Usage: %s device 0|1\n, argv[0]); return -1; } fd open(argv[1], O_RDWR); if(fd 0) { perror(open device failed); return -1; } value atoi(argv[2]); if(write(fd, value, 1) ! 1) { perror(write failed); close(fd); return -1; } close(fd); return 0; }编译这个程序后就可以通过命令行控制GPIO了./gpio_test /dev/gpio1_pc7 1 # 设置高电平 ./gpio_test /dev/gpio1_pc7 0 # 设置低电平4.2 交叉编译环境配置RV1106通常需要交叉编译Makefile配置很关键# 驱动模块Makefile obj-m gpio1_pc7.o KDIR : /path/to/kernel PWD : $(shell pwd) all: make -C $(KDIR) M$(PWD) modules clean: rm -f *.ko *.o *.mod.* # 应用程序Makefile CROSS_COMPILE arm-rockchip830-linux-uclibcgnueabihf- CC $(CROSS_COMPILE)gcc all: gpio_test gpio_test: gpio_test.c $(CC) -o $ $^ clean: rm -f gpio_test确保KDIR指向正确的内核源码路径这是很多新手容易出错的地方。我第一次编译时就因为路径不对折腾了好久。5. 调试技巧与常见问题5.1 设备树调试方法设备树配置是否正确是第一个容易出问题的地方。我常用的调试方法查看解析后的设备树cat /proc/device-tree/gpio1pc7/status检查GPIO是否成功注册cat /sys/kernel/debug/gpio使用dtc工具反编译dtb文件dtc -I dtb -O dts -o output.dts /boot/xxx.dtb5.2 驱动调试技巧驱动开发过程中printk是最直接的调试手段。我习惯按日志级别分类printk(KERN_DEBUG Debug message\n); // 调试信息 printk(KERN_INFO Normal message\n); // 普通信息 printk(KERN_ERR Error message\n); // 错误信息可以通过修改/proc/sys/kernel/printk调整控制台输出级别。5.3 常见问题解决GPIO申请失败可能是引脚被其他驱动占用检查/sys/kernel/debug/gpio设备树节点未生效确认dts已编译为dtb并正确烧录用户空间无权限检查/dev下设备节点的权限或者配置udev规则电平反向检查设备树中GPIO_ACTIVE_HIGH/LOW配置是否正确记得每次修改设备树后都要重新编译dtb并烧录这个步骤我忘记过好几次结果调试了半天才发现设备树根本没更新。