从DWS到DTBO：揭秘MTK平台设备树构建的完整工具链

1. MTK平台设备树构建的演进之路

记得我第一次接触MTK平台的硬件配置时，DWS（Driver Wizard Setting）工具简直是我的救星。这个图形化界面让GPIO配置变得像搭积木一样简单，点点鼠标就能完成引脚功能定义、上下拉设置等操作。但随着内核版本升级到3.x之后，设备树（Device Tree）逐渐成为主流，MTK也不得不跟上技术潮流。

有趣的是，MTK并没有完全抛弃DWS，而是创造性地保留了这套工具链。在实际项目中，我发现工程师们仍然习惯用DWS配置硬件，然后通过自动化工具转换成DTSI文件。这种过渡方案既照顾了老用户的习惯，又兼容了新内核的要求。现在MTK平台的典型工作流是这样的：硬件工程师用DWS完成配置 -> 自动生成DTSI -> 与主DTS合并编译 -> 最终生成DTB/DTBO镜像。

2. DWS到DTSI的魔法转换

2.1 DWS文件的双重身份

在MT6752平台上，你会遇到两个DWS文件：

• 内核路径下的drivers/misc/mediatek/dws/mt6752/mt6752_64.dws
• Vendor路径下的vendor/mediatek/proprietary/custom/mt6752_64/kernel/dct/dct/codegen.dws

经过多次项目验证，我发现内核路径下的DWS才是真正被使用的配置文件。这个文件包含了完整的硬件寄存器定义，比如某个GPIO引脚是用于I2C功能还是作为普通GPIO使用，都能在这里直观配置。

2.2 drvgen工具的转换奥秘

转换过程的核心是drvgen.mk这个Makefile脚本。它主要做三件事：

1. 解析DWS文件中的硬件配置
2. 提取项目特定的配置参数
3. 生成符合设备树语法的DTSI文件

关键代码段解析：

$(python) $(DRVGEN_TOOL) $$dws_path $$prj_path $$prj_path cust_dtsi

这条命令调用Python编写的drvgen工具，将.dws文件转换为.cust_dtsi文件。我曾在调试时加上-v参数查看详细输出，发现它会逐行解析DWS中的硬件寄存器定义，然后映射为设备树的节点属性。

生成的DTSI文件最终出现在：obj/KERNEL_OBJ/arch/arm64/boot/dts/mt6752_64/cust_dtsi这个文件会被主DTS通过#include指令引用，完成硬件配置的最终集成。

3. DTBO镜像的生成全流程

3.1 dtboimg.cfg的配置艺术

MTK使用一个配置文件来管理多个DTBO模块，这个文件就是dtboimg.cfg。它的生成逻辑很有意思：

define mk_dtboimg_cfg echo $(1) >>$(2);\ echo " id=$(my_dtbo_id)" >>$(2);\ $(eval my_dtbo_id:=$(shell echo $$(($(my_dtbo_id)+1)))) endef

每个DTBO模块都会被分配一个自增的ID，这个设计让我在调试多设备树场景时受益匪浅。实际生成的cfg文件内容类似：

mt6752_64.dtbo id=0 mt6765_camera.dtbo id=1

3.2 mkdtimg的打包魔法

真正的打包工作由mkdtimg工具完成，这个来自AOSP的工具被MTK深度定制过。关键打包命令：

mkdtimg cfg_create dtbo.img dtboimg.cfg

我在某次项目中发现，如果DTBO文件超过8个，需要修改dtbo.mk中的MAX_DTBO_NUM参数。打包过程会验证每个DTBO的兼容性，确保不会出现设备树重叠的情况。

4. DTB与DTBO的协同工作机制

4.1 主DTB的生成路径

MTK平台有个特殊设计：最终生成的DTB文件会被重命名为mtk.dtb。这个文件实际上是由多个DTB合并而成：

DTB_NAMES := $(subst $\",,$(CONFIG_BUILD_ARM64_APPENDED_DTB_IMAGE_NAMES)) DTB_LIST := $(addsuffix .dtb,$(DTB_NAMES)) $(obj)/mtk.dtb: $(DTB_OBJS) $(call if_changed,cat)

这个cat操作很有意思，它直接把多个DTB文件拼接在一起。我在调试时发现，MTK的bootloader会按照固定偏移量来解析这个合并后的DTB。

4.2 设备树的选择策略

内核配置中定义了两个关键参数：

CONFIG_BUILD_ARM64_APPENDED_DTB_IMAGE_NAMES="mediatek/mt6752" CONFIG_BUILD_ARM64_DTB_OVERLAY_IMAGE_NAMES="mediatek/mt6752_64"

这意味着：

• mt6752.dts用于生成基础DTB
• mt6752_64.dts用于生成DTBO

在实际项目中，我经常需要根据不同的硬件版本调整这两个配置。比如对于带NFC功能的变种机型，就需要额外加载一个nfc_overlay.dtbo。

5. 实战中的问题排查技巧

5.1 常见错误与解决方案

问题1：DWS修改后未生效

• 检查cust_dtsi文件的更新时间
• 确认主DTS正确包含了生成的DTSI
• 运行make drvgen强制重新生成

问题2：DTBO加载失败

• 使用mkdtimg dump dtbo.img查看镜像内容
• 检查内核日志中的of_fdt相关错误
• 确认bootloader版本支持DTBO功能

5.2 调试工具推荐

1. fdtdump：直接查看DTB文件内容

   fdtdump mtk.dtb | less

2. dtc工具链：

   dtc -I dtb -O dts -o decompiled.dts mtk.dtb

3. 内核配置：

   CONFIG_OF_DEBUG=y CONFIG_OF_OVERLAY=y

6. 性能优化实践

在最近的一个项目中，我们发现DTB加载时间过长。通过分析发现是设备树节点过多导致的。优化方案包括：

1. 将不常用的外设移到DTBO中动态加载
2. 使用/delete-node/移除未使用的硬件配置
3. 启用内核的CONFIG_OF_FLATTREE优化选项

经过这些调整，启动时间减少了约300ms。这个案例让我深刻体会到，设备树不仅是硬件描述文件，更是系统性能调优的重要抓手。