YAFFS2移植到AliOS Things指南

YAFFS2介绍

YAFFS（Yet Another Flash File System）是第一个专门为NAND Flash存储器设计的嵌入式文件系统，适用于大容量的存储设备。YAFFS 是基于日志的文件系统，提供磨损平衡和掉电恢复的健壮性。它还为大容量的Flash 芯片做了很好的调整，针对启动时间和RAM 的使用做了优化。它适用于大容量的存储设备，Yaffs代码已成功用于许多不同的32位和64位CPU，包括MIPS，68000，ARM，ColdFire，PowerPC和x86，甚至被用于各种DSP架构芯片。

目前有YAFFS和YAFFS2两个版本，YAFFS1和YAFFS2主要差异在于PAGE读写size的大小，YAFFS2可支持到2K Bytes page, 远高于YAFFS的512 Bytes, 因此对大容量NAND Flash更具优势。YAFFS2是目前NAND Flash的首选文件系统。

YAFFS2具有如下特点：

1. 使用C代码编写，支持大端和小端处理器，易于移植。
2. 提供nand flash坏块处理机制和ECC校验算法，可发现并纠正一定量的位翻转。
3. 采用日志式文件系统设计，异常掉电不会造成文件系统破坏，掉电后恢复速度快。
4. 拥有高度优化和可预测的垃圾收集策略，具有优异的性能和高度的确定性。
5. 比大多数日志式文件系统具有更低的内存占用。
6. 支持POSIX接口，易于使用。

YAFFS2移植 1. YAFFS2源码获取

官方网站：https://yaffs.net/get-yaffs

代码分为如下几部分：

A、核心文件系统代码，位于yaffs2目录下

文件说明yaffs_allocator.c分配Yaffs对象和tnode结构yaffs_bitmap.cblock和chunk相关处理yaffs_ecc.cecc校验相关代码yaffs_guts.cyaffs主要算法affs_nameval.c用于处理扩展属性（xattr）的名称/值代码。yaffs_nand.cnand flash抽象接口文件yaffs_packedtags1.cyaffs1的tag相关定义代码yaffs_packedtags2.cyaffs2的tag相关定义代码yaffs_summary.c处理块信息相关代码yaffs_tagscompat.c兼容yaffs1模式的tag相关代码yaffs_tagsmarshall.c标记编组代码yaffs_verify.c校验相关代码yaffs_yaffs1.cyaffs1模式相关代码yaffs_yaffs2.cyaffs2模式相关代码

B、直接接口文件，位于yaffs2/direct目录下

文件说明yaffs_attribs.c属性处理代码yaffs_error.c错误报告代码yaffsfs.cYaffs直接接口封装代码yaffs_hweight.c字节使用频率统计代码yaffs_qsort.cyaffs2扫描使用到的qsort代码

C、flash驱动程序示例，以及用于测试的模拟器和配置，位于yaffs2/direct/ test-framework目录下

D、相关测试用例，位于其他目录下

详见官方文档：https://yaffs.net/documents/yaffs-direct-interface

2. 添加文件

将如下文件拷贝到AliOS-Things/kernel/modules/fs/yaffs2目录下，并编写相应makefile或者添加到相应的工程。

a) 这些文件在位于源码的yaffs2和yaffs2/direct目录下。b) yportenv.h、yaffs_attribs.c文件有多个，前者使用direct目录下版本，后者使用yaffs2目录下版本。c) yaffs_alios.c、yaffs_install_drv.c、yaffs_install_drv.h这三个文件用于适配AliOS-Things和驱动，见kernel/modules/fs/yaffs2目录。

3. 代码适配 3.1 增加相应数据和函数定义

a) yportenv.h增加如下代码：

#define CONFIG_YAFFS_DIRECT
#define CONFIG_YAFFS_PROVIDE_DEFS
#define CONFIG_YAFFSFS_PROVIDE_VALUES
#define CONFIG_YAFFS_DEFINES_TYPES

#define inline  RHINO_INLINE

typedef long off_t;
typedef unsigned long loff_t;
typedef long dev_t;
typedef int mode_t;

b) yaffsfs.c增加如下代码：

unsigned int yaffs_trace_mask = 0;

unsigned int strnlen(const char *s, unsigned int max) {
        register const char *p;
        for(p = s; *p && max--; ++p);
        return(p - s);
    }

c) yaffs_list.h增加如下代码：

#define inline  RHINO_INLINE

3.2 对接操作系统

与AliOS-Things适配的操作系统接口已经实现好，直接包含yaffs_alios.c即可。

该文件中实现了yaffsfs_Lock、yaffsfs_Unlock、yaffsfs_CurrentTime、yaffsfs_malloc、yaffsfs_free等函数的对接，另外还创建了一个用于yaffs的后台任务。

yaffsfs_CheckMemRegion函数用于检查内存地址是否有效，需用户自己根据具体硬件补充实现。

操作系统接口函数列表如下：

void yaffsfs_Lock(void)；
void yaffsfs_Unlock(void)；
u32 yaffsfs_CurrentTime(void)；
int yaffsfs_GetLastError(void)；
void yaffsfs_SetError(int err)；
void *yaffsfs_malloc(size_t size)；
void yaffsfs_free(void *ptr)；
void yaffsfs_OSInitialisation(void)；
void yaffs_bug_fn(const char *file_name, int line_no)；
int yaffsfs_CheckMemRegion(const void *addr, size_t size, int write_request)；

3.3 对接nand flash驱动

yaffs_install_drv.c用于yaffs对接nand flash驱动，用户需根据硬件配置param中的参数，并实现如下驱动函数：

static int nand_WriteChunk(struct yaffs_dev *dev, int nand_chunk,
                   const u8 *data, int data_len,
                   const u8 *oob, int oob_len);
static int nand_ReadChunk(struct yaffs_dev *dev, int nand_chunk,
                   u8 *data, int data_len,
                   u8 *oob, int oob_len,
                   enum yaffs_ecc_result *ecc_result);
static int nand_EraseBlock(struct yaffs_dev *dev, int block_no);
static int nand_MarkBad(struct yaffs_dev *dev, int block_no);
static int nand_CheckBad(struct yaffs_dev *dev, int block_no);
static int nand_Initialise(struct yaffs_dev *dev);

完成以上步骤即完成YAFFS2的移植。

扫码获取更多资讯：