Revision as of 16:35, 3 May 2023

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

This page is using the default release RELEASE_BUSTER_V2.0_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 Debian 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.78_1.0.0_ga_var01
$ cd uboot-imx

Configure compilation environment:

$ export ARCH=arm64
$ export CROSS_COMPILE=~/var_mx8m_dart_debian/toolchain/gcc-linaro-6.3.1-2017.05-x86_64_aarch64-linux-gnu/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/DP firmware:

$ git clone https://github.com/varigit/debian-var.git -b debian_buster_var01
$ cp debian-var/variscite/imx8m-var-dart/imx-boot-tools/*ddr4* .
$ cp debian-var/variscite/imx8m-var-dart/imx-boot-tools/signed_* .

Download ATF:

$ wget https://github.com/varigit/debian-var/raw/debian_buster_var01/variscite/imx8m-var-dart/imx-boot-tools/bl31-mx8m.bin -O bl31.bin

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/ .

Download imx-mkimage:

$ git clone /imx-mkimage -b   
$ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/iMX8M/soc.mak .

Build boot image:

$ make -f soc.mak clean
$ make -f soc.mak SOC= dtbs= 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= 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

@@ Line 109: / Line 109: @@
   $ cp debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/*ddr4* .
   {{#switch: {{#var:SOC}}|mx8m= $ cp debian-var/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/signed_* .|#default=}}
-}}
-<!-- imx-mkimage tool -->
-{{#switch: {{#var:SOC_FAMILY}}
-| imx8=
-Download and build imx-mkimage:
- $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
- $ cd imx-mkimage
- $ make
- $ cp mkimage_imx8 {{#var:IMX_MKIMAGE_SOC}}/soc.mak {{#var:IMX_MKIMAGE_SOC}}/*.sh scripts/pad_image.sh ..
- $ cd ..
-| imx9=
-Download and build imx-mkimage:
- $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
- $ cd imx-mkimage
- $ make soc={{#var:IMX_MKIMAGE_SOC}}
- $ cp {{#var:IMX_MKIMAGE_SOC}}/soc.mak mkimage_imx8 ..
- $ cd ..
-| #default=
-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
- | <!-- For Bullseye (Debian 11) and above, use patches located at debian-var -->
- $ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}
- $ cd imx-mkimage
- $ git apply ../{{#var:DEBIAN_GIT}}/{{#var:IMX_MKIMAGE_SOC_PATCH}}<!--
-  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 |
- <br>$ git apply ../{{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:IMX_MKIMAGE_SOC_PATCH_1}}
- }}<!--
-  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 |
- <br>$ git apply ../{{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:IMX_MKIMAGE_SOC_PATCH_2}}
- }}
- $ cd ..
- | <!-- For Buster (Debian 10), overwrite soc.mak (only for mx8mn) -->
- {{#switch:{{#var:SOC}}
- $ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}
- |mx8mn= $ cp {{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:MACHINE_NAME}}/soc.mak imx-mkimage/iMX8M/soc.mak
- }}
- }} <!-- end of DEBIAN_VERSION -->
- $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/iMX8M/soc.mak . <!-- dtb-check.sh -->
 }}
@@ Line 179: / Line 138: @@
 }}
-<!-- Build imx-boot -->
+<!-- Copy U-Boot binaries -->
 Copy U-Boot binaries:
   $ cp ../tools/mkimage mkimage_uboot
@@ Line 202: / Line 161: @@
 |#default=
   $ cp ../spl/u-boot-spl.bin .
+}}
+<!-- imx-mkimage tool -->
+{{#switch: {{#var:SOC_FAMILY}}
+| imx8=
+Download and build imx-mkimage:
+ $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
+ $ cd imx-mkimage
+ $ make
+ $ cp mkimage_imx8 {{#var:IMX_MKIMAGE_SOC}}/soc.mak {{#var:IMX_MKIMAGE_SOC}}/*.sh scripts/pad_image.sh ..
+ $ cd ..
+| imx9=
+Download and build imx-mkimage:
+ $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
+ $ cd imx-mkimage
+ $ make soc={{#var:IMX_MKIMAGE_SOC}}
+ $ cp {{#var:IMX_MKIMAGE_SOC}}/soc.mak mkimage_imx8 ..
+ $ cd ..
+| #default=
+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
+ | <!-- For Bullseye (Debian 11) and above, use patches located at debian-var -->
+ $ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}
+ $ cd imx-mkimage
+ $ git apply ../{{#var:DEBIAN_GIT}}/{{#var:IMX_MKIMAGE_SOC_PATCH}}<!--
+  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 |
+ <br>$ git apply ../{{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:IMX_MKIMAGE_SOC_PATCH_1}}
+ }}<!--
+  -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 |
+ <br>$ git apply ../{{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:IMX_MKIMAGE_SOC_PATCH_2}}
+ }}
+ $ cd ..
+ | <!-- For Buster (Debian 10), overwrite soc.mak (only for mx8mn) -->
+ {{#switch:{{#var:SOC}}
+ $ git clone {{#var:DEBIAN_GIT}} -b {{#var:DEBIAN_BRANCH}}
+ |mx8mn= $ cp {{#var:DEBIAN_GIT}}/variscite/{{#var:MACHINE_NAME}}/imx-boot-tools/{{#var:MACHINE_NAME}}/soc.mak imx-mkimage/iMX8M/soc.mak
+ }}
+ }} <!-- end of DEBIAN_VERSION -->
+ $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh imx-mkimage/iMX8M/soc.mak . <!-- dtb-check.sh -->
 }}

Debian Build U-Boot: Difference between revisions