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桁の16進数値としてフォーマットされます。

  • size: ファイルのサイズ（バイト単位）。開いたファイルの memoryview の長さから取得されます。

  • alignment: ファイルのアドレスが満たす最大の2の累乗のアラインメント（128、64、32、16、8、4 に対してチェックされます）。アドレスがこれらの境界のいずれにも揃っていない場合は、代わりに NOT aligned が出力されます。

  • name: /rom 内のファイル名。

この関数は引数を取らず、None を返します。