Pular para conteúdo

Montando o build-toradex

Note

Faça esta etapa depois da Prática 07 e antes da Prática 08, somente nas turmas que usam a Toradex Colibri iMX8X.

  • Diretório de build: ~/treinamento/yp/poky/build-toradex
  • Camada: ~/treinamento/yp/poky/meta-treinamento


Até aqui usamos o build do QEMU. Agora vamos criar um segundo projeto de build, o build-toradex, usando o mesmo Poky, mas com as camadas do BSP e da distribuição da Toradex. Os dois builds convivem lado a lado e compartilham os downloads e o sstate-cache.


Baixando as camadas da Toradex

O BSP da Toradex depende de várias camadas (Toradex, NXP/Freescale, meta-arm, meta-security...). Para não digitar cada git clone, use o script toradex-camadas.sh, que baixa todas nos commits validados para o treinamento:

Executar no HOST
cd ~/treinamento/yp/poky

bash ~/treinamento/toradex-camadas.sh

Saída esperada (semelhante a):

>> meta-openembedded: já existe, mantido
>> meta-qt5: clonando (branch scarthgap)
>> meta-toradex-bsp-common: clonando (branch scarthgap-7.x.y)
...
>> meta-b2open-treinamento: clonando (branch scarthgap)

Camadas prontas em /home/b2open/treinamento/yp/poky

O script faz um git clone de cada camada no branch indicado e um git checkout no commit validado. Fixar o commit garante que todos os alunos tenham exatamente o mesmo BSP. Se o script ainda não estiver em ~/treinamento/, crie o arquivo com o conteúdo abaixo:

~/treinamento/toradex-camadas.sh
#!/bin/bash
#
# B2Open Systems - Treinamento Yocto Project
# Baixa as camadas do BSP Toradex (scarthgap) nos commits validados para o treinamento.
#
# Uso: bash toradex-camadas.sh
#
# Pode ser executado mais de uma vez: camadas que já existem são mantidas.
#

set -e

POKY_DIR="${POKY_DIR:-$HOME/treinamento/yp/poky}"

if [ ! -f "$POKY_DIR/oe-init-build-env" ]; then
    echo "ERRO: Poky não encontrado em $POKY_DIR"
    exit 1
fi

cd "$POKY_DIR"

# clonar <url> <branch> [commit]
clonar() {
    local url="$1" branch="$2" commit="$3"
    local dir
    dir="$(basename "$url" .git)"

    if [ -d "$dir" ]; then
        echo ">> $dir: já existe, mantido"
        return
    fi

    echo ">> $dir: clonando (branch $branch)"
    git clone -q -b "$branch" "$url" "$dir"

    if [ -n "$commit" ]; then
        git -C "$dir" -c advice.detachedHead=false checkout -q "$commit"
    fi
}

# Camadas da comunidade
clonar https://git.openembedded.org/meta-openembedded                 scarthgap
clonar https://github.com/meta-qt5/meta-qt5.git                       scarthgap

# BSP e distro Toradex
clonar https://git.toradex.com/meta-toradex-bsp-common.git            scarthgap-7.x.y  3fead3b1e2dcf83e086647b4f0e4185a94f12f11
clonar https://git.toradex.com/meta-toradex-nxp.git                   scarthgap-7.x.y  e43ed4b34727f351a63232013de205b27f09180f
clonar https://git.toradex.com/meta-toradex-ti.git                    scarthgap-7.x.y  d30db4b7b9b6b27af75427fbb59f089bc6ab9c1e
clonar https://git.toradex.com/meta-toradex-distro.git                scarthgap-7.x.y  65a1511acecc37d9e9252c588bc57ac7944c92f5
clonar https://git.toradex.com/meta-toradex-demos.git                 scarthgap-7.x.y  4ba1cebc6909ee7a83d569e8cc748f69e6a0a24f

# Dependências do BSP
clonar https://git.yoctoproject.org/meta-security                     scarthgap        afbbe28cee4af2c6760aaead43a4a3ef29969809
clonar https://git.yoctoproject.org/meta-arm                          scarthgap        a81c19915b5b9e71ed394032e9a50fd06919e1cd
clonar https://git.yoctoproject.org/meta-ti                           scarthgap        ea8c0b1cf1ab8a0b327e3feb1144c1ccf05b8278
clonar https://github.com/Freescale/meta-freescale-3rdparty.git       scarthgap        70c83e96c7f75e73245cb77f1b0cada9ed4bbc6d
clonar https://github.com/Freescale/meta-freescale-distro.git         scarthgap        b9d6a5d9931922558046d230c1f5f4ef6ee72345
clonar https://github.com/Freescale/meta-freescale.git                scarthgap        902dde8c5bd29bb507ac8d37772565a6c9ab77cd

# Camada do treinamento
clonar https://github.com/b2open/meta-b2open-treinamento              scarthgap

echo
echo "Camadas prontas em $POKY_DIR"

Note

Na prática, fabricantes como a Toradex distribuem o BSP com a ferramenta repo e um manifesto XML que lista as camadas e os commits, como vimos nos slides de Gerenciando Camadas. O script faz o mesmo papel, mantendo a estrutura de diretórios usada no treinamento.


Criando o projeto build-toradex

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

source oe-init-build-env build-toradex


Adicione as camadas com um único comando. A ordem respeita as dependências entre as camadas:

Executar no HOST
bitbake-layers add-layer \
    ../meta-openembedded/meta-oe \
    ../meta-openembedded/meta-python \
    ../meta-openembedded/meta-networking \
    ../meta-openembedded/meta-multimedia \
    ../meta-openembedded/meta-filesystems \
    ../meta-openembedded/meta-initramfs \
    ../meta-freescale \
    ../meta-freescale-3rdparty \
    ../meta-freescale-distro \
    ../meta-toradex-bsp-common \
    ../meta-toradex-nxp \
    ../meta-toradex-demos \
    ../meta-toradex-distro \
    ../meta-security/meta-tpm \
    ../meta-qt5 \
    ../meta-b2open-treinamento \
    ../meta-treinamento


Confira as camadas do projeto:

Executar no HOST
bitbake-layers show-layers


Ajustando o conf/local.conf

Edite o conf/local.conf. Comente a linha MACHINE ??= "qemux86-64" e adicione:

MACHINE ?= "colibri-imx8x"
# MACHINE ?= "verdin-imx8mp"


Comente a linha DISTRO ?= "poky" e adicione:

DISTRO ?= "tdx-xwayland"


Aponte DL_DIR e SSTATE_DIR para os mesmos diretórios do build do QEMU, assim os dois builds reaproveitam downloads e compilações:

DL_DIR ?= "/home/b2open/downloads"
SSTATE_DIR ?= "/home/b2open/sstate-cache"


No final do arquivo adicione:

# Remove os arquivos de trabalho de cada receita após o build, para economizar disco
INHERIT += "rm_work"

# Mantém o diretório de trabalho do kernel (usado na Prática 11 com menuconfig e devshell)
RM_WORK_EXCLUDE += "linux-toradex"

# Classes da Toradex
INHERIT += "toradex-mirrors toradex-sanity"

# Configurações específicas da MACHINE, se o arquivo existir
include conf/machine/include/${MACHINE}.inc

# Aceite da licença dos componentes NXP
ACCEPT_FSL_EULA = "1"

# Baixa somente os 10 últimos commits dos repositórios git
BB_GIT_SHALLOW_DEPTH ?= "10"

# Limites de paralelismo do build
BB_NUMBER_THREADS = "8"
PARALLEL_MAKE = "-j 8"
PARALLEL_MAKEINST = "-j 8"

OE_TERMINAL = "tmux"

DICA

Ajuste BB_NUMBER_THREADS e PARALLEL_MAKE conforme os núcleos e a memória da sua máquina. Veja a dica Configurando Limites para bitbake em Dicas Extras e Avançadas.


Gerando a primeira imagem para a Toradex

Use a imagem de referência da Toradex para validar o ambiente e a placa:

Executar no HOST
bitbake tdx-reference-minimal-image -k

A opção -k (continue) faz o BitBake seguir com as tarefas independentes mesmo que alguma falhe, mostrando todos os erros de uma vez no final.


Resultado do build

Todos os arquivos gerados ficam em tmp/deploy/images/colibri-imx8x/:

Executar no HOST
ls tmp/deploy/images/colibri-imx8x/

Os principais arquivos (saída resumida):

imx-boot                                                 Bootloader (SCFW + ATF + U-Boot) gravado no início da eMMC
u-boot-colibri-imx8x.bin                                 U-Boot
Image.gz                                                 Kernel Linux (6.6)
imx8qxp-colibri-aster.dtb                                Device tree da placa Aster (e demais placas base)
overlays/                                                Device tree overlays
modules-colibri-imx8x.tgz                                Módulos do kernel
Colibri-iMX8X_Reference-Minimal-Image.tar.xz             RootFS
Colibri-iMX8X_Reference-Minimal-Image.manifest           Lista de pacotes da imagem
Colibri-iMX8X_Reference-Minimal-Image.spdx.tar.zst       SBOM (SPDX)
Colibri-iMX8X_Reference-Minimal-Image.wic.gz             Imagem completa para cartão SD
Colibri-iMX8X_Reference-Minimal-Image-Tezi.tar           Pacote de instalação do Toradex Easy Installer


Instalando na placa com o TEZI

Copie e extraia o arquivo Colibri-iMX8X_Reference-Minimal-Image-Tezi.tar no pendrive ou cartão microSD de instalação e siga os guias:

Se o módulo ainda não tiver o Toradex Easy Installer, baixe a versão para o Colibri iMX8X na página Toradex Easy Installer (versão usada no treinamento: 7.5.0).


Ambiente Toradex pronto! Siga para a Prática 08.