4. 地址映射原理：CPU地址空间、总线地址空间、外设地址空间的关系，MMU与ioremap机制

在嵌入式Linux系统中，驱动开发者经常遇到“地址”概念混淆导致的调试困境。CPU发出的地址、总线上传输的地址、以及外设寄存器实际所在的地址，三者并不总是相同。理解这三层地址空间的关系以及MMU（内存管理单元）和ioremap机制，是排查设备树reg属性映射错误的理论基础。

4.1 三层地址空间模型

从CPU核心到外设寄存器，地址经历了三次语义转换。下表总结了每一层地址空间的定义、特点与典型宽度：

4.2 地址映射流程与MMU角色

MMU是连接CPU虚拟地址与物理地址的核心硬件单元。下图展示了从驱动访问外设寄存器到最终操作硬件引脚的完整地址流：

4.3 ioremap 机制详解

ioremap是Linux内核提供的核心API，用于将外设的物理地址空间映射到内核虚拟地址空间。其工作原理如下：

• 页表建立：在内核页表中创建指定物理地址范围到虚拟地址范围的映射条目，设置属性为非缓存（non-cacheable）和设备内存（Device memory），防止CPU缓存导致的外设访问不一致。
• 虚拟地址返回：返回一个内核虚拟地址指针，驱动通过该指针使用readl/writel等访问函数操作外设寄存器。
• 映射生命周期：映射在驱动probe时建立，在remove时通过iounmap解除。错误的生命周期管理会导致系统崩溃。

4.4 常见地址映射错误模式

基于三层地址空间模型，驱动调试中常见的映射错误可归纳为以下四类：

4.5 设备树reg属性与地址映射的对应关系

设备树中reg属性直接描述了外设在CPU物理地址空间中的位置。以下是一个典型示例：

/* 设备树节点 */
uart0: serial@10000000 {
    compatible = "vendor,uart-ip";
    reg = <0x0 0x10000000 0x0 0x1000>;
    interrupts = <0 33 4>;
};

/* 驱动中映射代码 */
static int uart_probe(struct platform_device *pdev)
{
    struct resource *res;
    void __iomem *base;

    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    if (!res)
        return -ENXIO;

    /* devm_ioremap_resource 自动处理映射与错误检查 */
    base = devm_ioremap_resource(&pdev->dev, res);
    if (IS_ERR(base))
        return PTR_ERR(base);

    /* 通过 base 访问寄存器 */
    writel(0x01, base + UART_CTRL_OFFSET);
    return 0;
}

4.6 调试地址映射问题的实用命令

在目标系统上，以下命令和接口是验证地址映射正确性的第一手工具：

• /proc/iomem：列出所有已注册的物理地址范围及其所有者驱动。检查设备树reg解析出的地址是否在此列表中。
• /sys/kernel/debug/gpio：对于GPIO控制器，可查看寄存器基地址与实际映射地址的对应关系。
• devmem2 或 busybox devmem：用户空间工具，直接读取物理地址内容。用于验证ioremap前后数据一致性。
• trace_printk 与 ftrace：在驱动中插入trace_printk打印虚拟地址和物理地址，通过trace-cmd分析映射流程。

下图总结了从设备树解析到驱动映射的完整数据流，以及调试工具的介入点：

4.7 总结：地址映射调试清单

当遇到设备树reg属性相关的地址映射问题时，按以下清单逐项排查：

1. 确认物理地址正确性：对照SoC数据手册，验证设备树reg中的地址是否属于该外设的物理地址范围。
2. 检查地址对齐：外设寄存器基地址通常需要页对齐（4KB），部分SoC要求64位对齐。
3. 验证映射大小：确保reg的size覆盖所有需要访问的寄存器，避免越界访问。
4. 确认映射属性：使用ioremap而非缓存版本，防止缓存一致性问题。
5. 利用调试接口：通过/proc/iomem和devmem交叉验证映射是否生效。
6. 检查总线桥接：对于PCIe、USB等总线设备，确认ranges属性中的地址转换规则正确。