ส่วนหัวของอิมเมจบูท

จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

Android 9 ได้เปิดตัวช่องเวอร์ชันในส่วนหัวของภาพการบูต ซึ่งช่วยให้อัปเดตส่วนหัวได้ในขณะที่ยังคงใช้งานร่วมกับเวอร์ชันเก่าได้ บูตโหลดเดอร์ต้องตรวจสอบช่องเวอร์ชันส่วนหัวและแยกวิเคราะห์ส่วนหัวตามนั้น อุปกรณ์ที่เปิดตัวด้วย

• Android 13 สามารถใช้ส่วนหัวการบูตเวอร์ชัน 3 หรือ 4 สำหรับ อุปกรณ์ที่รองรับอิมเมจเคอร์เนลทั่วไป (GKI) สถาปัตยกรรมเวอร์ชัน 4 คืออิมเมจการเปิดเครื่องหลักและ os_version ในส่วนหัวการเปิดเครื่องต้องเป็น 0 คาดว่า Bootloader ของอุปกรณ์ รับข้อมูลเวอร์ชันจากการเปิดเครื่องที่ได้รับการยืนยันของ Android (AVB) พร็อพเพอร์ตี้แทน
• Android 12 สามารถใช้ส่วนหัวของบูตเวอร์ชัน 3 หรือ 4 สำหรับ อุปกรณ์ที่รองรับอิมเมจเคอร์เนลทั่วไป (GKI) สถาปัตยกรรมเวอร์ชัน 4 คืออิมเมจการเปิดเครื่องหลัก
• Android 11 สามารถใช้ส่วนหัวการเปิดเครื่องเวอร์ชัน 3 ได้ สำหรับ อุปกรณ์ที่รองรับอิมเมจเคอร์เนลทั่วไป (GKI) สถาปัตยกรรม คุณต้องใช้เวอร์ชันนี้สำหรับอิมเมจการเปิดเครื่องหลัก
• Android 10 ต้องใช้ส่วนหัวการบูตเวอร์ชัน 2
• Android 9 ต้องใช้ส่วนหัวการบูตเวอร์ชัน 1
• Android 8 และต่ำกว่าจะถือว่าใช้ส่วนหัวอิมเมจการเปิดเครื่องเวอร์ชัน 0

สำหรับอุปกรณ์ทั้งหมดที่ใช้ Android 9 ขึ้นไป Vendor Test Suite (VTS) จะตรวจสอบรูปแบบของ boot/recovery เพื่อให้ส่วนหัวอิมเมจการเปิดเครื่องใช้ที่ถูกต้อง เวอร์ชัน หากต้องการดูรายละเอียด AOSP เกี่ยวกับส่วนหัวของภาพสำหรับบูตและภาพสำหรับบูตของผู้ให้บริการที่รองรับทั้งหมด โปรดดูที่ system/tools/mkbootimg/include/bootimg/bootimg.h

ใช้การกำหนดเวอร์ชันส่วนหัวอิมเมจการเปิดเครื่อง

เครื่องมือ mkbootimg ยอมรับอาร์กิวเมนต์ต่อไปนี้

อุปกรณ์ BoardConfig.mk ใช้การกําหนดค่า BOARD_MKBOOTIMG_ARGS เพื่อเพิ่ม header version ลงในอาร์กิวเมนต์เฉพาะบอร์ดอื่นๆ ของ mkbootimg เช่น

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

ระบบบิลด์ Android ใช้ตัวแปร BoardConfig BOARD_PREBUILT_DTBOIMAGE เพื่อตั้งค่าอาร์กิวเมนต์ recovery_dtbo ของเครื่องมือ mkbootimg ในระหว่างการสร้างอิมเมจการกู้คืน ดูรายละเอียดเกี่ยวกับการเปลี่ยนแปลงในโครงการ Android Open Source (AOSP) ได้ที่รายการการเปลี่ยนแปลงที่เกี่ยวข้องสำหรับส่วนหัวของภาพสำหรับบูต

ส่วนหัวของอิมเมจบูตเวอร์ชัน 4

Android 12 มี boot_signature ในอิมเมจเปิดเครื่อง ส่วนหัวเวอร์ชัน 4 ซึ่งสามารถใช้เพื่อตรวจสอบความสมบูรณ์ของเคอร์เนลและ ramdisk การตรวจสอบจะดำเนินการใน VtsSecurityAvbTest และจำเป็นสำหรับอุปกรณ์ที่ใช้สถาปัตยกรรม GKI อย่างไรก็ตาม boot_signature ไม่ได้เกี่ยวข้องกับกระบวนการเปิดเครื่องที่เชื่อถือได้เฉพาะอุปกรณ์ และจะใช้ใน VTS เท่านั้น ดูกระดาน Boot.img ของ GKI การกำหนดค่า และการเปิดเครื่องที่ได้รับการยืนยัน GKI การตั้งค่า เพื่อดูรายละเอียด

อิมเมจการเปิดเครื่องของผู้ให้บริการ ส่วนหัว เวอร์ชัน 4 รองรับ Fragment ของ RAM ของผู้ให้บริการหลายรายการ

เวอร์ชัน 4 ของเวอร์ชันส่วนหัวของอิมเมจการเปิดเครื่องจะใช้รูปแบบต่อไปนี้

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 */
};

ส่วนหัวของอิมเมจบูตเวอร์ชัน 3

Android 11 อัปเดตส่วนหัวของอิมเมจการเปิดเครื่องเป็นเวอร์ชัน 3 ซึ่งจะลบข้อมูลต่อไปนี้

• Bootloader ระยะที่ 2 ช่อง second_size และ second_addr จะไม่ปรากฏในส่วนหัวของภาพสำหรับบูตอีกต่อไป อุปกรณ์ที่มี Bootloader ระยะที่ 2 ต้องจัดเก็บ Bootloader นั้นไว้ในพาร์ติชันของตัวเอง

• อิมเมจการกู้คืน เราได้เลิกใช้งานข้อกำหนดในการระบุรูปภาพการกู้คืนแล้ว และช่อง recovery_dtbo_size, recovery_dtbo_offset, recovery_acpio_size และ recovery_acpio_offset จะไม่ปรากฏในส่วนหัวของรูปภาพสำหรับบูตอีกต่อไป

  • อุปกรณ์ A/B ใช้รูปแบบการอัปเดตและการกู้คืนที่ทำให้ไม่จำเป็น ระบุอิมเมจ DTBO หรือ ACPIO สำหรับการกู้คืน

  • อุปกรณ์ที่ไม่ใช่ A/B ที่ต้องการระบุรูปภาพการกู้คืน (DTBO หรือ ACPIO) ควรใช้ส่วนหัวของรูปภาพสำหรับบูตเวอร์ชัน 1 หรือ 2

• บล็อกแผนผังอุปกรณ์ (DTB) DTB จะเก็บอยู่ในการเปิดเครื่องของผู้ให้บริการ พาร์ติชัน เพื่อไม่ให้ช่อง dtb_size และ dtb_addr ปรากฏในอิมเมจเปิดเครื่องอีก ส่วนหัว (แต่อยู่ในส่วนหัวอิมเมจการเปิดเครื่องของผู้ให้บริการ)

อุปกรณ์สามารถใช้ส่วนหัวของภาพการบูตเวอร์ชัน 3 เพื่อปฏิบัติตามสถาปัตยกรรมภาพเคอร์เนลทั่วไป (GKI) ซึ่งรวมเคอร์เนลหลักและย้ายโมดูลของผู้ให้บริการที่จําเป็นสําหรับการบูตไปยังพาร์ติชัน vendor_boot (หมายความว่าภาพการบูตจะมีเฉพาะคอมโพเนนต์ GKI) อุปกรณ์ที่มีลักษณะดังนี้

• ใช้ GKI (ต้องใช้เคอร์เนล android-4.19 หรือ android-5.4) แต่อย่าใช้การอัปเดต A/B ซึ่งระบุอิมเมจการกู้คืนได้โดยใช้อิมเมจบูตเวอร์ชัน 3 สำหรับอิมเมจบูตและอิมเมจบูตเวอร์ชัน 2 สำหรับอิมเมจการกู้คืน

• ไม่ใช้ GKI และไม่ใช้การอัปเดต A/B จะระบุอิมเมจการกู้คืนได้โดยใช้ อิมเมจการเปิดเครื่องเวอร์ชัน 1 หรือ 2 สำหรับทั้งอิมเมจการเปิดเครื่องและอิมเมจการกู้คืน

เวอร์ชัน 3 ของเวอร์ชันส่วนหัวของอิมเมจการเปิดเครื่องจะใช้รูปแบบต่อไปนี้

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];
};

ส่วนหัวของรูปภาพเปิดเครื่อง เวอร์ชัน 2

Android 10 อัปเดตส่วนหัวของภาพการบูตเป็นเวอร์ชัน 2 ซึ่งเพิ่มส่วนสำหรับข้อมูลภาพ DTB สำหรับการกู้คืน (ขนาดภาพและที่อยู่การโหลดจริง)

เวอร์ชัน 2 ของเวอร์ชันส่วนหัวของอิมเมจการเปิดเครื่องจะใช้รูปแบบต่อไปนี้

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 */
};

ส่วนหัวของรูปภาพเปิดเครื่อง เวอร์ชัน 1

Android 9 แปลงช่อง unused ของการเปิดเครื่อง ไปยังช่องเวอร์ชันส่วนหัว อุปกรณ์ที่เปิดตัวด้วย Android 9 ต้องใช้ส่วนหัวของภาพสำหรับบูตโดยตั้งค่าเวอร์ชันส่วนหัวเป็น 1 ขึ้นไป (VTS จะยืนยันข้อมูลนี้)

ส่วนหัวของภาพสำหรับบูตเวอร์ชัน 1 ใช้รูปแบบต่อไปนี้

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 */
};

อุปกรณ์ที่ไม่ใช่ A/B สามารถระบุรูปภาพซ้อนทับ DTB/ACPI สำหรับ การกู้คืนเพื่อช่วยลด การอัปเดตผ่านอากาศ (OTA) ไม่สำเร็จ (อุปกรณ์ A/B จะไม่มีปัญหานี้และไม่จำเป็นต้องระบุรูปภาพวางซ้อน) คุณสามารถระบุภาพของ DTBO หรือ อิมเมจ ACPIO แต่ไม่ใช่ทั้ง 2 รูป (เนื่องจากใช้ในสถาปัตยกรรมที่ต่างกัน) หากต้องการกำหนดค่าส่วนหัวอิมเมจการเปิดเครื่องอย่างถูกต้อง ให้ทำดังนี้

• รูปภาพ DTBO สำหรับการกู้คืน ให้ใส่ช่อง recovery_dtbo_size และ recovery_dtbo_offset (และอย่าใส่ช่อง recovery_acpio_size และ recovery_acpio_offset)

• อิมเมจ ACPIO สำหรับการกู้คืน ซึ่งมี recovery_acpio_size และ recovery_acpio_offset ช่อง (และไม่รวม recovery_dtbo_size และ recovery_dtbo_offset ช่อง)

ช่อง header_size จะมีขนาดของส่วนหัวอิมเมจการเปิดเครื่อง หากตั้งค่าเวอร์ชันส่วนหัวของภาพบูตเป็น 1 ช่อง id จะมีข้อมูลสรุป SHA-1 สำหรับส่วน recovery_[dtbo|acpio] ของภาพบูต นอกเหนือจาก kernel, ramdisk และ second sections ดูรายละเอียดเกี่ยวกับช่อง recovery_[dtbo|acpio]_size และ recovery_[dtbo|acpio]_offset ได้ที่รูปภาพการกู้คืน

ส่วนหัวอิมเมจการเปิดเครื่องแบบเดิม เวอร์ชัน 0

อุปกรณ์ที่เปิดก่อน Android 9 โดยใช้ ส่วนหัวอิมเมจการเปิดเครื่องจะถือว่าใช้ส่วนหัวอิมเมจการเปิดเครื่องเวอร์ชัน 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];
};