פריסה של GBL

בדף הזה מוסבר איך פורסים את קובץ ה-GBL (Generic Bootloader) הבינארי.

הדרישות לגבי קושחת האתחול

כדי להשתמש ב-GBL, קושחת האתחול צריכה לעמוד בדרישות הבאות:

  • תאימות ל-Unified Extensible Firmware Interface‏ (UEFI). הקושחה צריכה להטמיע ולהשתמש בפרוטוקולי UEFI הנדרשים. הקושחה צריכה גם לאפשר שימוש בתוספים ספציפיים לספק באמצעות פרוטוקולי UEFI מוגדרים.

  • אבטחה. הקושחה צריכה ליישם את כל הדרישות של Android Verified Boot ‏ (AVB), כדי לאפשר ל-GBL לאמת תמונות אתחול.

  • מצבי הפעלה. קובץ הבינארי צריך להיות מסוגל לטפל במצבי אתחול שונים, כמו אתחול רגיל, אתחול לשחזור ואתחול מהיר.

  • חלוקה דינמית למחיצות. קושחת האתחול צריכה להטמיע לוגיקה של בחירת משבצת כדי לתמוך בקריאה של משבצת האתחול הנכונה מסוג A/B, ולהיות תואמת למחיצות דינמיות ולנתוני משתמשים ב-super.

  • הגדרת מערכת ההפעלה. הקושחה צריכה להיות מסוגלת לשנות את שורת הפקודה של ליבת המערכת, את עץ המכשיר (DTB) ואת bootconfig עם התאמות אישיות של OEM שנדרשות להפעלת המכשיר.

  • מכונה וירטואלית מוגנת בטעינה. הקובץ הבינארי צריך לטעון בצורה נכונה קושחת מכונה וירטואלית מוגנת שאומתה מראש לפני ליבת Android, בנוכחות מכונות וירטואליות מוגנות. מידע נוסף זמין במאמר בנושא רצף האתחול של Microdroid.

  • ניהול זיכרון. קושחת האתחול צריכה לתמוך בממשק ה-API של הקצאת זיכרון UEFI.

דרישות הטמעה

כדי להטמיע את GBL בצורה נכונה במכשיר, אתם צריכים לעמוד בדרישות הבאות:

  • המכשיר צריך להכיל שתי מחיצות FAT32 בגודל של 4 MB (או יותר) בשמות android_esp_a ו-android_esp_b במכשיר בלוק שניתן לגשת אליו על ידי ה-SOC.

    • מכשיר בלוק הוא מכשיר אחסון שאפשר לקרוא ממנו או לכתוב בו ביחידות של בלוקים. דוגמאות: מכשירי UFS,‏ eMMC וכרטיסי SD.
    • נעשה שימוש ב-FAT32 כי זו מערכת קבצים נפוצה ופשוטה.
    • שתי המחיצות נדרשות לעדכונים ולהחזרות לגרסה קודמת (rollback) דרך האוויר (OTA) למשך חלון התמיכה של גרסת Android הזו.
    • הגודל של GBL הוא בערך 2 MB לא דחוס. נפח של 4 MB מספיק כדי להביא בחשבון את הצמיחה הצפויה כתוצאה מהוספת תכונות במהלך שבע השנים הבאות.
    • במקרה של עדכון ב-GBL, צריך לעדכן את כל המחיצה android_esp_${SLOT_SUFFIX}. עדכון GBL בלבד לא נתמך על ידי Android OTA.

  • הגרסה של GBL שמוטמעת חייבת להיות הגרסה העדכנית ביותר של סביבת הייצור שאושרה על ידי הענף המתאים של GBL. מומלץ לחתום על העותק המאושר על ידי Google של GBL באמצעות פתרון החתימה המועדף ולאחסן את המטא-נתונים של ה-build והחתימה שנוצרו בתוך מחיצת android_esp_${SLOT_SUFFIX}.

    • חתימת ה-OEM לא יכולה לשנות את אישור ה-GBL, ולא יכולה להוסיף כותרת לקובץ הבינארי.
    • גרסת ה-GBL של המפתח משמשת אך ורק למטרות פיתוח וניפוי באגים. אי אפשר לשלוח את הגרסה הזו והיא לא תאושר על ידי Google.

  • צריך לאחסן את קובץ ה-GBL בנתיב /EFI/BOOT/BOOTAA64.EFI במחיצת FAT32.

  • כדי לתמוך ב-GBL, צריך להטמיע את פרוטוקולי ה-UEFI ו-Android UEFI הנדרשים. אם הממשקים האלה לא נתמכים, אי אפשר להפעיל את גרסת הייצור של GBL.

    • ‫EFI_BLOCK_IO_PROTOCOL או EFI_BLOCK_IO2_PROTOCOL מאחזרים את תמונות האתחול ואת תמונות pvmfw מהדיסק
    • ‫EFI_RNG_PROTOCOL עבור קנריות מחסנית, זרעי KASLR וזרעי RNG
    • שירותים להקצאת זיכרון להקצאת זיכרון זמני לביצוע חישובים של AVB ו-DICE
    • ‫EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL מספקת אפשרות להטמעות ללא פעולה, אבל GBL מתעדת ביומן באמצעות הפרוטוקול הזה כברירת מחדל
    • ‫GBL_EFI_AVB_PROTOCOL ניגש למפתחות ציבוריים ולמדדי חזרה כדי לאמת תמונות אתחול
    • ‫GBL_EFI_BOOT_CONTROL_PROTOCOL רוכש מטא-נתונים של משבצות וסיבות לאתחול מהקושחה
    • ‫GBL_EFI_AVF_PROTOCOL יוצר נתוני הגדרה של AVF משרשרת ה-DICE

  • פרוטוקולי ה-UEFI שמומלצים מאוד לשילוב GBL מתועדים במאמר פרוטוקולי GBL UEFI.

תמיכה בקושחה של אתחול

ההטמעות הבאות של קושחת UEFI פועלות עם GBL, אחרי שמבצעים בהן את השינויים הנדרשים כדי לתמוך בדרישות שצוינו בקטע הקודם:

  • ‫EDK2 (Tianocore). EDK2 היא הטמעה פופולרית של UEFI בקוד פתוח. נדרשת תמיכה ב-GBL עבור טועני אתחול (bootloaders) שמבוססים על EDK2, ותמיכה ב-UEFI כבר קיימת.
  • U-Boot. פרויקט גמיש ופופולרי של טוען אתחול בקוד פתוח, שמתרחבת בו התאימות ל-UEFI לשימוש ב-GBL.
  • ‫LittleKernel‏ (LK). תוכנת אתחול בקוד פתוח שמשמשת חלק מהספקים.

הפעלת GBL

אתם יכולים להשיג קובץ בינארי של GBL שמוכן להפעלה, או ליצור קובץ משלכם ולהפעיל אותו.

השגת הקובץ הבינארי של GBL והרצתו

‫GBL מופץ כקובץ בינארי יחיד של אפליקציית UEFI. אפשר לעדכן את הקובץ הבינארי הזה בנפרד מהקושחה הבסיסית של המכשיר באמצעות מנגנון העדכון הרגיל של Android.

החל מ-Android 16, אם אתם שולחים מכשיר שמבוסס על ערכת שבבים ARM-64, מומלץ מאוד לפרוס את הגרסה העדכנית ביותר שאושרה על ידי Google של GBL ולשלב אותה בשרשרת האתחול.

Build GBL

כדי ליצור GBL:

  1. מוודאים שכלי ה-repo ו-Bazel bootstrap מותקנים:

    sudo apt install repo bazel-bootstrap

  2. מאתחלים את הספרייה הנוכחית לבקרת מקור באמצעות קובץ המניפסט uefi-gbl-mainline:

    repo init -u https://android.googlesource.com/kernel/manifest -b uefi-gbl-mainline
repo sync -j16

  3. יוצרים את אפליקציית UEFI:

    tools/bazel run //bootable/libbootloader:gbl_efi_dist

בדיקת GBL במכשיר וירטואלי של Android

  1. מריצים את GBL בתוך Cuttlefish:

    cvd start --android_efi_loader=path_to_the_UEFI_app ...

    במקום להפעיל את Android ישירות, הפקודה cvd start הזו משתמשת באפליקציית UEFI כדי להפעיל את Android.

דיווח על באגים ויצירת קשר עם צוות תוכנת האתחול

כדי לדווח על באג ב-GBL, עוברים אל רכיב Android Generic Bootloader ב-Buganizer.

אם יש לך שאלות, אפשר לפנות לצוות GBL באימייל לכתובת android-gbl@google.com.