mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
docs: Update the CN translation with the label missing
This commit is contained in:
parent
39a1e17c32
commit
f0ef081d0a
@ -76,7 +76,7 @@ Overview
|
||||
- :c:macro:`SDMMC_HOST_SLOT_1` is routed via GPIO Matrix. This means that any GPIO may be used for each of the SD card signals. It is for non UHS-I usage.
|
||||
- :c:macro:`SDMMC_HOST_SLOT_0` is dedicated to UHS-I mode, which is not yet supported in the driver.
|
||||
|
||||
On {IDF_TARGET_NAME}, SDMMC host requires an external power supply for the IO voltage. Please refer to :ref:'pwr-ctrl' for details.
|
||||
On {IDF_TARGET_NAME}, SDMMC host requires an external power supply for the IO voltage. Please refer to :ref:`pwr-ctrl` for details.
|
||||
|
||||
Supported Speed Modes
|
||||
---------------------
|
||||
@ -173,8 +173,8 @@ To configure the bus width, set the ``width`` field of :cpp:class:`sdmmc_slot_co
|
||||
|
||||
If the design does require higher speed SD modes (which only work at 1.8V IO levels), there are two options available:
|
||||
|
||||
- Use the on-chip programmable LDO. In this case, connect the desired LDO output channel to VDDPST_5 (SD_VREF) pin. Call :cpp:func:'sd_pwr_ctrl_new_on_chip_ldo' to initialize the SD power control driver, then set :cpp:class:'sdmmc_host_t::pwr_ctrl_handle' to the resulting handle.
|
||||
- Use an external programmable LDO. Likewise, connect the LDO output to the VDDPST_5 (SD_VREF) pin. Then implement a custom `sd_pwr_ctrl` driver to control your LDO. Finally, assign :cpp:class:'sdmmc_host_t::pwr_ctrl_handle' to the handle of your driver instance.
|
||||
- Use the on-chip programmable LDO. In this case, connect the desired LDO output channel to VDDPST_5 (SD_VREF) pin. Call :cpp:func:`sd_pwr_ctrl_new_on_chip_ldo` to initialize the SD power control driver, then set :cpp:class:`sdmmc_host_t::pwr_ctrl_handle` to the resulting handle.
|
||||
- Use an external programmable LDO. Likewise, connect the LDO output to the VDDPST_5 (SD_VREF) pin. Then implement a custom `sd_pwr_ctrl` driver to control your LDO. Finally, assign :cpp:class:`sdmmc_host_t::pwr_ctrl_handle` to the handle of your driver instance.
|
||||
|
||||
|
||||
DDR Mode for eMMC Chips
|
||||
|
@ -73,10 +73,10 @@ SDMMC 主机驱动
|
||||
|
||||
.. only:: esp32p4
|
||||
|
||||
- 卡槽 :c:macro:`SDMMC_HOST_SLOT_1` 通过GPIO矩阵连接。这意味着任何GPIO都可以用于每个SD卡信号。它适用于非UHS-I用途。
|
||||
- 卡槽 :c:macro:`SDMMC_HOST_SLOT_0` 专用于UHS-I模式,驱动程序中尚不支持该模式。
|
||||
- 卡槽 :c:macro:`SDMMC_HOST_SLOT_1` 通过 GPIO 交换矩阵路由,即任何 GPIO 都可以用于每个 SD 卡信号。这适用于非 UHS-I 用途。
|
||||
- 卡槽 :c:macro:`SDMMC_HOST_SLOT_0` 专用于 UHS-I 模式,驱动程序中尚不支持该模式。
|
||||
|
||||
目前SDMMC主机需要为IO电平提供外部电压参考。如果您自行购买ESP32P4芯片并计划使用SDMMC外设,请参阅 :ref:'wr-ctrl' 。
|
||||
在 {IDF_TARGET_NAME} 上,SDMMC 主机需要外部电源为 IO 电压供电。详情请参阅 :ref:`pwr-ctrl`。
|
||||
|
||||
支持的速率模式
|
||||
---------------------
|
||||
@ -123,7 +123,7 @@ SDMMC 主机驱动支持以下速率模式:
|
||||
|
||||
如需选择标准速率以外的特定频率,请根据所使用的 SD 接口(SDMMC 或 SDSPI)确定适当频率范围,并选择其中的任意值。然而,实际的时钟频率会由底层驱动程序计算,可能与你所需的值不同。
|
||||
|
||||
使用 SDMMC 接口时,``max_freq_khz`` 即频率上限,因此最终的频率值应始终低于该上限。而使用 SDSPI 接口时,驱动程序会提供最接近的适配频率,因此该值可以大于、等于或小于 ``max_freq_khz``。
|
||||
使用 SDMMC 接口时,``max_freq_khz`` 即频率上限,因此最终的频率值应始终低于或等于该上限。而使用 SDSPI 接口时,驱动程序会提供最接近的适配频率,因此该值可以大于、等于或小于 ``max_freq_khz``。
|
||||
|
||||
请配置 :cpp:class:`sdmmc_slot_config_t` 的 ``width`` 字段,配置总线宽度。例如,配置 1 线模式的代码如下:
|
||||
|
||||
@ -166,13 +166,16 @@ SDMMC 主机驱动支持以下速率模式:
|
||||
|
||||
.. _pwr-ctrl:
|
||||
|
||||
配置供电和参考电压
|
||||
配置电压电平
|
||||
------------------
|
||||
|
||||
{IDF_TARGET_NAME} SDMMC主机需要为IO电平提供外部电压参考 ,以支持高速设备, 驱动器将动态配置电压参考。您可以使用片上可编程LDO作为从机电源和电压参考 ,也可以提供正确的外部电源。
|
||||
{IDF_TARGET_NAME} SDMMC 主机需要通过 VDDPST_5 (SD_VREF) 管脚从外部提供 IO 电压。如果设计不需要更高速度的 SD 模式,则将此管脚连接到 3.3 V 供电即可。
|
||||
|
||||
如果设计需要更高速度的 SD 模式(仅在 1.8 V IO 电平下工作),则有两种可选方案:
|
||||
|
||||
- 使用片上可编程 LDO。将所需的 LDO 输出通道连接到 VDDPST_5 (SD_VREF) 管脚上,并调用 :cpp:func:`sd_pwr_ctrl_new_on_chip_ldo` 来初始化 SD 电源控制驱动。最后,将 :cpp:class:`sdmmc_host_t::pwr_ctl_handle` 设置为生成句柄。
|
||||
- 使用外部可编程 LDO。同样,将 LDO 输出连接到 VDDPST_5 (SD_VREF) 管脚,并自定义 `sd_pwr_ctrl` 驱动程序来控制 LDO。最后,将 :cpp:class:`sdmmc_host_t::pwr_ctrl_handle` 分配给驱动程序实例句柄。
|
||||
|
||||
- 要使用片上LDO ,请确保 VDDPST_5(sd_vref) 引脚连接到所选的片上LD通道 ,并调用 :cpp:func:'sd_pwr_ctrl_new_on_chip_ldo' 分配所选的LDO通道 ,然后将 'pwr_ctr_handle' 传递给 :cpp:class:'sdmmc_host_t::pwr_ctl_handle' 。
|
||||
- 要使用外部电源,请确保 VDDPST_5(sd_vref) 引脚已连接,然后按照 :cpp:class:'sd_pwr_ctrl_drv_t' 构造外部电源控制结构体,并将其传递给 :cpp:class:'sdmmc_host_t::pwr_ctr_handle'。
|
||||
|
||||
eMMC 芯片的 DDR 模式
|
||||
-----------------------
|
||||
|
@ -6,47 +6,28 @@ SD/SDIO/MMC 驱动程序
|
||||
概述
|
||||
--------
|
||||
|
||||
SD/SDIO/MMC 驱动是一种基于 SDMMC 和 SD SPI 主机驱动的协议级驱动程序,目前已支持 SD 存储器、SDIO 卡和 eMMC 芯片。
|
||||
SD/SDIO/MMC 驱动目前支持 SD 存储器、SDIO 卡和 eMMC 芯片。这是一个协议层驱动 (:component_file:`sdmmc/include/sdmmc_cmd.h`),可以由以下方式实现:
|
||||
|
||||
SDMMC 主机驱动和 SD SPI 主机驱动(:component_file:`esp_driver_sdmmc/include/driver/sdmmc_host.h` 和 :component_file:`esp_driver_sdspi/include/driver/sdspi_host.h`)为以下功能提供 API:
|
||||
.. list::
|
||||
:SOC_SDMMC_HOST_SUPPORTED: - SDMMC 主机驱动 (:component_file:`esp_driver_sdmmc/include/driver/sdmmc_host.h`),详情请参阅 :doc:`SDMMC Host API <../peripherals/sdmmc_host>`。
|
||||
:SOC_GPSPI_SUPPORTED: - SDSPI 主机驱动 (:component_file:`esp_driver_sdspi/include/driver/sdspi_host.h`),详情请参阅 :doc:`SD SPI Host API <../peripherals/sdspi_host>`。
|
||||
|
||||
协议层与主机层
|
||||
^^^^^^^^^^^^^^
|
||||
|
||||
本文中的 SDMMC 协议层能处理 SD 协议的具体细节,例如卡初始化流程和各种数据传输命令流程。该协议层通过 :cpp:class:`sdmmc_host_t` 结构体与主机通信。该结构体包含指向主机各种功能的指针。
|
||||
|
||||
主机驱动通过支持以下功能来实现协议驱动:
|
||||
|
||||
- 发送命令至从设备
|
||||
- 接收和发送数据
|
||||
- 处理总线错误
|
||||
|
||||
初始化函数及配置函数:
|
||||
.. blockdiag:: /../_static/diagrams/sd/sd_arch.diag
|
||||
:scale: 100%
|
||||
:caption: SD 主机端组件架构
|
||||
:align: center
|
||||
|
||||
.. list::
|
||||
|
||||
:SOC_SDMMC_HOST_SUPPORTED: - 如需初始化和配置 SDMMC 主机,请参阅 :doc:`SDMMC 主机 API <../peripherals/sdmmc_host>`
|
||||
:SOC_GPSPI_SUPPORTED: - 如需初始化和配置 SD SPI 主机,请参阅 :doc:`SD SPI 主机 API <../peripherals/sdspi_host>`
|
||||
|
||||
|
||||
.. only:: SOC_SDMMC_HOST_SUPPORTED
|
||||
|
||||
本文档中所述的 SDMMC 协议层仅处理 SD 协议相关事项,例如卡初始化和数据传输命令。
|
||||
|
||||
协议层通过 :cpp:class:`sdmmc_host_t` 结构体和主机协同工作,该结构体包含指向主机各类函数的指针。
|
||||
|
||||
管脚配置
|
||||
------------------
|
||||
|
||||
..only:: SOC_SDMMC_USE_IOMUX and not SOC_SDMMC_USE_GPIO_MATRIX
|
||||
|
||||
SDMMC 管脚为专用管脚,无需配置。
|
||||
|
||||
..only:: SOC_SDMMC_USE_GPIO_MATRIX and not SOC_SDMMC_USE_IOMUX
|
||||
|
||||
SDMMC 管脚信号通过 GPIO 交换矩阵配置,请在 :cpp:type:`sdmmc_slot_config_t` 中配置管脚。
|
||||
|
||||
..only:: esp32p4
|
||||
|
||||
SDMMC 有两个卡槽:
|
||||
|
||||
.. list::
|
||||
|
||||
- 卡槽 0 管脚为 UHS-I 模式专用,但驱动程序尚不支持此模式。
|
||||
- 卡槽 1 管脚可通过 GPIO 交换矩阵配置,用于 UHS-I 之外的情况。如要使用卡槽 1,请在 :cpp:type:`sdmmc_slot_config_t` 中配置管脚。
|
||||
|
||||
应用示例
|
||||
-------------------
|
||||
|
@ -929,6 +929,7 @@ flash 加密的高级功能
|
||||
:esp32c3: - ``DIS_PAD_JTAG`` 和 ``DIS_USB_JTAG`` 禁用 JTAG。
|
||||
:esp32s3: - ``HARD_DIS_JTAG`` 和 ``DIS_USB_JTAG`` 禁用 JTAG。
|
||||
- ``DIS_DIRECT_BOOT``(即之前的 ``DIS_LEGACY_SPI_BOOT``)禁用传统的 SPI 启动模式。
|
||||
:SOC_EFUSE_DIS_DOWNLOAD_MSPI: - ``DIS_DOWNLOAD_MSPI`` 在下载模式下禁用 MSPI 访问
|
||||
|
||||
为了能启用这些功能,可在首次启动前仅烧录部分 eFuse,并用未设置值 0 写保护其他部分。例如:
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user