# 启动设备树

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

Linux 编译机器上用于启动 DT 的文件路径是 `/boot_images/boot/Settings/Soc/<chipset>/Core/Boot/sw_boot.dtsi.`

| 属性名称 | 属性描述 | 数据类型 | 可能的值/取值范围 | 设备行为 |
| --- | --- | --- | --- | --- |
| `vibration` | 在 XBL 出口处打开/关闭振动 | UINT32 | <ul class="simple"><br><li><p>0x00</p></li><br><li><p>0x01</p></li><br></ul> | <ul class="simple"><br><li><p>ENABLE (0x01)：打开振动。0x01 是默认设置。</p></li><br><li><p>禁用 (0x00)：关闭振动。</p></li><br></ul> |
| `forced_download.feature` | <ul class="simple"><br><li><p>在 XBL 阶段启用或禁用强制紧急下载模式 (EDL) 功能。</p></li><br><li><p>使用 USB 缆线和组合键（同时按下 POWER (PWR)、VOL+ 和 VOL- 键）来刷写镜像。</p></li><br></ul> | UINT32 | 0x00 | 强制 EDL 功能 (FEDL) DISABLE (0x00)：FEDL 已禁用。 |
| `forced_download.feature` | <ul class="simple"><br><li><p>在 XBL 阶段启用或禁用强制紧急下载模式 (EDL) 功能。</p></li><br><li><p>使用 USB 缆线和组合键（同时按下 POWER (PWR)、VOL+ 和 VOL- 键）来刷写镜像。</p></li><br></ul> | UINT32 | 0x01 | ENABLE (0x01)：在 XBL 中启用用户启动的 EDL。 |
| `forced_download.check_usb_option` | 请选择 USB 缆线选项，以便进入 FEDL 模式。 | UINT32 | 0x00 | CHECK\_USB\_D\_PLUS\_GROUND (0x00)：当使用将 D+ 线接地的专用 USB 缆线为设备供电时，设备会进入 EDL 模式。这是默认设置。 |
| `forced_download.check_usb_option` | 请选择 USB 缆线选项，以便进入 FEDL 模式。 | UINT32 | 0x01 | CHECK\_USB\_D\_PLUS\_HIGH\_WITH\_TIMEOUT (0x01)：在启动期间将设备连接到 USB + 地线。如果在启动超时时间内断开连接，设备将被迫进入 EDL 模式。 |
| `forced_download.check_usb_option` | 请选择 USB 缆线选项，以便进入 FEDL 模式。 | UINT32 | 0x02 | <ul class="simple"><br><li><p>超时由 <code class="docutils literal notranslate"><span class="pre">forced_download.check_dp_timeout</span></code> DT 属性提供，以毫秒 (ms) 为单位</p></li><br><li><p>CHECK_USB_REGULAR_CABLE (0x02)：使用普通 USB 线启动时，设备会强制进入 EDL 模式</p></li><br></ul> |
|  |  |  |  |  |
|  |  |  |  |  |

## UEFI

> 
> 
> 在 UEFI 环境中，设备路径协议定义如何连接和识别设备，节点是该协议的一部分。Linux 编译机器上的 UEFI 文件路径为 `/boot_ images/boot/Settings/Soc/Core/Uefi/cfg/ueficfg.dtsi`。
> 
> 
> 下表列出了 UEFI 设备路径节点的主要类型以及属性名称。

表：UEFI 设备路径节点与属性

| DT 属性名称 | 数据类型 | 可能的值/取值范围 | 说明 |
| --- | --- | --- | --- |
| OsConfigTableSelection | UINT32 | 范围从 0x1 到 0x2，具体取决于虚拟机管理程序。 | 您可以指定要使用的 Hypervisor。值如下：<br><br><br><br>> <br>> <br>> <ul class="simple"><br>> <li><p>0x1 - BOOT_TYPE_LINUX - Gunyah<sup>TM</sup> Hypervisor 软件</p></li><br>> <li><p>0x2 - BOOT_TYPE_LINUX_WITH_KVM</p></li><br>> </ul> |
| QcCapsuleRootCert | UINT8 列表 | 具有 OpenSSL 生成的证书内容。 | 您使用根证书进行 capsule 身份验证。该节点包含完整的根证书内容，用于对 capsule 进行身份验证。该节点还用于固件更新。 |

Last Published: May 13, 2025

[Previous Topic
平台信息](https://docs.qualcomm.com/bundle/publicresource/80-70018-4SC/topics/platform.md) [Next Topic
PMIC](https://docs.qualcomm.com/bundle/publicresource/80-70018-4SC/topics/pmic-developer-touchpoints.md)

Source: [https://docs.qualcomm.com/doc/80-70018-4SC/topic/boot-developer-touchpoints.html](https://docs.qualcomm.com/doc/80-70018-4SC/topic/boot-developer-touchpoints.html)