Arduino接SD卡模块:exFAT不认 SPI四线接法

2026-11-15 14:36:52 107阅读

给项目加一块掉电不丢的存储,SD 卡是最省事的答案。几十块的开发板配一个十几块的 SPI 卡座板,就能把传感器数据写成文件、拔下来带走,跟树莓派拿它当硬盘是一个思路。不过这块小板子接上去容易,卡认不认、格式化对不对,坑都藏在看不见的地方。这次把 MicroSD 卡模块接 Arduino 的完整链路拆一遍:电平转换怎么过、四根 SPI 线怎么排、文件系统挑哪种、代码跑起来是什么效果。

Arduino SD卡模块 microSD卡座

一、先分清卡:FAT16/FAT32/exFAT 的分界线

SD 卡是 1999 年 8 月由 SanDisk、松下、东芝三家联手推出的,2000 年 1 月这三家成立了 SD 协会来定标准。常见规格里,SD/SDSC 是标准容量卡,上限 2GB,早期卡用 FAT16 文件系统,后来的用 FAT32;SDHC 是高容量卡,2GB 到 32GB,同样走 FAT32;SDXC 是扩展容量卡,32GB 起步到 2TB,文件系统换成了 exFAT;再往上还有 2TB 到 128TB 的 SDUC。miniSD 这种中间规格 2008 年之后就停产了,不用考虑。

速度标识也要看清。老的 Class 1 到 Class 10 分级,现在随便一张正经卡都能跑赢,基本失去参考价值;SDHC/SDXC 卡可以走 UHS 总线,UHS-I 的速率是 50 到 104 MB/s,UHS-II 156 MB/s,UHS-III 312 到 624 MB/s,最新的 SD Express 规格能到 985 MB/s。但 Arduino 总线本身就跑不快,这些上限一张也吃不满,买卡别为速度等级多花一分钱。

结论先给:给 Arduino 选卡就认 SDHC,2GB 到 32GB、FAT32 格式、Class 10 足够。SDXC 的 exFAT 文件系统 Arduino SD 库不认,卡插上去初始化直接失败,这是新手翻车最多的一步。

SD卡模块与microSD卡模块实物

二、电平转换是分水岭:两种模块两种接法

SD 卡本体是 3.3V 逻辑器件,标准 SD 卡走 SPI 总线;SDHC/SDXC 还能切到 one-bit SD 总线,那种模式下工作电压降到 1.8V。microSD 卡和标准 SD 卡电气兼容,只是引脚排布不同,卡包装里附的塑料 SD 转接卡干的就是重新排线这件事。

市面上的卡座板分两类,这里别踩。全尺寸 SD 卡模块很多不带电平转换,板上的稳压器只负责把 5V 供电降到 3.3V,逻辑信号仍然按 3.3V 算,接 Uno、Mega 这类 5V 逻辑板要自己补电平转换芯片或者电阻分压阵列,否则读出来的数据是乱码。microSD 模块则反过来,板载电平转换加稳压器,天生为 5V 逻辑准备,只留一个 5V 电源输入,Uno 直插就能用。

microSD模块与Arduino Uno SPI接线图

四根线照着接 Uno:MOSI 接 11,MISO 接 12,SCK 接 13,CS 接 4。换 Mega 引脚全变:MISO 50、MOSI 51、SCK 52、CS 53。CS 理论上可以用任意数字脚,代码里对应改就行。用带 SD 卡座的扩展板要留个心眼,有些板子把 CS 固定在 6 脚或 10 脚,查不到资料就拿万用表量一下走线。

SPI 信号Arduino UnoArduino Mega
MISO1250
MOSI1151
SCK1352
CS4(可换其他脚)53(可换其他脚)

三、SD 库的三条规矩:格式、文件名、目录

Arduino IDE 自带的 SD 库支持 SDSC 和 SDHC 卡上的 FAT16、FAT32 两种文件系统,exFAT 明确不在支持列表里,重新格式化卡的时候千万别顺手选成 exFAT。第二条规矩是文件名沿用老的 8.3 约定:主名不超过 8 个字符,扩展名最多 3 个字符,TESTFILE.TXT 合法,MYNICEFILE.FILE 这种不行。第三条,需要目录就在路径里用正斜杠分隔,例如 /LOG/DATA.TXT。

我的习惯是格式化在电脑上做完再插到模块上,写完的数据也拔下来直接在电脑上读,FAT32 双向通用,省去中间环节变量。

电脑读取SD卡FAT32文件

四、ReadWrite 实测:写入、追加、读回

官方示例 ReadWrite 是最短的完整闭环,IDE 里从 File 菜单的 Examples 找到 SD 分组就能打开。核心三步:SD.begin(4) 用 CS 脚 4 初始化,失败就停在死循环里报错;SD.open("test.txt", FILE_WRITE) 打开文件写入一行,写完必须 close,SD 库一次只能开一个文件;然后不带参数重新 SD.open("test.txt") 只读打开,逐字节吐给串口监视器。

/*
  SD card read/write

 This example shows how to read and write data to and from an SD card file
 The circuit:
 * SD card attached to SPI bus as follows:
 ** MOSI - pin 11
 ** MISO - pin 12
 ** CLK - pin 13
 ** CS - pin 4 (for MKRZero SD: SDCARD_SS_PIN)

 created   Nov 2010
 by David A. Mellis
 modified 9 Apr 2012
 by Tom Igoe

 This example code is in the public domain.

 */

#include "SPI.h"
#include "SD.h"

File myFile;

void setup() {
  // Open serial communications and wait for port to open:
  Serial.begin(9600);
  while (!Serial) {
    ; // wait for serial port to connect. Needed for native USB port only
  }


  Serial.print("Initializing SD card...");

  if (!SD.begin(4)) {
    Serial.println("initialization failed!");
    while (1);
  }
  Serial.println("initialization done.");

  // open the file. note that only one file can be open at a time,
  // so you have to close this one before opening another.
  myFile = SD.open("test.txt", FILE_WRITE);

  // if the file opened okay, write to it:
  if (myFile) {
    Serial.print("Writing to test.txt...");
    myFile.println("testing 1, 2, 3.");
    // close the file:
    myFile.close();
    Serial.println("done.");
  } else {
    // if the file didn't open, print an error:
    Serial.println("error opening test.txt");
  }

  // re-open the file for reading:
  myFile = SD.open("test.txt");
  if (myFile) {
    Serial.println("test.txt:");

    // read from the file until there's nothing else in it:
    while (myFile.available()) {
      Serial.write(myFile.read());
    }
    // close the file:
    myFile.close();
  } else {
    // if the file didn't open, print an error:
    Serial.println("error opening test.txt");
  }
}

void loop() {
  // nothing happens after setup
}

FILE_WRITE 有个行为值得记住:文件不存在就新建,存在则在末尾追加。实测每按一次 Uno 的复位键,串口监视器就多一行 testing 1, 2, 3.,数据是一次次追加而不是覆盖。不想堆行就改成先删后建。

ReadWrite示例串口监视器输出

五、DataLogger 实测与选卡建议

DataLogger 示例把 A0、A1、A2 三路模拟量读数写进卡里,是不带时间戳的极简记录仪,要时间戳就得自己加 RTC 模块。接线在三个电位器上,拧动旋钮,卡里的数值跟着变,拔下来在电脑上打开就是一列列原始读数,DumpFile 示例可以把卡里的文件原样倒回串口核对。

DataLogger三路模拟量接线图

DataLogger串口数据实测

最后给结论。卡选 SDHC、容量 16GB 或 32GB、FAT32 格式化;模块选带电平转换的 microSD 卡座板,Uno、Mega 直插四根线搞定。全尺寸 SD 卡座板更便宜,但多半没有电平转换,配 5V 板要额外补转换芯片,这笔账要算进去。UHS-II、SD Express 这类高速卡的钱花在 Arduino 上是浪费,慢总线吃不到;省下的预算拿去买靠谱品牌的卡更实际,劣质卡坏一次文件就够喝一壶。截至 2026 年 11 月,这类模块电商价格仍在十几元一档,入门成本几乎可以忽略。


作者:写launch的皮皮
链接:https://www.aiddithome.com/p/44f6587c254bb.html
本作版权归作者所有,未经允许请勿转载。若存在违规行为,您可以点击 “举报”。


登录 后发表评论
4条评论
只看不说话
1楼 · 2026-11-15 14:37:25

FILE_WRITE追加这个细节太真实了,我当时还以为程序出bug了怎么每复位一次多一行,原来是特性哈哈。

阿强焊点总飞
2楼 · 2026-11-15 14:37:24

想问下8.3文件名这条是对所有SD库版本都生效吗?之前写个长文件名好像也能建出来,就是电脑上看着名字怪怪的。

锡点
3楼 · 2026-11-15 14:37:22

电平转换这段写得好,网上很多便宜的全尺寸SD卡座真没带转换芯片,接5V板读出来全是乱码,血泪教训。

老张装机
4楼 · 2026-11-15 14:37:21

这波总结到位,第一次给Uno接卡座就是被exFAT坑的,卡在电脑上好好的,插模块上初始化直接失败,重格成FAT32才救回来。