blob: 1f64cbd9b2eb4072678b6228bc05803b7afa1d18 [file] [log] [blame]
Heiko Thiery16c73692022-01-31 17:30:45 +01001.. SPDX-License-Identifier: GPL-2.0+
2
3Kontron pitx-imx8m
4==================
5
6The Kontron pitx-imx8m is an embedded board with an i.MX8MQ in the pITX
7form factor.
8
9The board has two Ethernet ports, USB, HDMI/LVDS, m.2 slot, SD card, CAN,
10RS232 and much more.
11
12Quick 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
21Get and build the ARM Trusted firmware binary
22^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
23
24Note: 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
33Get DDR and HDMI firmware
34^^^^^^^^^^^^^^^^^^^^^^^^^
35
36Note: 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
46Build U-Boot
47^^^^^^^^^^^^
48
49.. code-block:: bash
50
51 $ make kontron_pitx_imx8m_defconfig
52 $ make CROSS_COMPILE=aarch64-linux-gnu-
53
54Install on SD card
55^^^^^^^^^^^^^^^^^^
56
57
58Burn 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
64Boot
65^^^^
66
67Set the boot source selection to SD card boot and power on the board.