4、设备树地址编码与映射：#address-cells、#size-cells、ranges属性、地址转换机制、64位地址处理

设备树（Device Tree）是嵌入式Linux系统中描述硬件拓扑与资源分布的核心数据结构。地址编码与映射是设备树中最关键、也最容易出错的环节之一。本章将深入剖析 #address-cells、#size-cells、ranges 属性的语义与用法，揭示地址转换的底层机制，并给出64位地址场景下的处理方案。

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

在设备树中，每个总线节点（bus node）或桥接节点（bridge node）必须通过 #address-cells 和 #size-cells 属性声明其子节点地址域的编码格式。这两个属性共同决定了 reg 属性中地址与长度的字长。

// 示例1：32位地址空间，1个地址单元，1个长度单元
soc {
    #address-cells = <1>;
    #size-cells = <1>;
    
    uart@101f0000 {
        reg = <0x101f0000 0x1000>;  // 基址0x101f0000，长度0x1000
    };
};

// 示例2：64位地址空间，2个地址单元，2个长度单元
pcie@40000000 {
    #address-cells = <2>;
    #size-cells = <2>;
    
    pci-ep@0,0 {
        reg = <0x0 0x40000000 0x0 0x100000>;  // 64位基址，64位长度
    };
};

4.2 ranges 属性：地址映射的桥梁

ranges 属性定义了父总线地址空间与子总线地址空间之间的映射关系。它使得子节点中的地址能够被父节点正确解析，是设备树地址转换的核心机制。

4.2.1 ranges 属性格式

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

其中每个字段的字长由以下规则决定：

• child-bus-address：子节点地址域中的起始地址，字长由子节点的 #address-cells 决定。
• parent-bus-address：父节点地址域中的起始地址，字长由父节点的 #address-cells 决定。
• length：映射区域的大小，字长由子节点的 #size-cells 决定。

4.2.2 典型映射场景

// 示例：CPU总线 → 外设总线映射
cpu-bus {
    #address-cells = <1>;
    #size-cells = <1>;
    
    // 外设总线在CPU地址空间中的基址为0x10000000
    // 外设总线内部地址0x0 ~ 0xFFFFFF 映射到 CPU 地址 0x10000000 ~ 0x10FFFFFF
    peripheral-bus@10000000 {
        compatible = "simple-bus";
        #address-cells = <1>;
        #size-cells = <1>;
        ranges = <0x0 0x10000000 0x1000000>;  // child=0x0, parent=0x10000000, len=0x1000000
        
        uart@0 {
            reg = <0x0 0x1000>;  // 外设总线内部地址0x0，实际CPU地址为0x10000000
        };
        timer@1000 {
            reg = <0x1000 0x100>;  // 外设总线内部地址0x1000，实际CPU地址为0x10001000
        };
    };
};

4.3 地址转换机制：从设备树到CPU物理地址

设备树地址转换是一个递归解析过程，由内核的 of_translate_address() 函数实现。转换路径从目标节点开始，逐级向上遍历父节点，应用每一级的 ranges 映射，最终得到CPU物理地址。

4.4 64位地址处理

随着嵌入式系统对内存和外设地址空间需求的增长，64位地址处理已成为常态。设备树通过 #address-cells = <2> 和 #size-cells = <2> 来支持64位地址。

4.4.1 64位地址编码规则

// 64位地址空间中的reg属性
memory@0 {
    device_type = "memory";
    reg = <0x0 0x80000000 0x0 0x80000000>;  // 基址0x80000000，长度0x80000000
};

// 64位外设地址映射
pcie@0x4000000000 {
    #address-cells = <2>;
    #size-cells = <2>;
    ranges = <0x0 0x0 0x0 0x4000000000 0x0 0x10000000>;
    // child: 0x0_0x0, parent: 0x0_0x4000000000, len: 0x0_0x10000000
};

4.4.2 64位地址转换示例

以下是一个完整的64位地址转换案例，展示从PCIe端点设备到CPU物理地址的映射过程：

// 根节点
/ {
    #address-cells = <2>;
    #size-cells = <2>;
    
    // PCIe控制器节点
    pcie@0x4000000000 {
        compatible = "pci-host-ecam-generic";
        #address-cells = <3>;  // PCIe规范：3个地址单元
        #size-cells = <2>;
        reg = <0x0 0x4000000000 0x0 0x10000000>;  // ECAM配置空间
        
        // 将PCIe总线地址0x0_0x0 ~ 0x0_0xFFFFFF 映射到CPU地址0x0_0x50000000 ~ 0x0_0x50FFFFFF
        ranges = <0x02000000 0x0 0x0 0x0 0x50000000 0x0 0x1000000>;
        // PCIe地址格式：type(1字) + bus_addr(2字) → CPU_addr(2字) → len(2字)
        
        // PCIe端点设备
        pci-ep@0,0 {
            reg = <0x02000000 0x0 0x0 0x0 0x0 0x0>;
            // type=0x02000000(非预取内存), bus_addr=0x0_0x0
        };
    };
};

4.5 地址转换调试技巧

4.6 常见错误与避坑指南

• #address-cells / #size-cells 不匹配：父子节点之间的地址单元数不一致，导致 ranges 解析错位。务必确保每个字段的字长符合声明。
• ranges 缺失导致地址隔离：如果子节点需要被父节点访问但未定义 ranges，驱动将无法通过 of_iomap() 获取有效地址。
• 64位地址截断：在32位系统中处理64位地址时，内核可能截断高32位。使用 phys_addr_t 类型确保完整存储。
• PCIe地址类型混淆：PCIe的 #address-cells = <3> 中第一个字是地址类型标识（配置空间、I/O、内存等），不要与普通地址混淆。

4.7 驱动接口中的地址获取

在Linux驱动中，通过以下API获取经过设备树转换的物理地址和映射后的虚拟地址：

#include <linux/of_address.h>
#include <linux/of_platform.h>

static int my_driver_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;
    struct resource *res;
    void __iomem *base;
    
    // 方法1：通过资源获取（推荐）
    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    if (!res) {
        dev_err(dev, "Failed to get memory resource\n");
        return -ENXIO;
    }
    dev_info(dev, "Physical address: 0x%llx, size: 0x%llx\n",
             (unsigned long long)res->start,
             (unsigned long long)resource_size(res));
    
    // 方法2：直接映射
    base = devm_ioremap_resource(dev, res);
    if (IS_ERR(base))
        return PTR_ERR(base);
    
    // 方法3：通过设备树节点直接获取（底层调试用）
    struct device_node *np = pdev->dev.of_node;
    const __be32 *addr;
    u64 phys_addr;
    addr = of_get_address(np, 0, NULL, NULL);
    if (addr)
        phys_addr = of_translate_address(np, addr);
    
    return 0;
}