# Bootloader/UEFI 设备树

设备树指定了 UFS 主机配置参数，例如档位数、通道数、速率值、超时值等。

##  UFS 

设备树位于 `<workspace_root_path>\boot_images\boot\Settings\Soc\Kodiak\Core\Storage\UFS\ufs.dtsi`。

下面将介绍 UEFI 中的 UFS 设备树节点。

| 设备树节点/键 | 子节点 | 设备树值 | 备注 |
| --- | --- | --- | --- |
| `init_speed_params` | `EnableHighSpeed` | 1 | 启用 HS 模式 |
| `init_speed_params` | `NumGears` | 4 | 待使用的最大档位。 |
| `init_speed_params` | `NumLanes` | 2 | UFS 中使用的通道数 |
| `init_speed_params` | `Rate` | 2 | 其值如下：<br><br><ul class="simple"><br><li><p>1 = 速率 A</p></li><br><li><p>2 = 速率 B</p></li><br></ul> |
| `perf_speed_params` | `EnableHighSpeed` | 1 | 在 perf 模式下启用 HS 模式 |
| `perf_speed_params` | `NumGears` | 4 | 在 perf 模式下使用的最大档位。 |
| `perf_speed_params` | `NumLanes` | 2 | 在 perf 模式下 UFS 使用的通道数 |
| `perf_speed_params` | `Rate` | 2 | 在 perf 模式下的序列<br>- 1 = 速率 A<br>- 2 = 速率 B |
| `timeout_values` | `fDeviceInitTimeoutUs` | 2,500,000 | 设备初始化期间的超时 (µs) |
| `timeout_values` | `UTRDPollTimeoutUs` | 30,000,000 | UTRD 超时 (µs) |
| `BatteryThresholdMv` |  | 3,600 | 移至 1 档的电池阈值（单位为 mV） |
| `LinkStartupRetryCount` |  | 5 | 链路启动的重试计数 |
| `FUA_Value` |  | 1 | 强制单位访问 |
| `EnableLogging` |  | 0 | 在加载程序中启用 DT 串行调试日志<br>- 1 - 启用<br>- 0 - 禁用 |
| `RefClock` |  | 19,200,000 | UFS 控制器参考时钟 19.2 MHz |
| `MphyInitTable` |  |  | MphyInit 表 |
| `MphyInitEndTable` |  |  | MphyInitEnd 表 |
| `MphyLaneInitTable` |  |  | Mphy 2 通道初始化表 |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

任何在 `.dtsi` 中的更改都应编译成 `xbl_config.elf` 并将镜像重新刷写到设备上。

Note

`MphyInitTable`、 `MphyInitEndTable` 和 `MphyLaneInitTable` 均用于 UFS phy 初始化，且这些值由 Qualcomm 调整。对于任何 phy 层问题的调试/调整，这些值应在 Qualcomm 团队的指导下进行更改。

Note

默认值适用于 UFS 3.1 部分。对于 UFS 2.x 部分， `NumGears` 值应为 3。对于 UFS 2.x 部分，其他参数不需要更改。

##  SD 卡 

此设备树位于 `<workspace_root_path>\boot_images\boot\Settings\Soc\Kodiak\Core\Storage\SDCC\sdcc.dtsi`。
这指定了 SD 卡的参数，例如驱动强度、最大速度模式、HSR 设置等。

以下是 UEFI 中的 SD 卡设备树节点描述。

| 设备树节点/键 | 设备树值 | 备注 |
| --- | --- | --- |
| `DriveStrength` | 0x1FE4 | `DriveStrength` 按照建议，将 SDC CLK、CMD 和数据驱动强度分别设置为 7、4、4。 |
| `MaxSpeedMode` | `SDCC_SDR104_MODE` | 定义最大速度模式。对于 SD 卡，应为 `SDCC_SDR104_MODE`。 |

Last Published: Dec 10, 2024

[Previous Topic
电源管理状态](https://docs.qualcomm.com/bundle/publicresource/80-70015-6SC/topics/power-management-states.md) [Next Topic
Linux 内核设备树](https://docs.qualcomm.com/bundle/publicresource/80-70015-6SC/topics/linux-device-tree.md)

Source: [https://docs.qualcomm.com/doc/80-70015-6SC/topic/bootloader-uefi-device-tree.html](https://docs.qualcomm.com/doc/80-70015-6SC/topic/bootloader-uefi-device-tree.html)