compatible 字符串进行匹配,从 FIT 镜像中选择正确的 DTB。
DTS 和 DTSI 文件结构
设备树源文件位于内核源码树的arch/arm64/boot/dts/qcom/ 目录下。
表:设备树文件类型
板级与 SoC 分层
Qualcomm Linux 遵循严格的两层分层约定:-
SoC DTSI(例如
qcs6490.dtsi),定义时钟、电源域、中断控制器以及使用该 SoC 的所有单板通用的核心外设。 -
板级 DTS(例如
qcs6490-rb3gen2.dts),包含 SoC DTSI 并添加板级特定节点:GPIO 分配、稳压器数值、板载传感器和显示面板。
基于 FIT 的 DTB 打包
Qualcomm Linux 在单个软件发布版本中支持多个 SoC 和单板。DTB 被打包到一个 Flattened Image Tree(FIT)镜像(qclinux_fit.img)中,存储在 dtb_a 分区。UEFI 固件在启动时通过将硬件检测到的标识符与每个 FIT 配置条目的 compatible 字符串进行匹配来选择正确的 DTB。
FIT 镜像由 Image Tree Source(.its)文件描述,并使用 mkimage 构建。它包含两个顶层部分:
images,声明所有二进制数据块:DTB、DTBO 以及元数据二进制文件。configurations,声明所有平台配置,每个配置引用一个或多个镜像。
Qualcomm DTB 元数据
qcom-dtb-metadata 项目提供:qcom-metadata.dts编译为元数据 DTB,固件使用它将硬件标识符映射到 FIT 配置的compatible字符串。qcom-next-fitimage.its是用于独立构建的 ITS 模板。
compatible 字符串后缀标记(token)分组到以下节点中:
soc、soc-sku、socver、board、boardrev、board-subtype-*、softsku
和 oem。
启动时的 DTB 选择流程
- UEFI 从
dtb_a分区加载qclinux_fit.img。 - 解析嵌入的
qcom-metadata.dtb,构建一个将硬件数字 ID 映射到compatible字符串中使用的符号标记名称的表。 - 读取硬件标识符:SoC 芯片 ID/版本、来自配置数据表(CDT)的单板类型和修订版本、存储类型以及 DDR 容量。
- 按顺序遍历 FIT 配置(
conf-1、conf-2、…)。 - 对于每个配置,将其
compatible字符串中的每个标记与硬件推导出的值进行精确匹配。选择所有标记均匹配的第一个配置。 - 加载所选配置的 DTB,并通过 EFI 启动传递给操作系统。
- 如果没有配置匹配,则启动失败。诊断步骤请参阅 常见 DT 问题与修复。
Compatible 字符串格式
每个 FIT 配置的compatible 字符串以短横线分隔的标记编码平台标识:
configurations 块中,更具体的字符串应出现在通用字符串之前。
示例:
将 DTB 接入 FIT 镜像(Yocto)
Yocto 构建从两个输入生成 FIT 镜像:KERNEL_DEVICETREE和LINUX_QCOM_KERNEL_DEVICETREE表示要打包到images部分的 DTB 和 DTBO 列表。conf/machine/include/fit-dtb-compatible.inc中的FIT_DTB_COMPATIBLE条目枚举configurations部分的条目,这些条目将某个 DTB(或 DTB+DTBO 组合)映射到 UEFI 在启动时要匹配的硬件compatible字符串。
FIT_DTB_COMPATIBLE 条目
每个条目将一个 DTB 键(或以+ 作为分隔符的 DTB+DTBO 键)映射到一个或多个 compatible 字符串:
没有覆盖的单个 DTB:
configurations 块,其中每个 conf-N 条目携带对应的 compatible 字符串和 fdt 列表。
UEFI 按顺序遍历这些配置,并选择第一个匹配的配置。
在
configurations 块中,更具体的 compatible 字符串必须出现在通用字符串之前。FIT 按顺序评估配置;第一个匹配的配置生效。有关 compatible 字符串标记的参考,请参阅设备树架构。用于 KVM 的 EL2 设备树
文件名中带有el2 标记的设备树文件支持 Linux 在异常级别 2(EL2)运行以用于 KVM。构建系统将 el2 覆盖应用于平台 DTB,以生成 EL2 DTB 变体。目标平台默认启动进入 KVM 模式,少数尚未支持 KVM 的目标平台除外。请参阅发行说明了解平台能力。更多详情请参阅启用虚拟化。
Staging 设备树覆盖
文件名中带有staging 标记的设备树文件用于启用存在于内核源码中但尚未提交到上游的内核树内驱动程序。示例包括 SoC 级 TGU 节点(kodiak-staging.dtso、
lemans-staging.dtso、monaco-staging.dtso、talos-staging.dtso)以及用于开发套件的板级 staging 以太网 PHY 覆盖。当 VendorDtbOverlays EFI 变量设置为 staging 时,构建系统会应用这些覆盖:
当需要 staging 下游功能时,请使用 staging DTB。
CAMX 相机设备树覆盖
文件名中带有camx 标记的设备树文件将上游相机子系统(camss)替换为 Qualcomm® CAMX 专有相机框架。板级 CAMX 覆盖(例如
qcs6490-rb3gen2-vision-mezzanine-camx.dtso、lemans-evk-camx.dtso、
monaco-evk-camx.dtso)会禁用上游 camss 节点并启用 CAMX 节点。当同时需要 CAMX 和 KVM 时,会应用组合的 *-camx-el2.dtso 覆盖。当 VendorDtbOverlays EFI 变量设置为 camx 时,构建系统会应用 CAMX 覆盖:
仅在使用 Qualcomm 专有相机栈构建时才使用 CAMX DTB。在 CAMX 配置中,上游
camss 驱动程序已被禁用。