# 配置 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

这些参数仅供参考。请勿更改。

| 属性 | 说明 |
| --- | --- |
| `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` | 以与时钟属性相同的顺序存储的&lt;最小值 最大值&gt;工作频率数据组。 |
| `reset-gpios` | `phandle` 和 GPIO 说明符，表示连接的 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` | <ul class="simple"><br><li><p>表示通过名称（通过 reg 属性）传递给驱动程序的各种资源。</p></li><br><li><p>所需的 <code class="docutils literal notranslate"><span class="pre">reg-names</span></code> 是 <code class="docutils literal notranslate"><span class="pre">phy_mem</span></code>。</p></li><br></ul> |
| `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`。

# 配置 SDHCI（eMMC 和 SD 卡内置）Linux 内核设备树

SoC DTSI 节点指定寄存器地址空间、时钟、中断和复位信息。平台 DTSI 节点指定电源、电压和电流水平。`sdhc_2: mmc@8804000` 节点描述片上 SDHC 主机控制器通常位于 SoC DTSI 文件中。例如，`<workspace_root_path>/sources/kernel/kernel_platform/kernel/arch/arm64/boot/dts/qcom/sc7280.dtsi` 文件。

Note

这些参数仅供参考。不要修改它们。

| 属性 | 说明 |
| --- | --- |
| `Compatible` | 详细说明兼容的字符串，例如 `qcom,sc7280-sdhci`、`qcom,sdhci-msm-v5`。 |
| `Pinctrl-names` | 定义引脚控制状态的名称。 |
| `Pinctrl-0 &amp;1` | 指向引脚控制设置。这是一个定义多种状态的引脚控制设置的数组。 |
| `Interrupts` | SDHC IRQ 的中断映射。 |
| `Interrupt-names` | 列出在 `interrupts` 属性中定义的每个中断对应的名称。 |
| `reg` | SDHC 主机寄存器地址映射。 |
| `iommus` | `Iommus` 指定 IOMMU 节点和流 ID。 |
| `clock-names` | 时钟输入名称字符串列表。 |
| `clocks` | Phandle 和时钟说明符对列表。 |
| `interconnects` | 定义设备的互连路径。 |
| `interrupt-names` | 列出在 `interconnects` 属性中定义的每个互连路径的名称。 |
| `power-domains` | 指定 SDHC 使用的电源域。 |
| `bus-width` | 指定用于通信的数据线数量。 |
| `dma-coherent` | 指定 SDHCI 和 CPU 保持缓存一致性。 |
| `qcom,dll-config` | `DLL_CONFIG` reg 的平台特定设置。 |
| `resets` | 复位节点寄存器。 |
| `sdhc2_opp_table` | 该表定义了 SDHCI 支持的各种工作点。 |

Last Published: Nov 02, 2025

[Previous Topic
使用 SD 卡参数配置设备](https://docs.qualcomm.com/bundle/publicresource/80-70022-6SC/topics/bootloader-uefi-device-tree.md) [Next Topic
配置 UFS 设备](https://docs.qualcomm.com/bundle/publicresource/80-70022-6SC/topics/ufs-provisioning.md)