Pular para conteúdo

Prática 11 - Customizando Kernel e Criando Patches


Nesta prática vamos customizar o kernel Linux da imagem b2open-core-image sem alterar a receita original, usando um .bbappend na camada meta-treinamento:

  1. Habilitar dois drivers com o menuconfig e salvar a mudança como um fragmento de configuração (.cfg).
  2. Alterar o código-fonte do kernel e transformar a alteração em um patch.
  3. Compilar o kernel uma única vez, gerar a imagem e validar no TARGET.

Economizando tempo de build

Compilar o kernel é uma das tarefas mais demoradas do build. Por isso esta prática faz todas as alterações primeiro e compila o kernel uma única vez no final.

Não use bitbake -c cleansstate virtual/kernel nesta prática: ele apaga o cache do kernel e obriga o BitBake a baixar, descompactar e compilar tudo de novo. O BitBake já detecta sozinho quando o .bbappend muda e recompila o que for necessário.


Carregue o ambiente de build:

Executar no HOST
cd ~/treinamento/yp/poky/

source oe-init-build-env build-qemu


Descobrindo a receita do kernel

O nome virtual/kernel é um apelido para a receita de kernel escolhida pela MACHINE. Use-o para descobrir o nome (PN) e a versão (PV) da receita:

Executar no HOST
bitbake-getvar -q -r virtual/kernel --value PN

bitbake-getvar -q -r virtual/kernel --value PV

Resultado (semelhante a):

linux-yocto
6.6.151+git


Criando o .bbappend do kernel

Na camada meta-treinamento, crie o diretório dos arquivos do kernel e o .bbappend. O % no nome vale para qualquer versão da receita, assim o .bbappend continua funcionando quando o kernel for atualizado:

Executar no HOST
cd ~/treinamento/yp/poky/meta-treinamento/

mkdir -p recipes-kernel/linux/linux-yocto

touch recipes-kernel/linux/linux-yocto_%.bbappend


Adicione no .bbappend:

FILESEXTRAPATHS:prepend := "${THISDIR}/${PN}:"

Essa linha faz o BitBake procurar os arquivos do SRC_URI também no diretório linux-yocto ou linux-toradex (variável PN) ao lado do .bbappend (variável THISDIR). É lá que vamos colocar o fragmento e o patch.


Configurando o kernel com menuconfig

Volte para o diretório de build e abra o menu de configuração do kernel:

Executar no HOST
cd ~/treinamento/yp/poky/build-qemu

bitbake -c menuconfig virtual/kernel


Na mesma sessão do menuconfig, habilite os dois drivers abaixo como módulo <M>:

1. GPIOLIB

Device Drivers --->
    [*] GPIO Support  --->

2. Driver de touchscreen Goodix

Device Drivers --->
    Input device support --->
        [*] Touchscreens --->
            <M> Goodix I2C touchscreen

3. Protocolo de rede mesh B.A.T.M.A.N.

[*] Networking support --->
        Networking options --->
            <M> B.A.T.M.A.N. Advanced Meshing Protocol

DICA

No menuconfig, pressione / para pesquisar uma opção pelo nome, por exemplo GOODIX ou BATMAN. O resultado mostra onde a opção fica no menu e de quais outras ela depende.

Selecione Save, confirme o nome .config e saia com Exit até fechar o menu.


Gerando o fragmento de configuração

O .config alterado fica em uma área temporária do build e seria perdido na próxima reconfiguração do kernel. Para guardar somente o que mudou, gere um fragmento com -c diffconfig:

Executar no HOST
bitbake -c diffconfig virtual/kernel

Saída esperada (semelhante a):

Config fragment has been dumped into:
 /home/b2open/treinamento/yp/poky/build-qemu/tmp/work/qemuarm-b2open-linux-gnueabi/linux-yocto/6.6.151+git/fragment.cfg

O diffconfig compara o .config atual com a cópia que o menuconfig guardou ao ser aberto (.config.orig). Por isso o fragmento contém só as mudanças da última sessão do menuconfig.


Copie o fragmento para a camada com o nome b2open.cfg. Para não digitar o caminho completo, que muda conforme a MACHINE e a versão do kernel, use o bitbake-getvar:

Executar no HOST
KWORK=$(bitbake-getvar -q -r virtual/kernel --value WORKDIR)

cp $KWORK/fragment.cfg ../meta-treinamento/recipes-kernel/linux/linux-yocto/b2open.cfg

cat ../meta-treinamento/recipes-kernel/linux/linux-yocto/b2open.cfg

Saída esperada (semelhante a):

CONFIG_BATMAN_ADV=m
CONFIG_BATMAN_ADV_BATMAN_V=y
CONFIG_BATMAN_ADV_BLA=y
CONFIG_BATMAN_ADV_DAT=y
# CONFIG_BATMAN_ADV_NC is not set
CONFIG_BATMAN_ADV_MCAST=y
# CONFIG_BATMAN_ADV_DEBUG is not set
# CONFIG_BATMAN_ADV_TRACING is not set
# CONFIG_RFKILL_GPIO is not set
# CONFIG_TI_ST is not set
# CONFIG_GP_PCI1XXXX is not set
# CONFIG_SPI_AX88796C is not set
# CONFIG_SMC91X is not set
# CONFIG_KEYBOARD_GPIO is not set
# CONFIG_KEYBOARD_GPIO_POLLED is not set
# CONFIG_KEYBOARD_MATRIX is not set
# CONFIG_MOUSE_GPIO is not set
CONFIG_INPUT_TOUCHSCREEN=y
# CONFIG_TOUCHSCREEN_ADS7846 is not set
# CONFIG_TOUCHSCREEN_AD7877 is not set
# CONFIG_TOUCHSCREEN_AD7879 is not set
# CONFIG_TOUCHSCREEN_AR1021_I2C is not set
# CONFIG_TOUCHSCREEN_ATMEL_MXT is not set
# CONFIG_TOUCHSCREEN_AUO_PIXCIR is not set
# CONFIG_TOUCHSCREEN_BU21013 is not set
# CONFIG_TOUCHSCREEN_BU21029 is not set
# CONFIG_TOUCHSCREEN_CHIPONE_ICN8318 is not set
# CONFIG_TOUCHSCREEN_CY8CTMA140 is not set
# CONFIG_TOUCHSCREEN_CY8CTMG110 is not set
# CONFIG_TOUCHSCREEN_CYTTSP_CORE is not set
# CONFIG_TOUCHSCREEN_CYTTSP4_CORE is not set
# CONFIG_TOUCHSCREEN_CYTTSP5 is not set
# CONFIG_TOUCHSCREEN_DYNAPRO is not set
# CONFIG_TOUCHSCREEN_HAMPSHIRE is not set
# CONFIG_TOUCHSCREEN_EETI is not set
# CONFIG_TOUCHSCREEN_EGALAX is not set
# CONFIG_TOUCHSCREEN_EGALAX_SERIAL is not set
# CONFIG_TOUCHSCREEN_EXC3000 is not set
# CONFIG_TOUCHSCREEN_FUJITSU is not set
CONFIG_TOUCHSCREEN_GOODIX=m
# CONFIG_TOUCHSCREEN_HIDEEP is not set
# CONFIG_TOUCHSCREEN_HYCON_HY46XX is not set
# CONFIG_TOUCHSCREEN_HYNITRON_CSTXXX is not set
# CONFIG_TOUCHSCREEN_ILI210X is not set
# CONFIG_TOUCHSCREEN_ILITEK is not set
# CONFIG_TOUCHSCREEN_S6SY761 is not set
# CONFIG_TOUCHSCREEN_GUNZE is not set
# CONFIG_TOUCHSCREEN_EKTF2127 is not set
# CONFIG_TOUCHSCREEN_ELAN is not set
# CONFIG_TOUCHSCREEN_ELO is not set
# CONFIG_TOUCHSCREEN_WACOM_W8001 is not set
# CONFIG_TOUCHSCREEN_WACOM_I2C is not set
# CONFIG_TOUCHSCREEN_MAX11801 is not set
# CONFIG_TOUCHSCREEN_MCS5000 is not set
# CONFIG_TOUCHSCREEN_MMS114 is not set
# CONFIG_TOUCHSCREEN_MELFAS_MIP4 is not set
# CONFIG_TOUCHSCREEN_MSG2638 is not set
# CONFIG_TOUCHSCREEN_MTOUCH is not set
# CONFIG_TOUCHSCREEN_NOVATEK_NVT_TS is not set
# CONFIG_TOUCHSCREEN_IMAGIS is not set
# CONFIG_TOUCHSCREEN_IMX6UL_TSC is not set
# CONFIG_TOUCHSCREEN_INEXIO is not set
# CONFIG_TOUCHSCREEN_PENMOUNT is not set
# CONFIG_TOUCHSCREEN_EDT_FT5X06 is not set
# CONFIG_TOUCHSCREEN_TOUCHRIGHT is not set
# CONFIG_TOUCHSCREEN_TOUCHWIN is not set
# CONFIG_TOUCHSCREEN_PIXCIR is not set
# CONFIG_TOUCHSCREEN_WDT87XX_I2C is not set
# CONFIG_TOUCHSCREEN_USB_COMPOSITE is not set
# CONFIG_TOUCHSCREEN_TOUCHIT213 is not set
# CONFIG_TOUCHSCREEN_TSC_SERIO is not set
# CONFIG_TOUCHSCREEN_TSC2004 is not set
# CONFIG_TOUCHSCREEN_TSC2005 is not set
# CONFIG_TOUCHSCREEN_TSC2007 is not set
# CONFIG_TOUCHSCREEN_RM_TS is not set
# CONFIG_TOUCHSCREEN_SILEAD is not set
# CONFIG_TOUCHSCREEN_SIS_I2C is not set
# CONFIG_TOUCHSCREEN_ST1232 is not set
# CONFIG_TOUCHSCREEN_SURFACE3_SPI is not set
# CONFIG_TOUCHSCREEN_SX8654 is not set
# CONFIG_TOUCHSCREEN_TPS6507X is not set
# CONFIG_TOUCHSCREEN_ZET6223 is not set
# CONFIG_TOUCHSCREEN_ZFORCE is not set
# CONFIG_TOUCHSCREEN_ROHM_BU21023 is not set
# CONFIG_TOUCHSCREEN_IQS5XX is not set
# CONFIG_TOUCHSCREEN_IQS7211 is not set
# CONFIG_TOUCHSCREEN_ZINITIX is not set
# CONFIG_TOUCHSCREEN_HIMAX_HX83112B is not set
# CONFIG_INPUT_GPIO_BEEPER is not set
# CONFIG_INPUT_GPIO_DECODER is not set
# CONFIG_INPUT_GPIO_VIBRA is not set
# CONFIG_INPUT_GPIO_ROTARY_ENCODER is not set
# CONFIG_INPUT_DRV260X_HAPTICS is not set
# CONFIG_SERIO_GPIO_PS2 is not set
# CONFIG_I2C_CBUS_GPIO is not set
# CONFIG_I2C_GPIO is not set
# CONFIG_SPI_GPIO is not set
# CONFIG_SPI_OC_TINY is not set
CONFIG_GPIOLIB=y
CONFIG_GPIOLIB_FASTPATH_LIMIT=512
CONFIG_OF_GPIO=y
# CONFIG_DEBUG_GPIO is not set
CONFIG_GPIO_CDEV=y
CONFIG_GPIO_CDEV_V1=y

#
# Memory mapped GPIO drivers
#
# CONFIG_GPIO_74XX_MMIO is not set
# CONFIG_GPIO_ALTERA is not set
# CONFIG_GPIO_CADENCE is not set
# CONFIG_GPIO_DWAPB is not set
# CONFIG_GPIO_FTGPIO010 is not set
# CONFIG_GPIO_GENERIC_PLATFORM is not set
# CONFIG_GPIO_GRGPIO is not set
# CONFIG_GPIO_HLWD is not set
# CONFIG_GPIO_MB86S7X is not set
# CONFIG_GPIO_MPC8XXX is not set
# CONFIG_GPIO_PL061 is not set
# CONFIG_GPIO_SIFIVE is not set
# CONFIG_GPIO_XILINX is not set
# CONFIG_GPIO_ZEVIO is not set
# CONFIG_GPIO_AMD_FCH is not set
# end of Memory mapped GPIO drivers

#
# I2C GPIO expanders
#
# CONFIG_GPIO_ADNP is not set
# CONFIG_GPIO_FXL6408 is not set
# CONFIG_GPIO_DS4520 is not set
# CONFIG_GPIO_GW_PLD is not set
# CONFIG_GPIO_MAX7300 is not set
# CONFIG_GPIO_MAX732X is not set
# CONFIG_GPIO_PCA953X is not set
# CONFIG_GPIO_PCA9570 is not set
# CONFIG_GPIO_PCF857X is not set
# CONFIG_GPIO_TPIC2810 is not set
# end of I2C GPIO expanders

#
# MFD GPIO expanders
#
# CONFIG_HTC_EGPIO is not set
# end of MFD GPIO expanders

#
# PCI GPIO expanders
#
# CONFIG_GPIO_BT8XX is not set
# CONFIG_GPIO_PCI_IDIO_16 is not set
# CONFIG_GPIO_PCIE_IDIO_24 is not set
# CONFIG_GPIO_RDC321X is not set
# end of PCI GPIO expanders

#
# SPI GPIO expanders
#
# CONFIG_GPIO_74X164 is not set
# CONFIG_GPIO_MAX3191X is not set
# CONFIG_GPIO_MAX7301 is not set
# CONFIG_GPIO_MC33880 is not set
# CONFIG_GPIO_PISOSR is not set
# CONFIG_GPIO_XRA1403 is not set
# end of SPI GPIO expanders

#
# USB GPIO expanders
#
# end of USB GPIO expanders

#
# Virtual GPIO drivers
#
# CONFIG_GPIO_AGGREGATOR is not set
# CONFIG_GPIO_LATCH is not set
# CONFIG_GPIO_MOCKUP is not set
# CONFIG_GPIO_VIRTIO is not set
# CONFIG_GPIO_SIM is not set
# end of Virtual GPIO drivers

# CONFIG_SENSORS_GPIO_FAN is not set
# CONFIG_SENSORS_LTC2992 is not set
# CONFIG_SENSORS_SHT15 is not set
# CONFIG_GPIO_WATCHDOG is not set
# CONFIG_MEN_A21_WDT is not set
# CONFIG_MFD_AAT2870_CORE is not set
# CONFIG_TPS65010 is not set
# CONFIG_MFD_TPS65910 is not set
# CONFIG_DRM_PANEL_LG_LB035Q02 is not set
# CONFIG_DRM_PANEL_NEC_NL8048HL11 is not set
# CONFIG_DRM_PANEL_SAMSUNG_S6D27A1 is not set
# CONFIG_FB_SSD1307 is not set
# CONFIG_HID_MCP2200 is not set
# CONFIG_USB_CONN_GPIO is not set
# CONFIG_USB_GPIO_VBUS is not set
# CONFIG_PHY_MAPPHONE_MDM6600 is not set

Ao habilitar o BATMAN, as sub-opções entram com os valores padrão. Elas fazem parte da configuração, por isso também vão para o fragmento.


Adicione o fragmento no .bbappend:

1
2
3
FILESEXTRAPATHS:prepend := "${THISDIR}/${PN}:"

SRC_URI += "file://b2open.cfg"

Alternativa: defconfig completo

Outra forma é salvar a configuração inteira em um defconfig, com bitbake -c savedefconfig virtual/kernel, e usar no .bbappend:

SRC_URI += "file://defconfig"
KCONFIG_MODE = "alldefconfig"

O defconfig substitui toda a configuração do fabricante. O fragmento contém só as suas mudanças, é mais fácil de revisar e continua válido quando o BSP é atualizado. Use fragmentos sempre que o kernel suportar (linux-yocto, linux-toradex e demais kernels com a classe kernel-yocto).


Adicionando os módulos na imagem

Os drivers foram configurados como módulo <M>, então cada um gera um pacote kernel-module-<nome>. A imagem só leva os módulos que forem pedidos. Edite a receita meta-treinamento/recipes-core/images/b2open-core-image.bb e adicione:

IMAGE_INSTALL += "kernel-module-batman-adv kernel-module-goodix-ts"


Compilando o kernel e gerando a imagem

Agora sim, compile o kernel. Como o .bbappend mudou, o BitBake aplica o patch, junta o fragmento à configuração e recompila o kernel:

Executar no HOST
bitbake virtual/kernel


Confira que o patch foi aplicado e o fragmento foi usado:

Executar no HOST
KBUILD=$(bitbake-getvar -q -r virtual/kernel --value B)

grep -E "GOODIX|BATMAN_ADV=" $KBUILD/.config

Saída esperada:

CONFIG_TOUCHSCREEN_GOODIX=m
CONFIG_BATMAN_ADV=m


Gere a imagem com o kernel novo e os módulos:

Executar no HOST
bitbake b2open-core-image


Validando no TARGET

Executar no HOST
runqemu b2open-core-image nographic


Carregue o módulo do BATMAN e confira o módulo do Goodix:

Executar no TARGET
modprobe batman-adv

lsmod | grep batman

modinfo goodix_ts 

Note

O driver Goodix só é carregado automaticamente quando o device tree descreve um touchscreen Goodix. Sem o hardware, basta confirmar com modinfo que o módulo está na imagem.


Visualizando as tarefas disponíveis do kernel

Executar no HOST
bitbake -c listtasks virtual/kernel

Repare nas tarefas usadas nesta prática: do_menuconfig, do_diffconfig e do_savedefconfig.


Prática 11 realizada com sucesso!