Yocto Build U-Boot: Difference between revisions
(Add Debian support) |
No edit summary |
||
(19 intermediate revisions by 3 users not shown) | |||
Line 2: | Line 2: | ||
--> {{INIT_RELEASE_PARAM|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: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}}}} <!-- | ||
--> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!-- | --> {{#lst:Debian_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!-- | ||
--> {{#vardefine:PLATFORM_OS|{{#varexists:DEBIAN_NAME|Debian|Yocto}}}} <!-- | --> {{#vardefine:PLATFORM_OS|{{#varexists:DEBIAN_NAME|Debian|Yocto}}}} <!-- | ||
--> {{PageHeader| | --> {{PageHeader|Yocto Build U-Boot from source code}} {{DocImage|category1=Yocto|category2=Debian}} <!-- | ||
--> [[category:{{#var:HARDWARE_NAME}}]] __toc__ | --> [[category:{{#var:HARDWARE_NAME}}]] __toc__ | ||
= Toolchain installation for out of Yocto builds = | |||
}} | |||
To install the toolchain, follow the {{Varlink2|Yocto Toolchain installation|{{#var:RELEASE_LINK}}}} guide. | |||
= Build U-Boot out of | = Build U-Boot out of Yocto tree = | ||
Obtain sources: | Obtain sources: | ||
Line 28: | Line 20: | ||
Configure compilation environment: | Configure compilation environment: | ||
$ source {{#var:TOOLCHAIN_LOCATION}} | $ source {{#var:TOOLCHAIN_LOCATION}} | ||
Cleanup everything: | Cleanup everything: | ||
Line 105: | 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 132: | 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 147: | 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 169: | 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 222: | 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 234: | 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= | ||
Line 243: | Line 245: | ||
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}} | $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}} | ||
|}} <!-- end of switch | |}} <!-- end of switch | ||
Line 281: | Line 283: | ||
{{Note|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 [[U-Boot 4.1.15 features#Environment handling commands|Environment handling commands]])}} | {{Note|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 [[U-Boot 4.1.15 features#Environment handling commands|Environment handling commands]])}} | ||
= Update your U-Boot out of | = Update your U-Boot out of Yocto tree = | ||
<pre> | <pre> | ||
$ git pull | $ git pull | ||
</pre> | </pre> |
Latest revision as of 17:01, 19 November 2024
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 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.
Update your U-Boot out of Yocto tree
$ git pull