从设备树到驱动：在RK3566上点亮一个LED的完整实战（GPIO0_B4为例）

从设备树到驱动在RK3566上点亮一个LED的完整实战GPIO0_B4为例当你第一次拿到一块Rockchip RK3566开发板时最令人兴奋的莫过于让硬件真正活起来。而点亮一个LED就像嵌入式世界的Hello World看似简单却蕴含着从硬件连接到软件控制的完整知识链。本文将带你以GPIO0_B4为例完整走通从设备树配置、驱动编写到内核编译烧录的全流程过程中你会遇到那些文档里没写的坑也会掌握真正实用的调试技巧。1. 硬件准备与环境搭建在开始编码之前我们需要确保硬件连接正确且开发环境就绪。ROC-RK3566-PC开发板上的GPIO0_B4对应物理引脚的位置可能因版本不同有所变化建议先查阅板子的原理图确认。通常这个引脚会位于扩展接口的某个位置用一个跳线帽连接LED时记得串联一个220Ω的限流电阻。开发环境需要准备一台运行Linux的主机推荐Ubuntu 20.04 LTS已安装的RK3566 SDK包含交叉编译工具链串口调试工具如minicom或picocom烧录工具RKDevTool或upgrade_tool提示在Ubuntu上安装依赖工具链时经常会遇到库版本冲突问题。建议使用SDK提供的docker环境避免污染主机系统。2. 深入理解RK3566的GPIO子系统Rockchip的GPIO控制器采用bank分组设计RK3566包含5组GPIO bankGPIO0-GPIO4每组又分为A、B、C、D四个子组。GPIO0_B4的命名规则解析如下字段含义值GPIO0Bank编号0B子组编号14引脚编号4计算全局GPIO编号的公式为pin bank * 32 group * 8 pin_num因此GPIO0_B4对应的全局编号为0 * 32 1 * 8 4 12在设备树中我们既可以使用数字编号gpio0 12也可以使用SDK提供的宏定义gpio0 RK_PB4。后者可读性更好但需要包含头文件#include dt-bindings/pinctrl/rockchip.h3. 设备树节点配置实战设备树是连接硬件描述与驱动程序的桥梁。我们在rk356x-firefly-demo.dtsi中添加一个gpio_demo节点gpio_demo: gpio_demo { status okay; compatible firefly,rk356x-gpio; led-gpio gpio0 RK_PB4 GPIO_ACTIVE_HIGH; };几个关键点需要注意compatible属性必须与驱动中的匹配表一致GPIO_ACTIVE_HIGH表示高电平点亮LED如果是低电平有效则使用GPIO_ACTIVE_LOW确保该GPIO没有被其他功能复用检查pinctrl配置编译设备树时经常会遇到语法错误导致编译失败。建议先用dtc工具检查dtc -I dts -O dtb -o test.dtb test.dts4. 编写LED驱动代码创建一个最简单的字符设备驱动主要实现以下功能#include linux/module.h #include linux/gpio.h static int led_gpio; static int gpio_demo_probe(struct platform_device *pdev) { struct device_node *np pdev-dev.of_node; enum of_gpio_flags flags; led_gpio of_get_named_gpio_flags(np, led-gpio, 0, flags); if (!gpio_is_valid(led_gpio)) { dev_err(pdev-dev, invalid GPIO pin\n); return -EINVAL; } if (gpio_request(led_gpio, led-gpio)) { dev_err(pdev-dev, GPIO request failed\n); return -EBUSY; } gpio_direction_output(led_gpio, 1); // 初始点亮LED return 0; } static const struct of_device_id gpio_demo_ids[] { { .compatible firefly,rk356x-gpio }, { } }; MODULE_DEVICE_TABLE(of, gpio_demo_ids); static struct platform_driver gpio_demo_driver { .driver { .name gpio-demo, .of_match_table gpio_demo_ids, }, .probe gpio_demo_probe, }; module_platform_driver(gpio_demo_driver);驱动开发中最常遇到的三个问题GPIO申请失败可能被其他驱动占用设备树匹配失败compatible字符串不匹配电平设置无效检查IO电压域配置5. 内核编译与固件烧录将驱动代码放入SDK的drivers/gpio目录后需要修改Kconfig和Makefile# drivers/gpio/Kconfig config GPIO_FIREFLY_DEMO tristate Firefly GPIO Demo default y# drivers/gpio/Makefile obj-$(CONFIG_GPIO_FIREFLY_DEMO) gpio-firefly-demo.o编译完整固件./build.sh kernel ./build.sh uboot ./mkfirmware.sh烧录时常见的坑开发板必须进入Loader模式按住Recovery键上电工具版本必须与芯片型号匹配烧录后务必执行重启设备操作6. 调试与问题排查当LED没有按预期点亮时可以按以下步骤排查确认GPIO是否成功申请cat /proc/interrupts | grep gpio检查GPIO当前状态# 导出GPIO echo 12 /sys/class/gpio/export # 查看方向 cat /sys/class/gpio/gpio12/direction # 手动设置电平 echo 1 /sys/class/gpio/gpio12/value测量物理引脚电压高电平应为3.3V左右低电平应接近0V如果电压异常检查IO电源域配置7. 进阶添加用户空间控制为了让应用层能控制LED我们可以实现一个简单的ioctl接口static long gpio_demo_ioctl(struct file *file, unsigned int cmd, unsigned long arg) { switch (cmd) { case LED_ON: gpio_set_value(led_gpio, 1); break; case LED_OFF: gpio_set_value(led_gpio, 0); break; default: return -ENOTTY; } return 0; }测试时可以用一个简单的Python脚本import fcntl fd open(/dev/gpio_demo, r) fcntl.ioctl(fd, LED_ON) # 点亮LED这个项目虽然简单但涵盖了嵌入式Linux开发的完整流程。在实际产品开发中还需要考虑电源管理、异常处理等更多因素。