与GPIO中断配置实战：从节点解析到驱动开发)
1. 设备树基础与Zephyr实现机制
第一次接触Zephyr设备树时，我盯着.dts文件里那些奇怪的符号看了半天——这玩意儿怎么比电路图还难懂？后来才发现，设备树其实就是用文本描述硬件连接的"地图"。举个例子，当你的开发板上有个LED接在GPIOI的第1个引脚，设备树是这么描述的：
leds { compatible = "gpio-leds"; green_led_1: led_1 { gpios = <&gpioi 1 GPIO_ACTIVE_HIGH>; label = "User LD1"; }; };这里的gpioi就像是个快递柜，1是柜子编号，GPIO_ACTIVE_HIGH说明要给高电平灯才会亮。Zephyr在编译时会用DTC（Device Tree Compiler）把这个描述转换成C头文件，生成类似DT_N_GPIO_LEDS_LED_1_GPIOS_PIN这样的宏。
我在STM32F746G-DISCO开发板上实测时发现，设备树节点必须包含三个关键属性：
- compatible：相当于硬件身份证，驱动靠这个"认领"设备
- reg：硬件寄存器地址范围
- status：设备状态，必须是"okay"驱动才会初始化
2. GPIO中断的设备树配置实战
2.1 红外传感器节点定义
假设我们要给红外传感器配置中断，设备树要这么写：
infrared_sensor: infrared@0 { compatible = "vishay,tsop4838"; gpios = <&gpioc 3 GPIO_ACTIVE_LOW>; // 数据引脚 interrupts = <3 IRQ_TYPE_EDGE_FALLING>; interrupt-parent = <&gpioe>; label = "IR_SENSOR"; };这里踩过的坑是中断域配置。有次我把interrupt-parent写成了&nvic，结果死活触发不了中断。后来才明白，对于STM32这类芯片，GPIO中断要先经过EXTI控制器，正确的写法应该是：
interrupts-extended = <&exti 3 IRQ_TYPE_EDGE_FALLING>; interrupt-parent = <&exti>;2.2 绑定文件(bindings)详解
绑定文件就像设备树的"使用说明书"，我在boards/arm/stm32f746g_disco目录下创建了infrared.yaml：
description: IR sensor with GPIO interrupt compatible: "vishay,tsop4838" include: base.yaml properties: gpios: type: phandle-array required: true interrupts: type: array required: true interrupt-parent: type: phandle required: false特别要注意的是specifier-cells的对应关系。比如GPIO控制器需要#gpio-cells = <2>，第一个cell是引脚号，第二个是标志位。我在nRF52840项目上就曾因为漏写这个导致编译报错。
3. 驱动开发中的设备树API
3.1 硬件信息获取
Zephyr提供了非常方便的宏来获取设备树信息：
#define IR_SENSOR_NODE DT_NODELABEL(infrared_sensor) // 获取GPIO引脚 static const struct gpio_dt_spec ir_gpio = GPIO_DT_SPEC_GET(IR_SENSOR_NODE, gpios); // 获取中断号 #define IRQ_NUM DT_IRQN(IR_SENSOR_NODE)实测中发现DT_IRQN在跨中断域时会返回错误值，这时需要用DT_IRQ_BY_IDX宏：
#define IRQ_NUM DT_IRQ_BY_IDX(IR_SENSOR_NODE, 0, irq)3.2 中断服务函数注册
完整的初始化流程应该是这样的：
// 中断回调结构体 static struct gpio_callback irq_cb; // 中断服务函数 void irq_handler(const struct device *dev, struct gpio_callback *cb, uint32_t pins) { printk("IRQ triggered at %"PRIu32"\n", k_cycle_get_32()); } // 初始化函数 int init_ir_sensor(void) { // 配置GPIO输入 gpio_pin_configure_dt(&ir_gpio, GPIO_INPUT); // 配置中断 gpio_pin_interrupt_configure_dt(&ir_gpio, GPIO_INT_EDGE_FALLING); // 初始化回调 gpio_init_callback(&irq_cb, irq_handler, BIT(ir_gpio.pin)); // 添加回调 gpio_add_callback(ir_gpio.port, &irq_cb); return 0; }这里有个性能优化点：在中断服务函数中避免使用printk这类阻塞函数。我通常会用k_work_submit把任务提交到工作队列处理。
4. 复杂中断控制器配置
4.1 NVIC中断优先级配置
当使用STM32的NVIC时，设备树里要这么写：
nvic: interrupt-controller@e000e100 { compatible = "arm,v7m-nvic"; reg = <0xe000e100 0xc00>; interrupt-controller; #interrupt-cells = <2>; arm,num-irq-priority-bits = <4>; };在驱动代码中设置优先级时要注意：Zephyr使用的优先级数值越小优先级越高，和裸机编程相反：
IRQ_CONNECT(DT_IRQN(IR_SENSOR_NODE), DT_IRQ(IR_SENSOR_NODE, priority), // 注意这个值要转成NVIC格式 irq_handler, NULL, 0);4.2 多级中断处理
遇到像GIC这种复杂控制器时，需要处理中断号映射。我在i.MX RT1060上就遇到过这个问题：
gic: interrupt-controller@40081000 { compatible = "nxp,imx-gpc"; reg = <0x40081000 0x1000>; interrupt-controller; #interrupt-cells = <3>; }; sensor: sensor@400a0000 { interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_HIGH>; };对应的驱动代码要用DT_IRQ_BY_IDX解析三个cell：
#define SPI_NUM DT_IRQ_BY_IDX(node_id, 0, spi) #define TRIG_TYPE DT_IRQ_BY_IDX(node_id, 0, flags)5. 调试技巧与常见问题
5.1 设备树检查工具
推荐几个实用命令：
# 查看生成的设备树 west build -t menuconfig # 检查绑定文件 west build -t guiconfig # 查看最终设备树 cat build/zephyr/zephyr.dts5.2 常见踩坑记录
中断不触发：检查
interrupt-parent是否指向正确的控制器，我用逻辑分析仪抓波形确认过GPIO电平变化优先级反转：两个中断互相阻塞时，要调整
CONFIG_IRQ_OFFLOAD配置资源冲突：用
devicetree.h中的DT_NODE_HAS_STATUS检查节点状态GPIO配置错误：有一次我把
GPIO_ACTIVE_LOW写成GPIO_ACTIVE_HIGH，导致中断触发逻辑完全相反
最后分享一个真实案例：在为光电编码器配置中断时，发现中断触发太频繁导致系统卡死。后来通过以下优化解决：
- 在设备树中增加防抖配置：
debounce-interval = <50>; - 驱动中改用
GPIO_INT_EDGE_BOTH双沿触发 - 在工作队列中做实际处理
