Pular para conteúdo

Bootloader – U-Boot

Nesta etapa será feito o download, configuração e compilação do Bootloader para Placa alvo do Treinamento - Colibri-iMX8.

Note

Diretório de Trabalho: ~/treinamento/Lab/Bootloader

Warning

Caso o Container Docker não esteja iniciado, crie a instância, e crie os seguintes diretórios:


Antes de continuar, confirme que esteja dentro do CONTAINER e no diretório /home do usuário, com o comando abaixo:

Executar no HOST
pwd

Saída esperada:

b2open@treinamento-b2open:~/treinamento$ pwd
/home/b2open/treinamento


Criar o diretório ~/treinamento/Lab/Bootloader e acessar o diretório criado:

Executar no HOST
mkdir -p ~/treinamento/Lab/Bootloader

cd ~/treinamento/Lab/Bootloader/


Download do Bootloader U-Boot

Warning

Antes de iniciar a configuração e compilação, lembre-se de configurar o PATH para o toolchain, pode utilizar source preparar_ambiente.sh.

Executar no HOST
git clone --depth 10 -b toradex_imx_lf_v2024.04 git://git.toradex.com/u-boot-toradex.git

Acessar o diretorio do repositorio do Bootloader clonado:

Executar no HOST
cd u-boot-toradex/


Aplicando o defconfig do Módulo Colibri iMX8X:

Executar no HOST
make colibri-imx8x_defconfig


Abrindo o menu de configurações:

Executar no HOST
make menuconfig


Abaixo a tela do menu de configuração do Bootloader U-Boot da Toradex.

Note

As versões do bootloader u-boot pode ser diferente entre BSP's e modelos de hardware.


Dentro do menuconfig, deverá procurar as opções abaixo e habilitar o comando temperature e alterar o nome do prompt.

Executar no HOST
Command line interface  --->
    (B2Lab iMX8X # ) Shell prompt


Command line interface  --->
    Device access commands  --->
        [*] temperature - display the temperature from thermal sensors


Selecione a opção < Save >, confirme o nome do arquivo a ser salvo .config confirme com < OK > e na sequência < Exit >.


Utilizando o comando make para compilar o bootloader:

Executar no HOST
make -j$(nproc)

Warning


Caso receber o erro abaixo:

include/image.h:1166:12: fatal error: openssl/evp.h: No such file or directory
1166 | #  include <openssl/evp.h>
     |             ^~~~~~~~~~~~~~~


Instale o libssl-dev:

Executar no HOST
sudo apt update && sudo apt install libssl-dev --yes


Repita o comando make -j$(nproc) novamente!


Resultado esperado:

...
...
...
  CAT     u-boot-dtb.bin
  COPY    u-boot.dtb
  COPY    u-boot.bin
  LD      u-boot.elf
WARNING './mx8qx-ahab-container.img' not found, resulting binary is not-functional
  CFGS    u-boot-dtb.cfgout
  OFCHK   .config


Copiando o binário gerado

Vamos criar o diretório ~/treinamento/Lab/Bootloader/output e transferir o u-boot.imx para lá, será utilizado para quando preparar o setup da placa.

Executar no HOST
mkdir ../output

cp u-boot.bin  ../output


Aplicando modificações fabricante SoC

O bootloader para família iMX8 ainda não está pronto, o NXP iMX8 faz uso de algumas etapas junto ao processo de boot que são SCU, SECO e SCFW, o processo completo e cada ferramenta está descrito em Etapas obrigatórias adicionais para SoCs Específicos.

Para gerar o arquivo imx-boot ele necessita do bootloader que compilamos u-boot.bin, então vamos copiar o script gerar_bootloader_uboot_scu.sh que esta dentro do diretório ~/treinamento/Scripts para ~/treinamento/Lab e em seguida executar o script.

Executar no HOST
cd ~/treinamento

cp treinamento-b2open/Scripts/gerar_bootloader_uboot_scu.sh Lab/

cd Lab/

./gerar_bootloader_uboot_scu.sh

Resultado esperado:

Executar no HOST
[01/03/2024 16:17:44] Criando diretorio scu-colibri-imx8x
[01/03/2024 16:17:44] Construindo imx-seco
[01/03/2024 16:17:46] Construindo scfw-bin
[01/03/2024 16:17:47] Construindo imx-atf
[01/03/2024 16:18:36] Construindo imx-mkimage
[01/03/2024 16:18:38]     Copiando imx-seco-3.7.4/firmware/seco/mx8qxb0-ahab-container.img -> imx-mkimage/iMX8QX/
[01/03/2024 16:18:38]     Copiando imx-seco-3.7.4/firmware/seco/mx8qxc0-ahab-container.img -> imx-mkimage/iMX8QX/
[01/03/2024 16:18:38]     Copiando scfw-bin/scfw_tcm.bin -> imx-mkimage/iMX8QX/
[01/03/2024 16:18:38]     Copiando imx-atf/build/imx8qx/release/bl31.bin -> imx-mkimage/iMX8QX/
[01/03/2024 16:18:38]     Copiando Lab/Bootloader/output/u-boot.bin -> imx-mkimage/iMX8QX/
[01/03/2024 16:18:38] Listando imx-boot:
-rw-r--r-- 1 b2open b2open 1162240 Mar 01 16:18 iMX8QX/imx-boot
[01/03/2024 16:18:38] Fim

Finalizamos o laboratório de Bootloader e já temos um bootloader funcional para o hardware.


Acessar Bootloader da Placa

Utilizar um cabo usb e conectar na porta USB X4 da Aster Board, utilizar as ferramentas minicom ou picocom para acessar o bootloader u-boot via Serial Console.

Info

Em caso de duvida veja o tópico Serial Console Colibri iMX8X no menu do lado esquerdo.

Executar no HOST
sudo picocom /dev/ttyUSB0 -b115200 


Neste momento conecte o plug de alimentação na placa e pressione qualquer tecla para interromper o processo de boot e entar na Interface de Comandos do Bootloader U-Boot:


Processo de boot esperado:

Executar no HOST
U-Boot 2022.04-6.8.0-devel+git.a1eb18d157f4 (Jul 16 2024 - 20:38:08 +0000)

CPU:   NXP i.MX8QXP RevC A35 at 1200 MHz at 41C

DRAM:  2 GiB
Core:  240 devices, 20 uclasses, devicetree: separate
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In:    serial
Out:   serial
Err:   serial
Model: Toradex 0038 Colibri iMX8QXP 2GB WB IT V1.0D
Serial#: 07330376

 BuildInfo:
  - SCFW f407904f, SECO-FW c9de51c0, IMX-MKIMAGE 3bfcfccb, ATF 3c1583b
  - U-Boot 2022.04-6.8.0-devel+git.a1eb18d157f4

flash target is MMC:0
Net:   eth0: ethernet@5b040000
Fastboot: Normal
Normal Boot
Hit any key to stop autoboot:  0
Colibri iMX8X #


Explorando o Prompt do Bootloader U-Boot

Executar no TARGET
Colibri iMX8X # help

Colibri iMX8X # version

Colibri iMX8X # echo "Treinamento de Linux Embarcado"

Colibri iMX8X # gpio

Colibri iMX8X # gpio status

Colibri iMX8X # cpu

Colibri iMX8X # cpu list

Colibri iMX8X # cpu detail

Colibri iMX8X # bdinfo

Colibri iMX8X # printenv ipaddr

Colibri iMX8X # net

Colibri iMX8X # net list

Colibri iMX8X # mmc

Colibri iMX8X # mmc rescan

Colibri iMX8X # mmc list

Colibri iMX8X # fatls

Colibri iMX8X # fatls mmc 0:1

Colibri iMX8X # fatls mmc 1:1

Colibri iMX8X # temperature

Colibri iMX8X # printenv

Colibri iMX8X # printenv board_name

Colibri iMX8X # env set product_name "ihm-box-v1"

Colibri iMX8X # saveenv

Colibri iMX8X # reset


Comando mmc

O comando mmc conseguimos listar as unidades de armazenamento:

Executar no TARGET
mmc info

mmc list

Abaixo a saída do comando mmc list:

FSL_SDHC: 0 (eMMC)
FSL_SDHC: 1

No caso do Colibri-iMX8 nos informa que a eMMC é o id 0 e MicroSD/SDCARD o id 1.


Comandos fatls e ext4ls

Ainda no prompt do Bootloader, independente do fabricante temos os comandos fatls e ext4ls, onde conseguimos visualizar o conteudo de acordo com o tipo de partição fatls para FAT32 e ext2ls para EXT4.

Listando a primeira partição do eMMC:

Executar no TARGET
fatls mmc 0:1

Listando a segunda partição do eMMC:

Executar no TARGET
ext4ls mmc 0:2


Comando bootcmd

Acesse novamente o Bootloader e digite o comando:

Executar no TARGET
run bootcmd

Todo bootloader independente do Fabricamente do Hardware utiliza o bootcmd para verificar as unidades configuradas e realizar algum processo de boot, ou cair no prompt caso falhar todas tentativas!


Carregar e Gravar o Novo Bootloader na Placa via Rede (TFTP)

Instalar dentro do container as ferramentas para subir o Container como TFTP Server:

Executar no HOST
echo '127.0.0.1   treinamento-b2open' | sudo tee -a /etc/hosts

sudo apt update

sudo apt install --yes tftpd-hpa tftp-hpa

Criando o diretório para utilizar e copiar os arquivos de Bootloader para carregar via rede:

Executar no HOST
sudo mkdir -p /tftpboot

Copiando os arquivos de Bootloader:

Executar no HOST
sudo cp -ra ${HOME}/treinamento/Lab/Bootloader/output/u-boot.bin /tftpboot/

sudo cp -ra ${HOME}/treinamento/Lab/Bootloader/output/imx-boot /tftpboot/

sudo chown -R tftp:tftp /tftpboot

Abrir o arquivo /etc/default/tftpd-hpa e alterar a variável TFTP_DIRECTORY para o diretório /tftpboot.

Executar no HOST
sudo vim /etc/default/tftpd-hpa

Novo valor da variável:

Executar no HOST
TFTP_DIRECTORY="/tftpboot"

Iniciando o TFTPServer:

Executar no HOST
sudo /etc/init.d/tftpd-hpa start

Configurando o Bootloader U-Boot para utilizar TFTP

Caso já esteja com o terminal com acesso ao prompt do Bootloader u-boot, pule para Configuração de Conexão de Rede.

Utilizar um cabo usb e conectar na porta USB X4 da Aster Board, utilizar as ferramentas minicom ou picocom para acessar o bootloader u-boot via Serial Console.

Info

Em caso de duvida veja o tópico Serial Console Colibri iMX8X no menu do lado esquerdo.

Executar no HOST
sudo picocom /dev/ttyUSB0 -b115200


Neste momento conecte o plug de alimentação na placa e pressione qualquer tecla para interromper o processo de boot e entar na Interface de Comandos do Bootloader U-Boot:


Acesso Bootloader via Serial Console

Confirme que ainda esteja conectado no Serial Console do prompt do Bootloader u-boot!

U-Boot 2024.04-7.5.0-devel+git.246e447fccb1 (Dec 22 2025 - 10:42:13 +0000)

CPU:   NXP i.MX8QXP RevC A35 at 1200 MHz at 53C

DRAM:  2 GiB
Core:  249 devices, 24 uclasses, devicetree: separate
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In:    serial
Out:   serial
Err:   serial
Model: Toradex 0038 Colibri iMX8QXP 2GB WB IT V1.0D
Serial#: 06995823
Boot:  MMC0
Reset cause: Software reset

 BuildInfo:
  - SCFW 83624b99, SECO-FW c9de51c0, IMX-MKIMAGE 81fca643, ATF lf-6.6.
  - U-Boot 2024.04-7.5.0-devel+git.246e447fccb1

flash target is MMC:0
Net:   eth0: ethernet@5b040000
Fastboot: Normal
Normal Boot
Hit any key to stop autoboot:  0
Colibri iMX8X #
Colibri iMX8X #
Colibri iMX8X #



Configuração de Conexão de Rede

Atenção

Escolha abaixo a opção que melhor se encaixa ao setup e infraestrutura do treinamento.

Configuração

  1. Configurar o Computador (HOST):

    • IP: 10.20.30.40
    • Máscara: 255.255.255.0
  2. Configurar a Placa (TARGET):

    • IP: 10.20.30.50

Executar no TARGET

Executar no TARGET
setenv autoload no

setenv ipaddr 10.20.30.50

setenv serverip 10.20.30.40

ping 10.20.30.40

Retorno esperado

Using ethernet@5b040000 device
host 10.20.30.40 is alive

Executar no TARGET

Executar no TARGET
setenv autoload no

dhcp

setenv serverip <IP-DO-SEU-COMPUTADOR>

ping <IP-DO-SEU-COMPUTADOR>

Retorno esperado

Using ethernet@5b040000 device
host XX.XX.XX.XX is alive


Carregando o Bootloader para a Placa

O Bootloader já possui um endereço para carregar o firmware do bootloader, a variável loadaddr, executando o comando para carregar o Bootloader imx-boot que esta no Host:

Executar no TARGET
tftp ${loadaddr} ${serverip}:imx-boot


Saída esperada:

Using ethernet@5b040000 device
TFTP from server 10.20.30.40; our IP address is 10.20.30.50
Filename 'imx-boot'.
Load address: 0x95c00000
Loading: ##################################################  1.1 MiB
     4.1 MiB/s
done
Bytes transferred = 1165312 (11c800 hex)


Uma variavel chamada filesize é atualizada com o valor do arquivo carregado, é esperado um valor diferente de zero:

Executar no TARGET
printenv filesize


Gravando o Bootloader

Executando as configurações e comandos para gravação do novo bootloder u-boot na Placa:

Executar no TARGET
setexpr blkcnt ${filesize} + 0x1ff

setexpr blkcnt ${blkcnt} / 0x200

mmc dev 0 1

mmc write ${loadaddr} 0x0 ${blkcnt}


Saída esperada, o valor de count pode variar dependendo da versão:

MMC write: dev # 0, block # 0, count 2276 ... 2276 blocks written: OK

Reinicie a placa via Bootloader e acesse o novo bootloader:
Executar no TARGET
reset


Se tudo ocorrer conforme esperado, este será o novo prompt do bootloader gravado:

U-Boot 2024.04-g1f3c8b66 (May 09 2026 - 17:58:17 -0300)

CPU:   NXP i.MX8QXP RevC A35 at 1200 MHz at 43C

DRAM:  1022 MiB
Core:  249 devices, 24 uclasses, devicetree: separate
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Loading Environment from MMC... OK
In:    serial
Out:   serial
Err:   serial
Model: Toradex 0052 Colibri iMX8DX 1GB V1.0D
Serial#: 14714430
Boot:  MMC0
Reset cause: Software reset

 BuildInfo:
  - SCFW 0d54291f, SECO-FW d63fdb21, IMX-MKIMAGE 57fec89e, ATF
  - U-Boot 2024.04-g1f3c8b66

flash target is MMC:0
Net:   eth0: ethernet@5b040000
Fastboot: Normal
Normal Boot
Hit any key to stop autoboot:  0
B2Lab iMX8X #


Testando o comando temperature adicionado:

Executar no TARGET
B2Lab iMX8X # temperature list

Saída:

| Device                        | Driver                        | Parent
| thermal-sensor                | imx_sc_thermal                | root_driver
| cpu-thermal0                  | imx_sc_thermal                | thermal-sensor
| drc-thermal0                  | imx_sc_thermal                | thermal-senso


Executar no TARGET
B2Lab iMX8X # temperature get thermal-sensor

Saída:

CPU Temperature (43000C) beyond alert (0C), close to critical (0C) waiting...
thermal-sensor: 43 C


Finalizada a Prática De Bootloader!