4. 设备树中的地址编码：reg属性、#address-cells、#size-cells、ranges属性的使用

在嵌入式Linux系统中，设备树（Device Tree）负责描述硬件资源的布局与映射关系。地址编码是设备树中最核心的机制之一，它通过 reg、#address-cells、#size-cells 和 ranges 属性，精确描述设备在总线或系统中的地址空间。本章将深入解析这些属性的语法、语义及实战用法。

4.1 地址编码基础：#address-cells 与 #size-cells

这两个属性定义在总线节点（如 soc、axi、i2c）中，用于声明该总线下的地址描述格式。

// 示例：32位地址空间，32位长度
soc {
    #address-cells = <1>;
    #size-cells = <1>;

    uart0: serial@10000000 {
        reg = <0x10000000 0x1000>;
        // 地址：0x10000000，大小：0x1000（4KB）
    };

    gpio0: gpio@10001000 {
        reg = <0x10001000 0x100>;
        // 地址：0x10001000，大小：0x100（256字节）
    };
};

// 示例：64位地址空间，32位长度
bus@0 {
    #address-cells = <2>;
    #size-cells = <1>;

    dma@0x4000000000 {
        reg = <0x40 0x00000000 0x1000>;
        // 地址高32位：0x40，地址低32位：0x00000000，大小：0x1000
    };
};

4.2 reg 属性：设备地址资源的声明

reg 属性是设备节点中最基本的地址描述属性，用于声明设备占用的地址空间（如内存映射寄存器、IO端口、DMA通道等）。其格式为：

reg = <address1 length1 [address2 length2] ...>;

每个 address 和 length 的单元数由父节点的 #address-cells 和 #size-cells 决定。当设备有多个不连续的地址段时，可以声明多个条目。

// 多段地址示例：网卡有两个独立的寄存器区域
ethernet@20000000 {
    reg = <0x20000000 0x1000    // 主寄存器区
           0x30000000 0x200>;   // DMA描述符区
};

4.3 ranges 属性：地址转换与映射

ranges 属性定义在总线节点中，用于将子节点的地址空间映射到父节点的地址空间。它实现了地址域的转换，是设备树中实现“地址翻译”的关键机制。

ranges 的格式为：

ranges = <child-bus-address parent-bus-address length>;

其中每个字段的单元数由当前节点（子总线）的 #address-cells、父节点的 #address-cells 和当前节点的 #size-cells 共同决定。

// 示例：外部总线地址转换
// 子总线地址 0x0 ~ 0x3FFFFFF 映射到父总线地址 0x80000000 ~ 0x83FFFFFF
bus@80000000 {
    #address-cells = <1>;
    #size-cells = <1>;
    ranges = <0x0 0x80000000 0x4000000>;
    // 子地址0 → 父地址0x80000000，长度0x4000000（64MB）

    ethernet@0 {
        reg = <0x0 0x1000>;
        // 子地址0x0 → 实际物理地址 0x80000000
    };

    display@100000 {
        reg = <0x100000 0x100000>;
        // 子地址0x100000 → 实际物理地址 0x80100000
    };
};

4.4 实战案例：GPIO 控制器节点的地址编码

结合 GPIO 控制器节点，展示完整的地址编码配置。以下是一个典型的 SoC 内部 GPIO 控制器设备树节点：

soc {
    #address-cells = <1>;
    #size-cells = <1>;
    ranges;

    gpio0: gpio@ff310000 {
        compatible = "snps,dw-apb-gpio";
        reg = <0xff310000 0x1000>;
        interrupts = <0 40 4>;
        #gpio-cells = <2>;
        gpio-controller;
        ngpios = <32>;
    };

    gpio1: gpio@ff320000 {
        compatible = "snps,dw-apb-gpio";
        reg = <0xff320000 0x1000>;
        interrupts = <0 41 4>;
        #gpio-cells = <2>;
        gpio-controller;
        ngpios = <16>;
    };
};

4.5 地址编码常见问题与避坑指南

1. 单元数不匹配： 子节点 reg 的单元数必须严格等于 #address-cells + #size-cells。多一个或少一个都会导致解析错误。
2. 忘记声明父节点属性： 如果父节点没有 #address-cells 和 #size-cells，内核会使用默认值（通常为 2 和 1），可能导致地址解析错误。
3. ranges 长度溢出： 转换长度不能超过父总线地址空间范围，否则会导致地址映射重叠或越界。
4. 64位地址的高低位顺序： 在 #address-cells = <2> 时，地址顺序为 <高32位 低32位>，不要写反。
5. 非内存映射设备不要用 ranges： I2C、SPI 等总线上的设备地址是从机地址，不是内存地址，不需要 ranges 转换。

4.6 本章小结