Latest revision as of 15:10, 13 September 2024

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

This page is using the default release mx8m-yocto-kirkstone-5.15-2.0.x-v1.1.
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

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_v2022.04_var01
$ cd uboot-imx

Configure compilation environment:

$ source /opt/fslc-xwayland/3.3/environment-setup-cortexa53-crypto-fslc-linux

Cleanup everything:

$ make mrproper

Select configuration:

$ make imx8mq_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.16.bin
$ chmod +x firmware-imx-8.16.bin
$ ./firmware-imx-8.16.bin
$ cp firmware-imx-8.16/firmware/ddr/synopsys/* .
$ cp firmware-imx-8.16/firmware/hdmi/cadence/signed_* .

Download imx_mkimage:

$ git clone https://github.com/nxp-imx/imx-mkimage -b lf-5.15.32_2.0.0
$ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh  imx-mkimage/scripts/*.sh .
$ cp dtb_check.sh ../scripts/

Download and build ATF:

$ git clone https://github.com/varigit/imx-atf -b lf_v2.6_var01 
$ git clone https://github.com/varigit/meta-variscite-bsp -b kirkstone
$ cd imx-mkimage

$ git apply ../meta-variscite-bsp/recipes-bsp/imx-mkimage/imx-boot/0001-iMX8M-soc-allow-dtb-override.patch
$ git apply ../meta-variscite-bsp/recipes-bsp/imx-mkimage/imx-boot/0002-iMX8M-soc-change-padding-of-DDR4-and-LPDDR4-DMEM-fir.patch
$ cp iMX8M/soc.mak ..
$ cd ..
$ cd imx-atf 
$ source /opt/fslc-xwayland/3.3/environment-setup-cortexa53-crypto-fslc-linux
$ 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/imx8mq-var-dart-dt8mcustomboard.dtb .

Build boot image:

$ make -f soc.mak clean
$ make -f soc.mak SOC=iMX8MQ dtbs=imx8mq-var-dart-dt8mcustomboard.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/…

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 Yocto tree

$ git pull

@@ Line 1: / Line 1: @@
-<!-- Set release according to "release" parameter in URL and use RELEASE_MORTY_V1.0_VAR-SOM-MX6 as default
+<!-- Set release according to "release" parameter in URL and use mx8m-yocto-kirkstone-5.15-2.0.x-v1.1 as default
---> {{#vardefine:RELEASE_PARAM|{{#urlget:release|mx8m-yocto-kirkstone-5.15-2.0.x-v1.1}}}} <!--
+--> {{INIT_RELEASE_PARAM|mx8m-yocto-kirkstone-5.15-2.0.x-v1.1}}<!--
 --> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
+--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
 --> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
---> {{PageHeader|Yocto Build U-Boot from source code}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__
+--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
+--> {{#vardefine:PLATFORM_OS|{{#varexists:DEBIAN_NAME|Debian|Yocto}}}} <!--
+--> {{PageHeader|Yocto Build U-Boot from source code}} {{DocImage|category1=Yocto|category2=Debian}} <!--
+--> [[category:{{#var:HARDWARE_NAME}}]] __toc__
 = Toolchain installation for out of Yocto builds =
-To install the toolchain, follow {{Varlink2|Yocto Toolchain installation|{{#var:RELEASE_LINK}}}}.
+To install the toolchain, follow the {{Varlink2|Yocto Toolchain installation|{{#var:RELEASE_LINK}}}} guide.
 = Build U-Boot out of Yocto tree =
@@ Line 43: / Line 48: @@
 {{#switch: {{#var:SOC_SERIES}} | imx8 | imx9=
 = Build boot image =
-The final boot image contains multiple firmware files. The following procedure builds the final image.
+The final boot image contains multiple firmware files, as explained by NXP in [https://www.nxp.com/docs/en/user-guide/IMX_LINUX_USERS_GUIDE.pdf 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:
@@ Line 76: / Line 83: @@
   $ ./{{#var:IMX_SENTINEL_BIN}}
   $ cp {{#var:IMX_SENTINEL_IMG_PATH}} .
+Download DDR firmware:
+ $ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin
+ $ chmod +x {{#var:NXP_FIRMWARE}}.bin
+ $ ./{{#var:NXP_FIRMWARE}}.bin
+ $ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* .
 | #default=
-Download DDR {{#ifeq: {{#var:SOC}}|mx8mq|and HDMI|}} firmware:
+Download DDR {{#switch: {{#var:SOC}}|mx8mq|mx8m= and HDMI|#default=}} firmware:
   $ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin
   $ chmod +x {{#var:NXP_FIRMWARE}}.bin
   $ ./{{#var:NXP_FIRMWARE}}.bin
   $ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* .
-  {{#ifeq: {{#var:SOC}}|mx8mq|$ cp {{#var:NXP_FIRMWARE}}/firmware/hdmi/cadence/signed_* .|}}
+  {{#switch: {{#var:SOC}}|mx8mq|mx8m= $ cp {{#var:NXP_FIRMWARE}}/firmware/hdmi/cadence/signed_* .|#default=}}
 }}
@@ Line 94: / Line 106: @@
   $ cd ..
 | imx9=
-Download imx_mkimage:
+Download and build imx_mkimage:
   $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
-  $ cp imx-mkimage/iMX9/soc.mak .
+  $ 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}}
   $ cp imx-mkimage/iMX8M/*.c imx-mkimage/iMX8M/*.sh {{#ifeq: {{#var:FSL_BSP_VERSION}}|L4.14.78-1.0.0_ga|imx-mkimage/iMX8M/soc.mak|}} {{#ifeq: {{#var:YOCTO_NAME}}|Morty||imx-mkimage/scripts/*.sh}} .
-  $ {{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.3 |cp dtb_check.sh ../scripts/}}
+  {{#ifexpr: {{#var:YOCTO_VERSION}} >= 3.3 |$ cp dtb_check.sh ../scripts/|}}
 }}
@@ Line 138: / Line 153: @@
 | mx8mp= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/*
 | mx8mm= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/imx8mm* ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/imx8m-* |
-| mx8mq= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/imx8m-*}} }} }} }}
+| mx8mq | mx8m= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/imx8m-*}} }} }} }}
   $ source {{#var:TOOLCHAIN_LOCATION}}
   $ unset LDFLAGS
@@ Line 148: / Line 163: @@
   $ cp ../tools/mkimage mkimage_uboot
   $ cp ../u-boot.bin .
-  {{#ifeq: {{#var:SOC_FAMILY}}|imx8m|
+  {{#switch: {{#var:SOC_FAMILY}}
+ | imx8m=
   {{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga |
   $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_FILE|{{#var:DEFAULT_DTB}}}} .
@@ Line 162: / Line 178: @@
   $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_FILE|{{#var:DEFAULT_DTB}}}} .
 }} }}
-|
+ | imx9=
+ $ cp ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} .
+|#default=
   $ cp ../spl/u-boot-spl.bin .
 }}
@@ Line 188: / Line 206: @@
   $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl
   $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}}
-| mx8mq=
+| mx8mq
+| mx8m=
 Build boot image:
   $ make -f soc.mak clean
@@ Line 200: / Line 219: @@
 Build boot image:
   $ make -f soc.mak clean
-  $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} dtbs="{{#var:U-BOOT_DTB_DART}} {{#var:U-BOOT_DTB_SOM}} {{#var:U-BOOT_DTB_SOM_10}}" MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_lpddr4_ddr4_evk
+  $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} {{#var:SOC_DIR}} dtbs="{{#var:U-BOOT_DTB_DART}} {{#var:U-BOOT_DTB_SOM}} {{#var:U-BOOT_DTB_SOM_10}}" MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_lpddr4_ddr4_evk
 }}
 | mx8mn=
 Build boot image:
   $ make -f soc.mak clean
-  $ make -f  soc.mak  SOC={{#var:IMX_MKIMAGE_SOC}}  dtbs="{{#var:U-BOOT_DTB_SOM}}  {{#var:U-BOOT_DTB_SOM_10}}" MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_ddr4_evk
+  $ make -f  soc.mak  SOC={{#var:IMX_MKIMAGE_SOC}} {{#var:SOC_DIR}} dtbs="{{#var:U-BOOT_DTB_SOM}}  {{#var:U-BOOT_DTB_SOM_10}}" MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_ddr4_evk
 | mx8mp=
 Build boot image:
   $ make -f soc.mak clean
-  $ make  -f soc.mak  SOC={{#var:IMX_MKIMAGE_SOC}}  dtbs="{{#var:U-BOOT_DTB_DART}}  {{#var:U-BOOT_DTB_SOM}}"  MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh  CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_evk
+  $ make -f soc.mak  SOC={{#var:IMX_MKIMAGE_SOC}} {{#var:SOC_DIR}} dtbs="{{#var:U-BOOT_DTB_DART}}  {{#var:U-BOOT_DTB_SOM}}"  MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh  CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_evk
+| mx93=
+Build boot image:
+ $ make -f soc.mak clean
+ $ make -f soc.mak  SOC={{#var:IMX_MKIMAGE_SOC}}  dtbs="{{#var:U-BOOT_DTB_SOM}}"  MKIMG=./imx-mkimage/mkimage_imx8 PAD_IMAGE=./pad_image.sh  CC=gcc flash_singleboot
+ $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}}
 |}} <!-- end of switch
 --> }} <!-- end of SOC_SERIES imx8 -->
 = Install the built U-Boot on an SD card =
-{{#ifeq: {{#var:SOC_SERIES}}|imx8|
+{{#switch: {{#var:SOC_SERIES}}
+|imx8
+|imx9=
   <br>
   $ sudo dd if={{#var:U-BOOT_SD_IMAGE_NAME}} of=/dev/sdX bs=1K seek={{#var:U-BOOT_OFFSET}} conv=fsync
-|
+|#default=
 {{#ifeq: {{#var:SPL_SD_IMAGE_NAME}} | N/A
 |<br>

Yocto Build U-Boot: Difference between revisions