这是最新(主)开发分支的文档。如果您正在查找以前版本的文档，使用左侧的下拉菜单选择所需的版本。

SDIO Host

简介

SDIO Host 模块包括 SDH SDMMC 和 SDH SPI

  • SDIO Host: 是一种用于嵌入式系统和计算机的接口，它允许设备通过 Secure Digital Input Output (SDIO) 接口与各种类型的 Secure Digital (SD) 卡进行通信

  • SDH SDMMC: 主要用于读写 SD 卡，包括传统的 SD 卡、SDHC (Secure Digital High Capacity) 卡

  • SDH SPI: SDIO 接口的 SPI 模式，允许设备通过 SPI (Serial Peripheral Interface) 协议与 SPI 设备进行通信，主要用于驱动那些只需要单向通信的设备，例如 TFT (Thin Film Transistor) 显示屏

功能列表

  • SDH SDMMC 存储卡读取写入

  • SDH SPI 同步传输数据

  • SDH SPI 异步传输数据

功能概述

SDH SDMMC 存储卡读写：

  • 支持传统的 SD 卡和 SDHC 卡，实现了对这些存储介质的高效读写操作

  • 允许用户访问和存储大量数据，包括文本、图像、音频和视频文件

  • 配合 FatFS 等文件系统进行使用

SDH SPI 同步传输数据：

  • 通过 SDIO 接口的 SPI 模式同步传输数据

  • 主要用于传输少量数，比如驱动 TFT 屏的 CMD 传输

SDH SPI 异步传输数据：

  • 通过 SDIO 接口的 SPI 模式异步传输数据

  • 主要用于传输大量数，比如驱动 TFT 屏的大量显示数据传输

硬件配置

通过修改 DT 进行配置。

主要功能

SDH SDMMC 设备数据读取写入

起始条件:

  • SDH SDMMC 初始化

相关时序API:

  • 调用 wm_drv_sdh_sdmmc_init 对 SDH SDMMC 模块初始化

  • 调用 wm_drv_sdh_sdmmc_read_blocks 从 SDH SDMMC 设备读取数据块

  • 根据 wm_drv_sdh_sdmmc_write_blocks 向 SDH SDMMC 设备写入数据块

结果:

  • 成功返回 return WM_ERR_SUCCESS ,失败返回对应错误码

SDH SPI 设备数据传输接收数据

起始条件:

  • 配置 SPI 模块

  • SDH SPI 初始化

相关时序API:

  • 调用 wm_drv_sdh_sdspi_init 对 SDH SPI 模块初始化

  • 调用 wm_drv_sdh_sdspi_transceive_sync 通过 SDH SPI 设备同步传输和接收数据

  • 根据 wm_drv_sdh_sdspi_transceive_async 通过 SDH SPI 设备异步传输和接收数据

结果:

  • 成功返回 return WM_ERR_SUCCESS ,失败返回对应错误码

注意事项

  • SDH SDMMC 存储卡读写，单块数据长度为 512 bytes

  • SDH SPI 异步传输数据，传入数据需 4 字节对齐

应用实例

API参考

API参考