]> rtime.felk.cvut.cz Git - coffee/buildroot.git/blob - board/engicam/icorem6/readme.txt
0b6f216029d8b7a4abba549b6b8c5b441e9a3683
[coffee/buildroot.git] / board / engicam / icorem6 / readme.txt
1 *********************************************
2 Buildroot for Engicam i.CoreM6 SOM platforms:
3 *********************************************
4
5 This file documents the Buildroot support for Engicam i.CoreM6
6 platform boards.
7
8 i.CoreM6 Quad/Dual/DualLite/Solo SOM Starter kits:
9 https://www.engicam.com/vis-prod/101120
10 i.CoreM6 Quad/Dual/DualLite/Solo Open Frame 10.1 C.TOUCH kits:
11 https://www.engicam.com/vis-prod/101133
12
13 This configuration uses U-Boot mainline and kernel mainline.
14
15 Build
16 =====
17
18 First, configure Buildroot for the Engicam i.CoreM6:
19
20 - for i.CoreM6 Quad/Dual/DualLite/Solo:
21
22   make engicam_imx6qdl_icore_defconfig
23
24 Build all components:
25
26   make
27
28 You will find the following files in output/images/:
29 - for i.CoreM6 Quad/Dual:
30   - imx6q-icore.dtb
31 - for i.CoreM6 DualLite/Solo:
32   - imx6dl-icore.dtb
33 - for i.CoreM6 Quad/Dual ofcap 10:
34   - imx6q-icore-ofcap10.dtb
35 - for i.CoreM6 Quad/Dual ofcap 12:
36   - imx6q-icore-ofcap12.dtb
37   - rootfs.ext4
38   - rootfs.tar
39   - sdcard.img
40   - SPL
41   - u-boot-dtb.img
42   - uImage
43
44 Create a bootable SD card
45 =========================
46
47 To determine the device associated to the SD card have a look in the
48 /proc/partitions file:
49
50   cat /proc/partitions
51
52 Buildroot prepares a bootable "sdcard.img" image in the output/images/
53 directory, ready to be dumped on a SD card. Launch the following
54 command as root:
55
56   dd if=output/images/sdcard.img of=/dev/<your-sd-device>
57   sync
58
59 *** WARNING! This will destroy all the card content. Use with care! ***
60
61 For details about the medium image layout, see the definition in
62 board/engicam/icorem6/genimage.cfg
63
64 Boot the i.CoreM6 boards with SD boot:
65 =====================================
66
67 To boot your newly created system:
68 - insert the SD card in the SD slot of the board;
69 - connect 3-wire RS232 serial port J28 on board, and connect with other
70   serial end or USB cable(if serial-to-usb converter used) using
71   a terminal emulator at 115200 bps, 8n1;
72 - close JM3 for sd boot.
73 - power on the board.
74
75 Testing graphics on i.CoreM6:
76 ============================
77
78 Build with support for Etnaviv, Qt5 and demo applications:
79
80   make engicam_imx6qdl_icore_qt5_defconfig
81   make
82
83 Running kmscube
84 # kmscube -D /dev/dri/card1
85
86 Running glmark2-es2-drm
87 # glmark2-es2-drm
88
89 Running Qt5 Cinematic Demo:
90 - for i.CoreM6 Starter Kit
91 # export QT_QPA_EGLFS_KMS_CONFIG=/root/imx6qdl-icore.json
92 - for i.CoreM6 ofcap10
93 # export QT_QPA_EGLFS_KMS_CONFIG=/root/imx6qdl-icore-ofcap10.json
94 - for i.CoreM6 ofcap12
95 # export QT_QPA_EGLFS_KMS_CONFIG=/root/imx6qdl-icore-ofcap12.json
96 # CinematicExperience-demo
97
98 Enjoy!