Android-Bootloader-Funktionen entwickeln

Auf dieser Seite wird beschrieben, wie Sie Android-Bootloader-Funktionen auf einem Sepia-Gerät erstellen, ausführen und entwickeln.

AOSP-Quellen

Verwenden Sie zum Entwickeln von Android-Bootloader-Funktionen die Cuttlefish-Konfiguration von U-Boot mit Cuttlefish in aosp-main oder in Generic System Image (GSI)-Branches für Android 11 oder höher. Folgende Quellen sind im AOSP verfügbar:

• Manifest für die Cuttlefish-Konfiguration von U-Boot (u-boot-mainline).

• U-Boot-Bootloader-Quellcode

• x86 Cuttlefish-Standard-Bootloader

• Der Standard-Bootloader von Cuttlefish für aarch64

• QEMU-Bootloader (arm, aarch64, x86_64, riscv)

Bootloader entwickeln

So erstellen, führen und entwickeln Sie Bootloader-Funktionen lokal:

Hinweis: Anstatt den Build lokal zu erstellen, können Sie die entsprechenden Artefakte unter ci.android.com herunterladen. Damit vermeiden Sie das Herunterladen des U-Boot-Quellcodes und das Einrichten einer Bootloader-Entwicklung.

1. Klonen Sie das Manifest für die Android-Fork von U-Boot:

   $ mkdir u-boot-mainline
   $ cd u-boot-mainline
   $ repo init -u https://android.googlesource.com/kernel/manifest -b u-boot-mainline
   $ repo sync -j$(nproc) -q

2. Erstellen Sie das Bootloader-Ziel, das für Ihre Cuttlefish-Architektur geeignet ist. Beispiel:

   • x86_64

     $ tools/bazel run //u-boot:crosvm_x86_64_dist

   • aarch64

     $ tools/bazel run //u-boot:crosvm_aarch64_dist

   Die resultierende Bootloader-Binärdatei (u-boot.bin für arm64 und u-boot.rom für x86_64) wird in $PATH_TO_REPO/out/u-boot-mainline/dist gefunden.

3. Starten Sie das Cuttlefish-Gerät mit dem Bootloader. Fügen Sie den Parameter pause_in_bootloader ein, um Autoboot zu deaktivieren und mit dem Bootloader interagieren zu können.

   $ launch_cvd \
       -bootloader /$PATH/$TO/u-boot-mainline/out/u-boot-mainline/dist/u-boot.rom \
       -pause_in_bootloader -console=true

   Hinweis: Verwenden Sie unter aarch64 u-boot.bin anstelle von u-boot.rom.

4. Um mit dem Bootloader zu interagieren, müssen Sie eine Verbindung zur Bootloader-Konsole herstellen.

   $ screen ~/cuttlefish_runtime/console

5. Wenn Sie mit den Interaktionen mit dem Bootloader fertig sind, fahren Sie mit dem Starten fort, indem Sie boot in die Konsole eingeben.

Bootloader-Ablauf mit verschiedenen Kerneln testen

Wenn Sie den Bootloader-Ablauf mit verschiedenen Kerneln oder Kernelmodulen testen möchten, geben Sie die Zielartefakte (Kernel und Kernelmodule) mit den Argumenten --kernel_path und --initramfs_path an. Der Assembler verpackt die Boot-Images basierend auf den in den Argumenten übergebenen Artefakten neu.

cvd create \
    -kernel_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/bzImage \
    -initramfs_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/initramfs.img

Weitere Informationen finden Sie unter Android-Kernel entwickeln.