DTBO/DTO 介绍

一叶知秋yyds

已于 2023-11-05 13:15:06 修改

阅读量2k

点赞数 2

CC 4.0 BY-SA版权

分类专栏： linux 文章标签： linux c语言 boosting 嵌入式硬件驱动开发

于 2023-11-05 13:13:21 首次发布

本文链接：https://blog.csdn.net/liu1250836704/article/details/134229008

linux 专栏收录该内容

90 篇文章

订阅专栏

本文介绍了AndroidP引入的DeviceTreeOverlay(DTO)功能，如何通过DTBO叠加在主设备树上，以及编译过程中的注意事项。重点讲述了DTO操作的原理、UBoot配置和常见错误原因。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

首先描述一下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;
}