> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 启动接口概述

DT 节点提供对启动接口和属性的访问。DT 提供描述系统硬件信息的数据结构。镜像执行环境（包括 XBL 和 UEFI 等固件）会读取此信息。您可以修改与启动相关的 DT 属性，以定制各种设备软件功能。

有关使用 QDTE 工具修改接口以及使用 QDTE 工具更改预构建 Devicetree blob（DTB）中 DT 属性的信息，请参阅[配置 QDTE](./qdte)。

有关 DT 的更多信息，请参阅 [https://github.com/devicetree-org](https://github.com/devicetree-org)。

## **XBL 配置与 UEFI DTB 文件**

`xbl_config.elf` 在所有平台上都承载 XBL 配置 DT 节点。它是否同时承载 UEFI DT 节点，或者这些节点是否位于单独的 UEFI DTB 文件中，取决于具体平台。

<Frame caption="**表：各平台的 XBL 配置与 UEFI DTB 文件**" />

| 平台                         | XBL 配置文件                        | UEFI DTB 文件                  | 基于 KVM 的启动文件         | 基于 Gunyah 的启动文件  |
| -------------------------- | ------------------------------- | ---------------------------- | -------------------- | ---------------- |
| Shikra                     | `xbl_config.elf`（仅 XBL 节点）      | `uefi_dtbs.elf`（UEFI 节点）     | `uefi_dtbs_kvm.elf`  | `uefi_dtbs.elf`  |
| Hamoa/IQ-X7181             | `xbl_config.elf`（仅 XBL 节点）      | `uefi_dtbs.xz`（UEFI 节点，压缩格式） | `uefi_dtbs_kvm.xz`   | `uefi_dtbs.xz`   |
| Purwa/IQ-X5121             | `xbl_config.elf`（仅 XBL 节点）      | `uefi_dtbs.xz`（UEFI 节点，压缩格式） | `uefi_dtbs_kvm.xz`   | `uefi_dtbs.xz`   |
| IQ10/Nord                  | `xbl_config.elf`（仅 XBL 节点）      | `uefi_dtbs.elf`（UEFI 节点）     | `uefi_dtbs_kvm.elf`  | `uefi_dtbs.elf`  |
| QCS6490/Kodiak/RB3Gen2     | `xbl_config.elf`（XBL 和 UEFI 节点） | –                            | `xbl_config_kvm.elf` | `xbl_config.elf` |
| QCS5430/Kodiak/RB3Gen2Lite | `xbl_config.elf`（XBL 和 UEFI 节点） | –                            | `xbl_config_kvm.elf` | `xbl_config.elf` |
| IQ9/IQ-9075/Lemans         | `xbl_config.elf`（XBL 和 UEFI 节点） | –                            | `xbl_config_kvm.elf` | `xbl_config.elf` |
| IQ8/IQ-8275/Monaco         | `xbl_config.elf`（XBL 和 UEFI 节点） | –                            | `xbl_config_kvm.elf` | `xbl_config.elf` |
| IQ6/IQ615/Talos            | `xbl_config.elf`（XBL 和 UEFI 节点） | –                            | `xbl_config_kvm.elf` | `xbl_config.elf` |

<Note>
  对于 Shikra 和 IQ10/Nord，`xbl_config.elf` 仅包含 XBL 专用 DT 节点，而 UEFI 专用 DT 节点位于单独的 `uefi_dtbs.elf`（或 `uefi_dtbs_kvm.elf`）文件中。启动流程取决于刷写的是哪个文件：刷写 `uefi_dtbs.elf` 会以基于 Gunyah 的方式启动，刷写 `uefi_dtbs_kvm.elf` 会以基于 KVM 的方式启动。

  对于 Hamoa/IQ-X7181 和 Purwa/IQ-X5121，`xbl_config.elf` 仅包含 XBL 专用 DT 节点，而 UEFI 专用 DT 节点位于单独的压缩文件 `uefi_dtbs.xz`（或 `uefi_dtbs_kvm.xz`）中——在这些平台上仅使用压缩的 `.xz` 文件。启动流程取决于刷写的是哪个文件：刷写 `uefi_dtbs.xz` 会以基于 Gunyah 的方式启动，刷写 `uefi_dtbs_kvm.xz` 会以基于 KVM 的方式启动。

  对于 QCS6490/Kodiak/RB3Gen2、QCS5430/Kodiak/RB3Gen2Lite、IQ9/IQ-9075/Lemans、IQ8/IQ-8275/Monaco 和 IQ6/IQ615/Talos，`xbl_config.elf` 包含 XBL 和 UEFI 两者的 DT 节点。启动流程取决于刷写的是哪个文件：刷写 `xbl_config.elf` 会以基于 Gunyah 的方式启动，刷写 `xbl_config_kvm.elf` 会以基于 KVM 的方式启动。
</Note>

[平台信息](./platform-information)

平台信息 devicetree 提供有关 CDT 的信息，其中包含平台信息版本、平台类型、主要硬件版本、次要硬件版本、子类型和 OEM-id。

[启动 devicetree 属性](./devicetree-boot-properties)

启动 devicetree 属性提供有关如何在 XBL 中启用和禁用用户发起的紧急下载（EDL）的信息。启动 DT 属性还描述了 EDL 超时以及可强制系统进入 EDL 模式的 USB 线缆选项。与启动相关的功能使用启动 DT 属性进行配置。

[电源管理集成电路（PMIC）](./power-management-integrated-circuit-pmic)

电源管理集成电路（PMIC）是一种专用电子组件，用于管理设备内的各种电源需求。

[通用输入/输出（GPIO）功能](./gpio-functions-top-level-mode-multiplexer-tlmm)

硬件通过顶层模式复用器（TLMM）控制通用输入/输出（GPIO）和备用功能的复用。您可以在启动过程中使用 TLMM 的 DT 属性配置 GPIO。

[总线](./buses)

总线促进各种系统组件之间的数据传输。DT 属性允许配置 Qualcomm Universal Peripheral（QUP）v3 串行接口设备节点。

[存储](./storage)

用于存储配置的 DT 属性。

[USB](./usb-devicetree-properties)

USB 的 DT 属性允许您调整 USB 信号质量。

## **后续步骤**

[设置开发环境](./set-up-your-development-environment)