Yocto Build U-Boot: Difference between revisions
From Variscite Wiki
No edit summary |
No edit summary |
||
| (28 intermediate revisions by 5 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:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!-- | |||
--> {{#lst:B2QT_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}} | --> {{#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 = | = 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 = | = Build U-Boot out of Yocto tree = | ||
| Line 43: | Line 48: | ||
{{#switch: {{#var:SOC_SERIES}} | imx8 | imx9= | {{#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 82: | Line 89: | ||
$ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* . | $ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* . | ||
| #default= | | #default= | ||
Download DDR {{# | Download DDR {{#switch: {{#var:SOC}}|mx8mq|mx8m= and HDMI|#default=}} firmware: | ||
$ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin | $ wget {{#var:NXP_FIRMWARE_URL}}/{{#var:NXP_FIRMWARE}}.bin | ||
$ chmod +x {{#var:NXP_FIRMWARE}}.bin | $ chmod +x {{#var:NXP_FIRMWARE}}.bin | ||
$ ./{{#var:NXP_FIRMWARE}}.bin | $ ./{{#var:NXP_FIRMWARE}}.bin | ||
$ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* . | $ cp {{#var:NXP_FIRMWARE}}/firmware/ddr/synopsys/* . | ||
{{# | {{#switch: {{#var:SOC}}|mx8mq|mx8m= $ cp {{#var:NXP_FIRMWARE}}/firmware/hdmi/cadence/signed_* .|#default=}} | ||
}} | }} | ||
| Line 103: | Line 110: | ||
$ cd imx-mkimage | $ cd imx-mkimage | ||
$ make soc={{#var:IMX_MKIMAGE_SOC}} | $ make soc={{#var:IMX_MKIMAGE_SOC}} | ||
$ cp soc.mak mkimage_imx8 .. | $ cp {{#var:IMX_MKIMAGE_SOC}}/soc.mak mkimage_imx8 .. | ||
$ cd .. | $ cd .. | ||
| #default= | | #default= | ||
| Line 109: | Line 116: | ||
$ 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 124: | Line 131: | ||
$ wget {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH_URL}} | $ wget {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH_URL}} | ||
$ git apply {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH}} | $ git apply {{#var:IMX_MKIMAGE_SOC_FREESCALE_PATCH}} | ||
$ | }}<!-- | ||
}} | -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_URL | | ||
$ git apply ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH}}<!-- | <br>$ wget {{#var:IMX_MKIMAGE_SOC_PATCH_URL}} | ||
}}<!-- | |||
<br>$ git apply ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH_1}} | -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1_URL | | ||
<br>$ wget {{#var:IMX_MKIMAGE_SOC_PATCH_1_URL}} | |||
}}<!-- | |||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2_URL | | |||
<br>$ wget {{#var:IMX_MKIMAGE_SOC_PATCH_2_URL}} | |||
}}<!-- | |||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_3_URL | | |||
<br>$ wget {{#var:IMX_MKIMAGE_SOC_PATCH_3_URL}} | |||
}}<!-- | |||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH | | |||
<br>$ git apply {{#if: {{#var:IMX_MKIMAGE_SOC_PATCH_URL}} | {{#var:IMX_MKIMAGE_SOC_PATCH}} | ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH}} }} | |||
}}<!-- | |||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_1 | | |||
<br>$ git apply {{#if: {{#var:IMX_MKIMAGE_SOC_PATCH_1_URL}} | {{#var:IMX_MKIMAGE_SOC_PATCH_1}} | ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH_1}} }} | |||
}}<!-- | }}<!-- | ||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 | | -->{{#varexists:IMX_MKIMAGE_SOC_PATCH_2 | | ||
<br>$ git apply ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH_2}} | <br>$ git apply {{#if: {{#var:IMX_MKIMAGE_SOC_PATCH_2_URL}} | {{#var:IMX_MKIMAGE_SOC_PATCH_2}} | ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH_2}} }} | ||
}}<!-- | |||
-->{{#varexists:IMX_MKIMAGE_SOC_PATCH_3 | | |||
<br>$ git apply {{#if: {{#var:IMX_MKIMAGE_SOC_PATCH_3_URL}} | {{#var:IMX_MKIMAGE_SOC_PATCH_3}} | ../{{#var:META_VARISCITE_REPO}}/{{#var:IMX_MKIMAGE_SOC_PATCH_3}} }} | |||
}} | }} | ||
$ rm *.patch | |||
$ cp iMX8M/soc.mak .. | $ cp iMX8M/soc.mak .. | ||
$ cd .. | $ cd .. | ||
| Line 146: | Line 170: | ||
| 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/* | ||
| 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-* | | ||
| 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}} | $ source {{#var:TOOLCHAIN_LOCATION}} | ||
$ unset LDFLAGS | $ unset LDFLAGS | ||
| Line 199: | Line 223: | ||
$ 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= | | mx8mq | ||
| mx8m= | |||
Build boot image: | Build boot image: | ||
$ make -f soc.mak clean | $ make -f soc.mak clean | ||
| Line 211: | Line 236: | ||
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}} {{#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= | | 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}} | $ 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= | | mx8mp= | ||
Build boot image: | Build boot image: | ||
$ make -f soc.mak clean | $ make -f soc.mak clean | ||
$ make | $ 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= | | mx93= | ||
Build boot image: | Build boot image: | ||
$ make -f soc.mak clean | $ make -f soc.mak clean | ||
$ make | $ 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 switch | ||
--> }} <!-- end of SOC_SERIES imx8 --> | --> }} <!-- 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> | ||
Latest revision as of 17:01, 19 November 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 $ rm *.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