DTBO/DTO 介绍

首先描述一下DTS/DTC/DTB/DTBO/DTO 之间的关系：
DTS 是用于描述 FDT(设备树) 的文件；
DTS 经过 DTC 编译后可生成 DTB/DTBO；
DTB 和 DTBO 通过 DTO 操作可合并成一个新的 DTB；
通常情况下很多用户习惯把“DTO“这个词的动作含义用“DTBO“来替代，下文中我们避开这个概念混用，明确：DTO 是一个动词概念，代表的是操作；DTBO 是一个名词概念，指的是用于叠加的次 dtb。

原理介绍：

DTO(Devcie Tree Overlay) 是 Android P 后引入且必须强制启用的功能，可让次设备树 Blob（DTBO） 叠加在已有的主设备树 Blob 上。DTO 可以维护系统芯片 SoC 设备树，并动态叠加针对特定设备的设备树，从而向树中添加节点并对现有树中的属性进行更改。
主设备树 Blob（*.dtb）一般由 Vendor 厂商提供，次设备树 Blob（*.dtbo）可由 ODM/OEM 等厂商提供，最后通过 bootloader 合并后再传递给 kernel。如下图：

需要注意：DTO 操作使用的 DTB 和 DTBO 的编译跟普通的 DTB 编译有区别，语法上有特殊区别：
使用 dtc 编译.dts 时，必须添加选项-@以在生成的.dtbo 中添加_symbols_节点。_symbols_节点包含带标签的所有节点的列表，DTO 库可使用这个列表作为参考。如下示例：

1. 编译主.dts 的示例命令：
dtc -@ -O dtb -o my_main_dt.dtb my_main_dt.dts
2. 编译叠加层 DT  .dts 的示例命令：
dtc -@ -O dtb -o my_overlay_dt.dtbo my_overlay_dt.dts

uboot 中 DTO 启用：

1. 配置使能：

CONFIG_CMD_DTIMG=y
CONFIG_OF_LIBFDT_OVERLAY=y

2. board_select_fdt_index()函数的实现。这是一个__weak 函数，用户可以根据实际情况重新实现它。函数作用是在多份 DTBO 中获取用于执行 DTO 操作的那份 DTBO（返回 index 索引，最小从 0 开始），默认的 weak 函数返回的 index 为 0。

/*
* Default return index 0.
*/
__weak int board_select_fdt_index(ulong dt_table_hdr)
{
/*
* User can use "dt_for_each_entry(entry, hdr, idx)" to iterate
* over all dt entry of DT image and pick up which they want.
*
* Example:
* struct dt_table_entry *entry;
* int index;
*
* dt_for_each_entry(entry, dt_table_hdr, index) {
*
* .... (use entry)
* }
*
* return index;
*/
return 0;
}

DTO 结果

1. DTO 执行完成后，在 U-Boot 的开机信息中可以看到结果：

// 成功时的打印
ANDROID: fdt overlay OK
// 失败时的打印
ANDROID: fdt overlay failed, ret=-19

通常引起失败的原因一般都是因为主/次设备书 blob 的内容存在不兼容引起，所以用户需要对它们的生成语法和兼容性要比较清楚。

2. DTO 执行成功后在给 kernel 的 cmdline 里追加如下信息，表明当前使用哪份 DTBO 进行 DTO 操作：

androidboot.dtbo_idx=1 // idx从0开始，这里表示选取idx=1的那份DTBO进行DTO操作

3. DTO 执行成功后可以在U-Boot命令行使用 fdt 命令查看DTB内容，确认改动是否生效