Implementazione di una partizione del modulo GKI

I moduli GKI e GKI possono essere aggiornati indipendentemente dal resto della partizione perché i moduli GKI si trovano in una partizione dinamica separata nell'immagine super chiamata system_dlkm. I moduli GKI sono firmati da Google utilizzando la coppia di chiavi al momento della compilazione del kernel e sono compatibili solo con il GKI con cui sono stati compilati. Non esiste stabilità ABI tra i moduli GKI e GKI. Affinché i moduli vengano caricati correttamente durante il runtime, i moduli GKI e GKI devono essere compilati e aggiornati insieme.

Implementa il supporto della partizione system_dklm

La partizione system_dlkm si trova nella partizione super come un'altra partizione dinamica. Questa partizione può contenere:

  • Moduli kernel firmati in fase di compilazione di Google
  • depmod elementi

Build system_dlkm

La creazione di system_dlkm è una procedura simile alla creazione di altre partizioni dinamiche. Per aggiungere system_dlkm alla tua build, segui questi passaggi:

  1. In BoardConfig.mk, aggiungi le seguenti voci:

    BOARD_USES_SYSTEM_DLKMIMAGE := true
BOARD_SYSTEM_DLKMIMAGE_FILE_SYSTEM_TYPE := $(TARGET_RO_FILE_SYSTEM_TYPE)
TARGET_COPY_OUT_SYSTEM_DLKM := system_dlkm

  2. Nell'elenco delle partizioni, aggiungi system_dlkm: BOARD_GOOGLE_SYSTEM_DYNAMIC_PARTITIONS_PARTITION_LIST := system_dlkm

  3. (Facoltativo) Per i dispositivi A/B e A/B virtuali, aggiungi la seguente riga al device.mk file per il tuo dispositivo:

    AB_OTA_PARTITIONS += system_dlkm

Identifica i moduli del kernel da copiare in system_dlkm

Affinché i moduli vengano caricati correttamente in fase di runtime, i moduli GKI e GKI devono essere creati insieme. Pertanto, devi identificare i moduli del kernel nella compilazione GKI per l'architettura di destinazione e fornirli come origine per la partizione system_dlkm durante la compilazione della piattaforma.

Per Android 13

Indica BOARD_SYSTEM_DLKM_SRC come una cartella contenente i file oggetto del kernel dei moduli GKI richiesti per il dispositivo come input per il sistema di compilazione per generare la partizione system_dlkm. Ad esempio:

Fornisci il codice sorgente dei moduli GKI in una cartella e fai in modo che BOARD_SYSTEM_DLKM_SRC rimandi a quella cartella. Ad esempio:

  BOARD_SYSTEM_DLKM_SRC := kernel/prebuilts/5.10/arm64/system_dlkm_staging

Al momento della compilazione, i moduli elencati in BOARD_SYSTEM_DLKM_SRC vengono installati in $ANDROID_PRODUCT_OUT/system_dlkm.

Per Android 14

Abbiamo semplificato l'implementazione con le macro (BOARD_*_KERNEL_MODULES) utilizzate per altre partizioni*_dlkm. L'elenco dei moduli GKI richiesti per il dispositivo deve essere richiamato dalla macro BOARD_SYSTEM_KERNEL_MODULES. Al momento della compilazione, questi moduli vengono installati in $ANDROID_PRODUCT_OUT/system_dlkm. Qualsiasi modulo nella partition vendor_dlkm con dipendenze dai moduli nella partition system_dlkm genera riferimenti corretti nel file modules.dep per la partition vendor_dlkm. A causa delle dipendenze tra partizioni rappresentate da modules.dep, quando viene caricato un modulo del fornitore, qualsiasi modulo GKI necessario viene caricato automaticamente.

Ad esempio, per installare tutti i moduli GKI sulla partizione system_dlkm per il kernel GKIarm64 5.15 da precompilati:

 BOARD_SYSTEM_KERNEL_MODULES := $(wildcard kernel/prebuilts/5.15/arm64/*.ko)

Monta system_dlkm in fase di runtime

A seconda del file system utilizzato come file system di sola lettura, aggiungi quanto segue in fstab per montare la partizione system_dlkm in fase di runtime:

ext4 come file system di sola lettura

  system_dlkm /system_dlkm ext4 noatime,ro,errors=panic wait,logical,first_stage_mount,slotselect,avb

erofs come file system di sola lettura

  system_dlkm /system_dlkm erofs ro wait,logical,first_stage_mount,slotselect,avb

Montaggio delle partizioni e caricamento dei moduli

Durante first_stage_init, la partizione system_dlkm viene montata in /system_dlkm come file system di sola lettura. In caso di montaggio riuscito, sono disponibili link simbolici in /system/lib/modules che rimandano a /system_dlkm/lib/modules.

Un processo del fornitore, ad esempio uno script .rc, può quindi caricare i moduli del kernel in base all'ordine specificato in modules.load. Il processo del fornitore deve utilizzare il link simbolico /system/lib/modules per caricare i moduli. Se necessario, il processo del fornitore può anche caricare i moduli in un secondo momento.

SELinux

Ogni file nella partizione system_dlkm è etichettato con il contesto del file di system_dlkm_file. Per caricare il file dei moduli GKI nella partizione system_dlkm, il processo del fornitore responsabile del caricamento dei moduli ha bisogno di un sepolicy nel dominio del fornitore.

Ad esempio, dlkm_loader utilizzato da Cuttlefish per caricare moduli GKI presenta le seguenti autorizzazioni nel file dei criteri all'indirizzo shared/sepolicy/vendor/dlkm_loader.te:

allow dlkm_loader self:capability sys_module;
allow dlkm_loader system_dlkm_file:dir r_dir_perms;
allow dlkm_loader system_dlkm_file:file r_file_perms;
allow dlkm_loader system_dlkm_file:system module_load;

Convalida la partizione system-dlkm

Google fornisce uno scenario di test GKI VTS per verificare la partizione system_dlkm. Per invocare manualmente il test, utilizza il seguente comando atest:

  atest -c vts_dlkm_partition_test