3. 设备树基础

设备树（Device Tree）是嵌入式 Linux 中描述硬件拓扑结构的核心机制。对于 ADC 设备驱动开发而言，理解设备树的语法、节点结构以及关键属性（reg、compatible、中断）是正确配置 IIO 驱动与通道绑定的前提。本章将系统讲解设备树的基础知识，并通过 ADC 实例进行实战解析。

3.1 设备树语法与节点结构

设备树采用树形结构描述硬件，每个硬件设备对应一个节点（node），节点内包含若干属性（property）。节点从根节点（/）开始，通过路径唯一标识。

3.2 关键属性详解

3.2.1 compatible 属性

compatible 是设备树中最重要的属性，用于将设备节点与驱动程序绑定。其值为字符串列表，格式为 "厂商,设备型号"。驱动通过 of_match_table 进行匹配。

3.2.2 reg 属性与地址编码

reg 属性描述设备在总线上的地址空间。对于 SPI 设备，reg 表示片选号；对于 I2C 设备，表示从设备地址；对于内存映射设备，表示基地址和范围。

// SPI 总线上的 ADC：reg 表示片选 CS0
spi_adc: adc@0 {
    compatible = "adi,ad7124";
    reg = <0>;               // 片选 0
    spi-max-frequency = <5000000>;
};

// I2C 总线上的 ADC：reg 表示从设备地址 0x48
i2c_adc: adc@48 {
    compatible = "ti,ads1015";
    reg = <0x48>;            // I2C 地址 0x48
};

// 内存映射 ADC：reg 表示基地址和范围
mmio_adc: adc@ffc00000 {
    compatible = "xlnx,xadc";
    reg = <0xffc00000 0x1000>;  // 基地址 0xffc00000，范围 4KB
};

3.2.3 中断属性配置

ADC 设备通常使用中断通知 CPU 数据就绪。中断属性包括 interrupt-parent（指定中断控制器）和 interrupts（中断号与触发类型）。

3.3 ADC 设备节点完整示例

以下是一个完整的 SPI 总线 ADC 设备节点配置，包含 compatible、reg、中断以及 IIO 驱动所需的通道绑定属性。

// SPI 总线定义
&spi0 {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&spi0_pins>;

    // ADC 设备节点
    adc0: adc@0 {
        compatible = "adi,ad7124";
        reg = <0>;                    // SPI 片选 CS0
        spi-max-frequency = <5000000>;
        interrupts-extended = <&gpio0 30 2>;  // GPIO0_30, 下降沿触发
        #address-cells = <1>;
        #size-cells = <0>;

        // IIO 通道绑定
        channel@0 {
            reg = <0>;                // 通道 0
            label = "vref";
            adi,bipolar = <0>;
            adi,buffered = <1>;
        };

        channel@1 {
            reg = <1>;                // 通道 1
            label = "temperature";
            adi,bipolar = <0>;
            adi,buffered = <1>;
        };
    };
};

3.4 设备树编译与调试

设备树源文件（.dts / .dtsi）需要通过 dtc 工具编译为二进制 .dtb 文件，再由 bootloader 传递给内核。

3.5 本章小结