Yocto Build U-Boot: Difference between revisions

From Variscite Wiki
No edit summary
(add template INIT_RELEASE_PARAM)
(32 intermediate revisions by one other user not shown)
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|RELEASE_MORTY_V1.0_VAR-SOM-MX6}}}} <!--
--> {{INIT_RELEASE_PARAM|mx8m-yocto-kirkstone-5.15-2.0.x-v1.1}}<!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
Line 20: Line 20:
  $ make mrproper
  $ make mrproper


{{#ifeq: {{#var:SOC_SERIES}} | imx8 |
{{#switch: {{#var:SOC_SERIES}} | imx8 | imx9=
  <br>
  <br>
Select configuration:
Select configuration:
Line 27: Line 27:
Build U-Boot:
Build U-Boot:
  $ make -j$(nproc)
  $ make -j$(nproc)
|
|#default=
Select one of the following configurations:
Select one of the following configurations:
   
   
Line 41: Line 41:
}}
}}


{{#ifeq: {{#var:SOC_SERIES}} | imx8 |
{{#switch: {{#var:SOC_SERIES}} | imx8 | imx9=
= Build boot image =
= 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:
Create imx-boot-tools directory:
Line 49: Line 51:
  $ cd imx-boot-tools
  $ cd imx-boot-tools


{{#ifeq: {{#var:SOC_FAMILY}} | imx8 |
{{#switch: {{#var:SOC_FAMILY}}
 
| imx8=
Obtain SC firmware:<br>
Obtain SC firmware:<br>
{{#ifexpr: {{#var:YOCTO_VERSION}} < 3.1 |Either build|Build}} SCFW by following the {{Varlink|Yocto_Build_SCFW|{{#var:RELEASE_LINK}}|Build SCFW from source code}} page and copy the SCFW image to the imx-boot-tools directory{{#ifexpr: {{#var:YOCTO_VERSION}} < 3.1 |, or download the pre-built binary by running:<br>
{{#ifexpr: {{#var:YOCTO_VERSION}} < 3.1 |Either build|Build}} SCFW by following the {{Varlink|Yocto_Build_SCFW|{{#var:RELEASE_LINK}}|Build SCFW from source code}} page and copy the SCFW image to the imx-boot-tools directory{{#ifexpr: {{#var:YOCTO_VERSION}} < 3.1 |, or download the pre-built binary by running:<br>
Line 70: Line 72:
  $ cp {{#var:SECO_FIRMWARE}}/firmware/seco/mx8q*-ahab-container.img .
  $ cp {{#var:SECO_FIRMWARE}}/firmware/seco/mx8q*-ahab-container.img .
}}
}}
|
| imx9=
Download Sentinel firmware:
$ wget {{#var:IMX_SENTINEL_URL}}
$ chmod +x {{#var:IMX_SENTINEL_BIN}}
$ ./{{#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 {{#ifeq: {{#var:SOC}}|mx8mq|and HDMI|}} firmware:
  $ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin
  $ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin
Line 79: Line 92:
}}
}}


{{#ifeq: {{#var:SOC_FAMILY}}|imx8|
{{#switch: {{#var:SOC_FAMILY}}
| imx8=
Download and build imx_mkimage:
Download and build imx_mkimage:
  $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
  $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
Line 86: Line 100:
  $ cp mkimage_imx8 {{#var:IMX_MKIMAGE_SOC}}/soc.mak {{#var:IMX_MKIMAGE_SOC}}/*.sh scripts/pad_image.sh ..
  $ cp mkimage_imx8 {{#var:IMX_MKIMAGE_SOC}}/soc.mak {{#var:IMX_MKIMAGE_SOC}}/*.sh scripts/pad_image.sh ..
  $ cd ..
  $ 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:
Download imx_mkimage:
  $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
  $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
Line 124: Line 145:
  {{#ifeq: {{#var:SOC_FAMILY}}| imx8m |
  {{#ifeq: {{#var:SOC_FAMILY}}| imx8m |
  {{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga | $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/* |
  {{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga | $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/* |
  {{#ifeq: {{#var:SOC}}|mx8mn| $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/* |
  {{#switch: {{#var:SOC}}|mx8mn= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/*
{{#ifeq: {{#var:SOC}}|mx8mp| $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/* |
| mx8mp= $ git apply ../{{#var:META_VARISCITE_REPO}}/recipes-bsp/imx-atf/imx-atf/*
{{#ifeq: {{#var:SOC}}|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-* |
| 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-* |
{{#ifeq: {{#var:SOC}}|mx8mq| $ git apply ../{{#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-*}} }} }} }}
  $ source {{#var:TOOLCHAIN_LOCATION}}
  $ source {{#var:TOOLCHAIN_LOCATION}}
  $ unset LDFLAGS
  $ unset LDFLAGS
Line 137: Line 158:
  $ cp ../tools/mkimage mkimage_uboot
  $ cp ../tools/mkimage mkimage_uboot
  $ cp ../u-boot.bin .
  $ 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 |
  {{#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}}}} .
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_FILE|{{#var:DEFAULT_DTB}}}} .
  |
  |
  {{#ifeq: {{#var:SOC}}|mx8mm|
  {{#switch: {{#var:SOC}}
| mx8mm=
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_DART}} ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} {{#varexists:U-BOOT_DTB_SOM_10 | ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM_10}} |}} .
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_DART}} ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} {{#varexists:U-BOOT_DTB_SOM_10 | ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM_10}} |}} .
  |
  | mx8mn=
{{#ifeq: {{#var:SOC}}|mx8mn|
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} .
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} .
  |
  | mx8mp=
{{#ifeq: {{#var:SOC}}|mx8mp|
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_DART}} ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} .
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_DART}} ../arch/arm/dts/{{#var:U-BOOT_DTB_SOM}} .
  |
  |
  $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:U-BOOT_DTB_FILE|{{#var:DEFAULT_DTB}}}} .
  $ 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 .
  $ cp ../spl/u-boot-spl.bin .
}}
}}
Line 200: Line 222:
Build boot image:
Build boot image:
  $ make -f soc.mak clean
  $ 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}}  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 =
= Install the built U-Boot on an SD card =
{{#ifeq: {{#var:SOC_SERIES}}|imx8|
{{#switch: {{#var:SOC_SERIES}}
|imx8
|imx9=
  <br>
  <br>
  $ sudo dd if={{#var:U-BOOT_SD_IMAGE_NAME}} of=/dev/sdX bs=1K seek={{#var:U-BOOT_OFFSET}} conv=fsync
  $ 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  
{{#ifeq: {{#var:SPL_SD_IMAGE_NAME}} | N/A  
|<br>
|<br>

Revision as of 22:17, 2 February 2023

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:

  1. Visit variwiki.com
  2. Select your SoM
  3. Select the software release
Yocto Build U-Boot from source code

Toolchain installation for out of Yocto builds

To install the toolchain, follow Yocto Toolchain installation.

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