c++如何在内存极其有限的单片机上读写SD卡文件

在内存只有几KB到几十KB的低成本单片机项目中，实现SD卡文件读写需要选择轻量级的文件系统方案，FatFs是专为嵌入式设备设计的开源FAT文件系统模块，占用资源极少，非常适合这类场景。通过C++封装相关操作，还能让代码更符合面向对象的设计习惯。

FatFs库移植准备

首先需要从FatFs官方网站获取最新版本的源码，解压后核心文件包含ff.h、ff.c、diskio.h、diskio.c。针对内存有限的单片机，需要修改ffconf.h配置文件，关闭不需要的功能以减少内存占用。

关键配置项说明

底层磁盘接口实现

FatFs通过diskio.c中的函数与底层存储硬件交互，内存有限的单片机需要精简实现这几个核心函数。

初始化函数实现

disk_initialize函数负责SD卡的硬件初始化，这里以SPI接口为例：

#include "diskio.h"
#include "sd_spi.h" // 单片机SPI操作底层头文件

DSTATUS disk_initialize(BYTE pdrv) {
    if (pdrv != 0) return STA_NOINIT; // 只支持磁盘0
    if (sd_spi_init() == 0) { // 调用SPI初始化函数
        return 0; // 初始化成功
    }
    return STA_NOINIT; // 初始化失败
}

扇区读写函数实现

disk_read和disk_write是核心的读写函数，需要适配SD卡的SPI读写协议：

DRESULT disk_read(BYTE pdrv, BYTE* buff, LBA_t sector, UINT count) {
    if (pdrv != 0) return RES_PARERR;
    // 调用SD卡读取函数，读取count个扇区到buff
    if (sd_read_sectors(sector, count, buff) == 0) {
        return RES_OK;
    }
    return RES_ERROR;
}

DRESULT disk_write(BYTE pdrv, const BYTE* buff, LBA_t sector, UINT count) {
    if (pdrv != 0) return RES_PARERR;
    // 调用SD卡写入函数，将buff内容写入count个扇区
    if (sd_write_sectors(sector, count, buff) == 0) {
        return RES_OK;
    }
    return RES_ERROR;
}

C++封装文件操作类

为了方便在C++项目中使用，我们可以封装一个简单的文件操作类，避免直接调用C风格的FatFs函数：

#include "ff.h"

class SdFile {
private:
    FIL m_file; // FatFs文件对象
    FRESULT m_last_result; // 最后一次操作结果
public:
    // 打开文件
    bool open(const char* path, BYTE mode) {
        m_last_result = f_open(&m_file, path, mode);
        return (m_last_result == FR_OK);
    }
    
    // 写入数据
    bool write(const void* data, UINT size, UINT* written) {
        m_last_result = f_write(&m_file, data, size, written);
        return (m_last_result == FR_OK);
    }
    
    // 读取数据
    bool read(void* buffer, UINT size, UINT* read_count) {
        m_last_result = f_read(&m_file, buffer, size, read_count);
        return (m_last_result == FR_OK);
    }
    
    // 关闭文件
    void close() {
        f_close(&m_file);
    }
    
    // 获取最后错误码
    FRESULT get_last_error() const {
        return m_last_result;
    }
    
    ~SdFile() {
        close();
    }
};

实际使用示例

下面是使用封装好的类在单片机中读写SD卡文件的完整示例：

#include "ff.h"
#include "sd_file.h"

int main() {
    FATFS fs; // 文件系统对象
    // 挂载文件系统，0是磁盘编号，1表示立即挂载
    FRESULT res = f_mount(&fs, "", 1);
    if (res != FR_OK) {
        // 挂载失败处理
        return -1;
    }
    
    SdFile file;
    // 打开文件，FA_CREATE_ALWAYS表示不存在则创建，FA_WRITE表示写入模式
    if (file.open("test.txt", FA_CREATE_ALWAYS | FA_WRITE)) {
        const char* content = "Hello SD Card";
        UINT written;
        // 写入内容
        if (file.write(content, 14, &written)) {
            // 写入成功处理
        }
        file.close();
    }
    
    // 读取文件测试
    if (file.open("test.txt", FA_READ)) {
        char buffer[32];
        UINT read_count;
        if (file.read(buffer, 32, &read_count)) {
            // buffer中存放读取到的内容
        }
        file.close();
    }
    
    f_mount(NULL, "", 1); // 卸载文件系统
    return 0;
}

内存优化注意事项

在内存极其有限的单片机上，还需要注意以下几点来进一步降低内存占用：

• 尽量使用局部变量，减少全局变量和静态变量的使用
• 文件读写缓冲区可以设置为512字节，刚好匹配SD卡扇区大小，避免额外的内存浪费
• 如果不需要长文件名支持，在ffconf.h中关闭_USE_LFN配置
• 避免在中断服务程序中调用文件操作函数，防止栈溢出

通过以上步骤，就可以在内存只有几KB的单片机上稳定实现SD卡文件的读写功能，满足嵌入式设备的存储需求。

C++FatFs单片机SD卡读写修改时间：2026-07-17 09:33:38