STM32系列文章（ FatFs文件系统——使用SPI读写MicroSD卡）

最新推荐文章于 2026-04-23 12:15:48 发布
原创 最新推荐文章于 2026-04-23 12:15:48 发布 · 5.9k 阅读 · 91
标签
#stm32 #网络 #嵌入式硬件 #物联网

文章目录

前言

本文仅代表个人的记录和理解，不具有权威性，请谨慎参考。

STM32 MCU 读写SD/MicroSD卡最简单和快速的方式是使用SDIO口，但有些系列的STM32 MCU没有SDIO接口必须采用SPI操作SD/MicroSD卡。

一、FatFs是什么？

在这里插入图片描述

FatFs 是用于小型嵌入式系统的通用 FAT/exFAT 文件系统模块。FatFs 模块是按照 ANSI C （C89） 编写的，并且与磁盘 I/O 层完全分离。因此，它独立于平台。它可以集成到资源有限的小型微控制器中。如果我们需要MCU读写SD/MicroSD卡上的文件如bmp图片，就需要用到FatFs 文件系统。

1.应用界面层

在这里插入图片描述

FatFs 为应用程序提供了各种文件系统功能，如下所示：

  • 文件访问
    f_open - 打开/创建文件
    f_close - 关闭打开的文件
    f_read - 从文件中读取数据
    f_write - 将数据写入文件
    f_lseek - 移动读/写指针，扩展大小
    f_truncate - 截断文件大小
    f_sync - 刷新缓存的数据
    f_forward - 将数据转发到流
    f_expand - 为文件分配一个连续的块
    f_gets - 读取字符串
    f_putc - 写一个字符
    f_puts - 写一个字符串
    f_printf - 编写格式化字符串
    f_tell - 获取当前读/写指针
    f_eof - 测试文件结束
    f_size - 获取尺寸
    f_error - 测试错误

  • 目录访问
    f_opendir - 打开目录
    f_closedir - 关闭打开的目录
    f_readdir - 读取目录项
    f_findfirst - 打开目录并读取匹配的第一个项目
    f_findnext - 读取下一个匹配的项目

  • 文件和目录管理
    f_stat - 检查文件或子目录是否存在
    f_unlink - 删除文件或子目录
    f_rename - 重命名/移动文件或子目录
    f_chmod - 更改文件或子目录的属性
    f_utime - 更改文件或子目录的时间戳
    f_mkdir - 创建子目录
    f_chdir - 更改当前目录
    f_chdrive - 更改电流驱动器
    f_getcwd - 检索当前目录和驱动器

  • 卷管理和系统配置
    f_mount - 注册/注销卷的工作区
    f_mkfs - 在逻辑驱动器上创建 FAT 卷
    f_fdisk - 在物理驱动器上创建分区
    f_getfree - 获取卷上的可用空间
    f_getlabel - 获取卷标
    f_setlabel - 设置卷标
    f_setcp - 设置活动代码页

2.媒体访问接口层

在这里插入图片描述

由于 FatFs 模块是独立于平台和存储介质的文件系统层，因此它与物理设备（如存储卡、硬盘和任何类型的存储设备）完全分离。存储设备控制模块不是 FatFs 模块的任何部分，需要由实现者提供。FatFs 通过如下所示的简单媒体访问接口控制存储设备。此外，下载中还提供了某些平台的示例实现。此处提供了存储设备控制模块的功能检查器:

  • 存储设备控制
    disk_status - 获取设备状态
    disk_initialize - 初始化设备
    disk_read - 读取数据
    disk_write - 写入数据
    disk_ioctl - 控制设备相关功能
  • 实时时钟
    get_fattime - 获取当前时间

二、硬件

1.MicroSD卡转接板

为方便把MicroSD卡连接到STM32开发板,使用一个转接板进行转接。转接板接口如下：
在这里插入图片描述

2.STM32F103C8T6开发板

开发板上面有一颗STM32F103C8T6 MCU。
在这里插入图片描述

3.连接关系

MicroSD卡和STM32F103C8T6的连接关系如下表：

序号 MicroSD卡 MCU
1 CS PA4
2 SCK PA5
3 MOSI PA7
4 MISO PA6
5 VCC 3.3V
6 GND GND

三、代码

使用CubeMx生成代码，步骤如下：(注意：这个工程只列出了关键步骤，为节省篇幅一些步骤省略了，如果对CubeMX和KEIIL不太熟悉，请谨慎参考)

1.SPI

使用SPI1控制MicroSD卡，采用软件片选信号。
在这里插入图片描述

2.GPIO

为SPI1接口增加片选信号SD_CS。
在这里插入图片描述

3.UART

使用USART1作为打印输出接口。
在这里插入图片描述

4.FatFs

在这里插入图片描述

5.生成代码

生成的MDK代码关于FatFs的文件如下：
在这里插入图片描述
为了使用FatFs文件系统通过SPI读写MicroSD卡我们需要完成的工作有两步：

  • 编写SPI控制MicroSD卡的代码。
  • 给user_diskio.c里的空函数加入实现方法。

7.SPI控制MicroSD卡代码

新建两个文件：fatfs_sd.h和fatfs_sd.c，并将其添加到工程中。代码如下：

fatfs_sd.h

#ifndef __FATFS_SD_H
#define __FATFS_SD_H
 
#include "stm32l5xx_hal.h"
#include "diskio.h"
 
/* Definitions for MMC/SDC command */
#define CMD0     (0x40+0)       /* GO_IDLE_STATE */
#define CMD1     (0x40+1)       /* SEND_OP_COND */
#define CMD8     (0x40+8)       /* SEND_IF_COND */
#define CMD9     (0x40+9)       /* SEND_CSD */
#define CMD10    (0x40+10)      /* SEND_CID */
#define CMD12    (0x40+12)      /* STOP_TRANSMISSION */
#define CMD16    (0x40+16)      /* SET_BLOCKLEN */
#define CMD17    (0x40+17)      /* READ_SINGLE_BLOCK */
#define CMD18    (0x40+18)      /* READ_MULTIPLE_BLOCK */
#define CMD23    (0x40+23)      /* SET_BLOCK_COUNT */
#define CMD24    (0x40+24)      /* WRITE_BLOCK */
#define CMD25    (0x40+25)      /* WRITE_MULTIPLE_BLOCK */
#define CMD41    (0x40+41)      /* SEND_OP_COND (ACMD) */
#define CMD55    (0x40+55)      /* APP_CMD */
#define CMD58    (0x40+58)      /* READ_OCR */
 
/* MMC card type flags (MMC_GET_TYPE) */
#define CT_MMC    0x01    /* MMC ver 3 */
#define CT_SD1    0x02    /* SD ver 1 */
#define CT_SD2    0x04    /* SD ver 2 */
#define CT_SDC    0x06    /* SD */
#define CT_BLOCK  0x08    /* Block addressing */
 
#define ACMD41_HCS           0x40000000
#define ACMD41_SDXC_POWER    0x10000000
#define ACMD41_S18R          0x04000000
#define ACMD41_VOLTAGE       0x00ff8000
#define ACMD41_ARG_HC        (ACMD41_HCS|ACMD41_SDXC_POWER|ACMD41_VOLTAGE)
#define ACMD41_ARG_SC        (ACMD41_VOLTAGE)  
 
/* Functions */
DSTATUS SD_disk_initialize (BYTE pdrv);
DSTATUS SD_disk_status (BYTE pdrv);
DRESULT SD_disk_read (BYTE pdrv, BYTE* buff, DWORD sector, UINT count);
DRESULT SD_disk_write (BYTE pdrv, const BYTE* buff, DWORD sector, UINT count);
DRESULT SD_disk_ioctl (BYTE pdrv, BYTE cmd, void* buff);
 
#define SPI_TIMEOUT 100
 
extern SPI_HandleTypeDef  hspi2;
#define HSPI_SDCARD     &hspi2
#define SD_CS_PORT      GPIOB
#define SD_CS_PIN     GPIO_PIN_11
 
#endif

fatfs_sd.c

#define TRUE  1
#define FALSE 0
#define bool BYTE
 
#include "fatfs_sd.h"
#include <stdio.h>
 
uint16_t Timer1, Timer2;          /* 1ms Timer Counter */
 
static volatile DSTATUS Stat = STA_NOINIT;  /* Disk Status */
static uint8_t CardType;                    /* Type 0:MMC, 1:SDC, 2:Block addressing */
static uint8_t PowerFlag = 0;       /* Power flag */
 
/***************************************
 * SPI functions
 **************************************/
 
/* slave select */
static void SELECT(void)
{
   
   
  HAL_GPIO_WritePin(SD_CS_PORT, SD_CS_PIN, GPIO_PIN_RESET);
  HAL_Delay(1);
}
 
/* slave deselect */
static void DESELECT(void)
{
   
   
  HAL_GPIO_WritePin(SD_CS_PORT, SD_CS_PIN, GPIO_PIN_SET);
  HAL_Delay(1);
}
 
/* SPI transmit a byte */
static void SPI_TxByte(uint8_t data)
{
   
   
  while(!__HAL_SPI_GET_FLAG(HSPI_SDCARD, SPI_FLAG_TXE));
  HAL_SPI_Transmit(HSPI_SDCARD, &data, 1, SPI_TIMEOUT);
}
 
/* SPI transmit buffer */
static void SPI_TxBuffer(uint8_t *buffer, uint16_t len)
{
   
   
  while(!__HAL_SPI_GET_FLAG(HSPI_SDCARD, SPI_FLAG_TXE));
  HAL_SPI_Transmit(HSPI_SDCARD, buffer, len, SPI_TIMEOUT);
}
 
/* SPI receive a byte */
static uint8_t SPI_RxByte(void)
{
   
   
  uint8_t dummy, data;
  dummy = 0xFF;
 
  while(!__HAL_SPI_GET_FLAG(HSPI_SDCARD, SPI_FLAG_TXE));
  HAL_SPI_TransmitReceive(HSPI_SDCARD, &dummy, &data, 1, SPI_TIMEOUT);
 
  return data;
}
 
/* SPI receive a byte via pointer */
static void SPI_RxBytePtr
最低0.47元/天 解锁文章
使用STM32F103作为基于 SPI 的 SD 卡读卡器示例
06-04
这使用了“Blue Pill”板上的 STM32F103X8Tx。该项目在 STM32 的 System Workbench 中设置和测试。 接线可设置如下： 标清 CS = PA4 SD SCK = PA5 标清味噌 = PA6 SD MOSI = PA7 USB D+ = PA12 USB D- = PA11 USB D+ 需要一个上拉电阻。如果您使用的是分线板，则 USB 可能已为您接线。 您还需要一些将 SD 卡连接到 micro 的方法，网上有很多便宜的分线板。
STM32的FATFS文件系统
扬帆起航
03-21 5401
STM32的FATFS文件系统
STM32——FATFS文件基础知识
weixin_62584795的博客
10-16 3889
STM32——FATFS文件基础知识
STM32实战：基于STM32F103的FatFs文件系统移植（SD卡读写）
最新发布
LCG元的博客
04-23 996
本文介绍了在STM32F103C8T6微控制器上实现FatFs文件系统与SD卡通信的完整方案。主要内容包括：1)硬件连接配置（SPI接口）；2)STM32CubeIDE工程创建与FatFs中间件设置；3)SD卡SPI驱动开发（含命令定义、初始化流程和读写操作）；4)文件系统功能实现。通过详细的代码示例和配置说明，展示了如何在小资源嵌入式系统中构建完整的文件存储解决方案，适用于数据采集、日志记录等应用场景。
STM32-基本知识梳理8-FATFS文件系统移植
ADAS_sunshine的博客
04-19 3989
文件系统本质上，可以理解为一个函数B，外部可以通过函数A调用函数B，而函数B不接触底层操作，而是通过调用函数C对底层存储进行操作。3，主要的文件需要包含上述的6个c文件或者h文件，在文件文件中，需要调整主要是diskio.c \ ffconf.h。1-启动首先第一步，是挂载系统。2- 如果写入完成，立即读取，则需要调用lseek进行重新定位，才能读取，这是由文件光标位置决定，相当于退后光标；2，移植需要借用spi-flash控制的源码，在spi-flash控制的源码的基础上，添加文件系统。
STM32学习——FATFS文件系统
qq_43460068的博客
02-25 1万+
什么是文件系统 负责管理和存储文件信息的软件机构，在磁盘上组织文件的方法。 常用的文件系统 FAT/FATFS 小型嵌入式系统 NTFS WINDOWS CDFS 光盘 exFAT 更适合用于闪存 FATFS优点：免费开源，专门为小型嵌入式系统设计，完全用C语言编写;支持FAT12,FAT16与FAT32，支持多种存储媒介，有独立的缓冲区，可对多个文件进行读写，可裁剪的文件系统（极为重要） FATFS的特点： Windows兼容的FAT文件系统，（支...
STM32CubeMX学习笔记（27）——FatFs文件系统使用（操作SD卡）
热门推荐
Leung的博客
12-07 2万+
一、FatFs简介 FatFs 是面向小型嵌入式系统的一种通用的 FAT 文件系统。它完全是由 ANSI C 语言编写并且完全独立于底层的 I/O 介质。因此它可以很容易地不加修改地移植到其他的处理器当中，如 8051、PIC、AVR、SH、Z80、H8、ARM 等。FatFs 支持 FAT12、FAT16、FAT32 等格式，所以我们利用前面写好的 SPI Flash 芯片驱动，把 FatFs 文件系统代码移植到工程之中，就可以利用文件系统的各种函数，对 SPI Flash 芯片以“文件”格式进行读写操
STM32F103C8T6+SD/Micro TF卡+SFATS+软SPI+硬SPI
pang9998的博客
01-06 1万+
使用环境(蓝色粗体字为特别注意内容) 1、软件环境：Keil MDK 5.15 2、硬件环境：STM32F103C8T6最小系统，Micro TF卡 在一个项目中需要用到SD卡，于是在某宝买了一块Micro TF卡插槽，SPI驱动： 貌似不用那个小芯片好像可以用IO口直接驱动TF卡，不知道那个小芯片干嘛用的，也没工夫去追究了，废话少说，先来看接线： TF卡模块   STM32单片机 G...
STM32实战指南：基于SPI接口的FatFs文件系统与MicroSD卡高效数据存储方案
tree的博客
02-28 614
本文详细介绍了在STM32平台上，如何通过SPI接口驱动MicroSD卡并集成FatFs文件系统，实现高效可靠的数据存储方案。文章从硬件连接到软件架构，手把手指导了从CubeMX配置、底层SPI驱动编写到FatFs中间件移植的全过程，并提供了实战应用示例与常见问题避坑指南，帮助开发者快速掌握嵌入式文件系统的核心技能。
STM32传感器模块编程实践(十二) micro SD卡模块简介及驱动源码
光子物联科技主要介绍STM32单片机，GD32单片机以及各种传感器模块原理以及驱动，适合学生，工程师等学习单片机嵌入式开发、传感器驱动、通信协议等。
11-16 6089
在STM32单片机中，MicroSD卡常用于存储和读取数据。本文介绍了MicroSD卡模块，以及使用STM32F030C8T6单片机连接MicroSD卡，使用SPI接线方式，提供参考例程
STM32实战指南：基于SPI接口的FatFs文件系统与MicroSD卡高效通信
weixin_29178069的博客
02-25 447
本文详细介绍了如何在STM32平台上，通过SPI接口驱动MicroSD卡并集成FatFs文件系统。内容涵盖从硬件连接到CubeMX工程配置、底层驱动移植，到文件读写实战与常见问题调试，旨在帮助开发者快速实现嵌入式设备的大容量、可靠数据存储方案。
FatFs文件系统在STM32上的移植指南：SPI模式下的MicroSD卡操作
weixin_29191761的博客
03-20 315
本文详细介绍了FatFs文件系统在STM32上的移植实践，重点解析了SPI模式下MicroSD卡的高效操作方法。从硬件配置到软件实现，提供了完整的移植指南和性能优化策略，帮助开发者快速掌握嵌入式文件系统的开发技巧。
STM32 串行FLASH文件系统FatFs
ChenWenHaoHaoHao的博客
12-21 3313
FatFs文件系统源码：doc文件夹里面是一些使用帮助文档；在src是FatFs文件系统的源代码。integer.h：文件中包含了一些数值类型定义（typedef）。diskio.c：包含底层存储介质的操作函数，这些函数需要用户自己实现，主要添加底层驱动函数。ff.c： FatFs核心文件，文件管理的实现方法。该文件独立于底层介质操作文件的函数，利用这些函数实现文件的读写。
STM32 中 FATFS 文件系统代码分析
千千道的博客
12-02 2193
FATFS 是一个开源的 FAT 文件系统模块，用 C 语言编写，可以移植到多种嵌入式系统中。小巧高效：代码量小，占用内存少，运行速度快。易于移植：完全用 C 语言编写，不依赖于特定的硬件平台，可以很容易地移植到不同的微控制器上。功能丰富：支持文件的创建、打开、读写、关闭、删除等操作，还支持目录的创建、删除、遍历等操作。兼容性好：与 Windows 系统的 FAT 文件系统兼容，可以在 Windows 系统上直接读取和写入 STM32 上的文件。
FatFS文件系统的使用（STM32）
weixin_38743772的博客
04-26 6661
分享关于FatFS在STM32平台的上的使用及注意事项
细说STM32单片机FatFS文件系统基础知识和函数详解
wenchm的博客
06-16 2678
目录一、FatFS概述1、FatFS的作用（1）用户应用程序（2）FatFS通用程序（3）FatFS底层设备控制（4）存储介质和RTC2、文件系统的一些基本概念（1）文件系统（2）FAT卷（3）扇区（4）簇（5）数据存储形式3、FatFS的功能特点和参数4、FatFS的文件组成（1）用户应用程序（2）FatFS应用接口5、FatFS通用硬件接口（1）具体硬件访问层（2）具体硬件6、FatFS的基本数据类型定义二、 FatFS的应用程序接口函数1、卷管理和系统配置相关函数（1）函数f_mkfs()（2）函数f
FatFs移植到STM32(SD卡)
BIN-XYB的博客
07-07 3690
FatFs驱动SD卡，文件读写
STM32存储左右互搏 SDIO总线FATS文件读写SD/MicroSD/TF卡
Pegasus的软件博客
04-22 2439
SD/MicroSD/TF卡是基于FLASH的一种常见非易失存储单元，由接口协议电路和FLASH构成。市面上由不同尺寸和不同容量的卡，手机领域用的TF卡实际就是MicroSD卡，尺寸比SD卡小，而电路和协议操作则是一样。这里介绍STM32CUBEIDE开发平台HAL库SDIO总线FATS文件操作读写SD/MicroSD/TF卡的例程。
【亲测免费】 STM32 SD/MicroSD卡读卡器（通过SPI驱动）
gitblog_09720的博客
10-16 1560
STM32 SD/MicroSD卡读卡器（通过SPI驱动） 【下载地址】STM32SDMicroSD卡读卡器通过SPI驱动 本资源文件提供了一个基于STM32的SD/MicroSD卡读卡器解决方案。通过SPI驱动，STM32单片机可以在不连接USB的情况下直接访问SD卡，并使用FatFs文件系统进行文件操作。当插入USB...
探索STM32的存储新境界：基于SPI的SD/MicroSD卡读卡器
gitblog_09783的博客
10-19 782
探索STM32的存储新境界：基于SPI的SD/MicroSD卡读卡器 【下载地址】STM32SDMicroSD卡读卡器通过SPI驱动 本资源文件提供了一个基于STM32的SD/MicroSD卡读卡器解决方案。通过SPI驱动，STM32单片机可以在不连接USB的情况下直接访问SD卡，并使用FatFs文件系统进行文件操作。当...
评论 8
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值