xref: /OK3568_Linux_fs/buildroot/board/freescale/imx8mqevk/readme.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1***************************
2Freescale i.MX8MQ EVK board
3***************************
4
5This file documents the Buildroot support for the Freescale i.MX8MQ
6EVK board.
7
8Build
9=====
10
11First, configure Buildroot for the i.MX8MQ EVK board:
12
13If you want to use the NXP kernel:
14
15  make freescale_imx8mqevk_defconfig
16
17Or if you want to use a mainline kernel:
18
19  make imx8mqevk_defconfig
20
21Build all components:
22
23  make
24
25You will find in output/images/ the following files:
26  - bl31.bin
27  - boot.vfat
28  - fsl-imx8mq-evk.dtb
29  - Image
30  - imx8-boot-sd.bin
31  - lpddr4_pmu_train_fw.bin
32  - rootfs.ext2
33  - rootfs.ext4
34  - rootfs.tar
35  - sdcard.img
36  - signed_hdmi_imx8m.bin
37  - u-boot.bin
38  - u-boot.imx
39  - u-boot-nodtb.bin
40  - u-boot-spl-ddr.bin
41
42Create a bootable SD card
43=========================
44
45To determine the device associated to the SD card have a look in the
46/proc/partitions file:
47
48  cat /proc/partitions
49
50Buildroot prepares a bootable "sdcard.img" image in the output/images/
51directory, ready to be dumped on a SD card. Launch the following
52command as root:
53
54  dd if=output/images/sdcard.img of=/dev/<your-sd-device>
55
56*** WARNING! This will destroy all the card content. Use with care! ***
57
58For details about the medium image layout, see the definition in
59board/freescale/common/imx/genimage.cfg.template_imx8.
60
61Boot the i.MX8MQ EVK board
62==========================
63
64To boot your newly created system:
65- insert the SD card in the SD slot of the board;
66- Configure the switches as follows:
67SW801:	ON	ON	OFF	OFF
68SW802:	ON	OFF
69- put a micro USB cable into the Debug USB Port and connect using a terminal
70  emulator at 115200 bps, 8n1;
71- power on the board.
72
73Enable HDMI output
74==================
75
76To enable HDMI output at boot you must provide the video kernel boot
77argument.  To set the video boot argument from U-Boot run after
78stopping in U-Boot prompt:
79
80setenv mmcargs 'setenv bootargs console=${console} root=${mmcroot} video=HDMI-A-1:1920x1080-32@60'
81saveenv
82reset
83
84Change screen resolution to suit your connected display.
85
86Enjoy!
87