Android 11 a introduit le concept de Generic Kernel Image (GKI). Pour permettre le démarrage facile d'un appareil arbitraire avec GKI, les appareils Android 11 peuvent utiliser la version 3 de l'en-tête d'image de démarrage. Dans la version 3, toutes les informations spécifiques au fournisseur sont extraites de la partition boot
et déplacées dans une nouvelle partition vendor_boot
. Un appareil ARM64 lancé avec Android 11 sur le noyau Linux 5.4 doit prendre en charge la partition vendor_boot
et le format de partition boot
mis à jour pour réussir les tests avec le GKI.
Les appareils Android 12 peuvent utiliser la version 4 de l’en-tête d’image de démarrage, qui prend en charge l’inclusion de disques virtuels de plusieurs fournisseurs dans la partition vendor_boot
. Plusieurs fragments de disque virtuel du fournisseur sont concaténés les uns après les autres dans la section du disque virtuel du fournisseur. Une table de disque virtuel du fournisseur est utilisée pour décrire la disposition de la section du disque virtuel du fournisseur et les métadonnées de chaque fragment de disque virtuel du fournisseur.
Structure des partitions
La partition de démarrage du fournisseur est A/B avec A/B virtuel et protégée par Android Verified Boot.
Version 3
La partition se compose d'un en-tête, du disque virtuel du fournisseur et du blob de l'arborescence des périphériques (DTB).
Section | Nombre de pages |
---|---|
En-tête de démarrage du fournisseur (n pages) | n = (2112 + page_size - 1) / page_size |
Disque virtuel du fournisseur (o pages) | o = (vendor_ramdisk_size + page_size - 1) / page_size |
DTB (ppages) | p = (dtb_size + page_size - 1) / page_size |
Version 4
La partition se compose d'un en-tête, de la section du disque virtuel du fournisseur (constituée de tous les fragments du disque virtuel du fournisseur, concaténés), du blob de l'arborescence des périphériques (DTB) et de la table du disque virtuel du fournisseur.
Section | Nombre de pages |
---|---|
En-tête de démarrage du fournisseur (n pages) | n = (2128 + page_size - 1) / page_size |
Fragments de disque virtuel du fournisseur (pages o) | o = (vendor_ramdisk_size + page_size - 1) / page_size |
DTB (ppages) | p = (dtb_size + page_size - 1) / page_size |
Tableau du disque virtuel du fournisseur (q pages) | q = (vendor_ramdisk_table_size + page_size - 1) / page_size |
Configuration de démarrage (pages r) | r = (bootconfig_size + page_size - 1) / page_size |
En-tête de démarrage du fournisseur
Le contenu de l'en-tête de la partition de démarrage du fournisseur est principalement constitué de données qui y ont été déplacées à partir de l' en-tête de l'image de démarrage . Il contient également des informations sur le disque virtuel du fournisseur.
Version 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 */
};
Version 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
est la taille totale de tous les fragments du disque virtuel du fournisseur. -
ramdisk_type
désigne le type du disque virtuel, les valeurs possibles sont :-
VENDOR_RAMDISK_TYPE_NONE
indique que la valeur n'est pas spécifiée. - Les disques virtuels
VENDOR_RAMDISK_TYPE_PLATFORM
contiennent des bits spécifiques à la plate-forme. Le chargeur de démarrage doit toujours les charger en mémoire. - Les disques virtuels
VENDOR_RAMDISK_TYPE_RECOVERY
contiennent des ressources de récupération. Le chargeur de démarrage doit les charger en mémoire lors du démarrage en mode récupération. - Les disques virtuels
VENDOR_RAMDISK_TYPE_DLKM
contiennent des modules de noyau chargeables dynamiquement.
-
-
ramdisk_name
est un nom unique du disque virtuel. -
board_id
est un vecteur d'identifiants matériels définis par le fournisseur.
Prise en charge du chargeur de démarrage
Étant donné que la partition de démarrage du fournisseur contient des informations (telles que la taille de la page Flash, le noyau, les adresses de chargement du disque virtuel, le DTB lui-même) qui existaient auparavant dans la partition de démarrage, le chargeur de démarrage doit accéder à la fois aux partitions de démarrage et au fournisseur pour disposer de suffisamment de données pour terminer le démarrage. .
Le chargeur de démarrage doit charger le disque virtuel générique en mémoire immédiatement après le disque virtuel du fournisseur (les formats CPIO, Gzip et lz4 prennent en charge ce type de concaténation). N'alignez pas les pages de l'image du disque virtuel générique et n'introduisez pas d'espace entre elle et la fin du disque virtuel du fournisseur en mémoire. Une fois que le noyau est décompressé, il extrait le fichier concaténé dans un initramfs
, ce qui donne une structure de fichier qui est un disque virtuel générique superposé à la structure de fichiers du disque virtuel du fournisseur.
Étant donné que le disque virtuel générique et le disque virtuel du fournisseur sont concaténés, ils doivent être au même format. L'image de démarrage GKI utilise un disque virtuel générique compressé lz4, donc un périphérique compatible GKI doit utiliser un disque virtuel de fournisseur compressé lz4. La configuration pour cela est présentée ci-dessous.
Les exigences du chargeur de démarrage pour prendre en charge bootconfig sont expliquées sur la page Implémentation de Bootconfig .
Disques virtuels de plusieurs fournisseurs (version 4)
Avec la version 4 de l'en-tête d'image de démarrage, le chargeur de démarrage peut sélectionner soit un sous-ensemble, soit tous les disques virtuels du fournisseur à charger en tant initramfs
pendant le démarrage. La table des disques virtuels du fournisseur contient les métadonnées de chaque disque virtuel et peut aider le chargeur de démarrage à décider quels disques virtuels charger. Le chargeur de démarrage peut décider de l'ordre de chargement des disques virtuels du fournisseur sélectionné, à condition que le disque virtuel générique soit chargé en dernier.
Par exemple, le chargeur de démarrage peut omettre de charger les disques virtuels du fournisseur de type VENDOR_RAMDISK_TYPE_RECOVERY
lors du démarrage normal pour conserver les ressources, de sorte que seuls les disques virtuels du fournisseur de type VENDOR_RAMDISK_TYPE_PLATFORM
et VENDOR_RAMDISK_TYPE_DLKM
sont chargés en mémoire. D'autre part, les disques virtuels des fournisseurs de type VENDOR_RAMDISK_TYPE_PLATFORM
, VENDOR_RAMDISK_TYPE_RECOVERY
et VENDOR_RAMDISK_TYPE_DLKM
sont chargés en mémoire lors du démarrage en mode de récupération.
Alternativement, le chargeur de démarrage peut ignorer la table du disque virtuel du fournisseur et charger l'intégralité de la section du disque virtuel du fournisseur. Cela a le même effet que le chargement de tous les fragments du disque virtuel du fournisseur dans la partition vendor_boot
.
Créer du soutien
Pour implémenter la prise en charge du démarrage du fournisseur pour un périphérique :
Définissez
BOARD_BOOT_HEADER_VERSION
sur3
ou plus.Définissez
BOARD_RAMDISK_USE_LZ4
surtrue
si votre appareil est compatible GKI ou s'il utilise un disque virtuel générique compressé lz4.Définissez
BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE
sur une taille appropriée pour votre appareil, en tenant compte des modules du noyau qui doivent être placés sur le disque virtuel du fournisseur.Mettez à jour
AB_OTA_PARTITIONS
pour inclurevendor_boot
et toutes les listes de partitions OTA spécifiques au fournisseur sur l'appareil.Copiez
fstab
de votre appareil dans/first_stage_ramdisk
dans la partitionvendor_boot
, et non dans la partitionboot
. Par exemple,$(LOCAL_PATH)/fstab.hardware:$(TARGET_COPY_OUT_VENDOR_RAMDISK)/first_stage_ramdisk/fstab.$(PRODUCT_PLATFORM)
.
Pour inclure plusieurs disques virtuels de fournisseurs dans vendor_boot
:
- Définissez
BOARD_BOOT_HEADER_VERSION
sur4
. Définissez
BOARD_VENDOR_RAMDISK_FRAGMENTS
sur une liste de noms de fragments de disque virtuel de fournisseur logique à inclure dansvendor_boot
.Pour ajouter un disque virtuel de fournisseur prédéfini, définissez
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).PREBUILT
sur le chemin du fichier prédéfini.Pour ajouter un disque virtuel de fournisseur DLKM, définissez
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).KERNEL_MODULE_DIRS
à la liste des répertoires de modules du noyau à inclure.Définissez
BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).MKBOOTIMG_ARGS
sur les argumentsmkbootimg
. Il s'agit des arguments--board_id[0-15]
et--ramdisk_type
pour le fragment de disque virtuel du fournisseur. Pour le disque virtuel du fournisseur DLKM, le--ramdisk_type
par défaut seraitDLKM
s'il n'est pas spécifié autrement.
Pour créer des ressources de récupération en tant que disque virtuel recovery
autonome dans vendor_boot
:
- Définissez
BOARD_BOOT_HEADER_VERSION
sur4
. - Définissez
BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT
surtrue
. - Définissez
BOARD_INCLUDE_RECOVERY_RAMDISK_IN_VENDOR_BOOT
surtrue
. - Cela ajoute un fragment de disque virtuel du fournisseur dont
ramdisk_name
estrecovery
etramdisk_type
estVENDOR_RAMDISK_TYPE_RECOVERY
. Le disque virtuel contient alors tous les fichiers de récupération, qui sont des fichiers installés sous$(TARGET_RECOVERY_ROOT_OUT)
.
Arguments mkbootimg
Argument | Description |
---|---|
--ramdisk_type | Le type du disque virtuel peut être NONE , PLATFORM , RECOVERY ou DLKM . |
--board_id[0-15] | Spécifiez le vecteur board_id , par défaut 0 . |
Voici un exemple de configuration :
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
Le vendor_boot
résultant contiendrait deux fragments de disque virtuel du fournisseur. Le premier est le disque virtuel "par défaut", qui contient le répertoire DLKM baz
et le reste des fichiers dans $(TARGET_VENDOR_RAMDISK_OUT)
. Le second est le disque virtuel dlkm_foobar
, qui contient les répertoires DLKM foo
et bar
, et le --ramdisk_type
est par défaut DLKM
.