基于FreeRTOS与MQTT的物联网技术应用系列——步进电机控制（三）SD卡驱动、FatFS等的移植和ini配置文件读取的实现

关注

VIP免费原创最新推荐文章于 2026-04-15 09:37:22 发布 2.1k 阅读 AI 写同款· GEO 优化 ›

STM32+FreeRTOS基于SD卡与FatFS的配置文件管理实践在嵌入式系统开发中，参数配置管理是影响设备灵活性与维护效率的关键环节。传统将参数写死在固件中的方式，在批量部署和现场调试时往往效率低下。通过引入文件系统，将配置参数外置到SD卡中，并采用轻量级的ini格式进行存储，既能实现参数免编译修改，又提升了系统的可维护性。文章从文件系统在单片机中的基础应用切入，详细阐述FatFS的移植要点、SD卡驱动对接以及ini解析器设计原理，并结合FreeRTOS任务调度特性，分析多任务环境下文件访问的互斥与时间戳处理方案。该技术路径在STM32平台上成功驱动步进电机控制，展示了阅读详情

本文实现了基于STM32F107VC的金牛开发板的基于SPI模式的SD卡驱动和FatFS的移植，以及利用minini库对ini配置信息文件进行读取。

因为后面连接网络需要相关配置参数，而且可能随时发生变化，这些参数不可能固定在程序中，所以，我们现在把它放在sd卡中，以便随时更改。

IDE环境为: MDK v5.23
硬件环境：基于STM32F107VC的金牛开发板

一、添加SD卡驱动代码、移植FatFS

为了节省时间，就不造轮子了，直接使用网上共享的spi和sd驱动代码、FatFS源代码。
这部分源代码摘自：
STM32_SD_FATFS_LCD_TOUCH
备用地址：STM32_SD_FATFS_LCD_TOUCH

把这个源代码下来,解压。
把STM32_SD_FATFS_LCD_TOUCH.rar\User\SD_CARD\src 目录下的spi.c、sdcard.c文件和
STM32_SD_FATFS_LCD_TOUCH.rar\User\SD_CARD\inc 目录下的spi.h、sdcard.h文件都复制到我们工程的BSP目录下，并把spi.c、sdcard.c加入工程的BSP组。

在spi.h中加入：

#include "stm32f10x_spi.h"

然后下载FatFS官方源码：
http://elm-chan.org/fsw/ff/arc/ff13.zip

解压后重命名整个文件夹为FatFS，并把它复制到我们工程的third_party目录下。

在IDE上添加一个组，名字为：third_party/FatFS，添加third_party/FatFS/source目录下的diskio.c、ff.c这两个文件。
其中ff.c是具体fat文件系统的实现，diskio.c是文件系统硬件驱动接口实现。

接下来，把STM32_SD_FATFS_LCD_TOUCH.rar\User\fatfs 目录下的diskio.h和diskio.c文件复制到third_party/FatFS/Source下面来，覆盖原同名文件。

这样就直接使用来源于网上的SD卡驱动接口实现了。

然后，把third_party/FatFS/source这个路径添加到IDE的包含路径中。
编译一下可以通过。

移植完了。写个demo测试一下。

首先参考网上的例程，写一个fatfs测试代码，主体放在common.h和common.c中：

common.h

#ifndef _COMMON_H_
#define _COMMON_H_  1

#include "stm32f10x.h"

#define FI 1
#define DI 2

/* Values magic to the Board keys */
#define  NOKEY  0
#define  KEY1   1
#define  KEY2   2
#define  KEY3   3
#define  KEY4   4

#define RCC_KEY1                                    RCC_APB2Periph_GPIOD
#define GPIO_KEY1_PORT                              GPIOD    
#define GPIO_KEY1                                   GPIO_Pin_3

#define RCC_KEY2                                    RCC_APB2Periph_GPIOA
#define GPIO_KEY2_PORT                              GPIOA  
#define GPIO_KEY2                                   GPIO_Pin_8

#define RCC_KEY3                                    RCC_APB2Periph_GPIOC
#define GPIO_KEY3_PORT                              GPIOC    
#define GPIO_KEY3                                   GPIO_Pin_13 

#define RCC_KEY4                                    RCC_APB2Periph_GPIOA
#define GPIO_KEY4_PORT                              GPIOA    
#define GPIO_KEY4                                   GPIO_Pin_0 

#define GPIO_KEY_ANTI_TAMP                          GPIO_KEY3
#define GPIO_KEY_WEAK_UP                            GPIO_KEY4


uint8_t GetKey(void);
void Sys_Soft_Reset(void);
void get_file_name(uint8_t *file_name,uint8_t length,uint8_t type);
uint8_t check_file_name(uint8_t *file_name,uint8_t length);

void format_disk(void);
void creat_file(void);
void delete_file(void);
void list_file(void);
void get_disk_info(void);
void creat_dir(void);
void edit_file(void);
void read_file(void);


int InitMQTTServerInfo(void);

#endif

common.c

#include "spi.h"
#include "common.h"
#include <stdio.h>
#include <stdlib.h>
#include "ff.h"
#include "integer.h"
#include "diskio.h"
#include <string.h>
#include "FreeRTOS.h"
#include "serial.h"

//#define _DEBUG
#include "dprintf.h"

/* Handle to the com port used by both tasks. */
static xComPortHandle xPort = NULL;

/* The Rx task will block on the Rx queue for a long period. */
#define comRX_BLOCK_TIME            ( ( TickType_t ) 0xffff )



void edit_file(void)
{
    FATFS fs;
    FIL file;
    FRESULT res; 
    DIR dirs;
    FILINFO finfo;
    signed char key = 0;
    char path[20];

    uint32_t index = 0x00;
    uint32_t reindex = 0x00;
    uint8_t file_buff[512] = {0};

    uint32_t files_num = 0;
    uint8_t length;
    res = f_mount(&fs,"",0);
    if (res != FR_OK)
    {
        printf("\r\n¹ÒÔØÎÄ¼þÏµÍ³Ê§°Ü,´íÎó´úÂë: %u",res);
        return;
    }
    res = f_opendir(&dirs,"/");
    printf("\r\n------------ÎÄ¼þÁÐ±í------------");
    if (res == FR_OK) 
    {
        while ((f_readdir(&dirs, &finfo) == FR_OK) && finfo.fname[0]) 
        {
            if (finfo.fattrib & AM_DIR)//Èç¹ûÊÇÎÄ¼þ¼Ð 
            { 
                continue;
            } 
            else 
            {   
                files_num++;
                //ÏÔÊ¾ÎÄ¼þÃû,ÏÔÊ¾ÎÄ¼þÊµ¼Ê´óÐ¡ ,ÎÄ¼þÊµ¼Ê´óÐ¡²ÉÓÃËÄÉáÎåÈë·¨
                printf("\r\n/%12s%7ld KB ",  &finfo.fname[0],(finfo.fsize+512)/1024);
            }
        }
        if( files_num == 0 )//ÎÞÎÄ¼þ
        {
            printf("\r\nÎÞÎÄ¼þ!");    
        }
    }
    else
    {
        printf("\r\n´ò¿ª¸ùÄ¿Â¼Ê§°Ü!");
        printf("\r\n´íÎó´úÂë: %u",res);
    }
    printf("\r\nÊäÈëÒª±à¼ÎÄ¼þÈ«Ãû,ÒÔ»Ø³µ½áÊø...");
    get_file_name((uint8_t *)path,length,FI);
    res = f_open(&file,path,FA_READ | FA_WRITE);
    if (res == FR_OK)
    {   
        printf("\r\n´ò¿ªÎÄ¼þ %s ³É¹¦",path);
        printf("\r\nÏÖÔÚÊÇÎÄ¼þ±à¼×´Ì¬,ÇëÊäÈëÒªÐ´ÈëµÄÊý¾Ý!");       
        printf("\r\n°´ESC»òÕßCtrl+C½áÊø±à¼!\r\n");

        while(1)
        {       
            if(xSerialGetChar( xPort, &key, comRX_BLOCK_TIME )== pdFALSE)  
            {
                continue;
            }

            if ((key == 0x1B) && (index == 0x00))//key ESC
            {
                printf("\r\nÊý¾Ý»¹Ã»ÓÐÊäÈë,ÏÖÔÚ´¦ÓÚ±à¼Ä£Ê½...");                               
                continue;
            }
            else if ((key == 0x1B)) //key ESC
            {
                printf("\r\n±£´æÊý¾Ý...");
                res = f_write(&file,file_buff,index,&reindex);
                if ((res == FR_OK) && (reindex == index))
                {
                    printf("\r\n±£´æÊý¾Ý³É¹¦!");
                    f_close(&file);
                    index = 0x00;
                    reindex = 0x00;                                 
                }
                else
                {
                    printf("\r\n±£´æÊý¾ÝÊ§°Ü!");
                    printf("\r\n´íÎó´úÂë: %u",res);                                 
                }
                break;
            }
            else if (key == 0x03) //key Ctrl+C
            {
                printf("\r\n½áÊøÎÄ¼þ±à¼!");
                printf("\r\n±£´æÊý¾Ý...");
                res = f_write(&file,file_buff,index,&reindex);
                if ((res == FR_OK) && (reindex == index))
                {
                    printf("\r\n±£´æÊý¾Ý³É¹¦!");
                    f_close(&file);
                    index = 0x00;
                    reindex = 0x00;                                 
                }
                else
                {
                    printf("\r\n±£´æÊý¾ÝÊ§°Ü!");
                    printf("\r\n´íÎó´úÂë: %u",res);                                 
                }
                break;
            }
            else if ((key < 0x21) || (key > 0x80))
            {
                continue;
            }
            else
            {
                file_buff[index++] = key;
                printf(