將 Fastboot 移至使用者空間

「Fastboot」是開機載入程式模組和模式的名稱。Android 10 以上版本支援可調整大小的分割區，方法是將 fastboot 實作項目從開機載入程式重新定位到使用者空間。這項重定位作業可將刷機程式碼移至可維護及可測試的通用位置，並僅透過硬體抽象層 (HAL) 實作 Fastboot 的供應商專屬部分。此外，Android 12 以上版本支援透過新增的 fastboot 指令刷寫 ramdisk。

統一 Fastboot 和 Recovery

由於使用者空間的 Fastboot 和 Recovery 類似，因此您可以將兩者合併為一個磁碟分割區或二進位檔。這項做法的優點包括減少空間用量、減少整體分割區，以及讓 Fastboot 和復原共用核心和程式庫。

Fastbootd 是使用者空間精靈和模式的名稱。 如要支援 fastbootd，開機載入程式必須實作 boot-fastboot 的新開機控制區塊 (BCB) 指令。如要進入 fastbootd 模式，開機載入器會將 boot-fastboot 寫入 BCB 訊息的指令欄位，並將 BCB 的 recovery 欄位維持不變 (以便重新啟動任何中斷的復原工作)。status、stage 和 reserved 欄位也會維持不變。 看到 BCB 指令欄位中的 boot-fastboot 時，開機載入器會載入並啟動復原映像檔。然後，復原程序會剖析 BCB 訊息，並切換至 fastbootd 模式。

ADB 指令

本節說明整合 fastbootd 的 adb 指令。視執行指令的是系統還是復原功能，指令會產生不同的結果。

Fastboot 指令

本節說明整合 fastbootd 的 fastboot 指令，包括用於刷寫及管理邏輯分割區的新指令。部分指令的結果會因執行者是開機載入程式或 fastbootd 而異。

Fastboot 和系統啟動載入程式

系統啟動載入程式會刷寫 bootloader、radio 和 boot/recovery 分區，之後裝置會啟動進入 Fastboot (使用者空間)，並刷寫所有其他分區。開機載入程式應支援下列指令。

動態分割區

開機載入器不得允許動態分區的刷機或清除作業，且如果嘗試執行這些作業，必須傳回錯誤。如果是改裝的動態分區裝置，fastboot 工具 (和開機載入器) 支援強制模式，可在開機載入器模式下直接刷新動態分區。舉例來說，如果 system 是改裝裝置上的動態分割區，使用 fastboot --force flash system 指令可讓開機載入程式 (而非 fastbootd) 刷寫分割區。

關機充電

如果裝置支援關機充電，或是在供電時自動啟動特殊模式，則 fastboot oem off-mode-charge 0 指令的實作方式必須略過這些特殊模式，讓裝置啟動時如同使用者按下電源鍵。

Fastboot OEM HAL

如要完全取代開機載入程式 Fastboot，Fastboot 必須處理所有現有的 Fastboot 指令。其中許多指令來自 OEM，且已記錄在文件中，但需要自訂實作。許多 OEM 專屬指令並未記錄在文件中。為處理這類指令，fastboot HAL 會指定必要的 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

如要在裝置上啟用 fastbootd，請按照下列步驟操作：

1. 在 device.mk 中將 fastbootd 新增至 PRODUCT_PACKAGES：PRODUCT_PACKAGES += fastbootd。

2. 確認 fastboot HAL、啟動控制 HAL 和健康狀態 HAL 已封裝為復原映像檔的一部分。

3. 新增 fastbootd 所需的任何裝置專屬 SEPolicy 權限。舉例來說，fastbootd 需要裝置專屬分區的寫入權限，才能將該分區刷寫至裝置。此外，實作 Fastboot HAL 也可能需要裝置專屬權限。

如要驗證使用者空間 Fastboot，請執行供應商測試套件 (VTS)。

刷入供應商 ramdisk

Android 12 以上版本支援使用新增的 Fastboot 指令刷寫 RAM 磁碟，從裝置擷取完整的 vendor_boot 映像檔。這個指令會提示主機端的 Fastboot 工具讀取供應商啟動標頭、重新建立映像檔，並刷入新映像檔。

如要提取完整的 vendor_boot 映像檔，Android 12 的 fastboot 協定和協定的 fastbootd 實作項目都新增了 fetch:vendor_boot 指令。請注意，fastbootd 會實作這項功能，但開機載入程式本身可能不會。原始設備製造商 (OEM) 可以在通訊協定的開機載入程式實作中新增 fetch:vendor_boot 指令。不過，如果開機載入程式模式無法辨識指令，則在開機載入程式模式中刷入個別供應商 ramdisk，並非供應商支援的選項。

系統啟動載入程式變更

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 的計算值。

• 指定位移，但未指定大小：size = partition_size - offset
• 兩者皆未指定：兩者皆使用預設值，size = partition_size - 0。

舉例來說，fetch:foo 會在偏移量 0 處擷取整個 foo 分區。

駕駛人異動

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

  這是 flash 指令的特殊變體。系統會擷取 vendor_boot 圖片，就像呼叫 fastboot fetch 一樣。

  • 如果供應商啟動標頭是版本 3，則會執行下列動作：
    • 使用指定映像檔取代供應商 RAM 磁碟。
    • 刷寫新的 vendor_boot 映像檔。
  • 如果供應商啟動標頭是版本 4，則會執行下列動作：
    • 以指定映像檔取代整個供應商 ramdisk，使指定映像檔成為 vendor_boot 映像檔中唯一的供應商 ramdisk 片段。
    • 重新計算供應商 RAM 磁碟表中的大小和偏移。
    • 刷寫新的 vendor_boot 映像檔。

• fastboot flash vendor_boot:foo vendor-ramdisk.img

  擷取 vendor_boot image，如同呼叫 fastboot fetch。

  • 如果供應商啟動標頭為第 3 版，則會傳回錯誤。

  • 如果供應商啟動標頭為第 4 版，則會執行下列操作：

    • 找出名為 ramdisk_<var>&lt;foo></var> 的供應商 RAM 磁碟片段。如果找不到相符項目，或是有多個相符項目，則會傳回錯誤。
    • 使用指定映像檔取代供應商 ramdisk 片段。
    • 重新計算供應商 RAM 磁碟表中的每個大小和位移。
    • 刷寫新的 vendor_boot 映像檔。

  • 如未指定 <foo>，則會嘗試尋找 ramdisk_。

mkbootimg

在 Android 12 以上版本中，名稱 default 保留用於命名供應商 RAM 磁碟片段。雖然 fastboot flash vendor_boot:default 語意保持不變，但不得將 ramdisk 片段命名為 default。

SELinux 變更

為支援刷入供應商 ramdisk， fastbootd.te 進行了變更。