romfs — כלי עזר ל-ROMFS

המודול romfs מספק כלי עזר לבחינת מערכת הקבצים לקריאה בלבד (ROMFS) שקושחת OpenMV מעגנת ב-/rom. ראו עבודה עם ROMFS לתיאור מקצה-לקצה של מערכת הקבצים ROMFS עצמה, אופן בניית התמונות ופריסתן, וממשקי ה-API הבסיסיים vfs.VfsRom / vfs.rom_ioctl().

מודול זה מתמקד בפריסה הפיזית של ROMFS שכבר מעוגן ולא בסמנטיקת מערכת הקבצים שלו. מאחר וקובצי bytecode מסוג .mpy ב-ROMFS מורצים ישירות מזיכרון הפלאש (flash) (ממופי-זיכרון, zero copy), MicroPython זקוק לכך שה-payload של כל קובץ יהיה מיושר לגבול מספיק – בדרך כלל 4 בתים עבור קובצי .mpy רגילים ועד 16 בתים כאשר קובץ מכיל blobs של קוד מקורי או הפניות לנתונים מיושרים. ls_romfs() מדווחת על הכתובת, הגודל והיישור הגדול ביותר בחזקת שתיים של כל קובץ כך שניתן לבדוק תמונה שנפרסה מתוך ה-REPL לפני שמסתמכים על ייבוא zero-copy.

פונקציות

romfs.ls_romfs() None

מפרטת כל קובץ הקיים ב-ROMFS המעוגן ב-/rom ומדפיסה מידע אבחוני על כל רשומה ל-stdout.

עבור כל קובץ, המידע הבא מודפס:

  • addr: כתובת הזיכרון של נתוני הקובץ, ממוסכת ל-28 ביט ומעוצבת כערך הקסדצימלי בן 8 ספרות.

  • size: גודל הקובץ בבתים, המתקבל מאורכו של memoryview של הקובץ הפתוח.

  • alignment: היישור הגדול ביותר בחזקת שתיים (הנבדק מול 128, 64, 32, 16, 8, 4) שכתובת הקובץ מקיימת. אם הכתובת אינה מיושרת לאף אחד מגבולות אלה, NOT aligned מודפס במקום זאת.

  • name: שם הקובץ בתוך /rom.

פונקציה זו אינה מקבלת ארגומנטים ומחזירה None.