View source for 1-3-1-1-2-1-8

<!-- Set release according to "release" parameter in URL and use RELEASE_MORTY_V1.0_VAR-SOM-MX6 as default
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_MORTY_V1.0_VAR-SOM-MX6}}}} <!--
--> {{PageHeader|Yocto Build U-Boot from source code}} {{DocImage|category1=Yocto|category2={{#var:HARDWARE_NAME}}}} __toc__
= Toolchain installation for out of Yocto builds =

To install the toolchain, follow {{Varlink2|Yocto Toolchain installation|{{#var:RELEASE_LINK}}}}.

= Build U-Boot out of Yocto tree =
Obtain sources: 

 $ git clone {{#var:U-BOOT_GIT}} -b {{#var:U-BOOT_BRANCH}}
 $ cd uboot-imx

Configure compilation environment:
 $ source {{#var:TOOLCHAIN_LOCATION}}

Cleanup everything:
 $ make mrproper

{{#ifeq: {{#var:SOC_SERIES}} | imx8 |
 <br>
Select configuration:
 $ make {{#var:U-BOOT_SD_DEFCONFIG}}

Build U-Boot:
 $ make -j4
|
Select one of the following configurations:
 
 For booting from SD card/eMMC:
 $ make {{#var:U-BOOT_SD_DEFCONFIG}}
 
 For booting from NAND flash:
 $ make {{#var:U-BOOT_NAND_DEFCONFIG}}

Build U-Boot:

 $ make -j4
}}

{{#ifeq: {{#var:SOC_SERIES}} | imx8 |
= Build boot image =
The final boot image contains multiple firmware files. The following procedure builds the final image.

Create imx-boot-tools directory:
 $ mkdir imx-boot-tools
 $ cd imx-boot-tools

{{#ifeq: {{#var:SOC_FAMILY}} | imx8 |

Obtain SC firmware:<br>
Either build it by following the {{Varlink|Yocto_Build_SCFW|{{#var:RELEASE_LINK}}|Build SCFW from source code}} page, or just download the pre-built binary by running:
 $ wget {{#var:META_VARISCITE_GIT}}/raw/{{#var:META_VARISCITE_BRANCH}}/recipes-bsp/imx-sc-firmware/imx-sc-firmware/{{#var:SC_FIRMWARE}} -O scfw_tcm.bin

Download SECO 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/seco/{{#var:SECO_FIRMWARE}} .
|
Download DDR {{#ifeq: {{#var:SOC}}|mx8mq|and HDMI|}} 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_* .|}}
}}

{{#ifeq: {{#var:SOC_FAMILY}}|imx8|
Download and build imx_mkimage:
 $ git clone {{#var:NXP_IMX_GIT}}/imx-mkimage -b {{#var:NXP_IMX_BRANCH}}
 $ cd imx-mkimage
 $ make 
 $ cp mkimage_imx8 {{#var:IMX_MKIMAGE_SOC}}/soc.mak {{#var:IMX_MKIMAGE_SOC}}/*.sh scripts/pad_image.sh ..
 $ cd ..
|
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/pad_image.sh}} .
}}

Download and build ATF:
 $ git clone {{#var:NXP_IMX_GIT}}/imx-atf -b {{#var:NXP_IMX_BRANCH}}
 {{#ifeq: {{#var:SOC_FAMILY}}|imx8m|
 $ git clone {{#var:META_VARISCITE_GIT}} -b {{#var:META_VARISCITE_BRANCH}}
 {{#ifeq: {{#var:FSL_BSP_VERSION}}|L4.14.78-1.0.0_ga||$ cp meta-variscite-imx/recipes-bsp/imx-mkimage/files/soc.mak .}}
 |
 }}
 $ cd imx-atf
 {{#ifeq: {{#var:SOC_FAMILY}}| imx8m |
 {{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga | $ git apply ../meta-variscite-imx/recipes-bsp/imx-atf/imx-atf/* |
 {{#ifeq: {{#var:SOC}}|mx8mn| $ git apply ../meta-variscite-imx/recipes-bsp/imx-atf/imx-atf/* | 
 {{#ifeq: {{#var:SOC}}|mx8mm| $ git apply ../meta-variscite-imx/recipes-bsp/imx-atf/imx-atf/imx8mm* ../meta-variscite-imx/recipes-bsp/imx-atf/imx-atf/imx8m-* |
 {{#ifeq: {{#var:SOC}}|mx8mq| $ git apply ../meta-variscite-imx/recipes-bsp/imx-atf/imx-atf/imx8m-*|}} }} }} }} }}

 $ source {{#var:TOOLCHAIN_LOCATION}}
 $ unset LDFLAGS
 $ make PLAT={{#var:IMX_ATF_PLAT}} bl31
 $ cp build/{{#var:IMX_ATF_PLAT}}/release/bl31.bin ..
 $ cd ..

Copy U-Boot binaries:
 $ cp ../tools/mkimage mkimage_uboot
 $ cp ../u-boot.bin .
 {{#ifeq: {{#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:DEFAULT_DTB}} .
 |
 {{#ifeq: {{#var:SOC}}|mx8mm|
 $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:DEFAULT_DTB}} ../arch/arm/dts/fsl-imx8mm-var-som.dtb .
 |
 $ cp ../u-boot-nodtb.bin ../spl/u-boot-spl.bin ../arch/arm/dts/{{#var:DEFAULT_DTB}} .
}} }} }}

{{#ifeq: {{#var:SOC_FAMILY}}|imx8|
Build boot image:
 $ make -f soc.mak clean
 $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh flash
 $ mv flash.bin {{#var:U-BOOT_SD_IMAGE_NAME}}
|
{{#ifeq: {{#var:SOC}}|mx8mq|
Build boot image:
 $ make -f soc.mak clean
 $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} dtbs={{#var:DEFAULT_DTB}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_evk
|
{{#ifeq: {{#var:SOC}}|mx8mm|
{{#ifeq: {{#var:FSL_BSP_VERSION}}| L4.14.78-1.0.0_ga |
Build boot image:
 $ make -f soc.mak clean
 $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} dtbs={{#var:DEFAULT_DTB}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_evk
|
Build boot image:
 $ make -f soc.mak clean
 $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} dtbs="{{#var:DEFAULT_DTB}} fsl-imx8mm-var-som.dtb" MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_lpddr4_ddr4_evk
}}
|
{{#ifeq: {{#var:SOC}}|mx8mn|
Build boot image:
 $ make -f soc.mak clean
 $ make -f soc.mak SOC={{#var:IMX_MKIMAGE_SOC}} dtbs={{#var:DEFAULT_DTB}} MKIMG=./mkimage_imx8 PAD_IMAGE=./pad_image.sh CC=gcc OUTIMG={{#var:U-BOOT_SD_IMAGE_NAME}} flash_ddr4_evk|}} }} }} }} }}

= Install the built U-Boot on an SD card =
{{#ifeq: {{#var:SOC_SERIES}}|imx8|
 <br>
 $ sudo dd if={{#var:U-BOOT_SD_IMAGE_NAME}} of=/dev/sdX bs=1K seek={{#var:U-BOOT_OFFSET}} conv=fsync
|
{{#ifeq: {{#var:SPL_SD_IMAGE_NAME}} | N/A 
|<br>
 $ sudo dd if={{#var:U-BOOT_IMAGE_NAME}} of=/dev/sdX bs=1K seek=1; sync
 (Replace /dev/sdX with the correct device)
|<br>
 $ sudo dd if=SPL of=/dev/sdX bs=1K seek=1; sync
 $ sudo dd if=u-boot.img of=/dev/sdX bs=1K seek=69; sync
 (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:
{{#ifeq: {{#var:SPL_SD_IMAGE_NAME}} | N/A 
|<br>
 $ sudo cp {{#var:U-BOOT_IMAGE_NAME}} /media/rootfs/opt/images/...
|<br>
 $ sudo cp SPL /media/rootfs/opt/images/... 
 $ sudo cp u-boot.img /media/rootfs/opt/images/...
}}
And eject the SD card gracefully from host machine.

{{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 Yocto tree =
<pre>
$ git pull
</pre>