ติดตั้งใช้งาน GBL

หน้านี้จะอธิบายวิธีติดตั้งใช้งานไบนารี 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_GUID 5a6d92f3-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

  1. ตรวจสอบว่าคุณได้ติดตั้งเครื่องมือ repo และ Bazel Bootstrap แล้ว โดยทำดังนี้

    sudo apt install repo bazel-bootstrap
    
  2. เริ่มต้นไดเรกทอรีปัจจุบันสำหรับการควบคุมซอร์สโค้ดโดยใช้ไฟล์ Manifest 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 ...
    

    คำสั่ง cvd start นี้จะใช้แอป UEFI เพื่อเปิดเครื่อง Android แทนการเปิดเครื่อง Android โดยตรง

รายงานข้อบกพร่องและติดต่อทีม Bootloader

หากต้องการรายงานข้อบกพร่องของ GBL ให้ไปที่คอมโพเนนต์ Generic Bootloader ของ Android ใน Buganizer

หากมีคำถาม โปรดติดต่อทีม GBL โดยส่งอีเมลไปที่ android-gbl@google.com