一、簡介

LittleFS是一個小型的Flash文件系統，它結合日志結構（log-structured）文件系統和COW（copy-on-write）文件系統的思想，以日志結構存儲元數據，以COW結構存儲數據。這種特殊的存儲方式，使LittleFS具有強大的掉電恢復能力（power-loss resilience)。分配COW數據塊時LittleFS采用了名為統計損耗均衡的動態損耗均衡算法，使Flash設備的壽命得到有效保障。同時LittleFS針對資源緊缺的小型設備進行設計，具有極其有限的ROM和RAM占用，并且所有RAM的使用都通過一個可配置的固定大小緩沖區進行分配，不會隨文件系統的擴大占據更多的系統資源。當在一個資源非常緊缺的小型設備上，尋找一個具有掉電恢復能力并支持損耗均衡的Flash文件系統時，LittleFS是一個比較好的選擇。

LittleFS在嵌入式開發過程中經常遇到，但是如何在OpenHarmony中使用呢？本文基于OpenHarmony 3.1Release + 小凌派-RK2206開發板做LittleFS文件系統移植，現將相關移植經驗發布，分享給大家。文中如有問題，請大家幫忙指正。

二、LittleFS移植過程

本文基于OpenHarmony3.1Release做LittleFS移植，小凌派-RK2206開發板內部Flash有8MB大小，其中4~8MB區間為空閑區域。我將4M~5M作為LittleFS文件系統的/data目錄掛載硬件設備。具體移植過程主要如下所示：

１、hcs配置

1.1、hdf.hcs

創建/device/soc/rockchip/rk2206/hcs_config/hdf.hcs文件，具體如下：

如上所述，我將在device_info/device_info.hcs添加LittleFS設備，并在fs/fs_config.hcs添加LittleFS具體信息。

1.2、BUILD.gn

新建//device/soc/rockchip/rk2206/hdf_config/BUILD.gn，具體代碼如下所示：

上述代碼將在編譯OpenHarmony3.1Rlease時，將編譯hdf.hcs。

1.3、device_info.hcs

創建/device/soc/rockchip/rk2206/hcs_config/device_info/device_info.hcs文件，在文件中添加LittleFS設備，具體代碼如下所示：

上述代碼表示建設一個設備驅動，該驅動的模塊名稱（即moduleName）為“HDF_PLATFORM_FS_LITTLEFS”，OpenHamrony系統依據該名稱匹配驅動程序；設備匹配信息（即deviceMatchAttr）添加小凌派開發板Flash特殊信息（比如：分區信息，掛載目錄名、起始地址、結束地址等）。

1.4、fs_config.hcs

新建//device/soc/rockchip/rk2206/hdf_config/fs/fs_config.hcs文件，該文件主要寫清楚設備掛載信息，具體如下：

如上所述，我將LittleFS移植所需的Flash信息分為4個：

（1）mount_points：掛載目錄。

（2）block_size：Flash的擦除塊大小。

（3）block_start：該掛載Flash區域的起始塊地址，實際Flash地址為block_size * block_start。

（4）block_count：該掛載Flash區域的存儲塊總數。

注意：match_attr所表示的字符串要與device_info.hcs所表示的字符串要一致。

２、hdf驅動

新建//device/soc/rockchip/rk2206/hdf_driver/fs文件夾，文件夾下創建2個文件，具體如下所示：

2.1、fs_driver.c

2.1.1、添加必要的頭文件

2.1.2、添加HDF驅動

添加LittleFS匹配的hdf驅動，具體代碼如下所示：

HDF_INIT(g_fsDriverEntry);

其中，moduleName必須要與device_info.hcs中的moduleName保持一致。

2.1.3、fs_driver_init函數

fs_driver_init為hdf驅動加載函數。OpenHarmony啟動時，將根據hcs的編寫匹配對應的驅動程序，并運行fs_driver_init函數。該函數負責：

（1）讀取hcs文件的配置參數。

（2）初始化Flash。

（3）適配LittleFS對應的read、write、erase和sync函數，并適配LittleFS相關參數。

（4）掛載LittleFS。

具體代碼如下所示：

2.2、BUILD.gn

BUILD.gn負責將fs_driver.c編譯到內核中，具體源代碼如下所示：

３、測試程序

我在main函數中添加一個任務，負責每隔5秒讀寫文件。具體代碼如下所示：

/* 文件系統測試 */

三、實驗結果

程序編譯燒寫到開發板后，按下開發板的RESET按鍵，通過串口軟件查看日志如下：