romfs --- ROMFS 輔助工具¶
romfs 模組提供輔助工具,用於檢視 OpenMV 韌體掛載於 /rom 的唯讀檔案系統(ROMFS)。關於 ROMFS 檔案系統本身、映像如何建置與部署,以及底層 vfs.VfsRom / vfs.rom_ioctl() API 的端對端說明,請參閱 使用 ROMFS。
本模組著重於已掛載 ROMFS 的實體佈局,而非其檔案系統語意。由於 ROMFS 中的 .mpy 位元組碼檔案是直接從快閃記憶體執行(記憶體對映、零複製),MicroPython 需要每個檔案的酬載對齊到足夠的邊界 -- 一般的 .mpy 檔案通常為 4 位元組,而當檔案包含原生程式碼區塊或對齊的資料參照時最多可達 16 位元組。ls_romfs() 會回報每個檔案的位址、大小與最大的 2 的次方對齊值,如此一來在依賴零複製匯入之前,便可從 REPL 對已部署的映像進行抽查。
函式¶
- romfs.ls_romfs() None¶
列出掛載於
/rom的 ROMFS 中存在的每個檔案,並將每個項目的診斷資訊列印至stdout。對於每個檔案,會列印下列資訊:
addr:檔案資料的記憶體位址,遮罩為 28 位元並格式化為 8 位數的十六進位值。size:以位元組計的檔案大小,由開啟檔案之memoryview的長度取得。alignment:檔案位址所滿足的最大 2 的次方對齊值(對照128、64、32、16、8、4檢查)。若位址未對齊到這些邊界中的任何一個,則改為列印NOT aligned。name:/rom中的檔案名稱。
此函式不接受任何引數並回傳
None。