xref: /qemu/docs/system/arm/imx8mp-evk.rst (revision 1ac21eb8fbb0297716a6c525e91196a247302b2b)
1a4eefc69SBernhard BeschowNXP i.MX 8M Plus Evaluation Kit (``imx8mp-evk``)
2a4eefc69SBernhard Beschow================================================
3a4eefc69SBernhard Beschow
4a4eefc69SBernhard BeschowThe ``imx8mp-evk`` machine models the i.MX 8M Plus Evaluation Kit, based on an
5a4eefc69SBernhard Beschowi.MX 8M Plus SoC.
6a4eefc69SBernhard Beschow
7a4eefc69SBernhard BeschowSupported devices
8a4eefc69SBernhard Beschow-----------------
9a4eefc69SBernhard Beschow
10a4eefc69SBernhard BeschowThe ``imx8mp-evk`` machine implements the following devices:
11a4eefc69SBernhard Beschow
12a4eefc69SBernhard Beschow * Up to 4 Cortex-A53 cores
13a4eefc69SBernhard Beschow * Generic Interrupt Controller (GICv3)
14a4eefc69SBernhard Beschow * 4 UARTs
15a81193c3SBernhard Beschow * 3 USDHC Storage Controllers
16fd1deb53SBernhard Beschow * 1 Designware PCI Express Controller
17a17c1d93SBernhard Beschow * 5 GPIO Controllers
18764f18afSBernhard Beschow * 6 I2C Controllers
1906908a84SBernhard Beschow * 3 SPI Controllers
20*1ac21eb8SBernhard Beschow * 3 Watchdogs
21487967beSBernhard Beschow * Secure Non-Volatile Storage (SNVS) including an RTC
2286c2dff9SBernhard Beschow * Clock Tree
23a4eefc69SBernhard Beschow
24a4eefc69SBernhard BeschowBoot options
25a4eefc69SBernhard Beschow------------
26a4eefc69SBernhard Beschow
27a4eefc69SBernhard BeschowThe ``imx8mp-evk`` machine can start a Linux kernel directly using the standard
28a4eefc69SBernhard Beschow``-kernel`` functionality.
29a4eefc69SBernhard Beschow
30a4eefc69SBernhard BeschowDirect Linux Kernel Boot
31a4eefc69SBernhard Beschow''''''''''''''''''''''''
32a4eefc69SBernhard Beschow
33a4eefc69SBernhard BeschowProbably the easiest way to get started with a whole Linux system on the machine
34a4eefc69SBernhard Beschowis to generate an image with Buildroot. Version 2024.11.1 is tested at the time
35a81193c3SBernhard Beschowof writing and involves three steps. First run the following commands in the
36a4eefc69SBernhard Beschowtoplevel directory of the Buildroot source tree:
37a4eefc69SBernhard Beschow
38a4eefc69SBernhard Beschow.. code-block:: bash
39a4eefc69SBernhard Beschow
40a4eefc69SBernhard Beschow  $ make freescale_imx8mpevk_defconfig
41a4eefc69SBernhard Beschow  $ make
42a4eefc69SBernhard Beschow
43a4eefc69SBernhard BeschowOnce finished successfully there is an ``output/image`` subfolder. Navigate into
44a81193c3SBernhard Beschowit and resize the SD card image to a power of two:
45a81193c3SBernhard Beschow
46a81193c3SBernhard Beschow.. code-block:: bash
47a81193c3SBernhard Beschow
48a81193c3SBernhard Beschow  $ qemu-img resize sdcard.img 256M
49a81193c3SBernhard Beschow
50a81193c3SBernhard BeschowFinally, the device tree needs to be patched with the following commands which
51a81193c3SBernhard Beschowwill remove the ``cpu-idle-states`` properties from CPU nodes:
52a4eefc69SBernhard Beschow
53a4eefc69SBernhard Beschow.. code-block:: bash
54a4eefc69SBernhard Beschow
55a4eefc69SBernhard Beschow  $ dtc imx8mp-evk.dtb | sed '/cpu-idle-states/d' > imx8mp-evk-patched.dts
56a4eefc69SBernhard Beschow  $ dtc imx8mp-evk-patched.dts -o imx8mp-evk-patched.dtb
57a4eefc69SBernhard Beschow
58a4eefc69SBernhard BeschowNow that everything is prepared the machine can be started as follows:
59a4eefc69SBernhard Beschow
60a4eefc69SBernhard Beschow.. code-block:: bash
61a4eefc69SBernhard Beschow
62a4eefc69SBernhard Beschow  $ qemu-system-aarch64 -M imx8mp-evk -smp 4 -m 3G \
63a4eefc69SBernhard Beschow      -display none -serial null -serial stdio \
64a4eefc69SBernhard Beschow      -kernel Image \
65a4eefc69SBernhard Beschow      -dtb imx8mp-evk-patched.dtb \
66a81193c3SBernhard Beschow      -append "root=/dev/mmcblk2p2" \
67a81193c3SBernhard Beschow      -drive file=sdcard.img,if=sd,bus=2,format=raw,id=mmcblk2
68