Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Boot Image Header

Android 9 memperkenalkan kolom versi di header image boot, yang memungkinkan update header sambil mempertahankan kompatibilitas ke belakang. Bootloader harus memeriksa kolom versi header dan mengurai header yang sesuai. Perangkat diluncurkan dengan:

  • Android 11 dapat menggunakan boot header versi 3. Untuk perangkat yang mendukung arsitektur Generic Kernel Image (GKI) , versi ini harus digunakan untuk image boot utama.
  • Android 10 harus menggunakan boot header versi 2.
  • Android 9 harus menggunakan boot header versi 1.
  • Android 8 dan yang lebih rendah dianggap menggunakan header image booting versi 0.

Untuk semua perangkat yang menjalankan Android 9 atau lebih tinggi, Vendor Test Suite (VTS) memeriksa format image boot/recovery untuk memastikan bahwa header image booting menggunakan versi yang benar. Untuk melihat detail AOSP pada semua header image booting dan boot vendor yang saat ini didukung, lihat system/tools/mkbootimg/include/bootimg/bootimg.h .

Menerapkan pembuatan versi header image booting

Alat mkbootimg menerima argumen berikut.

Argumen Deskripsi
header_version Menetapkan versi header image booting. Gambar boot dengan versi header:
  • 1 atau 2 mendukung citra DTBO pemulihan atau citra ACPIO pemulihan.
  • 3 tidak mendukung gambar pemulihan.
recovery_dtbo Digunakan untuk arsitektur yang menggunakan DTB. Menentukan jalur ke citra DTBO pemulihan. Opsional untuk perangkat A / B, yang tidak membutuhkan citra pemulihan. Perangkat non-A / B yang menggunakan header_version :
  • 1 atau 2 dapat menentukan jalur ini atau menggunakan bagian recovery_acpio untuk menentukan jalur ke citra ACPIO pemulihan.
  • 3 tidak dapat menentukan gambar DTBO pemulihan.
recovery_acpio Digunakan untuk arsitektur yang menggunakan ACPI, bukan DTB. Menentukan jalur ke citra ACPIO pemulihan. Opsional untuk perangkat A / B, yang tidak membutuhkan citra pemulihan. Perangkat non-A / B yang menggunakan header_version :
  • 1 atau 2 dapat menentukan jalur ini atau menggunakan bagian recovery_dtbo untuk menentukan jalur ke image DTBO pemulihan.
  • 3 tidak dapat menentukan citra ACPIO pemulihan.
dtb Path ke image DTB yang termasuk dalam image boot / recovery.
dtb_offset Saat ditambahkan ke argumen base , berikan alamat beban fisik untuk pohon perangkat terakhir. Sebagai contoh, jika base argumen adalah 0x10000000 dan dtb_offset argumen adalah 0x01000000 , yang dtb_addr_field di header boot image dihuni sebagai 0x11000000 .

BoardConfig.mk perangkat menggunakan konfigurasi BOARD_MKBOOTIMG_ARGS untuk menambahkan header version ke argumen khusus board lainnya dari mkbootimg . Sebagai contoh:

BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)

Android membangun sistem menggunakan BoardConfig variabel BOARD_PREBUILT_DTBOIMAGE untuk mengatur argumen recovery_dtbo dari mkbootimg alat selama pembuatan gambar pemulihan. Untuk detail tentang perubahan Android Open Source Project (AOSP), tinjau daftar perubahan terkait untuk pembuatan versi header image booting .

Boot image header, versi 3

Android 11 memperbarui header image booting ke versi 3, yang menghapus data berikut:

  • Bootloader tahap kedua. Kolom second_size dan second_addr tidak lagi muncul di header image boot. Perangkat dengan bootloader tahap kedua harus menyimpan bootloader tersebut di partisinya sendiri.

  • Gambar pemulihan. Persyaratan untuk menentukan citra pemulihan sudah tidak digunakan lagi, dan bidang recovery_dtbo_size , recovery_dtbo_offset , recovery_acpio_size , dan recovery_acpio_offset tidak lagi muncul di header image boot.

    • Perangkat A / B menggunakan skema pembaruan dan pemulihan yang membuatnya tidak perlu menentukan image DTBO atau ACPIO untuk pemulihan.

    • Perangkat non-A / B yang ingin menentukan citra pemulihan (baik DTBO atau ACPIO) harus menggunakan boot image header versi 1 atau 2.

  • Blob pohon perangkat (DTB). DTB disimpan di partisi boot vendor , sehingga bidang dtb_size dan dtb_addr tidak lagi muncul di header image boot (tetapi ada di header image boot vendor).

Perangkat dapat menggunakan boot image header versi 3 untuk mematuhi arsitektur Generic Kernel Image (GKI) , yang menyatukan kernel inti dan memindahkan modul vendor yang diperlukan untuk boot ke partisi vendor_boot (artinya image boot hanya berisi komponen GKI). Perangkat yang:

  • Gunakan GKI (memerlukan kernel android-4.19 atau android-5.4) tetapi tidak menggunakan pembaruan A / B dapat menentukan citra pemulihan dengan menggunakan citra boot versi 3 untuk citra boot dan citra boot versi 2 untuk citra pemulihan.

  • Jangan gunakan GKI dan jangan gunakan pembaruan A / B dapat menentukan citra pemulihan dengan menggunakan citra boot versi 1 atau 2 untuk citra boot dan pemulihan.

Versi 3 dari versi header image booting menggunakan format berikut.

struct boot_img_hdr
{
#define BOOT_MAGIC_SIZE 8
    uint8_t magic[BOOT_MAGIC_SIZE];

    uint32_t kernel_size;    /* size in bytes */
    uint32_t ramdisk_size;   /* size in bytes */

    uint32_t os_version;

    uint32_t header_size;    /* size of boot image header in bytes */
    uint32_t reserved[4];
    uint32_t header_version; /* offset remains constant for version check */

#define BOOT_ARGS_SIZE 512
#define BOOT_EXTRA_ARGS_SIZE 1024
    uint8_t cmdline[BOOT_ARGS_SIZE + BOOT_EXTRA_ARGS_SIZE];
};

Header gambar boot, versi 2

Android 10 memperbarui header gambar booting ke versi 2, yang menambahkan bagian untuk informasi gambar DTB pemulihan (ukuran gambar dan alamat pemuatan fisik).

Versi 2 dari versi header image booting menggunakan format berikut.

struct boot_img_hdr
{
    uint8_t magic[BOOT_MAGIC_SIZE];
    uint32_t kernel_size;               /* size in bytes */
    uint32_t kernel_addr;               /* physical load addr */

    uint32_t ramdisk_size;              /* size in bytes */
    uint32_t ramdisk_addr;              /* physical load addr */

    uint32_t second_size;               /* size in bytes */
    uint32_t second_addr;               /* physical load addr */

    uint32_t tags_addr;                 /* physical addr for kernel tags */
    uint32_t page_size;                 /* flash page size we assume */
    uint32_t header_version;
    uint32_t os_version;
    uint8_t name[BOOT_NAME_SIZE];       /* asciiz product name */
    uint8_t cmdline[BOOT_ARGS_SIZE];
    uint32_t id[8];                     /* timestamp / checksum / sha1 / etc */
    uint8_t extra_cmdline[BOOT_EXTRA_ARGS_SIZE];
    uint32_t recovery_[dtbo|acpio]_size;    /* size of recovery image */
    uint64_t recovery_[dtbo|acpio]_offset;  /* offset in boot image */
    uint32_t header_size;               /* size of boot image header in bytes */
    uint32_t dtb_size;                  /* size of dtb image */
    uint64_t dtb_addr;                  /* physical load address */
};

Boot image header, versi 1

Android 9 mengonversi bidang yang unused dari header gambar booting menjadi bidang versi header. Perangkat yang diluncurkan dengan Android 9 harus menggunakan header image boot dengan versi header yang disetel ke 1 atau lebih tinggi (ini diverifikasi oleh VTS).

Versi 1 dari versi header image booting menggunakan format berikut.

struct boot_img_hdr
{
    uint8_t magic[BOOT_MAGIC_SIZE];
    uint32_t kernel_size;               /* size in bytes */
    uint32_t kernel_addr;               /* physical load addr */
    uint32_t ramdisk_size;              /* size in bytes */
    uint32_t ramdisk_addr;              /* physical load addr */

    uint32_t second_size;               /* size in bytes */
    uint32_t second_addr;               /* physical load addr */

    uint32_t tags_addr;                 /* physical addr for kernel tags */
    uint32_t page_size;                 /* flash page size we assume */
    uint32_t header_version;
    uint32_t os_version;
    uint8_t name[BOOT_NAME_SIZE];       /* asciiz product name */
    uint8_t cmdline[BOOT_ARGS_SIZE];
    uint32_t id[8];                     /* timestamp / checksum / sha1 / etc */
    uint8_t extra_cmdline[BOOT_EXTRA_ARGS_SIZE];
    uint32_t recovery_[dtbo|acpio]_size;    /* size of recovery image */
    uint64_t recovery_[dtbo|acpio]_offset;  /* offset in boot image */
    uint32_t header_size;               /* size of boot image header in bytes */
};

Perangkat non-A / B dapat menentukan gambar overlay DTB / ACPI untuk pemulihan guna membantu mengurangi kegagalan pembaruan over-the-air (OTA). (Perangkat A / B tidak mengalami masalah ini dan tidak perlu menentukan gambar overlay.) Anda dapat menentukan gambar DTBO atau gambar ACPIO, tetapi tidak keduanya (karena keduanya digunakan oleh arsitektur yang berbeda). Untuk mengkonfigurasi header image booting dengan benar, saat menggunakan:

  • Gambar DTBO untuk pemulihan, sertakan bidang recovery_dtbo_size dan recovery_dtbo_offset (dan jangan sertakan bidang recovery_acpio_size dan recovery_acpio_offset ).

  • Gambar ACPIO untuk pemulihan, termasuk bidang recovery_acpio_size dan recovery_acpio_offset (dan tidak termasuk bidang recovery_dtbo_size dan recovery_dtbo_offset ).

Kolom header_size berisi ukuran header image booting. Jika versi header image booting disetel ke 1, kolom id berisi intisari SHA-1 untuk bagian recovery_[dtbo|acpio] dari image booting selain kernel , ramdisk , dan second sections . Untuk detail tentang bidang recovery_[dtbo|acpio]_size dan recovery_[dtbo|acpio]_offset , lihat Gambar Pemulihan .

Header gambar boot lama, versi 0

Perangkat yang diluncurkan sebelum Android 9 yang menggunakan header image booting lama dianggap menggunakan header image booting versi 0.

struct boot_img_hdr
{
    uint8_t magic[BOOT_MAGIC_SIZE];
    uint32_t kernel_size;                /* size in bytes */
    uint32_t kernel_addr;                /* physical load addr */

    uint32_t ramdisk_size;               /* size in bytes */
    uint32_t ramdisk_addr;               /* physical load addr */

    uint32_t second_size;                /* size in bytes */
    uint32_t second_addr;                /* physical load addr */

    uint32_t tags_addr;                  /* physical addr for kernel tags */
    uint32_t page_size;                  /* flash page size we assume */
    uint32_t unused;
    uint32_t os_version;
    uint8_t name[BOOT_NAME_SIZE];        /* asciiz product name */
    uint8_t cmdline[BOOT_ARGS_SIZE];
    uint32_t id[8];                      /* timestamp / checksum / sha1 / etc */
    uint8_t extra_cmdline[BOOT_EXTRA_ARGS_SIZE];
};