> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.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 软件</li><li>0x2 - BOOT\_TYPE\_LINUX\_WITH\_KVM</li></ul> | UINT32     | 范围从 0x1 到 0x2，取决于 hypervisor。 | 根据所选值选择 hypervisor。                          |
| `QcCapsuleRootCert`      | 用于 capsule 验证的根证书。此节点包含完整的根证书内容。                                                                                                                        | UINT8 list | 包含 OpenSSL 生成的证书内容。           | 用于 Capsule 验证的证书                             |
| `BootFromNvme`           | 启用从 NVMe 介质启动。                                                                                                                                          | UINT32     | 0x1 表示已启用从 NVMe 介质启动          | 设置为 0x1 时，EDK II 将枚举 NVMe 介质，并在存在时从其启动 Linux |
