概述
ramfs是AliOS Things提供的基于RAM不依賴flash驅動的可讀可寫的文件系統。和ROMFS的區別在于ROMFS為只讀,RAMFS可讀寫。 主要特性包括:
不依賴flash設備和驅動
可讀寫創建文件等
掉電不保存
版權信息
Apache license v2.0
目錄結構
├── src
│ ├── ramfs_adapt.c # ramfs和內核的對接層
│ ├── ramfs.c # ramfs核心代碼
│ └── ramfs_vfs.c # ramfs和vfs對接層
├── package.yaml # 編譯配置文件
├── example # 示例代碼
├── include # 對外頭文件
│ └── ramfs.h
└── internal # 內部頭文件
依賴組件
osal_aos
常用配置
無
API說明
參考 ramfs_aos_api注:ramfs本身只提供注冊去注冊接口;其他文件操作接口統一使用vfs接口/posix接口。
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具 alios-studio ,所以首先需要參考《aos-studio使用說明之搭建開發環境》,下載安裝 alios-studio 。 待開發環境搭建完成后,可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
如果用于測試的案例工程已存在,可參考《aos-studio使用說明之打開工程》打開已有工程。
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例(solution)來運行,這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《aos-studio使用說明之創建工程》。
步驟2 添加組件
案例下載完成后,需要在helloworld_demo組件的package.yaml中添加對組件的依賴:
depends:
- ramfs: dev_aos # helloworld_demo中引入ramfs組件
步驟3 下載組件
在已安裝了 alios-studio 的開發環境工具欄中,選擇Terminal -> New Terminal啟動終端,并且默認工作路徑為當前工程的workspace,此時在終端命令行中輸入:
aos install ramfs
上述命令執行成功后,組件源碼則被下載到了./components/ramfs路徑中。
步驟4 添加示例
ramfs組件的package.yaml中添加example
source_file:
- example/*.c
步驟5 編譯固件
在示例代碼已經添加至組件的配置文件,并且helloworld_demo已添加了對該組件的依賴后,就可以編譯helloworld_demo案例來生成固件了,具體編譯方法可參考《aos-studio使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后,可參考《aos-studio使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后,可以通過串口查看示例的運行結果,打開串口的具體方法可參考《aos-studio使用說明之查看日志》。
當串口終端打開成功后,可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入:
ramfs_example
關鍵日志
CLI日志:
ramfs: fd test success!
ramfs comp test success!
注意事項
ramfs_register是ramfs的初始化接口,用戶可自定義根路徑,默認為"/RAMFS"; ramfs需要對接vfs使用,對外統一使用標準的open/read/write/close接口;