Questa pagina è stata tradotta dall'API Cloud Translation.

Sposta fastboot nello spazio utente

Android 10 e versioni successive supportano le partizioni ridimensionabili di l'implementazione fastboot dal bootloader allo spazio utente. Questo il relocation consente di spostare il codice flash in un ambiente posizione comune con solo le parti di fastboot specifiche del fornitore implementate da un HAL (Hardware Astrazione Layer). Inoltre, Android 12 e superiori supportano il flashing dei ramdisk tramite un comando fastboot aggiunto.

Unifica fastboot e ripristino

Poiché fastboot e ripristino dello spazio utente sono simili, puoi unirli in una o binario. Offre vantaggi come l'utilizzo di meno spazio, il numero di partizioni complessive è minore e le operazioni di fastboot e di ripristino kernel e librerie.

Per supportare fastbootd, il bootloader deve implementare un nuovo blocco di controllo dell'avvio Comando (BCB) di boot-fastboot. Per attivare la modalità fastbootd, bootloader scrive boot-fastboot nel campo di comando del messaggio BCB e lascia il Campo recovery di BCB invariato (per consentire il riavvio di qualsiasi ripristino interrotto attività). Anche i campi status, stage e reserved rimangono invariati. Il bootloader si carica e si avvia nell'immagine di ripristino dopo aver visualizzato boot-fastboot nel campo di comando BCB. Il recupero analizza quindi il messaggio BCB e passa alla modalità fastbootd.

Comandi ADB

Questa sezione descrive il comando adb per l'integrazione di fastbootd. La ha risultati diversi, a seconda che venga eseguito dal sistema o per ripristino.

Comando	Descrizione
`reboot fastboot`	Si riavvia in `fastbootd` (sistema). Inserisce direttamente `fastbootd` senza riavvio (ripristino).

Comandi Fastboot

Questa sezione descrive i comandi fastboot per l'integrazione di fastbootd, inclusi nuovi comandi per il flashing e la gestione delle partizioni logiche. Alcune hanno risultati diversi, a seconda che siano stati eseguiti o meno bootloader o tramite fastbootd.

Comando	Descrizione
`reboot recovery`	Si riavvia e viene eseguito il ripristino (bootloader). Inserisce il ripristino direttamente senza riavvio (`fastbootd`).
`reboot fastboot`	Si riavvia in `fastbootd`.
`getvar is-userspace`	Restituisce `yes` (`fastbootd`). Restituisce `no` (bootloader).
`getvar is-logical:<partition>`	Restituisce `yes` se la partizione specificata è una partizione logica, `no` negli altri casi. Le partizioni logiche supportano tutti i comandi elencati di seguito.
`getvar super-partition-name`	Restituisce il nome della super partizione. Il nome include l'area attuale se la superpartizione è una partizione A/B (di solito non lo è).
`create-logical-partition <partition> <size>`	Crea una partizione logica con il nome e le dimensioni specificati. Il nome non deve esiste già come partizione logica.
`delete-logical-partition <partition>`	Elimina la partizione logica specificata (cancella la partizione).
`resize-logical-partition <partition> <size>`	Ridimensiona la partizione logica alle nuove dimensioni senza modificarne i contenuti. L'operazione non riesce se non c'è abbastanza spazio disponibile per eseguire il ridimensionamento.
`update-super <partition>`	Unisce le modifiche ai metadati della superpartizione. Se non è possibile unire (ad esempio, il formato sul dispositivo è una versione non supportata), questo non riesce. Un parametro facoltativo `wipe` sovrascrive la versione del dispositivo anziché eseguire un'unione.
`flash <partition> [ <filename> ]`	Scrive un file in una partizione flash. Il dispositivo deve essere in stato sbloccato.
`erase <partition>`	Resetta una partizione (non è necessaria per essere resettata sicura). Il dispositivo deve trovarsi in sbloccato.
`getvar <variable> \| all`	Visualizza una variabile bootloader o tutte le variabili. Se la variabile non esiste, restituisce un errore.
`set_active <slot>`	Imposta lo slot di avvio A/B specificato come `active`. Sul successivo tentativo di avvio, il sistema si avvia dallo slot specificato. Per il supporto A/B, gli slot sono insiemi duplicati di partizioni che possono essere avviati in modo indipendente. Gli slot sono denominati `a`, `b` e così via, e differenziati aggiungendo i suffissi `_a`, `_b` e e così via con il nome della partizione.
`reboot`	Riavvia il dispositivo normalmente.
`reboot-bootloader` (o `reboot bootloader`)	Riavvia il dispositivo in bootloader.
`fastboot fetch vendor_boot <out.img>`	Utilizza in Android 12 e versioni successive per supportare gli ramdisk del fornitore flash. Recupera l'intera dimensione della partizione e la dimensione del blocco. Recupera i dati per ogni blocco, poi unisce i dati in `<out.img>` Per maggiori dettagli, vedi `fastboot fetch vendor_boot <out.img>`.
`fastboot flash vendor_boot:default <vendor-ramdisk.img>`	Utilizzalo in Android 12 e versioni successive per supportare i ramdisk del fornitore flash. Si tratta di una variante speciale del comando Flash. Svolge una funzione immagine `fetch vendor_boot`, come se `fastboot fetch` fosse chiamato. La nuova immagine `vendor_boot` visualizzata dipende dal fatto che la versione dell'intestazione di avvio è la versione 3 o la versione 4. Per maggiori dettagli, vedi `fastboot flash vendor_boot:default <vendor-ramdisk.img>`
`fastboot flash vendor_boot:<foo> <vendor-ramdisk.img>`	Utilizza in Android 12 e versioni successive per supportare gli ramdisk del fornitore il flashing. Recupera l'immagine `vendor_boot`. Restituisce un errore se il fornitore è la versione 3. Se è la versione 4, trova quello corretto frammento ramdisk del fornitore (se disponibile). Sostituisce l'immagine con l'immagine ricalcola dimensioni e offset e mostra il nuovo valore `vendor_boot image`. Per maggiori dettagli, vedi `fastboot flash vendor_boot:<foo> <vendor-ramdisk.img>`

Fastboot e bootloader

Il bootloader esegue il flashing di bootloader, radio e boot/recovery partizioni di memoria, dopodiché il dispositivo si avvia in fastboot (spazio utente) e lampeggia da tutte le altre partizioni. Il bootloader deve supportare i comandi riportati di seguito.

Comando	Descrizione
`download`	Scarica l'immagine da flash.
`flash recovery <image>/ flash boot <image>/ flash bootloader <image>/`	Esegue il flashing della partizione `recovery/boot` e del bootloader.
`reboot`	Riavvia il dispositivo.
`reboot fastboot`	Si riavvia in fastboot.
`reboot recovery`	Viene riavviato per il ripristino.
`getvar`	Ottiene una variabile bootloader necessaria per il flashing di ripristino/avvio immagine (ad esempio, `current-slot` e `max-download-size`).
`oem <command>`	Comando definito dall'OEM.

Partizioni dinamiche

Il bootloader non deve consentire il flashing o la cancellazione delle partizioni dinamiche e deve restituire un errore se si tenta di eseguire queste operazioni. Per ristrutturazione i dispositivi di partizione dinamica, lo strumento fastboot (e bootloader) supporta una per eseguire il flashing diretto di una partizione dinamica in modalità bootloader. Per ad esempio, se system è una partizione dinamica sul dispositivo riadattato, utilizzando il comando fastboot --force flash system abilita il bootloader (invece di fastbootd) per eseguire il flashing della partizione.

Ricarica in modalità off

Se un dispositivo supporta la ricarica fuori modalità o comunque si avvia automaticamente in una in cui viene applicata la corrente, un'implementazione Il comando fastboot oem off-mode-charge 0 deve bypassare queste modalità speciali, in modo che il dispositivo si avvii come se l'utente avesse premuto il tasto di accensione.

HAL OEM Fastboot

Per sostituire completamente fastboot del bootloader, fastboot deve gestire tutte le risorse esistenti comandi fastboot. Molti di questi comandi provengono da OEM e sono documentati, richiedono un'implementazione personalizzata. Molti comandi specifici degli OEM non sono documentato. Per gestire questi comandi, l'HAL fastboot specifica le i comandi OEM. Gli OEM possono anche implementare i propri comandi.

La definizione di fastboot HAL è la seguente:

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

};

Abilita fastbootd

Per attivare fastbootd su un dispositivo:

Aggiungi fastbootd a PRODUCT_PACKAGES in device.mk: PRODUCT_PACKAGES += fastbootd.
Assicurati che fastboot HAL, HAL controllo dell'avvio e HAL di integrità siano pacchettizzati nell'immagine di ripristino.
Aggiungi eventuali autorizzazioni SEPolicy specifiche per il dispositivo richieste da fastbootd. Per Ad esempio, fastbootd richiede l'accesso in scrittura a una partizione specifica del dispositivo per eseguire il flashing della partizione. Inoltre, l'implementazione di fastboot HAL può anche richiedono autorizzazioni specifiche del dispositivo.

Per convalidare l'avvio rapido dello spazio utente, esegui la Test Suite del fornitore (VTS).

Ramdisk fornitore Flash

Android 12 e versioni successive offrono supporto per dei ramdisk lampeggianti con l'aggiunta di un comando fastboot che esegue il pull vendor_boot immagine da un dispositivo. Il comando richiede l'avvio rapido lato host per leggere l'intestazione di avvio del fornitore, la nuova immagine e il flashing della nuova immagine.

Per eseguire il pull dell'immagine vendor_boot completa, è stato aggiunto il comando fetch:vendor_boot sia al protocollo fastboot sia all'implementazione fastbootd del protocollo in Android 12. Tieni presente che fastbootd fa implementarla, ma potrebbe non esserlo il bootloader stesso. Gli OEM possono aggiungere il comando fetch:vendor_boot alla relativa implementazione del bootloader protocollo. Se invece il comando non viene riconosciuto in modalità bootloader, il flashing dei ramdisk dei singoli fornitori in modalità bootloader non è supportato .

Modifiche del bootloader

I comandi getvar:max-fetch-size e fetch:name sono implementati in fastbootd. Per supportare il flashing dei ramdisk del fornitore nel bootloader, è necessario implementare questi due comandi.

Modifiche a Fastbootd

getvar:max-fetch-size è simile a max-download-size. Specifica dimensione massima che il dispositivo può inviare in una risposta DATA. Il conducente non deve una dimensione superiore a questo valore.

fetch:name[:offset[:size]] esegue una serie di controlli sul dispositivo. Se tutte delle seguenti condizioni è vere, il comando fetch:name[:offset[:size]] restituisce dati:

Sul dispositivo è in esecuzione una build di cui è possibile eseguire il debug.
Il dispositivo è sbloccato (stato di avvio arancione).
Il nome della partizione recuperata è vendor_boot.
Il valore size rientra in 0 < size <= max-fetch-size.

Una volta verificati, fetch:name[:offset[:size]] restituisce le dimensioni della partizione e offset. Nota:

fetch:name equivale a fetch:name:0, che equivale a fetch:name:0:partition_size.
fetch:name:offset equivale a fetch:name:offset:(partition_size - offset)

Pertanto fetch:name[:offset[:size]] = fetch:name:offset:(partition_size - offset).

Quando offset o partition_size (o entrambi) non sono specificati, il valore Vengono utilizzati i valori predefiniti, che per offset è 0 e per size è il valore calcolato di partition_size - offset.

Offset specificato, dimensioni non specificate: size = partition_size - offset
Nessuno dei due specificati: valori predefiniti utilizzati per entrambi, size = partition_size - 0.

Ad esempio, fetch:foo recupera l'intera partizione foo con l'offset 0.

Modifiche ai driver

Sono stati aggiunti comandi allo strumento fastboot per implementare le modifiche del driver. Ciascuno è collegato alla sua definizione completa nella tabella di Fastboot comandi.

fastboot fetch vendor_boot out.img
- Richiama getvar max-fetch-size per determinare la dimensione del blocco.
- Richiama getvar partition-size:vendor_boot[_a] per determinare dell'intera partizione.
- Chiamate fastboot fetch vendor_boot[_a]:offset:size per ogni un blocco note. (la dimensione del blocco è maggiore della dimensione vendor_boot, perciò di solito esiste un solo blocco.
- Unisci i dati per out.img.
fastboot flash vendor_boot:default vendor-ramdisk.img

Si tratta di una variante speciale del comando Flash. Recupera le vendor_boot immagine, come se venisse chiamato fastboot fetch.
- Se l'avvio del fornitore è la versione dell'intestazione 3, esegue le seguenti operazioni:
  - Sostituisce il ramdisk del fornitore con l'immagine fornita.
  - Fa lampeggiare la nuova immagine vendor_boot.
- Se l'intestazione di avvio del fornitore è version 4, esegue le seguenti operazioni:
  - Sostituisce l'intero ramdisk del fornitore con l'immagine fornita in modo che l'immagine data diventa l'unico frammento ramdisk del fornitore nella vendor_boot immagine.
  - Ricalcola la dimensione e l'offset nella tabella ramdisk del fornitore.
  - Fa lampeggiare la nuova immagine vendor_boot.
fastboot flash vendor_boot:foo vendor-ramdisk.img

Recupera vendor_boot image, come se fosse stato chiamato fastboot fetch.
- Se l'intestazione di avvio del fornitore è la versione 3, restituisce un errore.
- Se l'intestazione di avvio del fornitore è la versione 4, procede come segue:
  - Trova il frammento ramdisk del fornitore con nome foo. Se non lo trovi, oppure se sono presenti più corrispondenze, restituisce un errore.
  - Sostituisce il frammento ramdisk del fornitore con l'immagine fornita.
  - Ricalcola ogni dimensione e offset nella tabella ramdisk del fornitore.
  - Fa lampeggiare la nuova immagine vendor_boot.

mkbootimg

Il nome default è riservato alla denominazione dei frammenti ramdisk del fornitore in Android 12 e versioni successive. Mentre fastboot flash vendor_boot:default la semantica rimane la stessa, non devi nominare i frammenti ramdisk come default.

Modifiche a SELinux

È stata apportata una modifica in fastbootd.te per supportare gli ramdisk del fornitore flash.