বিক্রেতা বুট পার্টিশন

অ্যান্ড্রয়েড 11 জেনেরিক কার্নেল ইমেজ (জিকেআই) ধারণাটি চালু করেছে। GKI-এর সাহায্যে সহজে একটি স্বেচ্ছাচারী ডিভাইস বুট করা সক্ষম করতে, Android 11 ডিভাইসগুলি বুট ইমেজ হেডার সংস্করণ 3 ব্যবহার করতে পারে। সংস্করণ 3-এ, সমস্ত বিক্রেতা-নির্দিষ্ট তথ্য boot পার্টিশন থেকে ফ্যাক্টর করা হয় এবং একটি নতুন vendor_boot পার্টিশনে স্থানান্তরিত হয়। 5.4 Linux কার্নেলে অ্যান্ড্রয়েড 11-এর সাথে লঞ্চ করা একটি ARM64 ডিভাইস অবশ্যই vendor_boot পার্টিশন এবং আপডেট করা boot পার্টিশন ফর্ম্যাটকে GKI-এর সাথে পরীক্ষায় উত্তীর্ণ হতে হবে।

অ্যান্ড্রয়েড 12 ডিভাইসগুলি বুট ইমেজ হেডার সংস্করণ 4 ব্যবহার করতে পারে, যা vendor_boot পার্টিশনে একাধিক বিক্রেতা রামডিস্ক সহ সমর্থন করে। একাধিক বিক্রেতা র‌্যামডিস্ক খণ্ড একের পর এক বিক্রেতা র‌্যামডিস্ক বিভাগে সংযুক্ত করা হয়েছে। একটি ভেন্ডর রামডিস্ক টেবিল ভেন্ডর রামডিস্ক সেকশনের লেআউট এবং প্রতিটি ভেন্ডর রামডিস্ক ফ্র্যাগমেন্টের মেটাডেটা বর্ণনা করতে ব্যবহৃত হয়।

পার্টিশন কাঠামো

ভেন্ডর বুট পার্টিশনটি ভার্চুয়াল A/B সহ A/B'd এবং Android Verified Boot দ্বারা সুরক্ষিত।

সংস্করণ 3

পার্টিশনে একটি হেডার, ভেন্ডর রামডিস্ক এবং ডিভাইস ট্রি ব্লব (DTB) থাকে।

অধ্যায় পৃষ্ঠা সংখ্যা
ভেন্ডর বুট হেডার (n পৃষ্ঠা) n = (2112 + page_size - 1) / page_size
বিক্রেতা রামডিস্ক (ও পৃষ্ঠা) o = (vendor_ramdisk_size + page_size - 1) / page_size
DTB (p পৃষ্ঠা) p = (dtb_size + page_size - 1) / page_size

সংস্করণ 4

পার্টিশনে একটি হেডার, ভেন্ডর র‍্যামডিস্ক বিভাগ (সমস্ত ভেন্ডর র‍্যামডিস্ক ফ্র্যাগমেন্ট সমন্বিত, কনক্যাটেনেটেড), ডিভাইস ট্রি ব্লব (DTB) এবং ভেন্ডর রামডিস্ক টেবিল রয়েছে।

অধ্যায় পৃষ্ঠা সংখ্যা
ভেন্ডর বুট হেডার (n পৃষ্ঠা) n = (2128 + page_size - 1) / page_size
বিক্রেতা র‌্যামডিস্কের টুকরো (ও পৃষ্ঠা) o = (vendor_ramdisk_size + page_size - 1) / page_size
DTB (p পৃষ্ঠা) p = (dtb_size + page_size - 1) / page_size
বিক্রেতা রামডিস্ক টেবিল (কিউ পৃষ্ঠা) q = (vendor_ramdisk_table_size + page_size - 1) / page_size
Bootconfig (r পৃষ্ঠাগুলি) r = (bootconfig_size + page_size - 1) / page_size

বিক্রেতা বুট হেডার

বিক্রেতা বুট পার্টিশন হেডারের বিষয়বস্তু প্রাথমিকভাবে বুট ইমেজ হেডার থেকে সেখানে স্থানান্তরিত করা ডেটা নিয়ে গঠিত। এটিতে বিক্রেতা রামডিস্ক সম্পর্কেও তথ্য রয়েছে।

সংস্করণ 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 */

};

সংস্করণ 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 হল সমস্ত ভেন্ডর র‍্যামডিস্কের টুকরোগুলির মোট আকার।
  • ramdisk_type ramdisk-এর ধরন বোঝায়, সম্ভাব্য মানগুলি হল:
    • VENDOR_RAMDISK_TYPE_NONE নির্দেশ করে যে মানটি অনির্দিষ্ট।
    • VENDOR_RAMDISK_TYPE_PLATFORM রামডিস্কে প্ল্যাটফর্ম নির্দিষ্ট বিট থাকে। বুটলোডারকে অবশ্যই এগুলোকে মেমরিতে লোড করতে হবে।
    • VENDOR_RAMDISK_TYPE_RECOVERY রামডিস্কে পুনরুদ্ধারের সংস্থান রয়েছে। পুনরুদ্ধারে বুট করার সময় বুটলোডারকে অবশ্যই মেমরিতে এগুলি লোড করতে হবে।
    • VENDOR_RAMDISK_TYPE_DLKM ramdisk-এ গতিশীল লোডযোগ্য কার্নেল মডিউল থাকে।
  • ramdisk_name হল ramdisk এর একটি অনন্য নাম।
  • board_id বিক্রেতা সংজ্ঞায়িত হার্ডওয়্যার সনাক্তকারীর একটি ভেক্টর।

বুটলোডার সমর্থন

যেহেতু বিক্রেতা বুট পার্টিশনে তথ্য রয়েছে (যেমন ফ্ল্যাশ পৃষ্ঠার আকার, কার্নেল, র‌্যামডিস্ক লোড ঠিকানা, DTB নিজেই) যা আগে বুট পার্টিশনে ছিল, বুটলোডারকে অবশ্যই বুট এবং বিক্রেতা বুট উভয় পার্টিশন অ্যাক্সেস করতে হবে যাতে বুটিং সম্পূর্ণ করার জন্য যথেষ্ট ডেটা থাকে। .

বুটলোডারকে অবশ্যই বিক্রেতা র‌্যামডিস্কের (CPIO, Gzip, এবং lz4 ফর্ম্যাটগুলি এই ধরনের সংমিশ্রণ সমর্থন করে) অনুসরণ করে মেমরিতে জেনেরিক রামডিস্ক লোড করতে হবে। জেনেরিক রামডিস্ক চিত্রটিকে পৃষ্ঠায় সারিবদ্ধ করবেন না বা মেমরিতে এটি এবং বিক্রেতা র্যামডিস্কের শেষের মধ্যে অন্য কোনও স্থান প্রবর্তন করবেন না। কার্নেল ডিকম্প্রেস করার পরে, এটি একটি initramfs এ সংযুক্ত ফাইলটি বের করে, যার ফলে একটি ফাইল কাঠামো তৈরি হয় যা বিক্রেতা র্যামডিস্ক ফাইল কাঠামোর উপর একটি জেনেরিক রামডিস্ক আবৃত হয়।

কারণ জেনেরিক রামডিস্ক এবং বিক্রেতা রামডিস্ক একত্রিত হয়, সেগুলি অবশ্যই একই বিন্যাসে হতে হবে৷ GKI বুট ইমেজ একটি lz4-সংকুচিত জেনেরিক র‌্যামডিস্ক ব্যবহার করে, তাই একটি ডিভাইস যেটি GKI-সঙ্গত সে অবশ্যই একটি lz4-সংকুচিত ভেন্ডর রামডিস্ক ব্যবহার করবে। এর জন্য কনফিগারেশন নীচে দেখানো হয়েছে।

বুটকনফিগকে সমর্থন করার জন্য বুটলোডারের প্রয়োজনীয়তাগুলি ইমপ্লিমেন্টিং Bootconfig পৃষ্ঠায় ব্যাখ্যা করা হয়েছে।

একাধিক বিক্রেতা রামডিস্ক (সংস্করণ 4)

বুট ইমেজ হেডার সংস্করণ 4 এর সাথে, বুটলোডার বুট করার সময় initramfs হিসাবে লোড করার জন্য একটি সাবসেট বা সমস্ত ভেন্ডর রামডিস্ক নির্বাচন করতে পারে। ভেন্ডর র‌্যামডিস্ক টেবিলে প্রতিটি র‌্যামডিস্কের মেটাডেটা থাকে এবং কোন র‌্যামডিস্ক লোড করা হবে তা সিদ্ধান্ত নিতে বুটলোডারকে সাহায্য করতে পারে। বুটলোডার নির্বাচিত বিক্রেতা র‌্যামডিস্কগুলি লোড করার আদেশ নির্ধারণ করতে পারে, যতক্ষণ না জেনেরিক রামডিস্ক শেষ লোড হয়।

উদাহরণ স্বরূপ, বুটলোডার সাধারণ বুটের সময় VENDOR_RAMDISK_TYPE_RECOVERY টাইপের ভেন্ডর র‍্যামডিস্ক লোড করা বাদ দিতে পারে রিসোর্স সংরক্ষণ করতে, তাই শুধুমাত্র VENDOR_RAMDISK_TYPE_PLATFORM এবং VENDOR_RAMDISK_TYPE_DLKM মেমরিতে লোড করা ভেন্ডর র‍্যামডিস্ক। অন্যদিকে, রিকভারি মোডে বুট করার সময় VENDOR_RAMDISK_TYPE_PLATFORM , VENDOR_RAMDISK_TYPE_RECOVERY এবং VENDOR_RAMDISK_TYPE_DLKM টাইপের ভেন্ডর রামডিস্কগুলি মেমরিতে লোড হয়৷

বিকল্পভাবে, বুটলোডার ভেন্ডর র‌্যামডিস্ক টেবিল উপেক্ষা করতে পারে এবং পুরো ভেন্ডর রামডিস্ক সেকশন লোড করতে পারে। vendor_boot পার্টিশনের সমস্ত ভেন্ডর রামডিস্কের টুকরো লোড করার মতোই এর প্রভাব রয়েছে।

সমর্থন তৈরি করুন

একটি ডিভাইসের জন্য বিক্রেতা বুট সমর্থন বাস্তবায়ন করতে:

  • BOARD_BOOT_HEADER_VERSION 3 বা তার বেশিতে সেট করুন।

  • BOARD_RAMDISK_USE_LZ4 true সেট করুন যদি আপনার ডিভাইস GKI-সঙ্গী হয়, অথবা যদি এটি অন্যথায় একটি lz4-সংকুচিত জেনেরিক রামডিস্ক ব্যবহার করে।

  • BOARD_VENDOR_BOOTIMAGE_PARTITION_SIZE আপনার ডিভাইসের জন্য একটি উপযুক্ত আকারে সেট করুন, কার্নেল মডিউলগুলি বিবেচনা করে যেগুলি ভেন্ডর র্যামডিস্কে যেতে হবে৷

  • AB_OTA_PARTITIONS আপডেট করুন vendor_boot এবং ডিভাইসে OTA পার্টিশনের যেকোনো ভেন্ডর-নির্দিষ্ট তালিকা অন্তর্ভুক্ত করতে।

  • vendor_boot পার্টিশনে /first_stage_ramdisk এ আপনার ডিভাইস fstab কপি করুন, boot পার্টিশনে নয়। উদাহরণস্বরূপ, $(LOCAL_PATH)/fstab.hardware:$(TARGET_COPY_OUT_VENDOR_RAMDISK)/first_stage_ramdisk/fstab.$(PRODUCT_PLATFORM)

vendor_boot এ একাধিক বিক্রেতা রামডিস্ক অন্তর্ভুক্ত করতে:

  • BOARD_BOOT_HEADER_VERSION কে 4 এ সেট করুন।

  • BOARD_VENDOR_RAMDISK_FRAGMENTS লজিক্যাল ভেন্ডর র‍্যামডিস্ক ফ্র্যাগমেন্ট নামের তালিকায় vendor_boot এ অন্তর্ভুক্ত করুন।

  • একটি প্রি-বিল্ট ভেন্ডর র‍্যামডিস্ক যোগ করতে, BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).PREBUILT সেট করুন। প্রিবিল্ট ফাইল পাথে PREBUILT।

  • একটি DLKM ভেন্ডর রামডিস্ক যোগ করতে, BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).KERNEL_MODULE_DIRS অন্তর্ভুক্ত করার জন্য কার্নেল মডিউল ডিরেক্টরির তালিকায় সেট করুন।

  • BOARD_VENDOR_RAMDISK_FRAGMENT.$(vendor_ramdisk).MKBOOTIMG_ARGS কে mkbootimg আর্গুমেন্টে সেট করুন। বিক্রেতা র‍্যামডিস্ক ফ্র্যাগমেন্টের জন্য এইগুলি হল --board_id[0-15] এবং --ramdisk_type আর্গুমেন্ট। DLKM ভেন্ডর ramdisk-এর জন্য, ডিফল্ট --ramdisk_type হবে DLKM যদি অন্যথায় নির্দিষ্ট করা না থাকে।

vendor_boot এ একটি স্বতন্ত্র recovery রামডিস্ক হিসাবে পুনরুদ্ধারের সংস্থানগুলি তৈরি করতে:

  • BOARD_BOOT_HEADER_VERSION কে 4 এ সেট করুন।
  • BOARD_MOVE_RECOVERY_RESOURCES_TO_VENDOR_BOOT true সেট করুন।
  • BOARD_INCLUDE_RECOVERY_RAMDISK_IN_VENDOR_BOOT true সেট করুন।
  • এটি একটি ভেন্ডর রামডিস্ক ফ্র্যাগমেন্ট যোগ করে যার ramdisk_name হল recovery এবং ramdisk_type হল VENDOR_RAMDISK_TYPE_RECOVERY । রামডিস্কে তখন সমস্ত পুনরুদ্ধার ফাইল থাকে, যেগুলি $(TARGET_RECOVERY_ROOT_OUT) এর অধীনে ইনস্টল করা ফাইল।

mkbootimg আর্গুমেন্ট

যুক্তি বর্ণনা
--ramdisk_type রামডিস্কের ধরন, NONE , PLATFORM , RECOVERY বা DLKM এর একটি হতে পারে।
--board_id[0-15] board_id ভেক্টর নির্দিষ্ট করুন, ডিফল্ট 0 এ।

নিম্নলিখিত একটি উদাহরণ কনফিগারেশন:

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 দুটি বিক্রেতা রামডিস্ক খণ্ড থাকবে। প্রথমটি হল "ডিফল্ট" র‍্যামডিস্ক, যেটিতে DLKM ডিরেক্টরি baz এবং বাকি ফাইল $(TARGET_VENDOR_RAMDISK_OUT) রয়েছে। দ্বিতীয়টি হল dlkm_foobar ramdisk, যেটিতে DLKM ডিরেক্টরি foo এবং bar রয়েছে এবং --ramdisk_type ডিফল্ট DLKM তে।