> ## 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.

# 启动

## **XBL**

启动 devicetree 属性说明了如何在 XBL 中启用和禁用用户发起的紧急下载（EDL）。您可以使用详细的 EDL 超时以及可强制系统进入 EDL 模式的 USB 线缆选项。您可以使用这些属性配置与启动相关的功能。

Linux 构建计算机上的启动 DT 文件路径为 `/boot_images/boot/Settings/Soc/<chipset>/Core/Boot/sw_boot.dtsi`。

<Frame caption="**表：启动 DT 属性**" />

| 属性名称                               | 属性说明                                                                                                      | 数据类型   | 可能的值/取值范围              | 设备行为                                                                                                                                 |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------- | ------ | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `vibration`                        | 在 XBL 退出时打开或关闭振动。                                                                                         | UINT32 | • `0x00`<br />• `0x01` | • **ENABLE (0x01)**：打开振动。`0x01` 为默认设置。<br />• **DISABLE (0x00)**：关闭振动。                                                               |
| `forced_download.feature`          | 在 XBL 阶段启用或禁用强制紧急下载模式（EDL）功能。<br /><br />使用 USB 线缆并配合组合键刷写镜像（同时按下 **POWER (PWR)**、**VOL+** 和 **VOL‑** 键）。 | UINT32 | `0x00`                 | **强制 EDL 功能（FEDL）DISABLE (0x00)**：FEDL 被禁用。                                                                                          |
| `forced_download.feature`          | 在 XBL 阶段启用或禁用强制紧急下载模式（EDL）功能。<br /><br />使用 USB 线缆并配合组合键刷写镜像（同时按下 **POWER (PWR)**、**VOL+** 和 **VOL‑** 键）。 | UINT32 | `0x01`                 | **ENABLE (0x01)**：在 XBL 中启用用户发起的 EDL。                                                                                                |
| `forced_download.check_usb_option` | 要进入 FEDL 模式，请选择 USB 线缆选项。                                                                                 | UINT32 | `0x00`                 | **CHECK\_USB\_D\_PLUS\_GROUND (0x00)**：使用将 D+ 线接地的特殊 USB 线缆通电时，设备进入 EDL 模式。这是默认设置。                                                   |
| `forced_download.check_usb_option` | 要进入 FEDL 模式，请选择 USB 线缆选项。                                                                                 | UINT32 | `0x01`                 | **CHECK\_USB\_D\_PLUS\_HIGH\_WITH\_TIMEOUT (0x01)**：在启动期间将设备连接到 USB + 接地。如果在启动超时时间内移除连接，设备将被强制进入 EDL 模式。                             |
| `forced_download.check_usb_option` | 要进入 FEDL 模式，请选择 USB 线缆选项。                                                                                 | UINT32 | `0x02`                 | • 超时由 `forced_download.check_dp_timeout` DT 属性以毫秒（ms）为单位提供。<br />• **CHECK\_USB\_REGULAR\_CABLE (0x02)**：使用普通 USB 线缆启动时，设备被强制进入 EDL。 |

## **UEFI**

在 UEFI 环境中，设备路径协议定义了如何连接和识别设备，节点是该协议的一部分。Linux 构建计算机上的 UEFI 文件路径为 `/boot_images/boot/Settings/Soc/Core/Uefi/cfg/ueficfg.dtsi`。

下表列出了 UEFI 设备路径节点的主要类型和属性名称。

<Frame caption="**表：UEFI 设备路径节点和属性**" />

| 属性名称                     | 属性说明                                                                                                                                                          | 数据类型       | 可能的值/取值范围                     | 设备行为                                         |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ----------------------------- | -------------------------------------------- |
| `OsConfigTableSelection` | 选择要启动的 hypervisor。取值如下：<br /> <ul><li>0x1 - BOOT\_TYPE\_LINUX - Gunyah <sup>TM</sup> Hypervisor Software</li><li>0x2 - BOOT\_TYPE\_LINUX\_WITH\_KVM</li></ul> | UINT32     | 范围为 0x1 至 0x2，取决于 hypervisor。 | 根据所选值选择 hypervisor。                          |
| `QcCapsuleRootCert`      | 用于胶囊（capsule）验证的根证书。此节点包含完整的根证书内容。                                                                                                                            | UINT8 list | 包含 OpenSSL 生成的证书内容。           | 用于胶囊验证的证书                                    |
| `BootFromNvme`           | 启用从 NVMe 介质启动。                                                                                                                                                | UINT32     | 0x1 表示已启用从 NVMe 介质启动          | 设置为 0x1 时，EDK II 将枚举 NVMe 介质，并在存在时从其启动 Linux |

<Note>
  这些 UEFI DT 属性（包括 `OsConfigTableSelection`）还用于为平台选择默认 hypervisor（Gunyah 或 KVM）。承载这些 UEFI DT 节点的二进制文件——`xbl_config.elf`/`xbl_config_kvm.elf` 或 `uefi_dtbs.elf`/`uefi_dtbs_kvm.elf`——取决于具体平台。有关完整的平台明细，请参阅[启动接口概述](./boot-interfaces-overview)。
</Note>
