Tedarikçi firma önyükleme bölümleri

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Android 11, Genel Kernel kavramını ortaya çıkardı Resim (GKI). Android 11 cihazlar, GKI ile rastgele bir cihazın başlatılmasını etkinleştirmek için önyükleme resmi üstbilgisi sürüm 3'ü kullanabilir. 3. sürümde, tedarikçiye özgü tüm bilgiler boot bölümünden çıkarılır ve yeni bir vendor_boot bölümüne taşınır. 5.4 Linux çekirdeğinde Android 11 ile kullanıma sunulan ARM64 cihazların, GKI ile testi geçmesi için vendor_boot bölümünü ve güncellenmiş boot bölüm biçimini desteklemesi gerekir.

Android 12 cihazlar başlatma görüntüsü başlığı sürüm 4'ü kullanabilir. vendor_boot bölüm. Birden fazla tedarikçi firma ramdisk parçası birbiri ardına birleştiriliyor yer alır. Bir tedarikçi firma ramdisk tablosu, tedarikçi firma ramdisk bölümünün düzeni ve her tedarikçi firma ramdisk'inin meta verileri olabilir.

Bölüm yapısı

Tedarikçi firma başlatma bölümü, sanal A/B ile A/B olarak ayarlanır ve Android tarafından korunur. Doğrulanmış Başlatma.

Sürüm 3

Bölüm bir başlık, tedarikçi firma diski ve cihaz ağacı blobundan oluşur. (DTB).

Sürüm 4

Bölüm bir başlıktan, tedarikçi firma ramdisk bölümünden ( birleştirilmiş), cihaz ağacı blob'u (DTB) ve tedarikçi firma ramdisk tablosu.

Tedarikçi firma başlatma başlığı

Tedarikçi firma önyükleme bölümü üstbilgisinin içeriği, temel olarak önyükleme resmi üstbilgisinin üstbilgisine taşınan verilerden oluşur. Google satıcı ramdisk'i hakkında da bilgi içerir.

Sürüm 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 */

};

Sürüm 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, tüm tedarikçi ramdisk parçalarının toplam boyutudur.
• ramdisk_type, ramdisk'in türünü gösterir. Olası değerler şunlardır:
  • VENDOR_RAMDISK_TYPE_NONE, değerin belirtilmediğini gösterir.
  • VENDOR_RAMDISK_TYPE_PLATFORM RAM'leri platforma özel bitler içerir. Bootloader bunları her zaman belleğe yüklemelidir.
  • VENDOR_RAMDISK_TYPE_RECOVERY ramdisk'leri kurtarma kaynaklarını içerir. Bootloader, kurtarma moduna önyükleme yaparken bunları belleğe yüklemelidir.
  • VENDOR_RAMDISK_TYPE_DLKM RAM diskleri, dinamik yüklenebilir çekirdek içeriyor modüllerinde yer alır.
• ramdisk_name, ramdisk'in benzersiz bir adıdır.
• board_id, tedarikçi firma tarafından tanımlanan donanım tanımlayıcılarının bir vektörüdür.

Bootloader desteği

Tedarikçi firma başlatma bölümü, Flash sayfası boyutu ve/veya alan adı gibi DTB'nin kendisi) aynı olacaktır. Bootloader'ın hem başlatma hem de satıcı başlatma işlemine erişmesi gerekir. bölüm oluşturmayı ve bölümleri değiştirmeyin.

Bootloader, genel ramdisk'i aşağıdaki işlemden hemen sonra belleğe yüklemelidir CPIO, Gzip ve lz4 biçimleri bu tür dosya türlerini destekler. birleştirme). Genel ramdisk resmini sayfaya hizalamayın veya bu resim ile bellekteki tedarikçi ramdisk'in sonu arasına başka bir alan eklemeyin. Çekirdek, sıkıştırmayı çözdükten sonra birleştirilmiş dosyayı bir initramfs dosyasına çıkarır. Bu işlem, tedarikçi ramdisk dosya yapısının üzerine yerleştirilmiş genel bir ramdisk olan bir dosya yapısıyla sonuçlanır.

Genel ramdisk ve tedarikçi ramdiski birleştirildiğinden aynı biçimde olmalıdırlar. GKI önyükleme görüntüsü lz4 sıkıştırılmış genel bir ramdisk kullandığından, GKI uyumlu bir cihaz lz4 sıkıştırılmış bir tedarikçi ramdiski kullanmalıdır. Bunun için gereken yapılandırma aşağıda gösterilmiştir.

bootconfig'i desteklemek için bootloader gereksinimleri bootconfig'i uygulama bölümünde açıklanmıştır.

Birden fazla tedarikçi firma RAM'i (sürüm 4)

Başlatma görüntüsü başlık sürümü 4'te, bootloader bir alt küme veya tüm tedarikçi firma RAM'lerini başlatma sırasında initramfs olarak yüklenecek şekilde ayarlayın. Tedarikçi firma ramdisk tablosu, her ramdisk'in meta verilerini içerir ve hangi ramdisk'lerin yükleneceğine karar verirken önyükleyiciye yardımcı olabilir. Genel ramdisk en son yüklenecek şekilde, önyükleme programı seçilen tedarikçi ramdisklerinin yükleme sırasına karar verebilir.

Örneğin, önyükleyici, kaynakları korumak için normal önyükleme sırasında VENDOR_RAMDISK_TYPE_RECOVERY türündeki tedarikçi ramdisk'lerini yüklemeyebilir. Bu nedenle, belleğe yalnızca VENDOR_RAMDISK_TYPE_PLATFORM ve VENDOR_RAMDISK_TYPE_DLKM türündeki tedarikçi ramdisk'leri yüklenir. Öte yandan, VENDOR_RAMDISK_TYPE_PLATFORM, VENDOR_RAMDISK_TYPE_RECOVERY ve VENDOR_RAMDISK_TYPE_DLKM türündeki tedarikçi ramdisk'leri, kurtarma modunda önyükleme yapılırken belleğe yüklenir.

Alternatif olarak, önyükleme programı tedarikçi ramdisk tablosunu yok sayabilir ve tedarikçi ramdisk bölümünün tamamını yükleyebilir. Bu, tüm reklam öğelerinin yüklenmesiyle vendor_boot bölümündeki tedarikçi firma ramdisk parçaları.

Derleme desteği

Bir cihaza satıcı başlatma desteğini uygulamak için:

• BOARD_BOOT_HEADER_VERSION öğesini 3 veya daha yüksek bir değere ayarlayın.

• Cihazınız GKI uyumluysa veya lz4 sıkıştırılmış genel bir ramdisk kullanıyorsa BOARD_RAMDISK_USE_LZ4 değerini true olarak ayarlayın.

• BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE öğesini videonuz için uygun bir boyuta ayarlayın tedarikçi firma RAM'inde bulunması gereken çekirdek modüllerini de göz önünde bulundurun.

• AB_OTA_PARTITIONS uygulamasını, vendor_boot ürününü ve tedarikçiye özel tüm öğeleri içerecek şekilde güncelleyin OTA bölümlerinin listesini görürsünüz.

• Cihazınızı boot değil, vendor_boot bölümündeki /first_stage_ramdisk içine kopyalayın. Örneğin, $(LOCAL_PATH)/fstab.hardware:$(TARGET_COPY_OUT_VENDOR_RAMDISK)/first_stage_ramdisk/fstab.$(PRODUCT_PLATFORM)

vendor_boot öğesine birden fazla tedarikçi firma RAM'i eklemek için:

• BOARD_BOOT_HEADER_VERSION değerini 4 olarak ayarlayın.

• BOARD_VENDOR_RAMDISK_FRAGMENTS öğesini, mantıksal satıcı ramdisk'inin bir listesine ayarlayın parça adları vendor_boot içine dahil edilecek.

• Önceden oluşturulmuş bir tedarikçi ramdisk'i eklemek için BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).PREBUILT değerini önceden oluşturulmuş yola ayarlayın.

• DLKM tedarikçisi ramdisk eklemek için BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).KERNEL_MODULE_DIRS değerini, dahil edilecek çekirdek modülü dizinlerinin listesine ayarlayın.

• BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).MKBOOTIMG_ARGS değerini şuna ayarla: mkbootimg bağımsız değişken. Bunlar --board_id[0-15] ve --ramdisk_type için bağımsız değişkenlerin bir listesidir. DLKM tedarikçisi ramdisk için, aksi belirtilmediyse varsayılan --ramdisk_type DLKM olur.

Kurtarma kaynaklarını vendor_boot ürününde bağımsız bir recovery RAM'i olarak oluşturmak için:

• BOARD_BOOT_HEADER_VERSION değerini 4 olarak ayarlayın.
• BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT değerini true olarak ayarlayın.
• BOARD_INCLUDE_RECOVERY_RAMDISK_IN_VENDOR_BOOT değerini true olarak ayarlayın.
• Bu işlem, ramdisk_name değeri recovery ve ramdisk_type değeri VENDOR_RAMDISK_TYPE_RECOVERY olan bir tedarikçi ramdisk parçası ekler. Ramdisk, altında bulunan tüm kurtarma dosyalarını $(TARGET_RECOVERY_ROOT_OUT)

mkbootimg bağımsız değişkenleri

Aşağıda örnek bir yapılandırma verilmiştir:

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

Sonuçta elde edilen vendor_boot, iki tedarikçi ramdisk parçası içerir. İlgili içeriği oluşturmak için kullanılan İlki "varsayılan" baz ve DLKM dizinini içeren ramdisk $(TARGET_VENDOR_RAMDISK_OUT) klasöründeki diğer dosyalar. İkincisi ise foo ve bar DLKM dizinlerini içeren dlkm_foobar ramdisk ve --ramdisk_type, varsayılan olarak DLKM değerine ayarlanır.