Android 11 memperkenalkan konsep Generic Kernel Image (GKI). Untuk memudahkan booting perangkat arbitrer dengan GKI, perangkat Android 11 dapat menggunakan header gambar booting versi 3. Dalam versi 3, semua informasi spesifik vendor dikeluarkan dari partisi boot
dan dipindahkan ke partisi vendor_boot
baru. Perangkat ARM64 yang diluncurkan dengan Android 11 pada kernel Linux 5.4 harus mendukung partisi vendor_boot
dan format partisi boot
yang diperbarui agar dapat lulus pengujian dengan GKI.
Perangkat Android 12 dapat menggunakan header image booting versi 4, yang mendukung penyertaan beberapa ramdisk vendor di partisi vendor_boot
. Beberapa fragmen ramdisk vendor digabungkan satu demi satu di bagian ramdisk vendor. Tabel vendor ramdisk digunakan untuk mendeskripsikan tata letak bagian ramdisk vendor dan metadata setiap fragmen ramdisk vendor.
Struktur partisi
Partisi boot vendor adalah A/B dengan A/B virtual dan dilindungi oleh Boot Terverifikasi Android.
Versi 3
Partisi ini terdiri dari header, ramdisk vendor, dan blob pohon perangkat (DTB).
Bagian | Jumlah halaman |
---|---|
Header boot vendor (n halaman) | n = (2112 + page_size - 1) / page_size |
Vendor ramdisk (o halaman) | o = (vendor_ramdisk_size + page_size - 1) / page_size |
DTB (halaman p) | p = (dtb_size + page_size - 1) / page_size |
Versi 4
Partisi ini terdiri dari header, bagian vendor ramdisk (terdiri dari semua fragmen ramdisk vendor, digabungkan), blob pohon perangkat (DTB), dan tabel vendor ramdisk.
Bagian | Jumlah halaman |
---|---|
Header boot vendor (n halaman) | n = (2128 + page_size - 1) / page_size |
Fragmen ramdisk vendor (o halaman) | o = (vendor_ramdisk_size + page_size - 1) / page_size |
DTB (halaman p) | p = (dtb_size + page_size - 1) / page_size |
Tabel ramdisk vendor (halaman q) | q = (vendor_ramdisk_table_size + page_size - 1) / page_size |
Bootconfig (halaman r) | r = (bootconfig_size + page_size - 1) / page_size |
Header boot vendor
Isi header partisi boot vendor terutama terdiri dari data yang dipindahkan ke sana dari header image boot . Ini juga berisi informasi tentang vendor ramdisk.
Versi 3
struct vendor_boot_img_hdr_v3
{
#define VENDOR_BOOT_MAGIC_SIZE 8
uint8_t magic[VENDOR_BOOT_MAGIC_SIZE];
uint32_t header_version;
uint32_t page_size; /* flash page size we assume */
uint32_t kernel_addr; /* physical load addr */
uint32_t ramdisk_addr; /* physical load addr */
uint32_t vendor_ramdisk_size; /* size in bytes */
#define VENDOR_BOOT_ARGS_SIZE 2048
uint8_t cmdline[VENDOR_BOOT_ARGS_SIZE];
uint32_t tags_addr; /* physical addr for kernel tags */
#define VENDOR_BOOT_NAME_SIZE 16
uint8_t name[VENDOR_BOOT_NAME_SIZE]; /* asciiz product name */
uint32_t header_size; /* size of vendor boot image header in
* bytes */
uint32_t dtb_size; /* size of dtb image */
uint64_t dtb_addr; /* physical load address */
};
Versi 4
struct vendor_boot_img_hdr_v4
{
#define VENDOR_BOOT_MAGIC_SIZE 8
uint8_t magic[VENDOR_BOOT_MAGIC_SIZE];
uint32_t header_version;
uint32_t page_size; /* flash page size we assume */
uint32_t kernel_addr; /* physical load addr */
uint32_t ramdisk_addr; /* physical load addr */
uint32_t vendor_ramdisk_size; /* size in bytes */
#define VENDOR_BOOT_ARGS_SIZE 2048
uint8_t cmdline[VENDOR_BOOT_ARGS_SIZE];
uint32_t tags_addr; /* physical addr for kernel tags */
#define VENDOR_BOOT_NAME_SIZE 16
uint8_t name[VENDOR_BOOT_NAME_SIZE]; /* asciiz product name */
uint32_t header_size; /* size of vendor boot image header in
* bytes */
uint32_t dtb_size; /* size of dtb image */
uint64_t dtb_addr; /* physical load address */
uint32_t vendor_ramdisk_table_size; /* size in bytes for the vendor ramdisk table */
uint32_t vendor_ramdisk_table_entry_num; /* number of entries in the vendor ramdisk table */
uint32_t vendor_ramdisk_table_entry_size; /* size in bytes for a vendor ramdisk table entry */
uint32_t bootconfig_size; /* size in bytes for the bootconfig section */
};
#define VENDOR_RAMDISK_TYPE_NONE 0
#define VENDOR_RAMDISK_TYPE_PLATFORM 1
#define VENDOR_RAMDISK_TYPE_RECOVERY 2
#define VENDOR_RAMDISK_TYPE_DLKM 3
struct vendor_ramdisk_table_entry_v4
{
uint32_t ramdisk_size; /* size in bytes for the ramdisk image */
uint32_t ramdisk_offset; /* offset to the ramdisk image in vendor ramdisk section */
uint32_t ramdisk_type; /* type of the ramdisk */
#define VENDOR_RAMDISK_NAME_SIZE 32
uint8_t ramdisk_name[VENDOR_RAMDISK_NAME_SIZE]; /* asciiz ramdisk name */
#define VENDOR_RAMDISK_TABLE_ENTRY_BOARD_ID_SIZE 16
// Hardware identifiers describing the board, soc or platform which this
// ramdisk is intended to be loaded on.
uint32_t board_id[VENDOR_RAMDISK_TABLE_ENTRY_BOARD_ID_SIZE];
};
-
vendor_ramdisk_size
adalah ukuran total semua fragmen ramdisk vendor. -
ramdisk_type
menunjukkan jenis ramdisk, nilai yang mungkin adalah:-
VENDOR_RAMDISK_TYPE_NONE
menunjukkan nilai yang tidak ditentukan. - Ramdisk
VENDOR_RAMDISK_TYPE_PLATFORM
berisi bit khusus platform. Bootloader harus selalu memuat ini ke dalam memori. - Ramdisk
VENDOR_RAMDISK_TYPE_RECOVERY
berisi sumber daya pemulihan. Bootloader harus memuat ini ke dalam memori saat boot ke pemulihan. - Ramdisk
VENDOR_RAMDISK_TYPE_DLKM
berisi modul kernel dinamis yang dapat dimuat.
-
-
ramdisk_name
adalah nama unik dari ramdisk. -
board_id
adalah vektor pengidentifikasi perangkat keras yang ditentukan vendor.
Dukungan bootloader
Karena partisi boot vendor berisi informasi (seperti ukuran halaman flash, kernel, alamat pemuatan ramdisk, DTB itu sendiri) yang sebelumnya ada di partisi boot, bootloader harus mengakses partisi boot dan boot vendor agar memiliki cukup data untuk menyelesaikan booting .
Bootloader harus memuat ramdisk generik ke dalam memori segera setelah ramdisk vendor (format CPIO, Gzip, dan lz4 mendukung jenis penggabungan ini). Jangan menyelaraskan halaman gambar ramdisk generik atau memasukkan ruang lain antara gambar tersebut dan akhir ramdisk vendor di memori. Setelah kernel didekompresi, kernel mengekstrak file gabungan tersebut menjadi initramfs
, yang menghasilkan struktur file berupa ramdisk generik yang dilapis pada struktur file ramdisk vendor.
Karena ramdisk generik dan ramdisk vendor digabungkan, keduanya harus dalam format yang sama. Image boot GKI menggunakan ramdisk generik yang dikompresi lz4, sehingga perangkat yang sesuai dengan GKI harus menggunakan ramdisk vendor yang dikompresi lz4. Konfigurasi untuk ini ditunjukkan di bawah.
Persyaratan bootloader untuk mendukung bootconfig dijelaskan di halaman Implementasi Bootconfig .
Beberapa ramdisk vendor (versi 4)
Dengan header gambar boot versi 4, bootloader dapat memilih subset atau semua ramdisk vendor untuk dimuat sebagai initramfs
selama waktu boot. Tabel ramdisk vendor berisi metadata setiap ramdisk, dan dapat membantu bootloader dalam memutuskan ramdisk mana yang akan dimuat. Bootloader dapat menentukan urutan untuk memuat ramdisk vendor yang dipilih, selama ramdisk generik dimuat terakhir.
Misalnya, bootloader dapat menghilangkan pemuatan ramdisk vendor jenis VENDOR_RAMDISK_TYPE_RECOVERY
selama boot normal untuk menghemat sumber daya, sehingga hanya ramdisk vendor jenis VENDOR_RAMDISK_TYPE_PLATFORM
dan VENDOR_RAMDISK_TYPE_DLKM
yang dimuat ke dalam memori. Di sisi lain, ramdisk vendor jenis VENDOR_RAMDISK_TYPE_PLATFORM
, VENDOR_RAMDISK_TYPE_RECOVERY
dan VENDOR_RAMDISK_TYPE_DLKM
dimuat ke dalam memori saat boot ke mode pemulihan.
Alternatifnya, bootloader dapat mengabaikan tabel ramdisk vendor dan memuat seluruh bagian ramdisk vendor. Ini memiliki efek yang sama seperti memuat semua fragmen ramdisk vendor di partisi vendor_boot
.
Membangun dukungan
Untuk menerapkan dukungan boot vendor pada perangkat:
Setel
BOARD_BOOT_HEADER_VERSION
ke3
atau lebih besar.Setel
BOARD_RAMDISK_USE_LZ4
ketrue
jika perangkat Anda mematuhi GKI, atau jika perangkat menggunakan ramdisk generik terkompresi lz4.Setel
BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE
ke ukuran yang sesuai untuk perangkat Anda, dengan mempertimbangkan modul kernel yang harus masuk ke ramdisk vendor.Perbarui
AB_OTA_PARTITIONS
untuk menyertakanvendor_boot
dan daftar partisi OTA khusus vendor apa pun pada perangkat.Salin
fstab
perangkat Anda ke/first_stage_ramdisk
di partisivendor_boot
, bukan partisiboot
. Misalnya,$(LOCAL_PATH)/fstab.hardware:$(TARGET_COPY_OUT_VENDOR_RAMDISK)/first_stage_ramdisk/fstab.$(PRODUCT_PLATFORM)
.
Untuk memasukkan beberapa ramdisk vendor di vendor_boot
:
- Setel
BOARD_BOOT_HEADER_VERSION
ke4
. Setel
BOARD_VENDOR_RAMDISK_FRAGMENTS
ke daftar nama fragmen ramdisk vendor logis untuk disertakan dalamvendor_boot
.Untuk menambahkan ramdisk vendor bawaan, setel
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).PREBUILT
ke jalur file bawaan.Untuk menambahkan ramdisk vendor DLKM, setel
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).KERNEL_MODULE_DIRS
ke daftar direktori modul kernel yang akan disertakan.Setel
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).MKBOOTIMG_ARGS
ke argumenmkbootimg
. Ini adalah argumen--board_id[0-15]
dan--ramdisk_type
untuk fragmen vendor ramdisk. Untuk ramdisk vendor DLKM,--ramdisk_type
defaultnya adalahDLKM
jika tidak ditentukan lain.
Untuk membangun sumber daya pemulihan sebagai ramdisk recovery
mandiri di vendor_boot
:
- Setel
BOARD_BOOT_HEADER_VERSION
ke4
. - Setel
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT
ketrue
. - Setel
BOARD_INCLUDE_RECOVERY_RAMDISK_IN_VENDOR_BOOT
ketrue
. - Ini menambahkan fragmen ramdisk vendor yang
ramdisk_name
adalahrecovery
danramdisk_type
adalahVENDOR_RAMDISK_TYPE_RECOVERY
. Ramdisk kemudian berisi semua file pemulihan, yaitu file yang diinstal di bawah$(TARGET_RECOVERY_ROOT_OUT)
.
argumen mkbootimg
Argumen | Keterangan |
---|---|
--ramdisk_type | Jenis ramdisknya, bisa berupa NONE , PLATFORM , RECOVERY atau DLKM . |
--board_id[0-15] | Tentukan vektor board_id , defaultnya adalah 0 . |
Berikut contoh konfigurasinya:
BOARD_KERNEL_MODULE_DIRS := foo bar baz
BOARD_BOOT_HEADER_VERSION := 4
BOARD_VENDOR_RAMDISK_FRAGMENTS := dlkm_foobar
BOARD_VENDOR_RAMDISK_FRAGMENT.dlkm_foobar.KERNEL_MODULE_DIRS := foo bar
BOARD_VENDOR_RAMDISK_FRAGMENT.dlkm_foobar.MKBOOTIMG_ARGS := --board_id0 0xF00BA5 --board_id1 0xC0FFEE
vendor_boot
yang dihasilkan akan berisi dua fragmen ramdisk vendor. Yang pertama adalah ramdisk "default", yang berisi direktori DLKM baz
dan file lainnya di $(TARGET_VENDOR_RAMDISK_OUT)
. Yang kedua adalah dlkm_foobar
ramdisk, yang berisi direktori DLKM foo
dan bar
, dan --ramdisk_type
defaultnya adalah DLKM
.