1. 课程导论：设备树在Linux驱动中的核心作用，reg属性与地址映射错误的常见场景与危害
1.1 设备树：从硬件拓扑到驱动实例的桥梁
在嵌入式Linux系统中，设备树（Device Tree，DT）是描述硬件资源的标准化数据结构。它替代了传统板级文件（board-*.c）中硬编码的硬件信息，将CPU、内存、外设控制器、中断控制器、GPIO等硬件组件的拓扑关系、寄存器地址、中断号、时钟频率等参数以树形节点形式传递给内核。
设备树的核心价值在于：驱动与硬件描述解耦。同一份驱动代码可以通过解析不同设备树文件，适配不同硬件平台，无需重新编译内核。
关键认知： 设备树是驱动开发者与硬件工程师之间的“契约文档”。驱动通过设备树节点获取硬件资源，硬件工程师通过设备树描述芯片手册中的寄存器布局。任何一方的偏差都会导致驱动运行异常。
1.2 reg属性：地址资源的“身份证”
reg属性是设备树节点中最核心的属性之一，用于描述设备占用的地址空间。其标准格式为：
reg = <address1 length1 address2 length2 ...>;每个<address length>对定义一段连续的物理地址范围。对于32位系统，每个值占一个u32；对于64位系统，通过#address-cells和#size-cells控制单元数。
| 组件 | 含义 | 示例 |
|---|---|---|
| address | 设备在总线上的起始物理地址 | 0x1c00000 |
| length | 地址空间的长度（字节数） | 0x1000 (4KB) |
| #address-cells | 父节点中地址字段占用的u32个数 |
<1> 或 <2> |
| #size-cells | 父节点中长度字段占用的u32个数 |
<1> 或 <2> |
典型设备树节点示例：
uart0: serial@1c00000 {
compatible = "fsl,imx6q-uart", "fsl,imx21-uart";
reg = <0x01c00000 0x4000>;
interrupts = <0 58 4>;
clocks = <&clks IMX6Q_CLK_UART_IPG>;
status = "okay";
};1.3 地址映射错误的常见场景
地址映射错误是驱动调试中最隐蔽、最耗时的问题之一。以下列出四种高频场景：
- reg属性值与芯片手册不一致：设备树中填写的起始地址或长度与硬件手册的寄存器基址、地址范围不匹配。
- 地址单元计数不匹配：父节点的
#address-cells或#size-cells与子节点reg中的字段个数不一致，导致内核解析出错误的地址值。 - 地址空间重叠或越界：多个设备节点声明了重叠的物理地址范围，或某个设备的地址范围超出了总线窗口。
- ioremap映射长度不足：驱动中调用
ioremap时使用的长度小于设备树中声明的length，导致访问高地址寄存器时触发总线错误。
⚠️ 典型危害： 地址映射错误轻则导致驱动无法初始化、寄存器读写返回错误值，重则引发内核Oops、系统死锁甚至硬件损坏（如向错误地址写入非法配置）。
1.4 地址映射错误的危害等级
| 危害等级 | 表现 | 后果 |
|---|---|---|
| L1 轻微 | 驱动probe失败，返回-ENXIO或-EFAULT | 设备不可用，系统日志可查 |
| L2 中等 | 寄存器读写返回全0或全F，功能异常 | 设备工作不稳定，数据错误 |
| L3 严重 | 访问非法地址触发同步外部中止（SError） | 内核Oops，系统panic |
| L4 灾难 | 错误地址写入导致硬件寄存器被意外修改 | 外设损坏、电源管理单元误操作 |
1.5 设备树地址解析流程（SVG架构图）
下图展示了从设备树节点到驱动获取地址资源的完整数据流：
1.6 本课程的学习路径
本课程将围绕设备树reg属性与地址映射，系统讲解以下核心能力：
- 设备树语法精讲：
reg、ranges、dma-ranges等地址相关属性的完整语义。 - 内核OF API深度解析：
of_iomap、of_address_to_resource、of_get_address等函数的实现原理与使用陷阱。 - 地址映射调试工具：
/proc/iomem、devmem2、ftrace、kgdb在地址问题排查中的实战用法。 - 典型故障复现与修复：通过真实案例演示地址重叠、越界、单元计数错误等问题的定位与修复过程。
💡 学习建议： 准备一块开发板（如Raspberry Pi、i.MX6ULL或QEMU模拟的vexpress-a9），配合本课程动手验证每个案例。地址映射错误的最佳排查工具是“对照芯片手册逐字节核对”。