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

# 配置 UFS Linux 内核设备树

SoC DTSI 节点指定寄存器地址空间、时钟、中断和复位信息。平台 DTSI 节点指定电源、电压和电流级别。

描述片上 UFS 设备主机控制器的 `Ufs_mem_hc` 节点通常位于 SoC DTSI 文件中。例如，`<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sc7280.dtsi`。

对于 Dragonwing IQ-9075 中的 `Ufs_mem_hc` 节点，请参见 `<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sa8775p.dtsi`。

<Note>
  这些参数仅供参考。请勿更改。
</Note>

| 属性                    | 说明                                         |
| --------------------- | ------------------------------------------ |
| `Compatible`          | Qualcomm SoC 必须包含诸如 `qcom`、`ufshc` 之类的字符串。 |
| `Interrupts`          | UFS 主机控制器 IRQ 的中断映射。                       |
| `Reg`                 | UFS 主机寄存器地址映射。                             |
| `Phys`                | 指向 UFS 设备 PHY 节点的 `phandle`。               |
| `lanes-per-direction` | 指定每个方向可用的 lane 数量。取值为 1 或 2。               |
| `clock-names`         | 时钟输入名称字符串列表。                               |
| `Clocks`              | `phandle` 和时钟说明符对的列表。                      |
| `freq-table-hz`       | 由 \<最小值 最大值> 工作频率组成的数组，其存储顺序与 clocks 属性相同。 |
| `reset-gpios`         | 表示所连接 GPIO 的 `phandle` 和 GPIO 说明符。         |
| `Resets`              | 复位节点寄存器。                                   |

`Ufs_mem_phy` 节点描述片上 UFS 设备 PHY 硬件，通常位于 SoC DTSI 文件中。例如，`<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sc7280.dtsi` 文件。

| 属性                    | 说明                                                      |
| --------------------- | ------------------------------------------------------- |
| `Compatible`          | 指定兼容性字符串，例如 `qcom`、`qmp-ufs-phy`。                       |
| `#phy-cells`          | 将该属性设置为 0。                                              |
| `Reg`                 | 应包含 PHY 寄存器地址空间。                                        |
| `reg-names`           | 表示按名称（通过 reg 属性）传递给驱动的各种资源。必需的 `reg-names` 为 `phy_mem`。 |
| `lanes-per-direction` | 每个方向可用的 lane 数量；取值为 1 或 2。                              |
| `clock-names`         | 时钟输入名称字符串列表。                                            |
| `clocks`              | phandle 和时钟说明符对的列表。                                     |
| `vdda-phy-supply`     | 指向模拟域主 PHY 电源的 `phandle`。                               |
| `vdda-pll-supply`     | 指向 PHY PLL 和 Power-Gen 模块电源的 `phandle`。                 |
| `Resets`              | 指定 UFS 设备控制器中的 PHY 复位。                                  |

有关 DTS 参数的更多信息，请参见 `/kernel_platform/msm-kernel/Documentation/devicetree/bindings/ufs/qcom,ufs.yaml`。