romfs — Pomocné nástroje ROMFS

Modul romfs poskytuje pomocné nástroje pro inspekci souborového systému určeného pouze pro čtení (ROMFS), který firmware OpenMV připojuje na /rom. Viz Práce s ROMFS pro úplný popis samotného souborového systému ROMFS, způsobu sestavování a nasazování obrazů a podkladových API vfs.VfsRom / vfs.rom_ioctl().

Tento modul se zaměřuje na fyzické rozložení již připojeného ROMFS spíše než na jeho sémantiku souborového systému. Protože bytecode soubory .mpy v ROMFS jsou spouštěny přímo z flash paměti (mapované do paměti, bez kopírování), MicroPython potřebuje, aby užitečné zatížení každého souboru bylo zarovnáno na dostatečnou hranici – typicky 4 bajty pro prosté soubory .mpy a až 16 bajtů, když soubor obsahuje bloby nativního kódu nebo zarovnané datové odkazy. ls_romfs() hlásí adresu, velikost a největší zarovnání na mocninu dvou každého souboru, takže lze nasazený obraz před spolehnutím se na importy bez kopírování zkontrolovat z REPL.

Funkce

romfs.ls_romfs() None

Vypíše každý soubor přítomný v ROMFS připojeném na /rom a vytiskne diagnostické informace o každé položce na stdout.

U každého souboru jsou vytisknuty následující informace:

  • addr: Adresa v paměti dat souboru, maskovaná na 28 bitů a formátovaná jako 8místná hexadecimální hodnota.

  • size: Velikost souboru v bajtech, získaná z délky objektu memoryview otevřeného souboru.

  • alignment: Největší zarovnání na mocninu dvou (kontrolováno proti 128, 64, 32, 16, 8, 4), které adresa souboru splňuje. Pokud adresa není zarovnána na žádnou z těchto hranic, vytiskne se místo toho NOT aligned.

  • name: Název souboru v rámci /rom.

Tato funkce nepřijímá žádné argumenty a vrací None.