Linux驱动开发：设备树与GPIO接口详解

1. Linux驱动开发中的设备树操作接口详解在嵌入式Linux驱动开发中设备树(Device Tree)已经成为硬件描述的标准方式。相比传统的硬编码方式设备树将硬件配置与驱动代码分离大大提高了代码的可移植性。掌握设备树相关操作接口是Linux驱动工程师的基本功。1.1 节点查找函数解析设备树以树形结构组织硬件信息查找节点是最基础的操作。内核提供了多种查找方式/* 通过节点名查找 */ struct device_node *of_find_node_by_name(struct device_node *from, const char *name); /* 通过device_type属性查找 */ struct device_node *of_find_node_by_type(struct device_node *from, const char *type); /* 通过compatible属性查找 */ struct device_node *of_find_compatible_node(struct device_node *from, const char *type, const char *compatible);实际开发中最常用的是of_find_compatible_node因为它通过厂商定义的compatible字符串匹配准确度最高。例如查找I2C控制器节点struct device_node *i2c_node of_find_compatible_node(NULL, NULL, fsl,imx6q-i2c);注意查找函数返回的device_node指针不需要手动释放内核会管理其生命周期。1.2 属性读取函数实践获取节点属性是驱动获取硬件配置的关键。常用属性读取函数包括/* 读取u32数组 */ int of_property_read_u32_array(const struct device_node *np, const char *propname, u32 *out_values, size_t sz); /* 读取字符串 */ int of_property_read_string(struct device_node *np, const char *propname, const char **out_string); /* 统计数组元素个数 */ int of_property_count_elems_of_size(const struct device_node *np, const char *propname, int elem_size);典型应用场景是解析reg属性获取寄存器地址u32 reg[2]; if (of_property_read_u32_array(node, reg, reg, 2)) { dev_err(dev, Failed to get reg property\n); return -EINVAL; }经验属性读取函数返回0表示成功负数表示失败。务必检查返回值避免空指针访问。2. GPIO子系统接口深度解析GPIO是驱动开发中最常用的外设接口之一Linux提供了完善的GPIO子系统。2.1 基础GPIO操作/* 申请GPIO */ int gpio_request(unsigned gpio, const char *label); /* 设置方向 */ int gpio_direction_input(unsigned gpio); int gpio_direction_output(unsigned gpio, int value); /* 读写值 */ int gpio_get_value(unsigned gpio); void gpio_set_value(unsigned gpio, int value); /* 释放GPIO */ void gpio_free(unsigned gpio);标准使用流程int ret gpio_request(gpio_num, my_gpio); if (ret) { /* 错误处理 */ } gpio_direction_output(gpio_num, 1); gpio_set_value(gpio_num, 0); /* 使用完成后 */ gpio_free(gpio_num);2.2 设备树GPIO接口现代驱动推荐通过设备树定义GPIO/* 统计GPIO数量 */ int of_gpio_count(struct device_node *np); /* 获取GPIO编号 */ int of_get_named_gpio(struct device_node *np, const char *propname, int index);设备树中定义my_gpio: gpio0 { compatible my,gpio; gpios gpio1 5 GPIO_ACTIVE_HIGH, gpio1 6 GPIO_ACTIVE_LOW; };驱动中获取int gpio1 of_get_named_gpio(node, gpios, 0); int gpio2 of_get_named_gpio(node, gpios, 1);注意通过设备树获取的GPIO编号可以直接用于gpio_*函数无需再调用gpio_request。3. 设备资源管理(devm)接口详解devm(Device Resource Management)系列接口可以自动释放资源避免资源泄漏。3.1 内存管理接口/* 分配内存 */ void *devm_kmalloc(struct device *dev, size_t size, gfp_t gfp); void *devm_kzalloc(struct device *dev, size_t size, gfp_t gfp); /* 释放内存 */ void devm_kfree(struct device *dev, void *p);使用示例struct my_data *data devm_kzalloc(pdev-dev, sizeof(*data), GFP_KERNEL); if (!data) return -ENOMEM;优势当设备卸载或probe失败时内核会自动释放这些内存无需手动管理。3.2 中断管理接口/* 申请中断 */ int devm_request_irq(struct device *dev, unsigned int irq, irq_handler_t handler, unsigned long flags, const char *name, void *dev_id); /* 释放中断 */ void devm_free_irq(struct device *dev, unsigned int irq, void *dev_id);典型用法ret devm_request_irq(pdev-dev, irq, my_handler, IRQF_TRIGGER_RISING, my_irq, NULL); if (ret) { dev_err(pdev-dev, Failed to request IRQ\n); return ret; }3.3 其他资源接口/* IO内存映射 */ void __iomem *devm_ioremap_resource(struct device *dev, const struct resource *res); /* 时钟管理 */ struct clk *devm_clk_get(struct device *dev, const char *id); void devm_clk_put(struct device *dev, struct clk *clk); /* pinctrl管理 */ struct pinctrl *devm_pinctrl_get(struct device *dev); void devm_pinctrl_put(struct device *dev, struct pinctrl *p);4. 实战经验与常见问题4.1 设备树使用技巧兼容性字符串compatible属性应包含厂商,型号格式例如compatible nxp,imx6ull-gpio, fsl,imx35-gpio;驱动中可以通过of_device_is_compatible()检查兼容性。寄存器地址处理reg属性通常包含地址和长度reg 0x0209c000 0x4000;驱动中应使用of_iomap()获取映射后的虚拟地址。中断处理interrupts属性定义中断号和触发方式interrupts GIC_SPI 66 IRQ_TYPE_LEVEL_HIGH;4.2 常见错误排查GPIO编号错误确保设备树中GPIO控制器已正确定义使用gpio-number属性时特别注意。资源申请失败检查返回值常见原因包括设备树节点未正确定义资源已被其他驱动占用内核配置缺少相关驱动支持内存泄漏即使使用devm接口也要注意循环分配场景下的泄漏问题。竞态条件在probe函数中初始化硬件前确保相关时钟和电源已就绪。4.3 性能优化建议延迟敏感操作对于GPIO控制等实时性要求高的操作考虑使用raw GPIO接口。中断处理中断处理函数应尽可能简短长时间任务使用tasklet或工作队列。资源缓存频繁访问的寄存器地址或GPIO编号可在probe时缓存避免重复查找。电源管理实现suspend/resume回调正确处理低功耗状态下的硬件配置。