Memindahkan Fastboot ke Userspace

Android 10 dan yang lebih tinggi mendukung partisi yang dapat diubah ukurannya dengan memindahkan implementasi fastboot dari bootloader ke ruang pengguna. Relokasi ini memungkinkan pemindahan kode flashing ke lokasi umum yang dapat dipelihara dan diuji dengan hanya bagian fastboot khusus vendor yang diimplementasikan oleh lapisan abstraksi perangkat keras (HAL). Selain itu, Android 12 dan yang lebih tinggi mendukung flashing ramdisk melalui perintah fastboot tambahan.

Menyatukan fastboot dan pemulihan

Karena fastboot dan pemulihan ruang pengguna serupa, Anda dapat menggabungkannya menjadi satu partisi atau biner. Ini memberikan keuntungan seperti menggunakan lebih sedikit ruang, memiliki lebih sedikit partisi secara keseluruhan, dan memiliki fastboot dan pemulihan berbagi kernel dan perpustakaan mereka.

Untuk mendukung fastbootd , bootloader harus mengimplementasikan perintah boot control block (BCB) baru dari boot-fastboot . Untuk masuk ke mode fastbootd , bootloader menulis boot-fastboot ke bidang perintah pesan BCB dan membiarkan bidang recovery BCB tidak berubah (untuk mengaktifkan memulai ulang tugas pemulihan yang terputus). status , stage , dan bidang yang reserved juga tetap tidak berubah. Bootloader memuat dan mem-boot ke image pemulihan setelah melihat boot-fastboot di bidang perintah BCB. Pemulihan kemudian mem-parsing pesan BCB dan beralih ke mode fastbootd .

perintah ADB

Bagian ini menjelaskan perintah adb untuk mengintegrasikan fastbootd . Perintah memiliki hasil yang berbeda, tergantung pada apakah itu dijalankan oleh sistem atau oleh pemulihan.

Perintah fastboot

Bagian ini menjelaskan perintah fastboot untuk mengintegrasikan fastbootd , termasuk perintah baru untuk mem-flash dan mengelola partisi logis. Beberapa perintah memiliki hasil yang berbeda, tergantung apakah perintah tersebut dijalankan oleh bootloader atau oleh fastbootd .

Fastboot dan bootloader

Bootloader mem-flash partisi bootloader , radio , dan boot/recovery , setelah itu perangkat melakukan booting ke fastboot (ruang pengguna) dan mem-flash semua partisi lainnya. Bootloader harus mendukung perintah berikut.

Partisi dinamis

Bootloader tidak boleh mengizinkan flashing atau penghapusan partisi dinamis dan harus mengembalikan kesalahan jika operasi ini dicoba. Untuk perangkat partisi dinamis yang dipasang kembali, alat fastboot (dan bootloader) mendukung mode paksa untuk mem-flash partisi dinamis secara langsung saat dalam mode bootloader. Misalnya, jika system adalah partisi dinamis pada perangkat yang dipasang kembali, menggunakan perintah fastboot --force flash system memungkinkan bootloader (bukan fastbootd ) untuk mem-flash partisi.

Pengisian daya di luar mode

Jika perangkat mendukung pengisian daya off-mode atau boot otomatis ke mode khusus saat daya diterapkan, implementasi perintah fastboot oem off-mode-charge 0 harus melewati mode khusus ini, sehingga perangkat melakukan booting seolah-olah pengguna telah menekan tombol daya.

Fastboot OEM HAL

Untuk sepenuhnya mengganti fastboot bootloader, fastboot harus menangani semua perintah fastboot yang ada. Banyak dari perintah ini berasal dari OEM dan didokumentasikan tetapi memerlukan implementasi khusus. Banyak perintah khusus OEM tidak didokumentasikan. Untuk menangani perintah tersebut, fastboot HAL menentukan perintah OEM yang diperlukan. OEM juga dapat mengimplementasikan perintah mereka sendiri.

Definisi fastboot HAL adalah sebagai berikut:

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);

};

Mengaktifkan fastbootd

Untuk mengaktifkan fastbootd pada perangkat:

1. Tambahkan fastbootd ke PRODUCT_PACKAGES di device.mk : PRODUCT_PACKAGES += fastbootd .

2. Pastikan fastboot HAL, boot control HAL, dan health HAL dikemas sebagai bagian dari citra pemulihan.

3. Tambahkan izin SEPolicy khusus perangkat apa pun yang diperlukan oleh fastbootd . Misalnya, fastbootd memerlukan akses tulis ke partisi khusus perangkat untuk mem-flash partisi tersebut. Selain itu, implementasi fastboot HAL mungkin juga memerlukan izin khusus perangkat.

Untuk memvalidasi fastboot ruang pengguna, jalankan Vendor Test Suite (VTS) .

Mem-flash ramdisk vendor

Android 12 dan yang lebih tinggi menyediakan dukungan untuk mem-flash ramdisk dengan perintah fastboot tambahan yang menarik image vendor_boot lengkap dari perangkat. Perintah tersebut meminta alat fastboot sisi host untuk membaca header boot vendor, reimage, dan mem-flash image baru.

Untuk menarik gambar vendor_boot lengkap, perintah fetch:vendor_boot telah ditambahkan ke protokol fastboot, dan implementasi protokol fastbootd di Android 12. Perhatikan bahwa fastbootd mengimplementasikan ini , tetapi bootloader itu sendiri mungkin tidak. OEM dapat menambahkan perintah fetch:vendor_boot ke implementasi protokol bootloader mereka. Namun, jika perintah tidak dikenali dalam mode bootloader, maka mem-flash ramdisk masing-masing vendor dalam mode bootloader bukanlah opsi yang didukung vendor.

Perubahan bootloader

Perintah getvar:max-fetch-size dan fetch:name diimplementasikan di fastbootd . Untuk mendukung flashing ramdisk vendor di bootloader, Anda harus mengimplementasikan dua perintah ini.

Perubahan fastboot

getvar:max-fetch-size mirip dengan max-download-size . Ini menentukan ukuran maksimum yang dapat dikirim perangkat dalam satu respons DATA. Pengemudi tidak boleh mengambil ukuran yang lebih besar dari nilai ini.

fetch:name[:offset[:size]] melakukan serangkaian pemeriksaan pada perangkat. Jika semua hal berikut ini benar, perintah fetch:name[:offset[:size]] mengembalikan data:

• Perangkat menjalankan build yang dapat di-debug.
• Perangkat tidak terkunci (kondisi boot oranye).
• Nama partisi yang diambil adalah vendor_boot .
• Nilai size termasuk dalam 0 < size <= max-fetch-size .

Ketika ini diverifikasi, fetch:name[:offset[:size]] mengembalikan ukuran partisi dan offset. Perhatikan hal berikut:

• fetch:name setara dengan fetch:name:0 , yang setara dengan fetch:name:0:partition_size .
• fetch:name:offset sama dengan fetch:name:offset:(partition_size - offset)

Oleh karena itu fetch:name[:offset[:size]] = fetch:name:offset:(partition_size - offset)

Ketika offset atau partition_size (atau keduanya) tidak ditentukan, nilai default digunakan, yang untuk offset adalah 0, dan untuk size adalah nilai yang dihitung dari partition_size - offset .

• Offset ditentukan, ukuran tidak ditentukan: size = partition_size - offset
• Tidak ditentukan: nilai default digunakan untuk keduanya, size = partition_size - 0.

Misalnya, fetch:foo mengambil seluruh partisi foo pada offset 0.

Perubahan pengemudi

Perintah ditambahkan ke alat fastboot untuk mengimplementasikan perubahan driver. Masing-masing ditautkan ke definisi lengkapnya di tabel perintah Fastboot .

• fastboot fetch vendor_boot out.img

  • Memanggil getvar max-fetch-size untuk menentukan ukuran chunk.
  • Memanggil getvar partition-size:vendor_boot[_a] untuk menentukan ukuran seluruh partisi.
  • Memanggil fastboot fetch vendor_boot[_a]:offset:size untuk setiap chunk. (Ukuran chunk lebih besar dari ukuran vendor_boot , jadi biasanya hanya ada satu chunk.)
  • Menyatukan data, menjadi out.img .

• fastboot flash vendor_boot:default vendor-ramdisk.img

  Ini adalah varian khusus dari perintah flash. Itu mengambil gambar vendor_boot , seolah-olah fastboot fetch dipanggil.

  • Jika boot vendor adalah header versi 3 , ia melakukan hal berikut:
    • Menggantikan ramdisk vendor dengan gambar yang diberikan.
    • Mem-flash gambar vendor_boot baru.
  • Jika header boot vendor adalah versi 4 , ia melakukan hal berikut:
    • Menggantikan seluruh ramdisk vendor dengan image yang diberikan sehingga image yang diberikan menjadi satu-satunya fragmen ramdisk vendor dalam image vendor_boot .
    • Menghitung ulang ukuran dan offset di tabel ramdisk vendor.
    • Mem-flash gambar vendor_boot baru.

• fastboot flash vendor_boot:foo vendor-ramdisk.img

  Mengambil vendor_boot image , seolah-olah fastboot fetch dipanggil.

  • Jika header boot vendor adalah versi 3, itu mengembalikan kesalahan.

  • Jika header boot vendor adalah versi 4, ia melakukan hal berikut:

    • Menemukan fragmen ramdisk vendor dengan nama foo . Jika tidak ditemukan, atau jika ada beberapa kecocokan, mengembalikan kesalahan.
    • Menggantikan fragmen ramdisk vendor dengan gambar yang diberikan.
    • Menghitung ulang setiap ukuran dan offset di tabel ramdisk vendor.
    • Mem-flash gambar vendor_boot baru.

mkbootimg

Nama default dicadangkan untuk penamaan fragmen ramdisk vendor di Android 12 dan yang lebih tinggi. Meskipun semantik fastboot flash vendor_boot:default tetap sama, Anda tidak boleh menamai fragmen ramdisk Anda sebagai default .

SELinux berubah

Perubahan dibuat di fastbootd.te untuk mendukung flashing ramdisk vendor.