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