# 使用 UFS 参数配置设备

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

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

有关 Dragonwing IQ-9075，请参阅 `<workspace_root_path>/boot_images/boot/Setting/soc/LeMans/Core/Storage/UFS/ufs.dtsi`。

下表列出了 UEFI 中 UFS 设备树节点的示例。

| 设备树节点/键 | 子节点 | 设备树值 | 说明 |
| --- | --- | --- | --- |
| `init_speed_params` | `EnableHighSpeed` | 1 | 启用高速模式 |
| `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 = Rate A</p></li><br><li><p>2 = Rate B</p></li><br></ul> |
| `perf_speed_params` | `EnableHighSpeed` | 1 | 在 perf 模式下启用高速模式 |
| `perf_speed_params` | `NumGears` | 4 | 指定在 perf 模式下使用的最大档位 |
| `perf_speed_params` | `NumLanes` | 2 | 在 perf 模式下 UFS 设备使用的通道数 |
| `perf_speed_params` | `Rate` | 2 | 在 perf 模式下的序列<br>- 1 = Rate A<br>- 2 = Rate B |
| `timeout_values` | `fDeviceInitTimeoutUs` | 2500000 | 表示设备初始化期间的超时 (µs) |
| `timeout_values` | `UTRDPollTimeoutUs` | 30000000 | 表示 UTRD 的超时 (μs) |
| `BatteryThresholdMv` | – | 3600 | 切换到 Gear1 的电池阈值（单位 mV） |
| `LinkStartupRetryCount` | – | 5 | 链路启动的重试计数 |
| `FUA_Value` | – | 1 | 强制单位访问 |
| `EnableLogging` | – | 0 | 在加载程序中启用 DT 串行调试日志<br>- 1 - 启用<br>- 0 - 禁用 |
| `RefClock` | – | 19200000 | UFS 设备控制器参考时钟 19.2 MHz |
| `MphyInitTable` | – | – | 表示 `MphyInit` 表 |
| `MphyInitEndTable` | – | – | 表示 `MphyInitEnd` 表 |
| `MphyLaneInitTable` | – | – | 表示 `Mphy` 2 通道初始化表 |
|  |  |  |  |
|  |  |  |  |
|  |  |  |  |

将 `.dtsi` 中的所有更改编译到 `xbl_config.elf`，并将镜像重新刷入设备。

Qualcomm^®^ 会针对 UFS 设备 PHY 初始化调整 `MphyInitTable`、`MphyInitEndTable` 和 `MphyLaneInitTable` 配置的值。对于调试和调整任何 PHY 层问题，应仅在 Qualcomm 的指导下更改这些配置值。

默认值适用于符合 UFS 设备 3.1 标准的部件。对于符合 UFS 设备 2.x 标准的部件，`NumGears` 值应为 3。请勿更改 UFS 设备 2.x 部件的其他参数。

# 使用 SD 卡参数配置设备

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

以下是 UEFI 中 SD 卡设备树节点的示例。

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

Last Published: Nov 02, 2025

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

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