GKI e i moduli GKI possono essere aggiornati indipendentemente dal resto della partizione perché i moduli GKI risiedono su una partizione dinamica separata nella super immagine chiamata system_dlkm . I moduli GKI sono firmati da Google utilizzando la coppia di chiavi in fase di compilazione del kernel e sono compatibili solo con la GKI con cui sono creati. Non c'è stabilità ABI tra GKI e i moduli GKI; affinché i moduli vengano caricati correttamente durante il runtime, i moduli GKI e GKI devono essere creati e aggiornati insieme.
Implementare il supporto per la partizione system_dklm
La partizione system_dlkm si trova nella super partizione come un'altra partizione dinamica. Questa partizione può contenere:
- Moduli kernel firmati in fase di compilazione da Google
- artefatti
depmod
Costruisci system_dlkm
La creazione di system_dlkm è un processo simile alla creazione di altre partizioni dinamiche. Esegui i seguenti passaggi per aggiungere system_dlkm alla tua build:
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_dlkmNell'elenco delle partizioni, aggiungi
system_dlkm:BOARD_GOOGLE_SYSTEM_DYNAMIC_PARTITIONS_PARTITION_LIST := system_dlkm(Facoltativo) Per i dispositivi A/B e A/B virtuali, aggiungi la seguente riga nel file
device.mkper il tuo dispositivo:AB_OTA_PARTITIONS += system_dlkm
Identificare 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 è necessario identificare i moduli del kernel nella build GKI per l'architettura di destinazione e fornirli come origine per la partizione system_dlkm durante la creazione della piattaforma.
Per Android 13
Puntare BOARD_SYSTEM_DLKM_SRC a 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 . Per esempio:
Fornire l'origine dei moduli GKI in una cartella e puntare BOARD_SYSTEM_DLKM_SRC a quella cartella. Per esempio:
BOARD_SYSTEM_DLKM_SRC := kernel/prebuilts/5.10/arm64/system_dlkm_staging
In fase di 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 referenziato dalla macro BOARD_SYSTEM_KERNEL_MODULES . In fase di compilazione questi moduli vengono installati in $ANDROID_PRODUCT_OUT/system_dlkm . Qualsiasi modulo nella partizione vendor_dlkm che ha dipendenze dai moduli nella partizione system_dlkm genera riferimenti corretti nel file modules.dep per la partizione vendor_dlkm . A causa di queste dipendenze tra partizioni rappresentate da modules.dep , quando viene caricato un modulo del fornitore, qualsiasi modulo GKI richiesto viene caricato automaticamente.
Ad esempio, per installare tutti i moduli GKI sulla partizione system_dlkm per GKI arm64 kernel 5.15 da quelli predefiniti:
BOARD_SYSTEM_KERNEL_MODULES := $(wildcard kernel/prebuilts/5.15/arm64/*.ko)
Monta system_dlkm in fase di esecuzione
A seconda del filesystem utilizzato come file system di sola lettura, aggiungi quanto segue nel tuo 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 della partizione 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 collegamenti simbolici su /system/lib/modules che puntano a /system_dlkm/lib/modules .
Un processo del fornitore, come 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 collegamento simbolico /system/lib/modules per caricare i moduli. Se necessario, il processo del fornitore può caricare i moduli anche in un secondo momento.
SELinux
Ogni file nella partizione system_dlkm è etichettato con il contesto del file system_dlkm_file . Per caricare il file dei moduli GKI nella partizione system_dlkm , il processo del fornitore responsabile del caricamento dei moduli necessita di una sepolicy nel dominio del fornitore.
Ad esempio, dlkm_loader utilizzato da Cuttlefish per caricare i moduli GKI ha le seguenti autorizzazioni nel file di policy su 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;
Convalidare la partizione system-dlkm
Google fornisce un test case GKI VTS per verificare la partizione system_dlkm . Per richiamare manualmente il test, utilizzare il seguente comando atest :
atest -c vts_dlkm_partition_test