4. 设备树在Linux内核中的角色：内核启动流程中设备树的传递、OF API简介

设备树（Device Tree）在Linux内核中扮演着“硬件描述语言”与“平台配置契约”的双重角色。它从引导加载程序（Bootloader）传递到内核，贯穿整个启动流程，最终被OF（Open Firmware）子系统解析为内核可用的资源列表。理解这一角色，是进行设备树调试的前提。

4.1 设备树在内核启动流程中的传递路径

设备树的传递并非简单的内存拷贝，而是一个经过校验、解压、映射和解析的严格流程。以下表格总结了从引导加载程序到内核完成解析的关键阶段：

下面这张SVG流程图展示了设备树从Bootloader到内核驱动绑定的完整传递路径：

4.2 OF API 简介：内核操作设备树的接口

OF（Open Firmware）API 是内核提供给驱动开发者操作设备树的标准接口。它分为三个层次：节点查找、属性读取、资源转换。掌握这些API是编写设备树感知驱动的核心。

4.2.1 核心数据结构

内核使用两个主要结构体表示设备树：

// 表示一个设备节点
struct device_node {
    const char *name;           // 节点名称，如 "uart@fe000000"
    const char *type;           // device_type 属性值
    phandle phandle;            // 节点的phandle
    const char *full_name;      // 完整路径，如 "/soc/uart@fe000000"
    struct property *properties;// 属性链表
    struct device_node *parent; // 父节点
    struct device_node *child;  // 子节点
    struct device_node *sibling;// 兄弟节点
};

// 表示一个属性
struct property {
    char *name;                 // 属性名，如 "compatible"
    int length;                 // 属性值长度（字节）
    void *value;                // 属性值指针
    struct property *next;      // 下一个属性
};

4.2.2 常用OF API分类

4.2.3 OF API调用关系图

下面的SVG图展示了一个典型驱动如何通过OF API从设备树节点获取资源：

4.3 设备树解析的早期调试方法

当内核在设备树解析阶段出现问题时，常规的printk可能尚未生效。此时可以使用以下方法进行调试：

• 早期printk（early_printk）：在 setup_arch() 之前启用，可以输出 early_init_dt_scan() 的执行状态。
• dtb反编译对比：使用 dtc -I dtb -O dts boot.dtb 将传递的dtb反编译为dts，与源码dts对比，确认Bootloader是否修改了节点。
• ftrace function_graph：在支持早期ftrace的平台上，可以追踪 unflatten_device_tree() 的子函数调用序列。
• CONFIG_OF_UNITTEST：内核内置的设备树单元测试框架，可以在启动时验证设备树解析的正确性。

4.4 本章小结