2. 设备树编译与反编译

设备树源文件（.dts）是人类可读的文本描述，而内核引导时实际使用的是二进制格式的设备树二进制文件（.dtb）。dtc（Device Tree Compiler）是完成这一转换的核心工具。本章将系统讲解 dtc 的编译、反编译与内容查看操作，帮助你在调试 V4L2 驱动时快速定位设备树配置问题。

2.1 dtc 工具概述

dtc 是设备树编译器的标准实现，通常集成在 Linux 内核源码的 scripts/dtc/ 目录下，也可通过系统包管理器单独安装。其核心功能包括：

• 编译（dts → dtb）：将文本格式的 .dts 文件转换为二进制 .dtb 文件。
• 反编译（dtb → dts）：将二进制 .dtb 还原为可读的 .dts 文本。
• 内容查看：以人类可读格式输出 dtb 的节点树结构。
• 语法检查：验证 dts 文件的语法正确性。

2.2 编译 dts 为 dtb

编译操作将设备树源文件转换为内核可识别的二进制格式。以下是一个针对 V4L2 摄像头节点的编译示例：

# 基本编译命令
dtc -I dts -O dtb -o imx8mm-camera.dtb imx8mm-camera.dts

# 启用空间优化（去除调试符号）
dtc -I dts -O dtb -o imx8mm-camera.dtb -@ imx8mm-camera.dts

# 指定输出文件路径
dtc -I dts -O dtb -o /boot/dtbs/imx8mm-camera.dtb imx8mm-camera.dts

参数说明：

• -I dts：指定输入格式为 dts 文本。
• -O dtb：指定输出格式为 dtb 二进制。
• -o：指定输出文件名。
• -@：生成符号节点，用于设备树叠加层（overlay）。

2.3 反编译 dtb 为 dts

反编译用于从现有 dtb 文件中提取可读的设备树描述，是调试和逆向分析的重要技能。例如，当从目标板中提取出 imx8mm-evk.dtb 后，可以反编译查看其完整配置：

# 基本反编译命令
dtc -I dtb -O dts -o imx8mm-evk-decompiled.dts imx8mm-evk.dtb

# 直接输出到终端（不保存文件）
dtc -I dtb -O dts imx8mm-evk.dtb

# 保留原始地址标签
dtc -I dtb -O dts -o output.dts -@ input.dtb

反编译后的 dts 文件会包含所有节点、属性和值，但注释和宏定义会被展开为具体数值。这对于验证编译过程是否丢失了关键配置非常有用。

2.4 查看 dtb 内容

除了完整的反编译，dtc 还支持以多种格式查看 dtb 内容，便于快速浏览节点结构：

# 以 dts 格式输出到终端（最常用）
dtc -I dtb -O dts imx8mm-evk.dtb

# 以二进制 hex 格式查看原始数据
dtc -I dtb -O dtb imx8mm-evk.dtb | xxd | head -20

# 使用 fdtdump 工具查看结构摘要
fdtdump imx8mm-evk.dtb

fdtdump 是 dtc 工具包中的另一个实用程序，它以紧凑格式输出设备树的节点路径和属性值，适合快速浏览：

// fdtdump 输出示例（部分）
/dts-v1/;

/ {
    compatible = "fsl,imx8mm-evk";
    #address-cells = <0x2>;
    #size-cells = <0x2>;

    cpus {
        #address-cells = <0x1>;
        #size-cells = <0x0>;
        cpu@0 {
            compatible = "arm,cortex-a53";
            reg = <0x0>;
        };
    };

    i2c@30a20000 {
        compatible = "fsl,imx8mm-i2c", "snps,designware-i2c";
        reg = <0x0 0x30a20000 0x0 0x10000>;
        #address-cells = <0x1>;
        #size-cells = <0x0>;
        clock-frequency = <0x61a80>;

        camera@3c {
            compatible = "ovti,ov5640";
            reg = <0x3c>;
            clocks = &clk_cam;
            pinctrl-names = "default";
            pinctrl-0 = &pinctrl_camera;
        };
    };
};

2.5 设备树编译与反编译流程

下图展示了从 dts 源文件到 dtb 二进制，再到反编译验证的完整工作流：

2.6 实战：编译与反编译 V4L2 摄像头设备树

以下是一个完整的实战流程，演示如何为 OV5640 摄像头节点编译设备树，并通过反编译验证配置：

1. 准备 dts 源文件：创建 ov5640-camera.dts，包含摄像头节点和必要的 pinctrl 配置。
2. 编译为 dtb：dtc -I dts -O dtb -o ov5640-camera.dtb ov5640-camera.dts
3. 反编译验证：dtc -I dtb -O dts ov5640-camera.dtb，检查输出中是否包含 compatible = "ovti,ov5640"、reg = <0x3c>、clocks 和 pinctrl-0 属性。
4. 对比差异：使用 diff 命令比较原始 dts 与反编译后的 dts，确认没有属性丢失。

# 步骤1：创建源文件（示例片段）
cat > ov5640-camera.dts << EOF
/dts-v1/;

/ {
    compatible = "custom,board";
    #address-cells = <1>;
    #size-cells = <1>;

    i2c@300a0000 {
        compatible = "snps,designware-i2c";
        reg = <0x300a0000 0x10000>;
        #address-cells = <1>;
        #size-cells = <0>;

        camera@3c {
            compatible = "ovti,ov5640";
            reg = <0x3c>;
            clocks = <&clk_cam>;
            clock-names = "xclk";
            pinctrl-names = "default";
            pinctrl-0 = <&pinctrl_camera>;
            DOVDD-supply = <&reg_camera_dovdd>;
            AVDD-supply = <&reg_camera_avdd>;
            DVDD-supply = <&reg_camera_dvdd>;
        };
    };
};
EOF

# 步骤2：编译
dtc -I dts -O dtb -o ov5640-camera.dtb ov5640-camera.dts

# 步骤3：反编译并检查
dtc -I dtb -O dts ov5640-camera.dtb | grep -E "compatible|reg|clocks|pinctrl"

compatible = "ovti,ov5640";
reg = <0x3c>;
clocks = <0x00000001>;    /* 引用被展开为 phandle 值 */
clock-names = "xclk";
pinctrl-names = "default";
pinctrl-0 = <0x00000002>; /* 引用被展开为 phandle 值 */

2.7 常见问题与避坑指南

2.8 小结