mirror
/
esp-idf
kopia lustrzana https://github.com/espressif/esp-idf
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
esp-idf/docs/zh_CN/api-reference/storage/sdmmc.rst

120 wiersze
5.9 KiB
ReStructuredText
Czysty Zwykły widok Historia

Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
SD/SDIO/MMC 驱动程序
=========================
:link_to_translation:`en:[English]`
概述
--------
SD/SDIO/MMC 驱动是一种基于 SDMMC 和 SD SPI 主机驱动的协议级驱动程序，目前已支持 SD 存储器、SDIO 卡和 eMMC 芯片。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
SDMMC 主机驱动和 SD SPI 主机驱动（:component_file:`driver/include/driver/sdmmc_host.h` 和 :component_file:`driver/include/driver/sdspi_host.h`）为以下功能提供 API：
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
- 发送命令至从设备
- 接收和发送数据
- 处理总线错误
初始化函数及配置函数：
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
.. list::
docs: Resolve doxygen & Sphinx warnings
2020-01-28 22:31:14 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
:SOC_SDMMC_HOST_SUPPORTED: - 如需初始化和配置 SDMMC 主机，请参阅 :doc:`SDMMC 主机 API <../peripherals/sdmmc_host>`
- 如需初始化和配置 SD SPI 主机，请参阅 :doc:`SD SPI 主机 API <../peripherals/sdspi_host>`
docs: Resolve doxygen & Sphinx warnings
2020-01-28 22:31:14 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
.. only:: SOC_SDMMC_HOST_SUPPORTED
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
本文档中所述的 SDMMC 协议层仅处理 SD 协议相关事项，例如卡初始化和数据传输命令。
协议层通过 :cpp:class:`sdmmc_host_t` 结构体和主机协同工作，该结构体包含指向主机各类函数的指针。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
应用示例
-------------------
ESP-IDF :example:`storage/sd_card` 目录下提供了 SDMMC 驱动与 FatFs 库组合使用的示例，演示了先初始化卡，然后使用 POSIX 和 C 库 API 向卡读写数据。请参考示例目录下 README.md 文件，查看更多详细信息。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
.. only:: SOC_SDMMC_HOST_SUPPORTED
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
协议层 API
------------------
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
协议层具备 :cpp:class:`sdmmc_host_t` 结构体，此结构体描述了 SD/MMC 主机驱动，列出了其功能，并提供指向驱动程序函数的指针。协议层将卡信息储存于 :cpp:class:`sdmmc_card_t` 结构体中。向 SD/MMC 主机发送命令时，协议层使用 :cpp:class:`sdmmc_command_t` 结构体来描述命令、参数、预期返回值和需传输的数据（如有）。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
用于 SD 存储卡的 API
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
1. 初始化主机，请调用主机驱动函数，例如 :cpp:func:`sdmmc_host_init` 和 :cpp:func:`sdmmc_host_init_slot`；
2. 初始化卡，请调用 :cpp:func:`sdmmc_card_init`，并将参数 ``host`` （主机驱动信息）和参数 ``card`` （指向 :cpp:class:`sdmmc_card_t` 结构体的指针）传递给此函数。函数运行结束后，将会向 :cpp:class:`sdmmc_card_t` 结构体填充该卡的信息；
3. 读取或写入卡的扇区，请分别调用 :cpp:func:`sdmmc_read_sectors` 和 :cpp:func:`sdmmc_write_sectors`，并将参数 ``card`` （指向卡信息结构的指针）传递给函数；
4. 如果不再使用该卡，请调用主机驱动函数，例如 :cpp:func:`sdmmc_host_deinit`，以禁用主机外设，并释放驱动程序分配的资源。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
用于 eMMC 芯片的 API
^^^^^^^^^^^^^^^^^^^^^^^^^
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
从协议层的角度而言，eMMC 存储芯片与 SD 存储卡相同。尽管 eMMC 是芯片，不具备卡的外形，但由于协议相似 (`sdmmc_card_t`, `sdmmc_card_init`)，用于 SD 卡的一些概念同样适用于 eMMC 芯片。注意，eMMC 芯片不可通过 SPI 使用，因此它与 SD API 主机驱动不兼容。
如需初始化 eMMC 内存并执行读/写操作，请参照上一章节 SD 卡操作步骤。
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
用于 SDIO 卡的 API
^^^^^^^^^^^^^^^^^^^^^^^^^
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
SDIO 卡初始化和检测过程与 SD 存储卡相同，唯一的区别是 SDIO 模式下数据传输命令不同。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
在卡初始化和卡检测（通过运行 :cpp:func:`sdmmc_card_init`）期间，驱动仅配置 IO 卡如下寄存器：
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
1. I/O 中止 (0x06) 寄存器：在该寄存器中设置 RES 位可重置卡的 IO 部分；
2. 总线接口控制 (0x07) 寄存器：如果主机和插槽配置中启用 4 线模式，则驱动程序会尝试在该寄存器中设置总线宽度字段。如果字段设置成功，则从机支持 4 线模式，主机也切换至 4 线模式；
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
3. 高速（0x13）寄存器：如果主机配置中启用高速模式，则该寄存器的 SHS 位会被设置。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
注意，驱动程序不会在 (1) I/O 使能寄存器和 Int 使能寄存器，及 (2) I/O 块大小中，设置任何位。应用程序可通过调用 :cpp:func:`sdmmc_io_write_byte` 来设置相关位。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
如需卡配置或传输数据，请根据您的具体情况选择下表中的函数：
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
.. list-table::
:widths: 55 25 20
:header-rows: 1
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
* - 操作
- 函数读取
- 函数写入
* - 使用 IO_RW_DIRECT (CMD52) 读写单个字节。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
- :cpp:func:`sdmmc_io_read_byte`
- :cpp:func:`sdmmc_io_write_byte`
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
* - 使用 IO_RW_EXTENDED (CMD53) 的字节模式读写多个字节。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
- :cpp:func:`sdmmc_io_read_bytes`
- :cpp:func:`sdmmc_io_write_bytes`
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
* - 块模式下，使用 IO_RW_EXTENDED (CMD53) 读写数据块。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
- :cpp:func:`sdmmc_io_read_blocks`
- :cpp:func:`sdmmc_io_write_blocks`
docs: remove front page C3 docs not updated warning
2021-05-06 00:39:11 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
使用 :cpp:func:`sdmmc_io_enable_int` 函数，应用程序可启用 SDIO 中断。在单线模式下使用 SDIO 时，还需要连接 D1 线来启用 SDIO 中断。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
如果您需要应用程序保持等待直至发生 SDIO 中断，请使用 :cpp:func:`sdmmc_io_wait_int` 函数。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
.. only:: esp32
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs:update CN transalation for get-started section and sdmmc
2021-12-10 08:26:01 +00:00
如果您需要与 ESP32 的 SDIO 从设备通信，请使用 ESSL 组件（ESP 串行从设备链接）。请参阅 :doc:`/api-reference/protocols/esp_serial_slave_link` 和 :example:`peripherals/sdio/host`。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
复合卡（存储 + IO）
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
^^^^^^^^^^^^^^^^^^^^^^^^^
docs: remove front page C3 docs not updated warning
2021-05-06 00:39:11 +00:00
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
该驱动程序不支持 SD 复合卡，复合卡会被视为 IO 卡。
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
线程安全
^^^^^^^^^^^^^
多数应用程序仅需在一个任务中使用协议层。因此，协议层在 :cpp:class:`sdmmc_card_t` 结构体或在访问 SDMMC 或 SD SPI 主机驱动程序时不使用任何类型的锁。这种锁通常在较高层级实现，例如文件系统驱动程序。
docs:update CN translation for API reference storage(fatfs and index)
2021-09-03 08:06:02 +00:00
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
API 参考
-------------
docs: add new top-level docs builder that builds docs for a single chip
2019-11-13 03:46:16 +00:00
.. include-build-file:: inc/sdmmc_cmd.inc
Add Chinese transaltion to sdmmc in storage folder The translation should be first reviewed by technical reviewer Xiao Xufeng and then by Carrie The translation for the other documents in storage folder can be found in MR5613, MR5620 and MR5737.
2019-09-18 05:28:16 +00:00
docs: Resolve doxygen & Sphinx warnings
2020-01-28 22:31:14 +00:00
.. include-build-file:: inc/sdmmc_types.inc