]> git.ipfire.org Git - thirdparty/u-boot.git/blob - doc/board/kontron/pitx-imx8m.rst
board: kontron: pitx-imx8m: Add Kontron pitx-imx8m board support
[thirdparty/u-boot.git] / doc / board / kontron / pitx-imx8m.rst
1 .. SPDX-License-Identifier: GPL-2.0+
2
3 Kontron pitx-imx8m
4 ==================
5
6 The Kontron pitx-imx8m is an embedded board with an i.MX8MQ in the pITX
7 form factor.
8
9 The board has two Ethernet ports, USB, HDMI/LVDS, m.2 slot, SD card, CAN,
10 RS232 and much more.
11
12 Quick Start
13 -----------
14
15 - Get and build the ARM Trusted firmware binary
16 - Get DDR and HDMI firmware
17 - Build U-Boot
18 - Install on SD card
19 - Boot
20
21 Get and build the ARM Trusted firmware binary
22 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
23
24 Note: builddir is U-Boot build directory (source directory for in-tree builds)
25
26 .. code-block:: bash
27
28 $ git clone https://github.com/ARM-software/arm-trusted-firmware.git
29 $ git checkout v2.5
30 $ make PLAT=imx8mq ARCH=aarch64 CROSS_COMPILE=aarch64-linux-gnu- bl31
31 $ cp build/imx8mq/release/bl31.bin $(builddir)
32
33 Get DDR and HDMI firmware
34 ^^^^^^^^^^^^^^^^^^^^^^^^^
35
36 Note: builddir is U-Boot build directory (source directory for in-tree builds)
37
38 .. code-block:: bash
39
40 $ wget https://www.nxp.com/lgfiles/NMG/MAD/YOCTO/firmware-imx-8.11.bin
41 $ chmod +x firmware-imx-8.11.bin
42 $ ./firmware-imx-8.11
43 $ cp firmware-imx-8.11/firmware/ddr/synopsys/lpddr4*.bin $(builddir)
44 $ cp firmware-imx-8.11/firmware/hdmi/cadence/signed_hdmi_imx8m.bin $(builddir)
45
46 Build U-Boot
47 ^^^^^^^^^^^^
48
49 .. code-block:: bash
50
51 $ make kontron_pitx_imx8m_defconfig
52 $ make CROSS_COMPILE=aarch64-linux-gnu-
53
54 Install on SD card
55 ^^^^^^^^^^^^^^^^^^
56
57
58 Burn the flash.bin to SD card at an offset of 33 KiB:
59
60 .. code-block:: bash
61
62 $ sudo dd if=flash.bin of=/dev/sd[x] bs=1024 seek=33
63
64 Boot
65 ^^^^
66
67 Set the boot source selection to SD card boot and power on the board.