Arduino+ESP32 之 SD卡读写

背景知识:

ESP32有两种使用SD卡的方法,一种是使用SPI接口访问SD卡,另一种是使用SDMMC接口访问SD卡 。

Arduino core for the ESP32中SPI方式占用4个IO口,SDMMC方式占用6个IO口,一般来说SDMMC方式速度要比SPI方式快。

 

1. SDMMC方式

ESP32虽然有两组SDMMC接口,但Arduino core for the ESP32中只用到了其中一组,IO口连接为:DAT2 - IO12DAT3 - IO13CMD - IO15CLK - IO14DAT0 - IO2DAT1 - IO4

bool begin(const char * mountpoint="/sdcard", bool mode1bit=false)
挂载存储卡,输入参数分别为挂载点、是否使用一线模式;

void end()
取消挂载;

sdcard_type_t cardType()   返回存储卡类型,0、1、2、3、4,分别如下:
CARD_NONE          未连接存储卡;
CARD_MMC            mmc卡;
CARD_SD                sd卡,最大2G;
CARD_SDHC           sdhc卡,最大32G;
CARD_UNKNOWN  未知存储卡;

uint64_t cardSize()      返回存储卡大小字节数;
uint64_t totalBytes()    返回文件系统总字节数;
uint64_t usedBytes()   返回文件系统已用字节数;

 

2. SPI方式

bool begin(uint8_t ssPin=SS, SPIClass &spi=SPI, uint32_t frequency=4000000, const char * mountpoint="/sd", uint8_t max_files=5)
挂载存储卡,输入参数分别为SS引脚号、SPI对象、时钟频率、挂载点、文件最大同时打开数;
默认IO口连接为:CS - IO5、DI - IO23、SCLK - IO18、DO - IO19;
void end()
取消挂载;
sdcard_type_t cardType()    返回存储卡类型,0、1、2、3、4,分别如下:
CARD_NONE         未连接存储卡;
CARD_MMC           mmc卡;
CARD_SD               sd卡,最大2G;
CARD_SDHC          sdhc卡,最大32G;
CARD_UNKNOWN  未知存储卡;
uint64_t cardSize()      返回存储卡大小字节数;
uint64_t totalBytes()     返回文件系统总字节数;
uint64_t usedBytes();   返回文件系统已用字节数

 

3. 我的实验

我手头的ESP32_CAM板子的原理图

Arduino+ESP32 之 SD卡读写

右图可知,我的SD卡接到了ESP32的GPIO12 13 14 15 2 4 这6个脚上,根据前述,这符合SDMMC方式的IO连接。所以,我在软件上需要使用SDMMC方式来驱动SD卡。

 

新建arduino项目文件,复制黏贴如下代码,即可以SDMMC方式驱动SD卡

//引用相关库
//#include "FS.h"
#include "SD_MMC.h"

// 接口连接如下:
// SD卡 - ESP32
// ------------
// DAT2 - IO12
// DAT3 - IO13
// CMD  - IO15
// CLK  - IO14
// DAT0 - IO2
// DAT1 - IO4

void setup()
{
  Serial.begin(115200);
  Serial.println();

  //挂载文件系统
  if (!SD_MMC.begin())
  {
    Serial.println("存储卡挂载失败");
    return;
  }
  uint8_t cardType = SD_MMC.cardType();

  if (cardType == CARD_NONE)
  {
    Serial.println("未连接存储卡");
    return;
  }
  else if (cardType == CARD_MMC)
  {
    Serial.println("挂载了MMC卡");
  }
  else if (cardType == CARD_SD)
  {
    Serial.println("挂载了SDSC卡");
  }
  else if (cardType == CARD_SDHC)
  {
    Serial.println("挂载了SDHC卡");
  }
  else
  {
    Serial.println("挂载了未知存储卡");
  }

  //打开/建立 并写入数据
  File file = SD_MMC.open("/test.txt", FILE_WRITE);
  if (file)
  {
    Serial.println("打开/建立 根目录下 test.txt 文件!");
  }

  char data[] = "hello world\r\n";
  file.write((uint8_t *)data, strlen(data));
  file.close();

  //重命名文件
  if (SD_MMC.rename("/test.txt", "/retest.txt"))
  {
    Serial.println("test.txt 重命名为 retest.txt !");
  }

  //读取文件数据
  file = SD_MMC.open("/retest.txt", FILE_READ);
  if (file)
  {
    Serial.print("文件内容是:");
    while (file.available())
    {
      Serial.print((char)file.read());
    }
  }

  //打印存储卡信息
  Serial.printf("存储卡总大小是: %lluMB \n", SD_MMC.cardSize() / (1024 * 1024)); // "/ (1024 * 1024)"可以换成">> 20"
  Serial.printf("文件系统总大小是: %lluB \n", SD_MMC.totalBytes());
  Serial.printf("文件系统已用大小是: %lluB \n", SD_MMC.usedBytes());
}

void loop()
{
}

 

4. 实验效果

Arduino+ESP32 之 SD卡读写

 

5.补充,如果不追求读写SD卡的速率,那么可以SPI方式来进行SD卡的读写,那么这样就可以省下ESP32宝贵的2个GPIO作其他用途。

其实,这些例程在我们安装好Arduino的ESP32支持包以后,我们电脑本地已经有了,参考下面的路径可以找到这些例程。

Arduino+ESP32 之 SD卡读写

 

 

 

.

上一篇:【3DS】必做清单


下一篇:k210 C语言开发-4 从sd卡读取播放烟花视频