romfs — Utilidades auxiliares de ROMFS

El módulo romfs proporciona utilidades auxiliares para inspeccionar el sistema de archivos de solo lectura (ROMFS) que el firmware de OpenMV monta en /rom. Consulte Trabajar con ROMFS para una descripción completa del propio sistema de archivos ROMFS, de cómo se construyen y despliegan las imágenes, y de las API subyacentes vfs.VfsRom / vfs.rom_ioctl().

Este módulo se centra en la disposición física de un ROMFS ya montado, más que en su semántica de sistema de archivos. Dado que los archivos de bytecode .mpy de un ROMFS se ejecutan directamente desde la memoria flash (mapeados en memoria, sin copia), MicroPython necesita que la carga útil de cada archivo esté alineada a un límite suficiente – normalmente 4 bytes para archivos .mpy simples y hasta 16 bytes cuando un archivo contiene blobs de código nativo o referencias a datos alineados. ls_romfs() informa de la dirección, el tamaño y la mayor alineación en potencia de dos de cada archivo, de modo que una imagen desplegada pueda verificarse rápidamente desde el REPL antes de confiar en importaciones sin copia.

Funciones

romfs.ls_romfs() → None

Lista todos los archivos presentes en el ROMFS montado en /rom e imprime información de diagnóstico sobre cada entrada en stdout.

Para cada archivo se imprime la siguiente información:

  • addr: La dirección de memoria de los datos del archivo, enmascarada a 28 bits y formateada como un valor hexadecimal de 8 dígitos.

  • size: El tamaño del archivo en bytes, obtenido de la longitud de un memoryview del archivo abierto.

  • alignment: La mayor alineación en potencia de dos (comprobada frente a 128, 64, 32, 16, 8, 4) que cumple la dirección del archivo. Si la dirección no está alineada a ninguno de estos límites, se imprime NOT aligned en su lugar.

  • name: El nombre del archivo dentro de /rom.

Esta función no recibe argumentos y devuelve None.