Arduino ESP32 SD卡读写实例

---

• Arduino官方文档参考：https://www.arduino.cc/en/Reference/SD

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() 获取卡的大小。

Serial.printf("SD.cardSize = %lld \r\n", SD.cardSize());//返回值是个64位数值

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()
{
}

• ESP32 Dev Module开发板编译信息

使用 1.0.5  版本的库 SD 在文件夹： C:\Users\Administrator\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.6\libraries\SD 
使用 1.0  版本的库 FS 在文件夹： C:\Users\Administrator\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.6\libraries\FS 
使用 1.0  版本的库 SPI 在文件夹： C:\Users\Administrator\AppData\Local\Arduino15\packages\esp32\hardware\esp32\1.0.6\libraries\SPI 
"C:\\Users\\Administrator\\AppData\\Local\\Arduino15\\packages\\esp32\\tools\\xtensa-esp32-elf-gcc\\1.22.0-97-gc752ad5-5.2.0/bin/xtensa-esp32-elf-size" -A "d:\\arduino\\MyHexDir/SD.ino.elf"
项目使用了 245306 字节，占用了 (18%) 程序存储空间。最大为 1310720 字节。
全局变量使用了13576字节，(4%)的动态内存，余留314104字节局部变量。最大为327680字节。