Partição DLKM de Fornecedor/ODM

O Android 11 introduz o conceito de imagem genérica do kernel e a partição de inicialização do fornecedor. A partição de inicialização do fornecedor armazena módulos de kernel compatíveis com GKI e é carregada pelo init do primeiro estágio. Os módulos do kernel anteriores ao lançamento do Android 11 também são armazenados em partições de fornecedor e ODM e são carregados por processos de fornecedor.

Para Android 11 ou superior, o kernel e todos os módulos do kernel podem ser atualizados independentemente do restante das partições. Para habilitar atualizações para módulos de kernel armazenados na partição de fornecedor (sem uma atualização de partição de fornecedor), mova todos os módulos de partição de fornecedor para uma nova partição chamada Vendor DLKM (módulo de kernel carregável dinamicamente). Você pode atualizar essa partição de forma independente. Da mesma forma, você pode mover todos os módulos do kernel armazenados na partição ODM para uma nova partição chamada ODM DLKM . Esta partição também pode ser atualizada de forma independente.

Local da partição

As partições vendor_dlkm e odm_dlkm estão localizadas na superpartição como outra partição dinâmica.

conteúdo do vendor_dlkm em /vendor/lib/modules

  • Módulos de kernel do fornecedor
  • arquivos de configuração modprobe
  • Um arquivo modules.load

conteúdo do odm_dlkm em /odm/lib/modules

  • Módulos do kernel ODM
  • arquivos de configuração modprobe
  • Um arquivo modules.load

Consulte Suporte ao módulo do kernel para obter mais detalhes sobre os arquivos de configuração do módulo do kernel.

Construir suporte

A construção vendor_dlkm e odm_dlkm é um processo similar à construção de outras partições dinâmicas.

exemplo de compilação vendor_dlkm

Crie vendor_dlkm conforme mostrado no exemplo abaixo.

BoardConfig.mk

BOARD_USES_VENDOR_DLKMIMAGE := true
BOARD_VENDOR_DLKMIMAGE_FILE_SYSTEM_TYPE := ext4
TARGET_COPY_OUT_VENDOR_DLKM := vendor_dlkm
BOARD_<GROUP_NAME>_PARTITION_LIST += vendor_dlkm

Substitua <GROUP_NAME> pelo nome apropriado do grupo de atualização. O grupo de atualização deve ser o grupo em que a partição do fornecedor está.

Para dispositivos A/B e Virtual A/B, device.mk

AB_OTA_PARTITIONS += vendor_dlkm

fstab

Adicione a seguinte entrada para vendor_dlkm ao fstab. Altere os sinalizadores de acordo com o dispositivo. Use o CL Add vendor_dlkm to CF como um exemplo.

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

exemplo de compilação odm_dlkm

Construa odm_dlkm conforme mostrado no exemplo abaixo.

BoardConfig.mk

BOARD_USES_ODM_DLKIMAGE := true
BOARD_ODM_DLKIMAGE_FILE_SYSTEM_TYPE := ext4
TARGET_COPY_OUT_ODM_DLKM := odm_dlkm
BOARD_<group_name>_PARTITION_LIST += odm_dlkm

Para dispositivos A/B e Virtual A/B, device.mk

AB_OTA_PARTITIONS += odm_dlkm

fstab

Adicione a seguinte entrada para odm_dlkm ao fstab. Altere os sinalizadores de acordo com o dispositivo. Use o CL Add odm_dlkm to CF como um exemplo.

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

Copiando módulos do kernel em uma partição

Para selecionar os módulos do kernel que você deseja copiar para a partição vendor_dlkm , liste-os em BOARD_VENDOR_KERNEL_MODULES .

Se você deseja substituir o conteúdo de modules.load , pode especificá-lo em BOARD_VENDOR_KERNEL_MODULES_LOAD .

No momento da compilação, os módulos listados em BOARD_VENDOR_KERNEL_MODULES são instalados em $ANDROID_PRODUCT_OUT/vendor_dlkm/lib/modules . Um link simbólico é criado em /vendor/lib/modules que leva a /vendor_dlkm/lib/modules .

Da mesma forma, para selecionar os módulos do kernel que você deseja copiar para a partição odm_dlkm , liste-os em BOARD_ODM_KERNEL_MODULES . A compilação da plataforma executa o depmod nos módulos e copia os arquivos de saída do depmod na imagem. A compilação cria um arquivo modules.load e o armazena na imagem. Este arquivo contém todos os módulos listados em BOARD_ODM_KERNEL_MODULES .

Se você deseja substituir o conteúdo de modules.load , você pode especificá-lo em BOARD_ODM_KERNEL_MODULES_LOAD .

No momento da compilação, os módulos listados em BOARD_ODM_KERNEL_MODULES serão instalados em $ANDROID_PRODUCT_OUT/odm_dlkm/lib/modules . Um link simbólico será criado em /odm/lib/modules que leva a /odm_dlkm/lib/modules .

Sempre use /vendor/lib/modules e /odm/lib/modules para módulos de kernel de fornecedor e ODM.

Nunca use /vendor_dlkm/lib/modules. Dispositivos sem uma partição vendor_dlkm instalam BOARD_VENDOR_KERNEL_MODULES em /vendor/lib/modules . Isso é problemático, pois /vendor_dlkm/lib/modules não existe.

Nunca use /odm_dlkm/lib/modules. Dispositivos sem uma partição odm_dlkm instalam BOARD_ODM_KERNEL_MODULES em /odm/lib/modules . Isso é problemático, pois /odm_dlkm/lib/modules não existe.

Montagem de partição e carregamento de módulo

Durante first_stage_init , as partições vendor_dlkm e odm_dlkm são montadas nas partições /vendor_dlkm e /odm_dlkm , respectivamente. Quando isso acontece, links simbólicos em /vendor/lib/modules e /odm/lib/modules ficam disponíveis.

Um processo de fornecedor (como um script '.rc') pode então carregar os módulos do kernel com base na ordem especificada em modules.load . O processo do fornecedor também pode carregar os módulos posteriormente, se necessário.

Para obter a documentação sobre a criação de uma partição de inicialização do fornecedor (que contém o RAMDisk do fornecedor), consulte o Kernel Module Support .