Debian Build U-Boot

From Variscite Wiki
Build U-Boot from source code

Toolchain installation for out of builds

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

Build U-Boot out of tree

Obtain sources:

$ git clone https://github.com/varigit/uboot-imx.git -b imx_v2018.03_4.14.98_2.3.0_var01
$ cd uboot-imx

Configure compilation environment:

$ export ARCH=arm64
$ export CROSS_COMPILE=~/debian_imx8qxp-var-som/toolchain/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-

Cleanup everything:

$ make mrproper

Select configuration:

$ make imx8qxp_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:
For i.MXQXP SOC revB:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools-b0/ -O scfw_tcm.bin

For i.MXQXP SOC revB:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools/ -O scfw_tcm.bin

Download SECO firmware:
For i.MXQXP SOC revB:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools-b0/

For i.MXQXP SOC revC:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools/

Download ATF:
For i.MXQXP SOC revB:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools-b0/bl31-imx8qx.bin -O bl31.bin

For i.MXQXP SOC revC:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8qxp-var-som/imx-boot-tools/bl31-imx8qx.bin -O bl31.bin

Download and build imx-mkimage:

$ git clone /imx-mkimage -b 
$ cd imx-mkimage
$ make 
$ cp mkimage_imx8 /soc.mak /*.sh scripts/pad_image.sh ..
$ cd .. 

Copy U-Boot binaries:

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

Depending on i.MX8QXP SOC revision different instructions should be used to build boot image.
The SOC revision is printed by u-boot as follows

CPU:   Freescale i.MX8QXP revB A35 at 1200 MHz at 36C

or

CPU:   Freescale i.MX8QXP revC A35 at 1200 MHz at 36C

Build boot image for SOC revision B:

$ make -f soc.mak clean
$ make -f soc.mak SOC= REV=B0 MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl
$ mv flash.bin u-boot.img-sd


Build boot image for SOC revision C:

$ make -f soc.mak clean
$ make -f soc.mak SOC= REV=C0 MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl
$ mv flash.bin u-boot.img-sd 

Install the built U-Boot on an SD card


$ sudo dd if=u-boot.img-sd 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 SPL /media/rootfs/opt/images/Debian
$ sudo cp u-boot.img /media/rootfs/opt/images/Debian

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 (see Environment handling commands)

Update your U-Boot out of Debian tree

$ cd uboot-imx
$ git pull