فست بوت را به فضای کاربری منتقل کنید

Fastboot نام یک ماژول و حالت بوت لودر است. اندروید 10 و بالاتر از پارتیشن های قابل تغییر اندازه با جابجایی پیاده سازی فست بوت از بوت لودر به فضای کاربری پشتیبانی می کند. این جابجایی امکان انتقال کدهای چشمک زن را به یک مکان مشترک قابل نگهداری و آزمایش می دهد که تنها بخش های خاص فروشنده فست بوت توسط یک لایه انتزاعی سخت افزاری (HAL) پیاده سازی شده است. علاوه بر این، اندروید 12 و بالاتر از فلش ramdisk از طریق دستور fastboot اضافه شده پشتیبانی می کند.

یکپارچه سازی فست بوت و بازیابی

از آنجایی که fastboot و بازیابی userspace مشابه هستند، می توانید آنها را در یک پارتیشن یا باینری ادغام کنید. این مزیت هایی مانند استفاده از فضای کمتر، داشتن پارتیشن های کمتر به طور کلی، و اشتراک گذاری فست بوت و بازیابی هسته و کتابخانه ها را فراهم می کند.

Fastbootd نام دیمون و حالت فضای کاربری است. برای پشتیبانی از fastbootd ، بوت لودر باید یک فرمان بلوک کنترل بوت جدید (BCB) از boot-fastboot را اجرا کند. برای ورود به حالت fastbootd ، bootloader boot-fastboot در قسمت فرمان پیام BCB می‌نویسد و قسمت recovery BCB را بدون تغییر می‌گذارد (برای فعال کردن راه‌اندازی مجدد وظایف بازیابی قطع شده). status ، stage و فیلدهای reserved نیز بدون تغییر باقی می مانند. بوت لودر با مشاهده boot-fastboot در فیلد فرمان BCB، تصویر بازیابی بارگیری و بوت می شود. سپس Recovery پیام BCB را تجزیه می کند و به حالت fastbootd می رود.

دستورات ADB

این بخش دستور adb را برای یکپارچه سازی fastbootd توضیح می دهد. این دستور بسته به اینکه توسط سیستم اجرا شود یا توسط بازیابی، نتایج متفاوتی دارد.

دستورات Fastboot

این بخش دستورات fastboot را برای یکپارچه سازی fastbootd ، از جمله دستورات جدید برای فلش کردن و مدیریت پارتیشن های منطقی توضیح می دهد. برخی از دستورات بسته به اینکه توسط bootloader یا fastbootd اجرا شده اند، نتایج متفاوتی دارند.

فست بوت و بوت لودر

بوت لودر پارتیشن های bootloader ، radio و boot/recovery را فلش می کند، پس از آن دستگاه به فست بوت (فضای کاربری) بوت می شود و همه پارتیشن های دیگر را فلش می کند. بوت لودر باید از دستورات زیر پشتیبانی کند.

پارتیشن های پویا

بوت لودر نباید اجازه چشمک زدن یا پاک کردن پارتیشن های پویا را بدهد و در صورت تلاش برای انجام این عملیات، باید خطا را برگرداند. برای دستگاه‌های پارتیشن پویا مجهز، ابزار fastboot (و بوت لودر) از حالت نیرو پشتیبانی می‌کند تا مستقیماً یک پارتیشن پویا را در حالت بوت‌لودر فلش کند. برای مثال، اگر system یک پارتیشن پویا در دستگاه مجهز شده است، با استفاده از دستور fastboot --force flash system بوت لودر را قادر می سازد (به جای fastbootd ) پارتیشن را فلش کند.

شارژ خارج از حالت

اگر دستگاهی از شارژ خارج از حالت پشتیبانی می‌کند یا در غیر این صورت هنگام استفاده از برق به حالت خاصی راه‌اندازی می‌شود، اجرای دستور fastboot oem off-mode-charge 0 باید این حالت‌های ویژه را دور بزند، به طوری که دستگاه به‌گونه‌ای بوت شود که گویی کاربر فشار داده است. دکمه پاور

Fastboot OEM HAL

برای جایگزینی کامل bootloader fastboot، fastboot باید تمام دستورات fastboot موجود را کنترل کند. بسیاری از این دستورات از OEM ها هستند و مستند شده اند اما نیاز به پیاده سازی سفارشی دارند. بسیاری از دستورات OEM خاص مستند نشده اند . برای رسیدگی به چنین دستوراتی، fastboot HAL دستورات OEM مورد نیاز را مشخص می کند. OEM ها همچنین می توانند دستورات خود را پیاده سازی کنند.

تعریف fastboot HAL به شرح زیر است:

import IFastbootLogger;

/**
 * IFastboot interface implements vendor specific fastboot commands.
 */
interface IFastboot {
    /**
     * Returns a bool indicating whether the bootloader is enforcing verified
     * boot.
     *
     * @return verifiedBootState True if the bootloader is enforcing verified
     * boot and False otherwise.
     */
    isVerifiedBootEnabled() generates (bool verifiedBootState);

    /**
     * Returns a bool indicating the off-mode-charge setting. If off-mode
     * charging is enabled, the device autoboots into a special mode when
     * power is applied.
     *
     * @return offModeChargeState True if the setting is enabled and False if
     * not.
     */
    isOffModeChargeEnabled() generates (bool offModeChargeState);

    /**
     * Returns the minimum battery voltage required for flashing in mV.
     *
     * @return batteryVoltage Minimum battery voltage (in mV) required for
     * flashing to be successful.
     */
    getBatteryVoltageFlashingThreshold() generates (int32_t batteryVoltage);

    /**
     * Returns the file system type of the partition. This is only required for
     * physical partitions that need to be wiped and reformatted.
     *
     * @return type Can be ext4, f2fs or raw.
     * @return result SUCCESS if the operation is successful,
     * FAILURE_UNKNOWN if the partition is invalid or does not require
     * reformatting.
     */
    getPartitionType(string partitionName) generates (FileSystemType type, Result result);

    /**
     * Executes a fastboot OEM command.
     *
     * @param oemCmd The oem command that is passed to the fastboot HAL.
     * @response result Returns the status SUCCESS if the operation is
     * successful,
     * INVALID_ARGUMENT for bad arguments,
     * FAILURE_UNKNOWN for an invalid/unsupported command.
     */
    doOemCommand(string oemCmd) generates (Result result);

};

فست بوت را فعال کنید

برای فعال کردن fastbootd در دستگاه:

1. افزودن fastbootd به PRODUCT_PACKAGES در device.mk : PRODUCT_PACKAGES += fastbootd .

2. مطمئن شوید که HAL fastboot، HAL کنترل بوت و HAL سلامت به عنوان بخشی از تصویر بازیابی بسته بندی شده اند.

3. هر گونه مجوز SEPolicy خاص دستگاه مورد نیاز fastbootd را اضافه کنید. برای مثال، fastbootd برای فلش کردن آن پارتیشن نیاز به دسترسی نوشتن به یک پارتیشن مخصوص دستگاه دارد. بعلاوه، اجرای fastboot HAL ممکن است به مجوزهای خاص دستگاه نیز نیاز داشته باشد.

برای تأیید اعتبار fastboot فضای کاربران، مجموعه تست فروشنده (VTS) را اجرا کنید.

رام دیسک های فروشنده فلش

اندروید 12 و بالاتر از فلش ramdisk با دستور fastboot اضافه شده پشتیبانی می‌کند که تصویر vendor_boot کامل را از دستگاه می‌کشد. دستور از ابزار fastboot سمت میزبان می‌خواهد هدر راه‌اندازی فروشنده را بخواند، تصویر جدید را دوباره تصویر کند و تصویر جدید را فلش کند.

برای کشیدن تصویر vendor_boot کامل، دستور fetch:vendor_boot به پروتکل fastboot و اجرای fastbootd پروتکل در اندروید 12 اضافه شد. توجه داشته باشید که fastbootd این را اجرا می کند، اما خود بوت لودر ممکن است این کار را انجام ندهد. OEM ها می توانند دستور fetch:vendor_boot را به پیاده سازی بوت لودر پروتکل خود اضافه کنند. با این حال، اگر فرمان در حالت بوت لودر شناسایی نشود، فلش کردن رم دیسک های تک تک فروشنده در حالت بوت لودر یک گزینه پشتیبانی شده توسط فروشنده نیست.

تغییرات بوت لودر

دستورات getvar:max-fetch-size و fetch:name در fastbootd پیاده سازی شده اند. برای پشتیبانی از ramdisk های فروشنده فلش در بوت لودر، باید این دو دستور را پیاده سازی کنید.

تغییرات Fastbootd

getvar:max-fetch-size مشابه max-download-size است. حداکثر اندازه ای را که دستگاه می تواند در یک پاسخ DATA ارسال کند را مشخص می کند. درایور نباید اندازه ای بزرگتر از این مقدار دریافت کند.

fetch:name[:offset[:size]] یک سری بررسی ها را روی دستگاه انجام می دهد. اگر همه موارد زیر درست باشد، فرمان fetch:name[:offset[:size]] داده ها را برمی گرداند:

• دستگاه در حال اجرای یک ساخت اشکال‌زدایی است.
• قفل دستگاه باز است (وضعیت بوت نارنجی).
• نام پارتیشن واکشی vendor_boot است.
• مقدار size در 0 قرار دارد < size <= max-fetch-size .

وقتی این موارد تأیید شد، fetch:name[:offset[:size]] اندازه پارتیشن و افست را برمی‌گرداند. به موارد زیر توجه کنید:

• fetch:name معادل fetch:name:0 است که معادل fetch:name:0:partition_size است.
• fetch:name:offset معادل fetch:name:offset:(partition_size - offset)

بنابراین fetch:name[:offset[:size]] = fetch:name:offset:(partition_size - offset) .

وقتی offset یا partition_size (یا هر دو) نامشخص هستند، از مقادیر پیش‌فرض استفاده می‌شود که برای offset 0 است و برای size مقدار محاسبه‌شده partition_size - offset است.

• Offset مشخص شده، اندازه نامشخص: size = partition_size - offset
• هیچ کدام مشخص نشده است: مقادیر پیش فرض استفاده شده برای هر دو، size = partition_size - 0.

برای مثال fetch:foo کل پارتیشن foo را با offset 0 واکشی می کند.

تغییر درایور

برای اجرای تغییرات درایور دستوراتی به ابزار fastboot اضافه شد. هر کدام به تعریف کامل خود در جدول دستورات Fastboot مرتبط هستند.

• fastboot fetch vendor_boot out.img

  • getvar max-fetch-size برای تعیین اندازه قطعه صدا می‌کند.
  • getvar partition-size:vendor_boot[_a] را برای تعیین اندازه کل پارتیشن فراخوانی می کند.
  • واکشی fastboot fetch vendor_boot[_a]:offset:size برای هر قطعه فرا می خواند. (اندازه تکه بزرگتر از اندازه vendor_boot است، بنابراین معمولاً فقط یک تکه وجود دارد.)
  • داده ها را به هم متصل می کند، به out.img .

• fastboot flash vendor_boot:default vendor-ramdisk.img

  این یک نوع خاص از دستور فلش است. تصویر vendor_boot واکشی می‌کند، گویی fastboot fetch فراخوانی شده است.

  • اگر بوت فروشنده نسخه هدر 3 باشد، موارد زیر را انجام می دهد:
    • ramdisk فروشنده را با تصویر داده شده جایگزین می کند.
    • تصویر vendor_boot جدید را فلش می کند.
  • اگر هدر بوت فروشنده نسخه 4 باشد، موارد زیر را انجام می دهد:
    • کل ramdisk فروشنده را با تصویر داده شده جایگزین می کند تا تصویر داده شده تنها قطعه ramdisk فروشنده در تصویر vendor_boot شود.
    • اندازه و آفست را در جدول ramdisk فروشنده دوباره محاسبه می کند.
    • تصویر vendor_boot جدید را فلش می کند.

• fastboot flash vendor_boot:foo vendor-ramdisk.img

  vendor_boot image واکشی می‌کند، گویی fastboot fetch فراخوانی شده است.

  • اگر هدر بوت فروشنده نسخه 3 باشد، یک خطا برمی گرداند.

  • اگر هدر بوت فروشنده نسخه 4 باشد، موارد زیر را انجام می دهد:

    • قطعه ramdisk فروشنده را با نام ramdisk_<var>&lt;foo></var> پیدا می کند. اگر پیدا نشد، یا اگر چندین مورد منطبق وجود داشته باشد، یک خطا برمی‌گرداند.
    • قطعه ramdisk فروشنده را با تصویر داده شده جایگزین می کند.
    • هر اندازه و آفست را در جدول ramdisk فروشنده دوباره محاسبه می کند.
    • تصویر vendor_boot جدید را فلش می کند.

  • اگر <foo> مشخص نشده باشد، سعی می کند ramdisk_ پیدا کند.

mkbootimg

نام default برای نام‌گذاری قطعات ramdisk فروشنده در اندروید 12 و بالاتر محفوظ است. در حالی که معنای fastboot flash vendor_boot:default ثابت می ماند، شما نباید قطعات ramdisk خود را به عنوان default نام ببرید.

SELinux تغییر می کند

تغییری در fastbootd.te برای پشتیبانی از ramdisks فروشنده چشمک زن ایجاد شد.