4. 设备树覆盖(Overlay)：概念、语法、编译与动态加载

设备树覆盖（Device Tree Overlay，简称 DTO）是嵌入式 Linux 中实现硬件功能动态组合与热插拔的关键机制。它允许在不重新编译主设备树（Base DTB）的前提下，通过加载一个或多个叠加片段（Overlay DTB）来修改、添加或禁用设备节点。这一特性在 FPGA 动态重配置、扩展板热插拔、模块化 SoC 设计中尤为重要。

4.1 设备树覆盖的概念与工作原理

设备树覆盖的本质是“片段（Fragment）”的合并。每个 Overlay 由一个或多个 fragment@N 节点组成，每个片段包含一个 target（指向主 DTB 中的目标节点）和一个 __overlay__ 子节点（包含要合并的属性或子节点）。内核在加载 Overlay 时，解析这些片段，将 __overlay__ 中的内容合并到 target 指定的节点下。

4.2 Overlay 语法与 DTS 编写规范

Overlay 的 DTS 文件使用 /dts-v1/; 和 /plugin/; 作为文件头，以标识这是一个可叠加的片段。核心语法要素如下：

4.2.1 完整 Overlay DTS 示例

// temperature-sensor.dts
/dts-v1/;
/plugin/;

/ {
    fragment@0 {
        target = &i2c0;
        __overlay__ {
            #address-cells = <1>;
            #size-cells = <0>;
            temperature@48 {
                compatible = "ti,tmp102";
                reg = <0x48>;
                status = "okay";
            };
        };
    };

    fragment@1 {
        target = &gpio;
        __overlay__ {
            alert_pin {
                gpios = <&gpio 17 0>;
                interrupt-parent = <&gpio>;
                interrupts = <17 2>;
            };
        };
    };
};

4.3 编译方法：从 DTS 到 DTO

设备树覆盖的编译使用与主 DTB 相同的 dtc 工具，但需要额外指定 -@ 选项以生成符号表。编译流程如下：

1. 编写 Overlay DTS：遵循 /plugin/ 和 fragment 语法。
2. 编译为 DTO：dtc -@ -I dts -O dtb -o temperature-sensor.dtbo temperature-sensor.dts
3. 验证输出：使用 fdtdump temperature-sensor.dtbo 查看结构。
4. 反编译检查：dtc -I dtb -O dts temperature-sensor.dtbo 确认片段正确。

4.4 动态加载与卸载

Linux 内核从 4.4 版本开始，通过 configfs 提供标准的 Overlay 动态管理接口。加载路径为 /sys/kernel/config/device-tree/overlays。操作步骤如下：

4.4.1 动态加载流程

1. 挂载 configfs（如未自动挂载）：mount -t configfs configfs /sys/kernel/config
2. 创建 Overlay 目录：mkdir /sys/kernel/config/device-tree/overlays/my-overlay
3. 写入 DTB 数据：cat temperature-sensor.dtbo > /sys/kernel/config/device-tree/overlays/my-overlay/dtbo
4. 检查状态：cat /sys/kernel/config/device-tree/overlays/my-overlay/status 应返回 applied。
5. 验证设备：ls /sys/bus/i2c/devices/ 或 dmesg | tail 查看新设备枚举。

4.4.2 动态卸载流程

1. 移除 Overlay 目录：rmdir /sys/kernel/config/device-tree/overlays/my-overlay
2. 内核自动处理：内核会撤销合并，移除对应设备节点，并触发驱动移除回调。
3. 验证卸载：ls /sys/bus/i2c/devices/ 确认设备已消失。

4.5 调试与故障排查

当 Overlay 加载失败时，可以从以下角度排查：

4.6 实践案例：Raspberry Pi 扩展板 Overlay

以 Raspberry Pi 上加载一个 I2C 温度传感器为例，展示完整操作链：

# 1. 编写 Overlay DTS (tmp102-overlay.dts)
/dts-v1/;
/plugin/;

/ {
    compatible = "brcm,bcm2835";

    fragment@0 {
        target = &i2c1;
        __overlay__ {
            #address-cells = <1>;
            #size-cells = <0>;
            status = "okay";
            tmp102@48 {
                compatible = "ti,tmp102";
                reg = <0x48>;
            };
        };
    };
};

# 2. 编译
dtc -@ -I dts -O dtb -o tmp102.dtbo tmp102-overlay.dts

# 3. 加载
sudo mkdir -p /sys/kernel/config/device-tree/overlays/tmp102
sudo cat tmp102.dtbo > /sys/kernel/config/device-tree/overlays/tmp102/dtbo

# 4. 验证
cat /sys/kernel/config/device-tree/overlays/tmp102/status
# 输出: applied
i2cdetect -y 1
# 应看到 0x48 地址

# 5. 卸载
sudo rmdir /sys/kernel/config/device-tree/overlays/tmp102