Skip to content

Yocto Build U-Boot from source code

Toolchain installation for out of Yocto builds

To install the toolchain, follow the Yocto Toolchain installation guide.

Build U-Boot out of Yocto tree

Obtain sources:

$ git clone https://github.com/varigit/uboot-imx.git -b lf-5.4.y_v2019.04_var01
$ cd uboot-imx

Configure compilation environment:

$ source /opt/fsl-imx-xwayland/5.4-zeus/environment-setup-aarch64-poky-linux

Cleanup everything:

$ make mrproper

Select configuration:

$ make imx8qm_var_som_defconfig

Build U-Boot:

$ make -j$(nproc)

Build boot image

The final boot image contains multiple firmware files, as explained by NXP in IMX_LINUX_USERS_GUIDE.pdf (Search for "How to build imx-boot image by using imx-mkimage").

The following procedure builds the final image:

Create imx-boot-tools directory:

$ mkdir imx-boot-tools
$ cd imx-boot-tools

Obtain SC firmware:
Either build SCFW by following the Build SCFW from source code page and copy the SCFW image to the imx-boot-tools directory, or download the pre-built binary by running:

$ wget https://github.com/varigit/meta-variscite-imx/raw/zeus-imx-5.4.3-var01/recipes-bsp/imx-sc-firmware/imx-sc-firmware/mx8qm-var-som-scfw-tcm.bin -O scfw_tcm.bin

Download SECO firmware:

$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/imx-seco-2.3.1.bin
$ chmod +x imx-seco-2.3.1.bin
$ ./imx-seco-2.3.1.bin
$ cp imx-seco-2.3.1/firmware/seco/mx8q*-ahab-container.img .

Download and build imx_mkimage:

$ git clone https://github.com/nxp-imx/imx-mkimage -b lf-5.4.y
$ cd imx-mkimage
$ make 
$ cp mkimage_imx8 iMX8QM/soc.mak iMX8QM/*.sh scripts/pad_image.sh ..
$ cd ..

Download and build ATF:

$ git clone https://github.com/nxp-imx/imx-atf -b lf-5.4.y 

$ cd imx-atf  
$ source /opt/fsl-imx-xwayland/5.4-zeus/environment-setup-aarch64-poky-linux
$ unset LDFLAGS
$ make PLAT=imx8qm bl31
$ cp build/imx8qm/release/bl31.bin ..
$ cd ..

Copy U-Boot binaries:

$ cp ../tools/mkimage mkimage_uboot
$ cp ../u-boot.bin .
$ cp ../spl/u-boot-spl.bin .

Build boot image:

$ make -f soc.mak clean
$ make -f soc.mak SOC=iMX8QM MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl
$ mv flash.bin imx-boot-sd.bin

Install the built U-Boot on an SD card

$ sudo dd if=imx-boot-sd.bin of=/dev/sdX bs=1K seek=32 conv=fsync

(Replace /dev/sdX with the correct device)

If you want to use our recovery SD card to flash the built U-Boot to NAND flash/eMMC, then copy it to the appropriate location in the SD card:

$ sudo cp imx-boot-sd.bin /media/rootfs/opt/images/…

And eject the SD card gracefully from host machine.

Note: If you manually upgrade an existing U-Boot, and you have an old environment saved, it is a good idea to reset your environment to the new default.)

Update your U-Boot out of Yocto tree

$ git pull