Yocto Build U-Boot: Difference between revisions
(add template INIT_RELEASE_PARAM) |
|||
(40 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
<!-- Set release according to "release" parameter in URL and use | <!-- Set release according to "release" parameter in URL and use mx8m-yocto-kirkstone-5.15-2.0.x-v1.1 as default | ||
--> {{ | --> {{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 | ||
{{# | {{#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: | ||
}} | }} | ||
{{# | {{#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 | ||
{{# | {{#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: | ||
}} | }} | ||
{{# | {{#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}} | ||
$ 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}} . | $ 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/}} | ||
}} | }} | ||
Line 102: | Line 123: | ||
{{#if: {{#var:IMX_MKIMAGE_SOC_PATCH}}| | {{#if: {{#var:IMX_MKIMAGE_SOC_PATCH}}| | ||
$ cd imx-mkimage | $ cd imx-mkimage | ||
{{#if: {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH}}| | |||
$ wget {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH_URL}} | |||
$ git apply {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH}} | |||
$ rm {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH}} | |||
}} | |||
$ git apply ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH}}<!-- | $ git apply ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH}}<!-- | ||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 | | -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 | | ||
Line 119: | 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/* | | ||
{{# | {{#switch: {{#var:SOC}}|mx8mn= $ 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/* | |||
| 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-*}} }} }} }} | |||
$ source {{#var:TOOLCHAIN_LOCATION}} | $ source {{#var:TOOLCHAIN_LOCATION}} | ||
$ unset LDFLAGS | $ unset LDFLAGS | ||
Line 132: | Line 158: | ||
$ cp ../tools/mkimage mkimage_uboot | $ cp ../tools/mkimage mkimage_uboot | ||
$ cp ../u-boot.bin . | $ cp ../u-boot.bin . | ||
{{# | {{#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}}}} . | ||
| | | | ||
{{# | {{#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= | |||
$ 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= | |||
$ 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 . | ||
}} | }} | ||
{{# | {{#switch: {{#var:SOC}} | ||
| mx8qxp= | |||
Depending on i.MX8QXP SOC revision different instructions should be used to build boot image.<br> | Depending on i.MX8QXP SOC revision different instructions should be used to build boot image.<br> | ||
The SOC revision is printed by u-boot as follows | The SOC revision is printed by u-boot as follows | ||
Line 169: | Line 196: | ||
$ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} REV=C0 MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl | $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} REV=C0 MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl | ||
$ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}} | $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}} | ||
| | | mx8qm= | ||
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}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash_spl | $ 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}} | $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}} | ||
| mx8mq= | |||
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_FILE|{{#var:DEFAULT_DTB}}}} 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_FILE|{{#var:DEFAULT_DTB}}}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_evk | ||
| mx8mm= | |||
{{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga | | {{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga | | ||
Build boot image: | Build boot image: | ||
Line 191: | Line 215: | ||
$ 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}} 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: | 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_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}} 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: | 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 = | ||
{{# | {{#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
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
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.
Update your U-Boot out of Yocto tree
$ git pull