ARM Linux设备树开发与调试实战指南

1. ARM Linux设备树开发实战指南

在嵌入式Linux开发中，设备树(Device Tree)已经成为描述硬件配置的标准方式。作为一名长期从事ARM平台开发的工程师，我深刻体会到掌握设备树语法对于驱动开发的重要性。本文将基于i.MX6ULL平台，详细解析设备树的核心语法和实际应用技巧。

2. 设备树基础架构解析

2.1 DTS文件整体结构

设备树源文件(.dts)采用类C语言的语法格式，以树形结构组织硬件信息。一个典型的DTS文件包含三个核心部分：

c复制/dts-v1/;  // 版本声明，必须位于文件开头

/ {        // 根节点，所有硬件描述都包含在此节点内
    // 子节点定义
    aliases {
        can0 = &flexcan1;  // 为flexcan1节点定义别名can0
    };
    
    cpus {
        #address-cells = <1>;
        #size-cells = <0>;
        
        cpu0: cpu@0 {
            compatible = "arm,cortex-a7";
            device_type = "cpu";
            reg = <0>;
        };
    };
};

在实际项目中，我建议采用这种分层注释的方式编写DTS文件，既保持结构清晰，又便于团队协作。每个节点都应明确其作用域和功能描述。

2.2 头文件包含机制

与C语言类似，设备树支持头文件包含，扩展名通常为.dtsi。例如：

c复制#include <dt-bindings/input/input.h>
#include "imx6ull.dtsi"

经验分享：

• SOC级通用描述（如CPU架构、外设寄存器等）应放在.dtsi文件中
• 板级特定配置（如具体外设连接方式）放在.dts文件中
• 使用#include时注意路径问题，建议使用相对路径

3. 设备节点详解

3.1 节点结构与命名规范

设备树采用树形结构描述硬件，每个设备都是一个节点。节点命名遵循以下格式：

code复制[label:] node-name@unit-address

实际案例：

c复制cpu0: cpu@0 {
    // 节点内容
};

其中：

• cpu0是标签(label)，可通过&cpu0引用该节点
• cpu@0是节点名，表示这是一个CPU设备，地址为0
• 当节点没有实际物理地址时，可以省略@unit-address部分

3.2 属性类型与语法

设备节点通过属性描述硬件特征，常见属性值类型包括：

1. 字符串：

c复制compatible = "arm,cortex-a7";

2. 32位无符号整数：

c复制reg = <0>;

3. 字符串列表：

c复制compatible = "fsl,imx6ull-gpmi-nand", "fsl,imx6ul-gpmi-nand";

在调试过程中，我发现属性值的格式错误是导致设备树解析失败的常见原因。建议使用dtc工具进行语法检查：

bash复制dtc -I dts -O dtb -o test.dtb test.dts

4. 关键标准属性解析

4.1 compatible属性

compatible属性是设备树中最重要的属性，用于绑定设备与驱动。其格式为：

c复制compatible = "manufacturer,model";

实际案例：

c复制compatible = "fsl,imx6ul-evk-wm8960", "fsl,imx-audio-wm8960";

内核驱动匹配规则：

1. 优先匹配第一个字符串"fsl,imx6ul-evk-wm8960"
2. 若无匹配，则尝试第二个字符串"fsl,imx-audio-wm8960"
3. 继续向后匹配，直到找到合适驱动或列表结束

4.2 地址相关属性

4.2.1 #address-cells与#size-cells

这对属性定义了子节点reg属性的格式：

c复制aips3: aips-bus@02200000 {
    #address-cells = <1>;  // 地址占1个32位数
    #size-cells = <1>;     // 长度占1个32位数
    
    dcp: dcp@02280000 {
        reg = <0x02280000 0x4000>;  // 地址0x02280000，长度0x4000
    };
};

4.2.2 reg属性

描述设备地址空间资源，格式为

c复制reg = <0x02280000 0x4000>;  // 起始地址0x02280000，范围0x4000字节

c复制soc {
    #address-cells = <1>;
    #size-cells = <1>;
    
    bus@10000000 {
        compatible = "simple-bus";
        #address-cells = <1>;
        #size-cells = <1>;
        ranges = <0x0 0x10000000 0x1000>;  // 子地址0x0映射到父地址0x10000000，长度0x1000
    };
};

bash复制cat /proc/device-tree/

bash复制hexdump -C /sys/firmware/devicetree/base/node/property

bash复制dtc -I dtb -O dts -o recovered.dts system.dtb

c复制gpio1: gpio@0209c000 {
    compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio";
    reg = <0x0209c000 0x4000>;
    interrupts = <GIC_SPI 66 IRQ_TYPE_LEVEL_HIGH>,
                 <GIC_SPI 67 IRQ_TYPE_LEVEL_HIGH>;
    gpio-controller;
    #gpio-cells = <2>;
    interrupt-controller;
    #interrupt-cells = <2>;
};

c复制clks: ccm@020c4000 {
    compatible = "fsl,imx6ul-ccm";
    reg = <0x020c4000 0x4000>;
    #clock-cells = <1>;
    clocks = <&osc>;
    clock-names = "osc";
};