概述
Flash(閃存)是一種速度非常快的非易失性存儲設備,允許在操作中被多次擦或寫的存儲器,目前被廣泛應用于嵌入式設備中。 該組件是Flash VFS驅動子系統,目前支持Nor Flash 和 Nand Flash給應用或組件提供通過VFS形式(open/close/ioctl)訪問Flash設備驅動對上層提供服務的接口。該組件初始化過程中,會根據板子中定義的分區數量來依此創建如下名稱的設備節點:
/dev/flash0
/dev/flash1
...
/dev/flashN
組件支持以下功能:
從Flash設備某個分區的區域讀數據
向Flash設備某個分區的區域寫數據
擦除Flash設備某個分區的區域
獲取Flash設備的信息
打開或關閉Flash設備區域的安全功能
設置/清理/獲取Flash設備上的Boot信息
分區定義
操作Flash需要通過分區號作為Flash設備的索引,所以操作Flash設備前需要了解板子的分區配置。 AliOS Things的全部標準分區在components/drivers/peripheral/flash/include/aos/hal/flash.h中的hal_partition_t定義, 但是這些分區每個板子不一定全都配置了,具體需要參考板子的分區配置,hardware/board/目錄下的每個板子都會定義自己的分區在hal_partitions數組中。 比如haas100的分區配置在hardware/board/haas100/config/partition_conf.c 的hal_partitions。
版權信息
Apache license v2.0
目錄結構
flash/
|-- example
| |-- flash_example.c # Flash示例代碼
|-- include
| |-- aos
| | |-- hal
| | |-- flash.h # Flash HAL API申明
| |-- vfsdev
| |-- flash_dev.h # Flash設備API申明
|-- package.yaml #編譯及配置文件
|-- README.md #README文檔
|-- src
|-- flash_dev.c #Flash設備子系統實現
依賴組件
base # 最底層核心驅動模型、驅動自動加載機制以及Device VFS core
vfs # VFS API抽象庫
epoll # 增強型多路復用IO接口 - epoll機制所在庫
API說明
使用示例
組件使用示例相關的代碼下載、編譯和固件燒錄均依賴AliOS Things配套的開發工具,所以首先需要參考《AliOS Things集成開發環境使用說明之搭建開發環境》,下載安裝。 待開發環境搭建完成后,可以按照以下步驟進行示例的測試。
步驟1 創建或打開工程
打開已有工程
如果用于測試的案例工程已存在,可參考《AliOS Things集成開發環境使用說明之打開工程》打開已有工程。
創建新的工程
組件的示例代碼可以通過編譯鏈接到AliOS Things的任意案例(solution)來運行,這里選擇helloworld_demo案例。helloworld_demo案例相關的源代碼下載可參考《AliOS Things集成開發環境使用說明之創建工程》。
步驟2 添加組件
案例下載完成后,需要在helloworld_demo組件的package.yaml中添加對組件的依賴:
depends:
- flash: dev_aos # helloworld_demo中引入flash組件
步驟3 下載組件
在已安裝了 的開發環境工具欄中,選擇Terminal -> New Terminal啟動終端,并且默認工作路徑為當前工程的workspace,此時在終端命令行中輸入:
aos install flash
上述命令執行成功后,組件源碼則被下載到了./components/flash路徑中。
步驟4 添加示例
在flash組件的package.yaml中添加example示例代碼:
source_file:
- src/*.c
- example/flash_example.c
- example/mtd_example.c
步驟5 編譯固件
在示例代碼已經添加至組件的配置文件,并且helloworld_demo已添加了對該組件的依賴后,就可以編譯helloworld_demo案例來生成固件了,具體編譯方法可參考《AliOS Things集成開發環境使用說明之編譯固件》。
步驟6 燒錄固件
helloworld_demo案例的固件生成后,可參考《AliOS Things集成開發環境使用說明之燒錄固件》來燒錄固件。
步驟7 打開串口
固件燒錄完成后,可以通過串口查看示例的運行結果,打開串口的具體方法可參考《AliOS Things集成開發環境使用說明之查看日志》。
當串口終端打開成功后,可在串口中輸入help來查看已添加的測試命令。
步驟8 測試示例
CLI命令行輸入:
flash_example <分區號> # 執行flash示例
關鍵日志:
vfs_flash_test success!
注意事項
建議應用通過文件系統來讀取或寫入文件,或者通過KV組件提供的接口操作Flash, 不要直接使用Flash驅動子系統提供的接口直接操作Flash。 因為直接操作裸的Flash需要應用自身考慮磨損平衡,壞塊管理等功能,否則可能導致Flash損壞。另外一些設備的認證信息,WIFI MAC,出廠信息等也存在Flash中,如果直接操作Flash不當,可能導致這些信息丟失,造成設備不可用。