玩转 ESP32 + Arduino (二十四) SD卡读写

一. 硬件连接

ESP32有两种使用SD卡的方法，一种是使用SPI接口访问SD卡，另一种是使用SDMMC接口访问SD卡。Arduino core for the ESP32中SPI方式占用4个IO口，SDMMC方式占用6个IO口，一般来说SDMMC方式速度要比SPI方式快。

1. SPI接线

根据引脚图, 我们很容易的接好SD卡模块的线, 默认IO口连接为：CS - IO5、DI - IO23、SCLK - IO18、DO - IO19；

二. SPI方式的函数

1. SD.begin() //挂载SD卡

bool begin(uint8_t ssPin=SS, SPIClass &spi=SPI, uint32_t frequency=4000000, const char * mountpoint="/sd", uint8_t max_files=5)

  if (!SD.begin())
  {
    Serial.print(".");
  }
  Serial.println("SD card Ready!");

2. SD.end() 取消SD卡挂载

void end()

3. SD.cardSize() 获取卡的大小

返回值是个64位数值

Serial.printf("SD.cardSize = %lld \r\n", SD.cardSize());

4. SD.cardType() 获取卡的类型

返回值:sdcard_type_t类型
该类型定义如下:

返回值	枚举值	说明
0	CARD_NONE	未连接存储卡；
1	CARD_MMC	mmc卡；
2	CARD_SD	sd卡，最大2G；
3	CARD_SDHC	sdhc卡，最大32G；
4	CARD_UNKNOWN	未知存储卡；

Serial.printf("SD.cardType = %d \r\n", SD.cardType());

5. SD.exists("/test.txt") 是否存在文件

6. SD.mkdir("/doc1"); 创建目录;

7. SD.rmdir("/doc1"); 删除目录

8. SD.remove("/test.txt"); 删除文件

9. SD.open 创建/打开文件

和之前的SPIFFS一样

File file = SD.open("/test.txt", FILE_WRITE);

10. SD.rename("/doc1","/doc"); 重命名

三. 示例

#include <Arduino.h>
#include "SD.h"

void setup()
{
  Serial.begin(115200);
  if (!SD.begin())
  {
    Serial.print(".");
  }
  Serial.println("SD card Ready!");
  Serial.printf("SD.cardSize = %lld \r\n", SD.cardSize());
  Serial.printf("SD.totalBytes = %lld \r\n", SD.totalBytes());
  Serial.printf("SD.usedBytes = %lld \r\n", SD.usedBytes());
  Serial.printf("SD.cardType = %d \r\n", SD.cardType());
  Serial.printf("is there /test.txt? :%d \r\n", SD.exists("/sd/doc1/test.txt"));
  Serial.println(SD.mkdir("/doc1"));
  Serial.printf("is there /doc1? :%d \r\n", SD.exists("/doc1"));
  Serial.printf("is there /test.txt? :%d \r\n", SD.exists("/test.txt"));
  File file = SD.open("/test.txt", FILE_WRITE);
  Serial.printf("is there /test.txt? :%d \r\n", SD.exists("/test.txt"));
  file.printf("hello!!!");
  file.close();
  file = SD.open("/test.txt", FILE_READ);
  Serial.println(file.readString());
  file.close();
  Serial.printf("is there /doc1/test1.txt? :%d \r\n", SD.exists("/doc1/test1.txt"));
  File file2 = SD.open("/doc1/test1.txt", FILE_WRITE);
  Serial.printf("is there /doc1/test1.txt? :%d \r\n", SD.exists("/doc1/test1.txt"));
  file2.printf("hello!!!");
  file2.close();
  file2 = SD.open("/test.txt", FILE_READ);
  Serial.println(file2.readString());
  file2.close();
  SD.end();
}

void loop()
{
}