elm FatFS 升级到 R0.14b 1.00

发布于 2021-09-09 17:06:33 浏览：1922 订阅该版

[tocm]

## 前言

今天偶然间想看看 elm 的官网，然后发现了今年的新版本，其中有两个改动比较重要，就触发了我想升级的想法。
 > Fixed the file gets dead-locked when f_open() failed with some conditions. (appeared at R0.12a)
   Fixed f_mkfs() can create wrong exFAT volume due to a timing dependent error. (appeared at R0.12)

需要改动的文件有以下三个。

### ffconf.h

这个是配置文件，基本上是添加一些从 rtconfig.h 定义的宏进行适配
目标系统默认编码
```c
#define FF_CODE_PAGE	932
```
改为
```c
#ifdef RT_DFS_ELM_CODE_PAGE
#    define FF_CODE_PAGE	RT_DFS_ELM_CODE_PAGE
#else
#    define FF_CODE_PAGE	936
#endif
```

是否启用长文件名，不启用就是 8.3 格式
```c
#define FF_USE_LFN		0
#define FF_MAX_LFN		255
```
改为
```c
#if RT_DFS_ELM_USE_LFN
#define FF_USE_LFN 	RT_DFS_ELM_USE_LFN
#define FF_MAX_LFN 	RT_DFS_ELM_MAX_LFN
#else
#define	FF_USE_LFN	0		/* 0 to 3 */
#define	FF_MAX_LFN	255		/* Maximum LFN length to handle (12 to 255) */
#endif
```

长文件名编码格式，不启用长文件名时无效
```c
#define FF_LFN_UNICODE	0
```
改为
```c
#ifdef RT_DFS_ELM_LFN_UNICODE
#define FF_LFN_UNICODE	RT_DFS_ELM_LFN_UNICODE	/* 0:ANSI/OEM or 1:Unicode */
#else
#define	FF_LFN_UNICODE	0	/* 0:ANSI/OEM or 1:Unicode */
#endif
```

卷数量
```c
#define FF_VOLUMES		1
```
改为
```c
#ifdef RT_DFS_ELM_DRIVES
#define FF_VOLUMES RT_DFS_ELM_DRIVES
#else
#define FF_VOLUMES	1
#endif
```

最小最大块支持
```c
#define FF_MIN_SS		512
#define FF_MAX_SS		512
```
改为
```c
#define FF_MIN_SS		512
#ifdef RT_DFS_ELM_MAX_SECTOR_SIZE
#define FF_MAX_SS     RT_DFS_ELM_MAX_SECTOR_SIZE
#else
#define FF_MAX_SS		512		/* 512, 1024, 2048 or 4096 */
#endif
```

是否支持 exFAT
```c
#define FF_FS_EXFAT		0
```
改为
```c
#ifdef RT_DFS_ELM_USE_EXFAT
#define FF_FS_EXFAT	1
#else
#define FF_FS_EXFAT	0
#endif
```

可重入已经锁定义
```c
#define FF_FS_REENTRANT	0
#define FF_FS_TIMEOUT	1000
#define FF_SYNC_t		HANDLE
```
改为
```c
#ifdef RT_DFS_ELM_REENTRANT
#define FF_FS_REENTRANT	1		/* 0 or 1 */
#else
#define FF_FS_REENTRANT	0		/* 0:Disable or 1:Enable */
#endif
#define FF_FS_TIMEOUT	1000
#define FF_SYNC_t		rt_mutex_t
```

另外，还有几个特性宏，按照原来的修改成一样的值就可以了。

### ff.h

添加`“#include <rtthread.h>”`头文件引用。

添加如下函数声明。
```c
FRESULT f_seekdir(DIR *dj, int offset);                             /* Seek in directory */
```

### ff.c

`f_readdir` 函数实现之后添加 `f_seekdir` 的实现。
```c
FRESULT f_seekdir(
    DIR *dj,        /* Pointer to the open directory object */
    int offset      /* the seek offset */
)
{
    int i = 0;

if (dir_sdi(dj, 0) != FR_OK || offset < 0)
        return FR_INT_ERR;

while(i < offset)
    {
        if(dir_read(dj, 0) != FR_OK || dir_next(dj, 0) != FR_OK)
            return FR_INT_ERR;
        i++;
    }
    return FR_OK;
}
```

文件末尾添加 `elm_get_vol` 函数实现。
```c
#if FF_VOLUMES > 1
int elm_get_vol(FATFS *fat)
{
    int vol;

for (vol = 0; vol < FF_VOLUMES; vol ++)
    {
        if (FatFs[vol] == fat) return vol;
    }

return -1;
}
#endif
```

## 结尾

只修改这三个文件，覆盖掉原来的就可以，其它的文件都可以原样不动（建议把其它几个文件也复制过去）。
编译项目，完美通过。