Merge tag 'u-boot-atmel-fixes-2021.01-b' of https://gitlab.denx.de/u-boot/custodians...
[platform/kernel/u-boot.git] / doc / board / freescale / imx8mp_evk.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 imx8mp_evk
4 ==========
5
6 U-Boot for the NXP i.MX8MP EVK board
7
8 Quick Start
9 -----------
10
11 - Build the ARM Trusted firmware binary
12 - Get the firmware-imx package
13 - Build U-Boot
14 - Boot
15
16 Get and Build the ARM Trusted firmware
17 --------------------------------------
18
19 Note: $(srctree) is the U-Boot source directory
20 Get ATF from: https://source.codeaurora.org/external/imx/imx-atf
21 branch: imx_5.4.3_2.0.0
22
23 .. code-block:: bash
24
25    $ make PLAT=imx8mp bl31
26    $ cp build/imx8mp/release/bl31.bin $(srctree)
27
28 Get the ddr firmware
29 --------------------
30
31 .. code-block:: bash
32
33    $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.7.bin
34    $ chmod +x firmware-imx-8.7.bin
35    $ ./firmware-imx-8.7.bin
36    $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_1d_dmem.bin
37    $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_1d_imem_201904.bin $(srctree)/lpddr4_pmu_train_1d_imem.bin
38    $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_dmem_201904.bin $(srctree)/lpddr4_pmu_train_2d_dmem.bin
39    $ cp firmware-imx-8.7/firmware/ddr/synopsys/lpddr4_pmu_train_2d_imem_201904.bin $(srctree)/lpddr4_pmu_train_2d_imem.bin
40
41 Build U-Boot
42 ------------
43
44 .. code-block:: bash
45
46    $ export CROSS_COMPILE=aarch64-poky-linux-
47    $ make imx8mp_evk_defconfig
48    $ export ATF_LOAD_ADDR=0x960000
49    $ make flash.bin
50
51 Burn the flash.bin to the MicroSD card at offset 32KB:
52
53 .. code-block:: bash
54
55    $sudo dd if=flash.bin of=/dev/sd[x] bs=1K seek=32 conv=notrunc; sync
56
57 Boot
58 ----
59
60 Set Boot switch to SD boot
61 Use /dev/ttyUSB2 for U-Boot console