ESP32 SD卡读写

ESP32 可以通过 SDMMC 和 SPI 两种方式读取SD/TF卡数据。
 【ESP32开发指南】  【Arduino开发指南】
开发板：NodeMCU32s（v1.3）
SD卡读写模块：SDIO/SPI 二合一
SD卡：闪迪 32GB（TF卡，实际29.7GB）/ Kingston 32G (TF卡，实际29.1GB)
开发框架：Arduino

Esp32 可以通过 SDMMC 和 SPI 两种方式读取SD/TF卡数据。
SDMMC 分为 1 位 SD 总线模式和 4 位 SD 总线模式
Esp32 上有 4 组 SPI 外设，其中，控制器 SPI2 和 SPI3 分别使用带前缀 HSPI 和 VSPI 的信号总线。
注意：
1.在程序下载前，需要断开 SD 卡供电，否则会出现报错。 【VSPI 除外】
2.SD 卡在复位或重启前（按下Esp32的复位键）断开 SD 卡供电，在程序进入 setup 函数后恢复供电（因此需要在 setup 函数中加入适当延时），否则 Esp32 会无限重启。 【4 位 SD 总线模式、HSPI 会发生】
下载程序到 Esp32 时未断开 SD 卡供电，出现报错信息：Timed out waiting for packet header


一、4 位 SD 总线模式

硬件连线方式：
-----------------------------------------------
|  NodeMCU32s            |   SD Card          |
|  --------------------------------------------
|  GPIO12                |   D02              |
|  GPIO4                 |   D01              |
|  GPIO15                |   CMD(MOSI)        |
|  GPIO2                 |   D00(MISO)        |
|  GPIO14                |   CLK(SCK)         |
|  GPIO13                |   D03(SS)          |
|  GND                   |   GND              |
|  VCC(3.3v)             |   VCC              |
----------------------------------------------- 
#include "FS.h"
#include "SD.h"
#include "SD_MMC.h"

void WriteFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  //unsigned long start_time = millis();
  Serial.printf("write [%s]...\n", path);

  File file = fs.open(path, FILE_WRITE);
  if (!file) {
    Serial.println("Failed to open file for writing");
    return;
  }
  
  if (!file.write(buf, len)) {
      Serial.println("Write failed");
      return;
    }

  file.flush();
  file.close();

  Serial.printf("Write [%s] Complete", path);
}

void ReadFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  Serial.printf("read [%s]...\n", path);

  File file = fs.open(path);
  if (!file) {
    Serial.println("Failed to open file for reading");
    return;
  }

  if (!file.read(buf, len)) {
      Serial.println("Read failed");
      return;
  }
  
  file.close();

  Serial.printf("Read [%s] Complete: %s", path, buf);
}

void testIO(fs::FS &fs)
{
  char buf[] = "hello world";

  WriteFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
  ReadFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
}

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);

  Serial.println("请插入内存卡");
  delay(8000);

  /* SD_MMC 4-bit Mode */
  if (!SD_MMC.begin()) {
    Serial.println("Card Mount Failed");
    return;
  }
  testIO(SD_MMC);
  SD_MMC.end(); // 取消SD挂载
}

void loop() {
}

二、1 位 SD 总线模式

硬件连线方式：
-----------------------------------------------
|  NodeMCU32s            |   SD Card          |
|  --------------------------------------------
|  -                     |   D02              |
|  -                     |   D01              |
|  GPIO15                |   CMD(MOSI)        |
|  GPIO2                 |   D00(MISO)        |
|  GPIO14                |   CLK(SCK)         |
|  -                     |   D03(SS)          |
|  GND                   |   GND              |
|  VCC(3.3v)             |   VCC              |
----------------------------------------------- 
#include "FS.h"
#include "SD.h"
#include "SD_MMC.h"

void WriteFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  //unsigned long start_time = millis();
  Serial.printf("write [%s]...\n", path);

  File file = fs.open(path, FILE_WRITE);
  if (!file) {
    Serial.println("Failed to open file for writing");
    return;
  }
  
  if (!file.write(buf, len)) {
      Serial.println("Write failed");
      return;
    }

  file.flush();
  file.close();

  Serial.printf("Write [%s] Complete", path);
}

void ReadFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  Serial.printf("read [%s]...\n", path);

  File file = fs.open(path);
  if (!file) {
    Serial.println("Failed to open file for reading");
    return;
  }

  if (!file.read(buf, len)) {
      Serial.println("Read failed");
      return;
  }
  
  file.close();

  Serial.printf("Read [%s] Complete: %s", path, buf);
}

void testIO(fs::FS &fs)
{
  char buf[] = "hello world";

  WriteFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
  ReadFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
}

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);

  Serial.println("请插入内存卡");
  delay(8000);

  /* SD_MMC 1-bit Mode */
  if (!SD_MMC.begin("/cdcard", true)) {
    Serial.println("Card Mount Failed");
    return;
  }
  testIO(SD_MMC);
  SD_MMC.end(); // 取消SD挂载
}

void loop() {
}

三、HSPI 总线模式

硬件连线方式：
-----------------------------------------------
|  NodeMCU32s            |   SD Card          |
|  --------------------------------------------
|  -                     |   D02              |
|  -                     |   D01              |
|  GPIO13                |   CMD(MOSI)        |
|  GPIO12                |   D00(MISO)        |
|  GPIO14                |   CLK(SCK)         |
|  GPIO15                |   D03(SS)          |
|  GND                   |   GND              |
|  VCC(3.3v)             |   VCC              |
----------------------------------------------- 
#include "FS.h"
#include "SD.h"
#include "SD_MMC.h"

void WriteFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  //unsigned long start_time = millis();
  Serial.printf("write [%s]...\n", path);

  File file = fs.open(path, FILE_WRITE);
  if (!file) {
    Serial.println("Failed to open file for writing");
    return;
  }
  
  if (!file.write(buf, len)) {
      Serial.println("Write failed");
      return;
    }

  file.flush();
  file.close();

  Serial.printf("Write [%s] Complete", path);
}

void ReadFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  Serial.printf("read [%s]...\n", path);

  File file = fs.open(path);
  if (!file) {
    Serial.println("Failed to open file for reading");
    return;
  }

  if (!file.read(buf, len)) {
      Serial.println("Read failed");
      return;
  }
  
  file.close();

  Serial.printf("Read [%s] Complete: %s", path, buf);
}

void testIO(fs::FS &fs)
{
  char buf[] = "hello world";

  WriteFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
  ReadFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
}

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);

  Serial.println("请插入内存卡");
  delay(8000);

  /* SD SPI Mode at HSPI */
  SPIClass spi = SPIClass(HSPI);
  spi.begin(14 /* SCK */, 12 /* MISO */, 13 /* MOSI */, 15 /* SS */);
  if (!SD.begin(15 /* SS */, spi, 80000000)) {
    Serial.println("Card Mount Failed");
    return;
  }
  testIO(SD);
  SD_MMC.end(); // 取消SD挂载
}

void loop() {
}
采用 32GB 闪迪 TF卡出现以下问题：

换成 32GB Kingston TF 卡正常。如果还不正常可以尝试换容量小一点的 TF 卡。


四、VSPI 总线模式

硬件连线方式：
-----------------------------------------------
|  NodeMCU32s            |   SD Card          |
|  --------------------------------------------
|  -                     |   D02              |
|  -                     |   D01              |
|  GPIO23                |   CMD(MOSI)        |
|  GPIO19                |   D00(MISO)        |
|  GPIO18                |   CLK(SCK)         |
|  GPIO5                 |   D03(SS)          |
|  GND                   |   GND              |
|  VCC(3.3v)             |   VCC              |
----------------------------------------------- 
#include "FS.h"
#include "SD.h"
#include "SD_MMC.h"

void WriteFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  //unsigned long start_time = millis();
  Serial.printf("write [%s]...\n", path);

  File file = fs.open(path, FILE_WRITE);
  if (!file) {
    Serial.println("Failed to open file for writing");
    return;
  }
  
  if (!file.write(buf, len)) {
      Serial.println("Write failed");
      return;
    }

  file.flush();
  file.close();

  Serial.printf("Write [%s] Complete", path);
}

void ReadFile(fs::FS &fs, const char *path, uint8_t *buf, int len)
{
  Serial.printf("read [%s]...\n", path);

  File file = fs.open(path);
  if (!file) {
    Serial.println("Failed to open file for reading");
    return;
  }

  if (!file.read(buf, len)) {
      Serial.println("Read failed");
      return;
  }
  
  file.close();

  Serial.printf("Read [%s] Complete: %s", path, buf);
}

void testIO(fs::FS &fs)
{
  char buf[] = "hello world";

  WriteFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
  ReadFile(fs, "/test.txt", (uint8_t *)buf, strlen(buf));
}

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);

  Serial.println("请插入内存卡");
  delay(8000);

  /* SD SPI Mode at VSPI */
  SPIClass spi = SPIClass(HSPI);
  spi.begin(18 /* SCK */, 19 /* MISO */, 23 /* MOSI */, 5 /* SS */);
  if (!SD.begin(5 /* SS */, spi, 80000000)) {
    Serial.println("Card Mount Failed");
    return;
  }
  testIO(SD);
  SD_MMC.end(); // 取消SD挂载
}

void loop() {
}
采用 32GB 闪迪 TF卡出现 VSPI 同样问题，换成 32GB Kingston TF 卡正常。

五、关于 SD 卡

SD（安全数码卡，Secure Digital Memory Card），由 MMC 基础发展而来。
  • 根据尺寸，可划分为SD card、miniSD、microSD(TF)。
  • 根据容量，可划分为SDSC(<2GB)、SDHC(2~32GB)、SDXC(32GB~2TB)
  • SD 使用的总线协议：SD Bus、SPI Bus、UHS-Ⅱ Bus。
  • SD 卡上有一个 C 字包裹一个数字的图形，是一个写入速度的标准，这个标准主要有Class 2、Class 4、Class 6、Class10。
  • SD 卡上有一个 U 字包裹一个数字的图形，这个同 C 字图形一样，也是一个写入速度的标准，如果同时出现，只需要看速度最快的那个即可。
  • V+ 数字表示视频速度等级，用来表示最低读写速度。
  • V 下面一般有罗马数字 Ⅰ、Ⅱ、Ⅲ，表示最低读写速度。Ⅰ只有一排金属触点，而其它有两排金属触点，数字越大，速度越快。（以Ⅰ为例，代表着UHS-1，Ultra High SpeedClass 1）
  • TF卡上有A1、A2（application performance class）标签，这种卡可用于手机扩容，因此划分等级用于说明程序打开速度，A2比A1快。
链接：https://blog.csdn.net/weixin_42258222/article/details/127494510
- 本文内容来自网络，如有侵权，请联系本站处理。

2023-10   阅读(1094)   评论(0)
 标签： maker Arduino ESP32 SD卡
涨知识
RISC-V

RISC-V（发音为“risk-five”）是一个基于精简指令集（RISC）原则的开源指令集架构（ISA）。RISC-V指令集可以自由地用于任何目的，允许任何人设计、制造和销售RISC-V芯片和软件。

评论:
相关文章
小鹏物联网 MicroPython 智能浇花方案

相信很多人都有把绿植给养死的经历，可能是浇水过多、忘记浇水、较长时间不在家不能浇水等，本文介绍一种可以灵活定制的智能浇花方案。

MicroPython 开发ESP32应用之线程介绍及实例分析

MicroPython 在 ESP32 上支持线程（Thread）功能，通过_thread模块实现。线程允许程序并发执行多个任务，适合处理需要同时运行的场景，例如传感器数据采集和网络通信。

盛思发布掌控板3.0

掌控板3.0升级了主控，还主打AI。带有双麦克风阵列，增加了音频解码芯片，板载了一个1W喇叭，还把之前的单色屏幕换成了1.47寸的彩色屏幕，有更多的可玩性。

ESP32 MicroPython采集模拟传感器数值

使用了 MicroPython 库，通过 定时器（Timer） 和 ADC（模数转换器） 功能来实时读取传感器数据。使用定时器可以实现高精度、非阻塞、低资源消耗的周期性任务，保证实时性和可靠性，特别适用于嵌入式系统中的多任务处理和低功耗场景。

tinkercad热敏电阻原理图绘制

ESP32 使用DAC模拟输出完成两路呼吸灯

ESP32的DAC函数可以实现真正的模拟输出。

在 ESP32 上使用 LEDC (PWM)

ESP32 没有Arduino输出 PWM 的 analogWrite(pin, value) 方法，取而代之的 ESP32 有一个 LEDC 来实现PWM功能。

《米思齐实战手册：Arduino图形化编程指南》

本书由少年创学院联合创始人兼院长、知名创客程晨撰写，以Arduino作为硬件平台，介绍了使用米思齐（Mixly）软件进行程序开发的方法。

Micropython基于ESP32的多线程开发

本文学习如何使用ESP32开发板来进行多线程的开发。

ESP8266 Arduino WIFI

ESP8266有三种工作模式，分别为：AP，STA，AP混合STA

搜索
最新课件
共 5 课
共 3 课
共 17 课
热点文章
蓝桥STEMA考试介绍，一文看懂！
2022-2025学年44项教育部白名单赛事官网合集！
十分钟不到，就学会使用乐高studio2.0做图纸啦！
ESP32-S3 引脚参考大全
电机驱动芯片TB6612的内部结构及应用
玩转Tinkercad电子电路设计 | 在线仿真让学习和创作如此简单
初识ESP32-S3芯片
数学直观学习神器——写给家长的GeoGebra简单使用指南
ESP32-C3 开发板和引脚说明
Tinkercad介绍
推荐文章
小鹏物联网 MicroPython 智能浇花方案
MicroPython 开发ESP32应用之线程介绍及实例分析
这些线上平台，让孩子足不出户，享受高质量教育
星型八缸发动机
7个乐高自动化水泵水车MOC作品
机器人技术七级实操测试考题解析-乒乓球捕捉系统
机器人技术七级理论测试卷考题解析
《中小学人工智能通识教育指南（2025年版）》全文发布
《中小学生成式人工智能使用指南（2025年版）》全文发布 | 附解读！
给梦想插上科技的翅膀 第八届全国青少年人工智能创新挑战赛启动
最新资源
米思齐手册
Arduino UNO 乐高兼容底座3D模型
乐高科技适配RaspberyPi,Arduino的底座3D模式
适用于ESP32和ESP8266板、树莓派Pico的外壳
ESP32-CAM箱式外壳
ESP32开发指南
Kolban's Book on ESP32
ESP8266-WiFi模块用户手册V1.0
ESP-SR 用户手册
青少年机器人技术等级考试三、四级：Arduino电子积木
小鹏STEM教研服务

专属教研服务系统，助您构建STEM课程体系，打造一站式教学环境。