Implementa GBL

En esta página, se explica cómo implementar el binario de GBL.

Requisitos del firmware de inicio

Para usar GBL, el firmware de arranque debe cumplir con los siguientes requisitos:

  • Cumplimiento con UEFI El firmware debe implementar y usar los protocolos UEFI requeridos. El firmware también debe permitir extensiones específicas del proveedor con protocolos de UEFI definidos.

  • Seguridad El firmware debe implementar todos los aspectos del inicio verificado de Android (AVB), lo que garantiza que solo se carguen imágenes autenticadas.

  • Modos de inicio El binario debe poder controlar varios modos de inicio, como el inicio normal, el inicio de recuperación y el inicio rápido.

  • Es el particionamiento dinámico. El firmware de arranque debe implementar la lógica de selección de ranuras para que admita la lectura de la ranura de arranque A/B correcta y sea compatible con las particiones dinámicas y los datos del usuario en super.

  • Configuración del SO El firmware debe ser capaz de modificar la línea de comandos del kernel, el árbol de dispositivos (DTB) y bootconfig con las personalizaciones del OEM necesarias para iniciar el dispositivo.

  • Carga de la VM protegida. El objeto binario debe cargar correctamente el firmware de la VM protegida previamente verificada antes del kernel de Android en presencia de VMs protegidas. Para obtener más información, consulta la secuencia de inicio de Microdroid.

  • Administración de la memoria El firmware de arranque debe admitir la API de asignación de memoria de UEFI.

  • Compatibilidad y retrocompatibilidad El firmware debe funcionar en dispositivos con diferentes proveedores y SoC, y mantener la retrocompatibilidad con la versión de Android correspondiente.

Compatibilidad con el firmware de inicio

Con las modificaciones necesarias para admitir los requisitos de la sección anterior, las siguientes implementaciones de firmware de UEFI funcionan con el GBF:

  • EDK2 (Tianocore). EDK2 es una implementación de UEFI de código abierto popular. Se necesita compatibilidad con GBL para los bootloaders basados en EDK2, y la compatibilidad con UEFI ya está presente.
  • U-Boot. Un proyecto de cargador de arranque de código abierto flexible y ampliamente utilizado que está ganando compatibilidad con UEFI para el uso de GBL.
  • LittleKernel (LK). Es un cargador de arranque de código abierto que usan algunos proveedores.

Ejecuta GBL

Puedes obtener un objeto binario de GBL compilado previamente para ejecutarlo o compilar el tuyo y ejecutarlo.

Obtén y ejecuta el objeto binario de GBL

GBL se distribuye como un solo objeto binario de la app para EFI. Puedes actualizar este archivo binario de forma independiente del firmware base del dispositivo con el mecanismo de actualización estándar de Android.

A partir de Android 16, si envías un dispositivo basado en un chipset ARM-64, te recomendamos que implementes la versión más reciente firmada por Google de GBL y la integres en tu cadena de arranque.

Compila y ejecuta la GBL

Para compilar y ejecutar la GBL, haz lo siguiente:

  1. Verifica que tengas instaladas las herramientas repo y Bazel bootstrap:

    sudo apt install repo bazel-bootstrap

  2. Inicializa tu directorio actual para el control de código fuente con el archivo de manifiesto uefi-gbl-mainline:

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

  3. Compila la app de EFI:

    ./tools/bazel run //bootable/libbootloader:gbl_efi_dist --extra_toolchains=@gbl//toolchain:all

  4. Ejecuta la app de EFI en Cuttlefish:

    cvd start --android_efi_loader=path_to_the_EFI_app ...

    En lugar de iniciar Android directamente, este comando cvd start usa la app de EFI para iniciar Android.

Cómo registrar errores y comunicarse con el equipo del cargador de arranque

Para informar un error del GBL, navega al componente del cargador de arranque genérico de Android en Buganizer.

Si tienes preguntas, comunícate con el equipo de GBL y envía un correo electrónico a android-gbl@google.com.