หน้านี้จะอธิบายวิธีติดตั้งใช้งานไบนารี Generic Bootloader (GBL)
ข้อกำหนดของเฟิร์มแวร์การเปิดเครื่อง
หากต้องการใช้ GBL เฟิร์มแวร์การเปิดเครื่องต้องเป็นไปตามข้อกำหนดต่อไปนี้
การปฏิบัติตามข้อกำหนดของ Unified Extensible Firmware Interface (UEFI) เฟิร์มแวร์ต้องใช้โปรโตคอล UEFI ที่จำเป็น นอกจากนี้ เฟิร์มแวร์ต้องอนุญาตให้ใช้ส่วนขยายเฉพาะของผู้ให้บริการโดยใช้โปรโตคอล UEFI ที่กำหนดไว้
ความปลอดภัย เฟิร์มแวร์ต้องใช้ข้อกำหนดทั้งหมดสำหรับการเปิดเครื่องที่ได้รับการยืนยัน (AVB) ของ Android เพื่อให้ GBL ตรวจสอบสิทธิ์อิมเมจบูตได้
โหมดเปิดเครื่อง ไบนารีควรจะจัดการโหมดการเปิดเครื่องต่างๆ ได้ เช่น การเปิดเครื่องปกติ การเปิดเครื่องเพื่อกู้คืน และ Fastboot
การแบ่งพาร์ติชันแบบไดนามิก เฟิร์มแวร์การเปิดเครื่องต้องใช้ตรรกะการเลือกช่องเพื่อให้รองรับการอ่านช่องเปิดเครื่อง A/B ที่ถูกต้อง และเข้ากันได้กับพาร์ติชันแบบไดนามิกและข้อมูลผู้ใช้ใน super
การกำหนดค่าระบบปฏิบัติการ เฟิร์มแวร์ต้องสามารถแก้ไขบรรทัดคำสั่งเคอร์เนล, แผนผังอุปกรณ์ (DTB) และ bootconfig ด้วยการปรับแต่ง OEM ที่จำเป็นต่อการเปิดเครื่องอุปกรณ์ได้
กำลังโหลด VM ที่ได้รับการปกป้อง ไบนารีควรโหลดเฟิร์มแวร์ VM ที่ได้รับการปกป้องและผ่านการตรวจสอบล่วงหน้าอย่างถูกต้องก่อนเคอร์เนล Android ในกรณีที่มี VM ที่ได้รับการปกป้อง ดูข้อมูลเพิ่มเติมได้ที่ลำดับการเปิดเครื่องของ Microdroid
การจัดการหน่วยความจำ เฟิร์มแวร์การเปิดเครื่องต้องรองรับ API การจัดสรรหน่วยความจำ UEFI
ข้อกำหนดในการใช้งาน
คุณต้องมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้เพื่อให้ติดตั้งใช้งาน GBL บนอุปกรณ์ได้อย่างถูกต้อง
อุปกรณ์ของคุณต้องมีพาร์ติชัน FAT 2 พาร์ติชันขนาด 8 MB (หรือใหญ่กว่า) ชื่อ
android_esp_aและandroid_esp_bในอุปกรณ์จัดเก็บบล็อกข้อมูลที่ SOC เข้าถึงได้- อุปกรณ์จัดเก็บบล็อกข้อมูลคืออุปกรณ์จัดเก็บข้อมูลที่สามารถอ่านหรือเขียนในหน่วยของบล็อกได้ ตัวอย่างเช่น อุปกรณ์ UFS, eMMC และการ์ด SD
- ระบบจะใช้ FAT เนื่องจากเป็นระบบไฟล์ที่พบได้ทั่วไปและใช้งานง่าย
- เราขอแนะนำให้คุณเลือกระบบไฟล์ FAT ที่เหมาะสมกับความต้องการของคุณจาก FAT12, FAT16 และ FAT32
- ทั้ง 2 พาร์ติชันจำเป็นสำหรับการอัปเดต OTA และการย้อนกลับตลอดระยะเวลาการสนับสนุนของ Android เวอร์ชันนี้
- GBL มีขนาดประมาณ 2 MB เมื่อไม่บีบอัด 8 MB เพียงพอที่จะรองรับการเติบโตที่เกิดจากฟีเจอร์เพิ่มเติมในช่วง 7 ปีข้างหน้า
- ในกรณีที่มีการอัปเดต GBL คุณต้องอัปเดตพาร์ติชัน
android_esp_${SLOT_SUFFIX}ทั้งหมด Android OTA ไม่รองรับการอัปเดต GBL เท่านั้น - GUID ประเภทพาร์ติชันที่ใช้สำหรับพาร์ติชัน FAT ทั้ง 2 พาร์ติชันต้องสอดคล้องกับ GUID ของพาร์ติชันระบบ EFI
C12A7328-F81F-11D2-BA4B-00A0C93EC93B
เวอร์ชันของ GBL ที่ติดตั้งใช้งานต้องเป็นบิลด์เวอร์ชันที่ใช้งานจริงที่ผ่านการรับรองล่าสุดจากสาขาการเผยแพร่ GBL ที่เกี่ยวข้อง เราขอแนะนำให้คุณลงนามในสำเนา GBL ที่ผ่านการรับรองจาก Google โดยใช้โซลูชันการลงนามที่ต้องการ และจัดเก็บข้อมูลเมตาของบิลด์และลายเซ็นที่ได้ไว้ในพาร์ติชัน
android_esp_${SLOT_SUFFIX}- ลายเซ็น OEM ต้องไม่เปลี่ยนแปลงใบรับรอง GBL และต้องไม่มีส่วนหัวที่ใช้กับไบนารี
- บิลด์ GBL ของนักพัฒนาซอฟต์แวร์ใช้เพื่อวัตถุประสงค์ในการพัฒนาและการแก้ไขข้อบกพร่องเท่านั้น คุณจะจัดส่งบิลด์ไม่ได้และ Google จะไม่รับรองบิลด์ดังกล่าว
ต้องจัดเก็บ GBL ไว้ที่เส้นทาง
/EFI/BOOT/BOOTAA64.EFIภายในพาร์ติชัน FATใช้โปรโตคอล UEFI และ Android UEFI ที่จำเป็นเพื่อรองรับ GBL บิลด์เวอร์ชันที่ใช้งานจริงของ GBL จะบูตไม่สำเร็จหากระบบไม่รองรับอินเทอร์เฟซเหล่านี้
EFI_BLOCK_IO_PROTOCOLหรือEFI_BLOCK_IO2_PROTOCOLจะดึงข้อมูลอิมเมจการเปิดเครื่องและอิมเมจ pvmfw จากดิสก์EFI_RNG_PROTOCOLสำหรับ Stack Canary, KASLR Seed และ RNG Seed- บริการจัดสรรหน่วยความจำสำหรับการจัดสรรหน่วยความจำชั่วคราวเพื่อทำการคำนวณ 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_EFI_VENDOR_GUID5a6d92f3-a2d0-4083-91a1-a50f6c3d9830และต้องยังคงเป็นแบบอ่านอย่างเดียวและได้รับการป้องกันจากการงัดแงะเมื่อ Bootloader ถูกล็อก- ต้องตั้งค่า
gbl_fw_api_levelเป็นระดับ API ของเฟิร์มแวร์แพลตฟอร์ม ซึ่งระบุระดับ API ของซอฟต์แวร์ของผู้ให้บริการ ตัวแปรนี้ต้องมีค่าเดียวกับพร็อพเพอร์ตี้ระบบro.board.api_level - ต้องตั้งค่า
gbl_fw_product_first_api_levelเป็นระดับ API SDK ที่อุปกรณ์จัดส่งมาด้วย และต้องคงที่ตลอดอายุการใช้งานของผลิตภัณฑ์ ไม่ว่าจะมีการอัปเดตซอฟต์แวร์หรือไม่ก็ตาม ตัวแปรนี้ต้องมีค่าเดียวกับพร็อพเพอร์ตี้ระบบro.product.first_api_level
- ต้องตั้งค่า
โปรโตคอล UEFI ที่แนะนำอย่างยิ่งเมื่อผสานรวม GBL มีระบุไว้ในโปรโตคอล GBL UEFI
การรองรับเฟิร์มแวร์การเปิดเครื่อง
การติดตั้งใช้งานเฟิร์มแวร์ UEFI ต่อไปนี้จะทำงานร่วมกับ GBL ได้เมื่อมีการปรับเปลี่ยนที่จำเป็นเพื่อรองรับข้อกำหนดในส่วนก่อนหน้า
- EDK2 (Tianocore) EDK2 เป็นการใช้งาน UEFI แบบโอเพนซอร์สที่ได้รับความนิยม ต้องรองรับ GBL สำหรับ Bootloader ที่ใช้ EDK2 และรองรับ UEFI อยู่แล้ว
- U-Boot โปรเจ็กต์ Bootloader แบบโอเพนซอร์สที่ยืดหยุ่นและใช้กันอย่างแพร่หลาย ซึ่งกำลังได้รับความเข้ากันได้กับ UEFI สำหรับการใช้งาน GBL
- LittleKernel (LK) Bootloader แบบโอเพนซอร์สที่ผู้ให้บริการบางรายใช้
เรียกใช้ GBL
คุณสามารถรับไบนารี GBL ที่สร้างไว้ล่วงหน้าเพื่อเรียกใช้หรือสร้างไบนารีของคุณเองและเรียกใช้ได้
รับและเรียกใช้ไบนารี GBL
GBL จะเผยแพร่เป็นไบนารีแอป UEFI รายการเดียว คุณสามารถอัปเดตไบนารีนี้แยกต่างหากจากเฟิร์มแวร์พื้นฐานของอุปกรณ์โดยใช้กลไกการอัปเดตมาตรฐานของ Android
ตั้งแต่ Android 16 เป็นต้นไป หากคุณจัดส่งอุปกรณ์ที่ใช้ชิปเซ็ต ARM-64 เราขอแนะนำอย่างยิ่งให้ติดตั้งใช้งาน GBL เวอร์ชันล่าสุดที่ผ่านการรับรองจาก Google และผสานรวมเข้ากับ Boot Chain
หากต้องการแก้ไขข้อบกพร่องของบิลด์ GBL นี้ คุณสามารถดาวน์โหลดอาร์ติแฟกต์เหล่านี้เพื่อช่วยในการแก้ไขข้อบกพร่องได้
- ตารางสัญลักษณ์ใช้โปรแกรมแก้ไขข้อบกพร่องของฮาร์ดแวร์และ GDB สำหรับบิลด์ GBL ที่ผ่านการรับรองจาก Google
- ไฟล์ Manifest จะทำการเปลี่ยนแปลงในบิลด์ที่รับรองโดยการสร้างบิลด์ GBL นี้ขึ้นมาใหม่จากแหล่งที่มาโดยใช้
repo - บิลด์สำหรับนักพัฒนาซอฟต์แวร์ GBL ที่เกี่ยวข้องมีประโยชน์สำหรับการเปิดเครื่องหรือการแก้ไขข้อบกพร่องที่ไม่ซับซ้อนของปัญหาที่ส่งผลต่อบิลด์เวอร์ชันที่ใช้งานจริงที่รับรองแล้ว
- ตารางสัญลักษณ์มีประโยชน์สำหรับบิลด์นักพัฒนาซอฟต์แวร์ GBL ที่มีโปรแกรมแก้ไขข้อบกพร่องฮาร์ดแวร์และ GDB
หากต้องการดูไบนารีและสัญลักษณ์ที่ผ่านการรับรองในทุกรุ่น โปรดดูบิลด์ที่เผยแพร่ของ GBL
สร้าง GBL
วิธีสร้าง GBL
ตรวจสอบว่าคุณได้ติดตั้งเครื่องมือ
repoและ Bazel Bootstrap แล้ว โดยทำดังนี้sudo apt install repo bazel-bootstrapเริ่มต้นไดเรกทอรีปัจจุบันสำหรับการควบคุมซอร์สโค้ดโดยใช้ไฟล์ Manifest
uefi-gbl-mainlineโดยทำดังนี้repo init -u https://android.googlesource.com/kernel/manifest -b uefi-gbl-mainline repo sync -j16สร้างแอป UEFI โดยทำดังนี้
tools/bazel run //bootable/libbootloader:gbl_efi_dist
ทดสอบ GBL ในอุปกรณ์เสมือน Android
เรียกใช้ GBL ภายใน Cuttlefish โดยทำดังนี้
cvd start --android_efi_loader=path_to_the_UEFI_app ...คำสั่ง
cvd startนี้จะใช้แอป UEFI เพื่อเปิดเครื่อง Android แทนการเปิดเครื่อง Android โดยตรง
รายงานข้อบกพร่องและติดต่อทีม Bootloader
หากต้องการรายงานข้อบกพร่องของ GBL ให้ไปที่คอมโพเนนต์ Generic Bootloader ของ Android ใน Buganizer
หากมีคำถาม โปรดติดต่อทีม GBL โดยส่งอีเมลไปที่ android-gbl@google.com