Revision as of 22:11, 2 June 2025

Warning: This page is designed to be used with a 'release' URL parameter.

This page is using the default release RELEASE_BUSTER_V3.1_DART-MX8M.
To view this page for a specific Variscite SoM and software release, please follow these steps:

Visit variwiki.com
Select your SoM
Select the software release

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_v2019.04_4.19.35_1.1.0-var01
$ cd uboot-imx

Configure compilation environment:

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

Cleanup everything:

$ make mrproper

Select configuration:

$ make imx8m_var_dart_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

Download DDR and HDMI firmware:

$ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.5.bin
$ chmod +x firmware-imx-8.5.bin
$ ./firmware-imx-8.5.bin
$ cp firmware-imx-8.5/firmware/ddr/synopsys/* .
$ cp firmware-imx-8.5/firmware/hdmi/cadence/signed_* .

Download ATF:

$ git clone https://github.com/nxp-imx/imx-atf -b imx_4.19.35_1.1.0
$ cd imx-atf
$ git apply ../debian-var/variscite/imx8mq-var-dart/imx-boot-tools/imx-atf/*
$ unset LDFLAGS
$ make PLAT=imx8mq bl31
$ cp build/imx8mq/release/bl31.bin ..
$ cd ..

Copy U-Boot binaries:

$ cp ../tools/mkimage mkimage_uboot
$ cp ../u-boot.bin .
$ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/fsl-imx8mq-var-dart.dtb .

Download imx-mkimage:

$ git clone https://github.com/nxp-imx/imx-mkimage -b imx_4.19.35_1.1.0

Build boot image:

$ make -f soc.mak clean
$ make -f soc.mak SOC=iMX8MQ dtbs=fsl-imx8mq-var-dart.dtb MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG=imx-boot-sd.bin flash_evk

Install the built U-Boot on an SD card

$ sudo dd if=imx-boot-sd.bin of=/dev/sdX bs=1K seek=33 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/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

@@ Line 199: / Line 199: @@
   $ cd ..
 | #default=
-{{#ifexpr: {{#var:DEBIAN_VERSION}} < 12 |
+{{#ifeq: {{#var:BUILD_PLAFTORM}} | flexbuild |
 Download imx-mkimage:
   $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
   <!-- Patch imx-mkimage for mx8mn, mx8mm, mx8mp, mx8mq -->
-  {{#ifexpr: {{#var:DEBIAN_VERSION}} = 11 and not {{#expr: {{#rpos:{{#var:SOC}}|8mm}} >= 0 and {{#rpos:{{#var:KERNEL_BRANCH}}|lf-5.4.y}} >= 0}}
+  {{#varexists:HAS_DEBIAN_CLONE|$ git clone {{#var:META_VARISCITE_GIT}} -b {{#var:META_VARISCITE_BRANCH}}|}}
- | <!-- For Bullseye (Debian 11) and above, use patches located at debian-var (except for mx8mm and kernel lf-5.4.y) -->
+  {{#varexists:HAS_DEBIAN_CLONE|$ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}|}}
-  {{#varexists:HAS_DEBIAN_CLONE||$ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}}}
   $ cd imx-mkimage
-  $ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH}}|/|-1}}<!--
+  $ git apply ../flexbuild/patch/imx_mkimage/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH}}|/|-1}}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 |
-  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_1}}|/|-1}}
+  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_1}}|/|-1}}
   }}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 |
-  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_2}}|/|-1}}
+  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_2}}|/|-1}}
   }}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_3 |
-  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_3}}|/|-1}}
+  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_3}}|/|-1}}
   }}<!--
+  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_4 |
+ <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_4}}|/|-1}}
+ }}
   $ cd ..
   $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/iMX8M/soc.mak imx-mkimage/scripts/*.sh .
- {{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.3 |$ cp dtb_check.sh ../scripts/|}}
- | <!-- For Buster (Debian 10), use the pre-patched version of soc.mak -->
- $ cp debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:MACHINE_NAME}}/soc.mak .
- $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/scripts/*.sh .
- }}
 |
 Download imx-mkimage:
   $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
   <!-- Patch imx-mkimage for mx8mn, mx8mm, mx8mp, mx8mq -->
-  {{#varexists:HAS_DEBIAN_CLONE|$ git clone {{#var:META_VARISCITE_GIT}} -b {{#var:META_VARISCITE_BRANCH}}|}}
+  {{#ifexpr: {{#var:DEBIAN_VERSION}} = 11 and not {{#expr: {{#rpos:{{#var:SOC}}|8mm}} >= 0 and {{#rpos:{{#var:KERNEL_BRANCH}}|lf-5.4.y}} >= 0}}
-  {{#varexists:HAS_DEBIAN_CLONE|$ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}|}}
+ | <!-- For Bullseye (Debian 11) and above, use patches located at debian-var (except for mx8mm and kernel lf-5.4.y) -->
+  {{#varexists:HAS_DEBIAN_CLONE||$ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}}}
   $ cd imx-mkimage
-  $ git apply ../flexbuild/patch/imx_mkimage/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH}}|/|-1}}<!--
+  $ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH}}|/|-1}}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 |
-  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_1}}|/|-1}}
+  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_1}}|/|-1}}
   }}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 |
-  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_2}}|/|-1}}
+  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_2}}|/|-1}}
   }}<!--
    -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_3 |
-  <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_3}}|/|-1}}
+  <br>$ git apply ../debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_3}}|/|-1}}
   }}<!--
-  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_4 |
- <br>$ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-mkimage/imx-boot/{{#explode:{{#var:IMX_MKIMAGE_SOC_PATCH_4}}|/|-1}}
- }}
   $ cd ..
   $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/iMX8M/soc.mak imx-mkimage/scripts/*.sh .
-  }}
+  {{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.3 |$ cp dtb_check.sh ../scripts/|}}
+ | <!-- For Buster (Debian 10), use the pre-patched version of soc.mak -->
+ $ cp debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:MACHINE_NAME}}/soc.mak .
+ $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/scripts/*.sh .
+ }}}}
 }} <!-- end of DEBIAN_VERSION -->

Debian Build U-Boot: Difference between revisions