W Androidzie 9 w nagłówku obrazu rozruchowego dodano pole wersji, które umożliwiało aktualizowanie nagłówka przy zachowaniu zgodności wstecznej. Program rozruchowy musi sprawdzić pole wersji nagłówka i odpowiednio przeanalizować nagłówek. Urządzenia uruchamiane z:
- Android 13 może używać nagłówka rozruchowego w wersji 3 lub 4. W przypadku urządzeń obsługujących architekturę ogólnego obrazu jądra (GKI) wersja 4 jest podstawowym obrazem rozruchowym, a pole
os_version
w nagłówku rozruchowym musi zawierać zero. Program rozruchowy urządzenia powinien zamiast tego pobrać informacje o wersji z usług weryfikacji podczas uruchamiania Androida (AVB). - Android 12 może używać nagłówka rozruchowego w wersji 3 lub 4. W przypadku urządzeń obsługujących architekturę ogólnego obrazu jądra (GKI) podstawowym obrazem rozruchowym jest wersja 4.
- Android 11 może używać nagłówka rozruchowego w wersji 3. W przypadku urządzeń obsługujących architekturę ogólnego obrazu jądra (GKI) ta wersja musi być używana jako podstawowy obraz rozruchowy.
- Android 10 musi używać nagłówka rozruchowego w wersji 2.
- Android 9 musi używać nagłówka rozruchowego w wersji 1.
- Android 8 i starsze wersje są uważane za korzystające z nagłówka obrazu rozruchowego w wersji 0.
W przypadku wszystkich urządzeń z Androidem 9 lub nowszym Vendor Test Suite (VTS) sprawdza format obrazu boot/recovery
, aby upewnić się, że nagłówek obrazu rozruchowego używa prawidłowej wersji. Szczegółowe informacje o AOSP dotyczące wszystkich obsługiwanych nagłówków obrazów rozruchowych i dostawców obrazów rozruchowych znajdziesz w system/tools/mkbootimg/include/bootimg/bootimg.h
.
Wdrażanie obsługi wersji nagłówka obrazu rozruchowego
Narzędzie mkbootimg
akceptuje poniższe argumenty.
Argument | Opis |
---|---|
header_version |
Ustawia wersję nagłówka obrazu rozruchowego. Obraz rozruchowy z wersją nagłówka:
|
recovery_dtbo |
Używana w przypadku architektur korzystających z przenoszenia danych. Określa ścieżkę do obrazu DTBO przywracania. Opcjonalny w przypadku urządzeń A/B, które nie wymagają obrazu przywracania.
Urządzenia inne niż A/B korzystające z header_version :
|
recovery_acpio |
Używany w przypadku architektur, które korzystają z ACPI zamiast DTB. Określa ścieżkę do obrazu przywracania ACPIO. Opcjonalny w przypadku urządzeń A/B, które nie wymagają obrazu przywracania. Urządzenia inne niż A/B korzystające z header_version :
|
dtb |
Ścieżka do obrazu DTB widocznego w obrazach rozruchowych/przywracania. |
dtb_offset |
Dodanie go do argumentu base powoduje podanie fizycznego adresu obciążenia końcowego drzewa urządzeń. Jeśli na przykład argument base to 0x10000000 , a argument dtb_offset to 0x01000000 , dtb_addr_field w nagłówku obrazu rozruchowego zostanie zapełniona jako 0x11000000 . |
Urządzenie BoardConfig.mk
używa konfiguracji BOARD_MKBOOTIMG_ARGS
, aby dodać header version
do innych argumentów tablicy mkbootimg
. Przykład:
BOARD_MKBOOTIMG_ARGS := --ramdisk_offset $(BOARD_RAMDISK_OFFSET) --tags_offset $(BOARD_KERNEL_TAGS_OFFSET) --header_version $(BOARD_BOOTIMG_HEADER_VERSION)
System kompilacji Androida używa zmiennej BoardConfig
BOARD_PREBUILT_DTBOIMAGE
do ustawienia argumentu recovery_dtbo
narzędzia mkbootimg
podczas tworzenia obrazu przywracania. Szczegółowe informacje o zmianach dotyczących Android Open Source Project (AOSP) znajdziesz na powiązanych listach zmian dotyczących obsługi wersji nagłówka obrazu rozruchowego.
Nagłówek obrazu rozruchowego, wersja 4
Android 12 udostępnia w nagłówku obrazu rozruchowego w wersji 4 identyfikator boot_signature
, który umożliwia sprawdzanie integralności jądra i ramdysk. Sprawdzanie jest wykonywane w VtsSecurityAvbTest i jest wymagane w przypadku urządzeń korzystających z architektury GKI. Jednak boot_signature
nie uczestniczy w procesie weryfikacji podczas uruchamiania konkretnego urządzenia i jest używany tylko w VTS. Szczegółowe informacje znajdziesz w sekcjach Konfiguracja płyty startowej GKI i Ustawienia zweryfikowanego rozruchu GKI.
Nagłówek obrazu rozruchowego dostawcy w wersji 4 obsługuje wiele fragmentów dysku ramdisk dostawcy.
Wersja 4 nagłówka obrazu rozruchowego korzysta z poniższego formatu.
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];
uint32_t signature_size; /* size in bytes */
};
Nagłówek obrazu rozruchowego, wersja 3
Android 11 aktualizuje nagłówek obrazu rozruchowego do wersji 3, która usuwa te dane:
Program rozruchowy drugiego etapu. Pola
second_size
isecond_addr
nie są już widoczne w nagłówku obrazu rozruchowego. Urządzenia z drugim etapem programu rozruchowego muszą przechowywać go na osobnej partycji.Obraz przywracania. Wycofaliśmy wymóg określania obrazu przywracania, a pola
recovery_dtbo_size
,recovery_dtbo_offset
,recovery_acpio_size
irecovery_acpio_offset
nie są już wyświetlane w nagłówku obrazu rozruchowego.Urządzenia A/B używają schematu aktualizacji i przywracania, dzięki czemu nie ma potrzeby określania obrazu DTBO ani ACPIO na potrzeby przywracania.
Urządzenia inne niż A/B, które chcą określić obraz przywracania (DTBO, albo ACPIO), powinny używać nagłówka obrazu rozruchowego w wersji 1 lub 2.
Obiekt blob drzewa urządzenia (DTB). Plik przenoszenia danych jest przechowywany w partycji rozruchowej dostawcy, więc pola
dtb_size
idtb_addr
nie są już widoczne w nagłówku obrazu rozruchowego (ale znajdują się w nagłówku obrazu rozruchowego dostawcy).
Urządzenia mogą używać nagłówka obrazu rozruchowego w wersji 3, aby zachować zgodność z architekturą ogólnego obrazu jądra (GKI), która ujednolica podstawowe jądro i przenosi moduły dostawców wymagane do rozruchu na partycję vendor_boot
(co oznacza, że obraz rozruchowy zawiera tylko komponenty GKI). Urządzenia, które:
Używaj GKI (wymaga ją jądra Androida w wersji 4.19 lub 5.4), ale nie używaj aktualizacji A/B, które mogą określać obraz przywracania przy użyciu obrazu rozruchowego w wersji 3 jako obrazu rozruchowego oraz obrazu rozruchowego w wersji 2 jako obrazu przywracania.
Nie używaj GKI i nie używaj aktualizacji A/B, aby określić obraz przywracania za pomocą obrazu rozruchowego w wersji 1 lub 2 zarówno dla obrazu rozruchowego, jak i przywracania.
Wersja 3 nagłówka obrazu rozruchowego korzysta z poniższego formatu.
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];
};
Nagłówek obrazu rozruchowego, wersja 2
Android 10 aktualizuje nagłówek obrazu rozruchowego do wersji 2, który zawiera sekcję z informacjami o obrazie przenoszenia danych (rozmiar obrazu i fizyczny adres wczytywania).
Wersja 2 nagłówka obrazu rozruchowego korzysta z poniższego formatu.
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 */
};
Nagłówek obrazu rozruchowego, wersja 1
Android 9 konwertuje pole unused
nagłówka obrazu rozruchowego na pole wersji nagłówka. Urządzenia uruchamiane z Androidem 9 muszą używać nagłówka obrazu rozruchowego z wersją nagłówka ustawioną na 1 lub wyższą (weryfikacja ta jest weryfikowana przez VTS).
Wersja 1 nagłówka obrazu rozruchowego używa poniższego formatu.
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 */
};
Urządzenia inne niż A/B mogą określić obraz nakładki DTB/ACPI na potrzeby odzyskiwania, aby zmniejszyć liczbę błędów aktualizacji bezprzewodowo (OTA). (W przypadku urządzeń A/B ten problem nie występuje i nie trzeba określać obrazu nad powierzchnią). Możesz podać albo DTBO, albo obraz ACPIO, ale nie oba (ponieważ są używane przez różne architektury). Aby poprawnie skonfigurować nagłówek obrazu rozruchowego, gdy używasz:
Obraz DTBO do odzyskiwania konta, uwzględnij pola
recovery_dtbo_size
irecovery_dtbo_offset
(bez pólrecovery_acpio_size
irecovery_acpio_offset
).Obraz ACPIO przywracania uwzględnij pola
recovery_acpio_size
irecovery_acpio_offset
(bez pólrecovery_dtbo_size
irecovery_dtbo_offset
).
Pole header_size
zawiera rozmiar nagłówka obrazu rozruchowego. Jeśli wersja nagłówka obrazu rozruchowego jest ustawiona na 1, pole id
zawiera skrót SHA-1 sekcji recovery_[dtbo|acpio]
obrazu rozruchowego oraz kernel
, ramdisk
i second sections
. Szczegółowe informacje o polach recovery_[dtbo|acpio]_size
i recovery_[dtbo|acpio]_offset
znajdziesz w artykule o obrazach przywracania.
Nagłówek starszej wersji obrazu rozruchowego, wersja 0
Urządzenia uruchomione przed Androidem 9, które korzystały ze starszego nagłówka obrazu rozruchowego, są uznawane za korzystające z nagłówka obrazu rozruchowego w wersji 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];
};