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:
Saída esperada:
Criar o diretório ~/treinamento/Lab/Bootloader e acessar o diretório criado:
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.
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:
Aplicando o defconfig do Módulo Colibri iMX8X:
Abrindo o menu de configurações:
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.
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:
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:
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.
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.
cd ~/treinamento
cp treinamento-b2open/Scripts/gerar_bootloader_uboot_scu.sh Lab/
cd Lab/
./gerar_bootloader_uboot_scu.sh
Resultado esperado:
[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.
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:
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
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:
Abaixo a saída do comando mmc list:
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:
Listando a segunda partição do eMMC:
Comando bootcmd
Acesse novamente o Bootloader e digite o comando:
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:
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:
Copiando os arquivos de Bootloader:
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.
Novo valor da variável:
Iniciando o TFTPServer:
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.
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.
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:
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:
Gravando o Bootloader
Executando as configurações e comandos para gravação do novo bootloder u-boot na Placa:
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:
Reinicie a placa via Bootloader e acesse o novo bootloader:
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:
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
Saída:
Finalizada a Prática De Bootloader!