> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.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` | 指定每个方向可用的通道数量。取值为 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` | 每个方向可用的通道数量；取值为 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`。