romfs --- أدوات ROMFS المساعدة

توفر الوحدة romfs أدوات مساعدة لفحص نظام الملفات للقراءة فقط (ROMFS) الذي يُركّبه برنامج OpenMV الثابت عند /rom. انظر العمل مع ROMFS للحصول على وصف شامل لنظام ملفات ROMFS نفسه، وكيف تُبنى الصور وتُنشر، وواجهتي vfs.VfsRom / vfs.rom_ioctl() الأساسيتين.

تركّز هذه الوحدة على التخطيط الفيزيائي لنظام ROMFS مُركّب بالفعل بدلًا من دلالات نظام الملفات الخاصة به. ولأن ملفات الشيفرة الثنائية .mpy في نظام ROMFS تُنفَّذ مباشرة من ذاكرة الفلاش (معيّنة في الذاكرة، بلا نسخ)، يحتاج MicroPython إلى محاذاة حمولة كل ملف إلى حدّ كافٍ -- عادةً 4 بايت لملفات .mpy العادية وحتى 16 بايت عندما يحتوي ملف على كتل شيفرة أصلية أو مراجع بيانات محاذاة. تُبلّغ ls_romfs() عن العنوان والحجم وأكبر محاذاة من قوى الاثنين لكل ملف بحيث يمكن فحص صورة منشورة بسرعة من REPL قبل الاعتماد على الاستيراد بلا نسخ.

الدوال

romfs.ls_romfs() → None

تسرد كل ملف موجود في نظام ROMFS المُركّب عند /rom وتطبع معلومات تشخيصية عن كل مدخل إلى stdout.

لكل ملف، تُطبع المعلومات التالية:

• addr: عنوان الذاكرة لبيانات الملف، مُقنَّعًا إلى 28 بت ومُنسَّقًا كقيمة ست عشرية من 8 أرقام.

• size: حجم الملف بالبايت، مُستخرَجًا من طول memoryview للملف المفتوح.

• alignment: أكبر محاذاة من قوى الاثنين (يُتحقق منها مقابل 128 و64 و32 و16 و8 و4) التي يحققها عنوان الملف. إذا لم يكن العنوان محاذيًا لأي من هذه الحدود، تُطبع NOT aligned بدلًا من ذلك.

• name: اسم الملف ضمن /rom.

لا تأخذ هذه الدالة أي معطيات وتُرجع None.