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 的次方對齊值(對照 12864321684 檢查)。若位址未對齊到這些邊界中的任何一個,則改為列印 NOT aligned

  • name/rom 中的檔案名稱。

此函式不接受任何引數並回傳 None