MaaXBoard

(EM-MC-SBC-IMX8M)

Linux
V1.1
 MaaXBoard-Linux-Yocto-UM-V1.1

MaaXBoard ( :EM-MC-SBC-IMX8M)

MaaXBoard CE, FCC

http://www.embest-tech.cn 2
 MaaXBoard-Linux-Yocto-UM-V1.1

V1.0 Sandy 20190301

1. MIPI USB Device Demo

V1.1 Sandy 20190619
2. Wi-Fi Camera

http://www.embest-tech.cn 3
 MaaXBoard-Linux-Yocto-UM-V1.1

....................................................................................................................................................... 3
1 ................................................................................................................................................ 6
1.1 ................................................................................................................................. 6
1.2 ..................................................................................................................................... 7
2 ......................................................................................................................................... 8
2.1 SDCard .................................................................................................................. 8
3 ........................................................................................................................ 10
3.1 USER LED ............................................................................................................................... 10
3.2 Button ....................................................................................................................................... 10
3.3 .......................................................................................................................................... 12
3.3.1 HDMI ............................................................................................................................. 12
3.3.2 MIPI-DSI ................................................................................................................... 12
3.3.3 MIPI-LVDS ................................................................................................................ 13
3.4 TouchScreen ............................................................................................................................ 13
3.5 HDMI Audio .............................................................................................................................. 13
3.6 UART........................................................................................................................................ 13
3.6.1 UART2 ........................................................................................................................... 13
3.7 ............................................................................................................................ 14
3.7.1 IP ............................................................................................................ 14
3.7.2 IP.................................................................................................................... 14
3.8 USB 3.0 ............................................................................................................................ 15
3.8.1 USB Host....................................................................................................................... 15
3.8.2 USB Device ................................................................................................................... 15
3.9 Wi-Fi ......................................................................................................................................... 18
3.9.1 Wi-Fi .............................................................................................................. 18
3.9.2 Wi-Fi .............................................................................................................. 18
3.9.3 Wi-Fi .............................................................................................................. 19
3.10 Bluetooth 4.2 ............................................................................................................................ 19
3.11 Camera..................................................................................................................................... 19

http://www.embest-tech.cn 4
 MaaXBoard-Linux-Yocto-UM-V1.1

3.12 GPIO (40 Pin Sense Hat) (TBD) .............................................................................................. 22

3.13 ................................................................................................................................... 22
3.14 ................................................................................................................................... 23
3.15 QT&GPU .................................................................................................................................. 23
3.16 ................................................................................................................................... 24
4 Demo Application ......................................................................................................................... 25
4.1 Wayland Terminal ..................................................................................................................... 26
4.2 QtFM ........................................................................................................................................ 27
4.3 Chromium ................................................................................................................................. 28
4.4 WiFi_Config.............................................................................................................................. 29
4.5 Camera..................................................................................................................................... 30
4.6 Video ........................................................................................................................................ 31
4.7 3D Example.............................................................................................................................. 33
4.8 QT Examples............................................................................................................................ 34
5 .................................................................................................................... 35
5.1 Windows SD ...................................................................................... 35
5.2 Linux SD ............................................................................................ 36
5.3 EMMC .................................................................................................................. 36
6 .............................................................................................................................................. 37
6.1 .......................................................................................................................................... 37
7 .................................................................................................................... 38
7.1 ................................................................................................................................... 38
7.2 ................................................................................................................................... 38
8 ....................................................................................................................................... 40

http://www.embest-tech.cn 5
 MaaXBoard-Linux-Yocto-UM-V1.1

1.1

Release Folder tree

├─01Doc
│ ├─RN
│ │ MaaXBoard-ReleaseNote-Vxx.pdf
│ └─UM
│ MaaXBoard-UserManual-Vxx.pdf
│ MaaXBoard-DevelopmentGuide-Vxx.pdf
└─02Linux
├─01LinuxSourceCode
│ linux_4.14.78_ xxx.tar.gz
│ u-boot_2018.03._xxx.tar.gz
├─02LinuxShipmentImage
│ MaaXBoard-LinuxShipmentImage-Yocto-Vxxx.img
└─03LinuxTools
gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz

01Doc Description
MaaXBoard-ReleaseNote-Vxx.pdf Release Note
MaaXBoard-UserManual-Vxx.pdf User Manual
MaaXBoard-DevelopmentGuide-Vxx.pdf Development Guide
01LinuxSourceCode Description
linux_4.14.78_xxx.gz Linux kernel source code: 4.14.78 version
u-boot_2018.03._xxx.tar.gz u-boot source code: 2018.03
02LinuxShipmentImage Description
MaaXBoard-LinuxShipmentImage-Yocto-Vxxx.img Yocto image with firmware, SD Card Image
03LinuxTools Description
gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz Gcc compiler for u-boot, kernel and applications
xxx Other tools

http://www.embest-tech.cn 6
 MaaXBoard-Linux-Yocto-UM-V1.1

1.2

U-Boot version: 2018.03

Kernel version: 4.14.78

Evaluation image Yocto sumo 2.5

Qt 5.1.1 Library or later

Desktop

Development based on NXP i.MX 8M

Micro SD boot

HDMI display

HDMI audio output

1 Gigabit Ethernet (RJ45)

2 USB 3.0 can work in Host & Device mode

3 UART (TTL) include debug port

External interfaces(I2C, UART,SPI ,SAI and GPIO)

WIFI & BLE 4.2

MIPI-LVDS Display

MIPI-DSI Display

MIPI camera

Dual Display (TBD)

http://www.embest-tech.cn 7
 MaaXBoard-Linux-Yocto-UM-V1.1

MaaXBoard SDCard 4

QSG

2.1 SDCard

PC PUTTY 115200 8 1

USB TTL PC Debug J10 6,8,10 USB TTL

GND,RXD TXD
SD (J19)
5V,2A,Type-C (J4)

http://www.embest-tech.cn 8
 MaaXBoard-Linux-Yocto-UM-V1.1

root

demo

demo.

http://www.embest-tech.cn 9
 MaaXBoard-Linux-Yocto-UM-V1.1

, MaaXBoard

3.1 USER LED

MaaXBoard LED0,LED1 LED usr_led sys_led

LED:

root@imx8mqevk:~# echo 0 > /sys/class/leds/usr_led/brightness

root@imx8mqevk:~# echo 0> /sys/class/leds/sys_led/brightness

LED:

root@imx8mqevk:~# echo 1 > /sys/class/leds/usr_led/brightness

root@imx8mqevk:~# echo 1 > /sys/class/leds/sys_led/brightness

3.2 Button

MaaXBoard S2 S3 S4 S2 PWR S3 BACK S4 HOME

1. BACK HOME evtest gpio_keys id

root@imx8mqevk:~# evtest
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0: 30370000.snvs:snvs-powerkey
/dev/input/event1: UVC Camera (046d:0825)
/dev/input/event2: Logitech USB Optical Mouse
/dev/input/event3: SIGMACH1P USB Keykoard
/dev/input/event4: SIGMACH1P USB Keykoard
/dev/input/event5: gpio_keys
/dev/input/event6: bd718xx-pwrkey
Select the device event number [0-6]: 5
Input driver version is 1.0.1

http://www.embest-tech.cn 10
 MaaXBoard-Linux-Yocto-UM-V1.1

Input device ID: bus 0x19 vendor 0x1 product 0x1 version 0x100
Input device name: "gpio_keys"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 102 (KEY_HOME)
Event code 412 (KEY_PREVIOUS)
Properties:
Testing ... (interrupt to exit)
Event: time 1551666241.347922, type 1 (EV_KEY), code 412 (KEY_PREVIOUS), value 1
Event: time 1551666241.347922, -------------- SYN_REPORT ------------
Event: time 1551666241.575856, type 1 (EV_KEY), code 412 (KEY_PREVIOUS), value 0
Event: time 1551666241.575856, -------------- SYN_REPORT ------------
Event: time 1551666246.259856, type 1 (EV_KEY), code 102 (KEY_HOME), value 1
Event: time 1551666246.259856, -------------- SYN_REPORT ------------
Event: time 1551666246.491858, type 1 (EV_KEY), code 102 (KEY_HOME), value 0
Event: time 1551666246.491858, -------------- SYN_REPORT ------------

2. PWR 8s 1s

PWR

root@imx8mqevk:~# evtest /dev/input/event0

Input driver version is 1.0.1
Input device ID: bus 0x19 vendor 0x0 product 0x0 version 0x0
Input device name: "30370000.snvs:snvs-powerkey"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 116 (KEY_POWER)
Properties:
Testing ... (interrupt to exit)
Event: time 1551666457.807550, type 1 (EV_KEY), code 116 (KEY_POWER), value 1
Event: time 1551666457.807550, -------------- SYN_REPORT ------------
Event: time 1551666458.000081, type 1 (EV_KEY), code 116 (KEY_POWER), value 0
Event: time 1551666458.000081, -------------- SYN_REPORT ------------

Ctrl+C

http://www.embest-tech.cn 11
 MaaXBoard-Linux-Yocto-UM-V1.1

3.3

MaaXBoard HDMI MIPI-LVDS MIPI-DSI 3

MaaXBoard HDMI

HDMI J19 ( HDMI )

MIPI-DSI J16

MIPI-LVDS J16

uEnv.txt fdt_file

vi /run/media/mmcblk0p1 uEnv.txt sync

3.3.1 HDMI

HDMI fdt_file

fdt_file=em-sbc-imx8m.dtb

HDMI 4K

3.3.2 MIPI-DSI

MIPI-DSI fdt_file

fdt_file=em-sbc-imx8m-dcss-dsi.dtb

MIPI-DSI 0~10

root@imx8mqevk:~# echo 7 > /sys/class/backlight/backlight/brightness

http://www.embest-tech.cn 12
 MaaXBoard-Linux-Yocto-UM-V1.1

3.3.3 MIPI-LVDS

MIPI-LVDS fdt_file

fdt_file=em-sbc-imx8m-dcss-lvds.dtb

MIPI-LVDS 0~10

root@imx8mqevk:~# echo 5 > /sys/class/backlight/lvds_backlight/brightness

3.4 TouchScreen

MIPI-DSI MIPI-LVDS

root@imx8mqevk:~# ts_calibrate

+ 5

3.5 HDMI Audio

HDMI

root@imx8mqevk:~# aplay audio_sample.wav

root@imx8mqevk:~# gst-play-1.0 audio_sample.wav

aplay wav gst-play wav, mp3 aac

3.6 UART

MaaXBoard 2 UART

MaaXBoard CPU

UART1 UART TTL ( )

UART2 UART TTL

3.6.1 UART2

UART2 /dev/ttymxc2

uart_test

http://www.embest-tech.cn 13
 MaaXBoard-Linux-Yocto-UM-V1.1

J10 16 18 pin

root@imx8mqevk:~# ./uart_test -d /dev/ttymxc1 -b 115200

/dev/ttymxc1 RECV 10 total
/dev/ttymxc1 RECV: 1234567890

RECV

Ctrl+C

3.7

J13 IP IP

3.7.1 IP

MaaXBoard ip ifconfig IP

root@imx8mqevk:~# ping www.baidu.com

3.7.2 IP

MaaXBoard IP

route add default gw 192.168.8.254

IP

root@imx8mqevk:~# ifconfig eth0 192.168.8.119

root@imx8mqevk:~# ping www.baidu.com

http://www.embest-tech.cn 14
 MaaXBoard-Linux-Yocto-UM-V1.1

3.8 USB 3.0

USB 3.0 HUB1 USB3.0 USB0 USB1

USB0 USB1 USB Host USB0 USB Device

3.8.1 USB Host

U USB0 USB1 :

[ 541.484723] usb 2-1: new SuperSpeed USB device number 2 using xhci-hcd
[ 541.548910] usb-storage 2-1:1.0: USB Mass Storage device detected
[ 541.558886] scsi host0: usb-storage 2-1:1.0
[ 542.593679] scsi 0:0:0:0: Direct-Access Kingston DataTraveler 3.0 PQ: 0 ANSI: 6
[ 542.604306] sd 0:0:0:0: [sda] 30218842 512-byte logical blocks: (15.5 GB/14.4 GiB)
[ 542.612602] sd 0:0:0:0: [sda] Write Protect is off
[ 542.618045] sd 0:0:0:0: [sda] Write cache: disabled, read cache: enabled, doesn't support DPO
or FUA
[ 542.632439] sda: sda1
[ 542.636616] sd 0:0:0:0: [sda] Attached SCSI removable disk
[ 542.817343] FAT-fs (sda1): Volume was not properly unmounted. Some data may be corrupt.
Please run fsck.

root@imx8mqevk:~# ls /dev/sd*
/dev/sda /dev/sda1

/dev sda1 U mount

USB

3.8.2 USB Device

USB0 USB Device USB

3.8.2.1

USB0 PC uuu

MaaXBoard EMMC

http://www.embest-tech.cn 15
 MaaXBoard-Linux-Yocto-UM-V1.1

3.8.2.2 USB

USB0 uEnv.txt fdt_file

fdt_file=em-sbc-imx8m-usb0-device.dtb

HDMI

USB0 HUB1 USB PC

Window 7

1) Linux USB Ethernet LinuxTools Linux

USB Ethernet/RNDIS Gadget

2) USB OTG IP IP IP

IP PC IP

root@imx8mqevk:~# ifconfig usb0 up

root@imx8mqevk:~# ifconfig usb0 192.168.1.115
root@imx8mqevk:~# ifconfig

usb0 Link encap:Ethernet HWaddr 92:a9:b6:be:8b:3f

inet addr:192.168.1.115 Bcast:192.168.1.255 Mask:255.255.255.0
inet6 addr: fe80::90a9:b6ff:febe:8b3f/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:167 errors:0 dropped:0 overruns:0 frame:0
TX packets:28 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:12180 (11.8 KiB) TX bytes:7075 (6.9 KiB)

3) PC

http://www.embest-tech.cn 16
 MaaXBoard-Linux-Yocto-UM-V1.1

4) Internet 4 TCP/IPv4

IP USB OTG

5)

root@imx8mqevk:~# ping 192.168.1.15

PING 192.168.1.15 (192.168.1.15) 56(84) bytes of data.
64 bytes from 192.168.1.15: icmp_seq=1 ttl=64 time=0.865 ms
64 bytes from 192.168.1.15: icmp_seq=2 ttl=64 time=0.464 ms
64 bytes from 192.168.1.15: icmp_seq=3 ttl=64 time=0.259 ms

http://www.embest-tech.cn 17
 MaaXBoard-Linux-Yocto-UM-V1.1

3.9 Wi-Fi

Wi-Fi 2.4G/5G

3.9.1 Wi-Fi

Wi-Fi

root@imx8mqevk:~# ./wifi_sta_connect.sh Embest-WiFi 12345678

Embest-WiFi SSID 12345678 Wi-Fi

udhcpc: sending discover

udhcpc: sending select for 192.168.1.141
udhcpc: lease of 192.168.1.141 obtained, lease time 86400
/etc/udhcpc.d/50default: Adding DNS 192.168.1.1

ping wifi

root@imx8mqevk:~# ping www.baidu.com -I wlan0

PING www.a.shifen.com (103.235.46.39) 56(84) bytes of data.
64 bytes from 103.235.46.39: icmp_seq=1 ttl=50 time=122 ms

3.9.2 Wi-Fi

Wi-Fi

root@imx8mqevk:~# ./wifi_stop.sh

Terminating DHCP
3907

Terminating hostapd

Terminating wpa_supplicant
root 3887 1 0 09:25 ? 00:00:00 wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf -D nl80211
sending signal 15 to procs
wlan0 has been disconnected on STA mode and AP mode !

http://www.embest-tech.cn 18
 MaaXBoard-Linux-Yocto-UM-V1.1

3.9.3 Wi-Fi

J13 Wi-Fi

root@imx8mqevk:~# ./wifi_ap_start.sh
Configuration file: /etc/hostapd_mx8.conf
rfkill: Cannot open RFKILL control device
wlan0: Could not connect to kernel driver
Using interface wlan0 with hwaddr 80:c5:f2:7f:6e:cd and ssid "wifi_testAP"
wlan0: interface state UNINITIALIZED->ENABLED
wlan0: AP-ENABLED

ssid wifi_testAP 12345678

vi /etc/hostapd_mx8.conf

./wifi_stop.sh

3.10 Bluetooth 4.2

root@imx8mqevk:~# ./bluetooth_start.sh

3.11 Camera

MaaXBoard USB Camera MIPI-CSI Camera Camera

Camera MaaXBoard

root@imx8mqevk:~# ./Camera

http://www.embest-tech.cn 19
 MaaXBoard-Linux-Yocto-UM-V1.1

Camera

USB uvcvideo MIPI-CSI mx6s-csi

Camera Camera

http://www.embest-tech.cn 20
 MaaXBoard-Linux-Yocto-UM-V1.1

Capture Video yuyv yuv

YUVPlayer

http://www.embest-tech.cn 21
 MaaXBoard-Linux-Yocto-UM-V1.1

Camera

$HOME/images/

Ctrl+C X

3.12 GPIO (40 Pin Sense Hat) (TBD)

TBD

3.13

Yocto /run/media/

root@imx8mqevk:~# ls /run/media/
mmcblk0p1 sda1

mmcblk0p1 SD sda1 U

http://www.embest-tech.cn 22
 MaaXBoard-Linux-Yocto-UM-V1.1

3.14

MaaXBoard Wayland

Terminal

Demo application Demo

3.15 QT&GPU

Yocto QT5.9.4 GPU EGL, OpenCV Open CL Open VG

GPU /opt/ :

root@imx8mqevk:~# /usr/share/qt5/examples/gui/openglwindow/openglwindow
root@imx8mqevk:~# /opt/imx-gpu-sdk/GLES3/Skybox/Skybox_Wayland
root@imx8mqevk:~# /opt/imx-gpu-sdk/OpenVG/Example3/Example3_Wayland
root@imx8mqevk:~# /opt/viv_samples/tiger/tiger

Ctrl+C

http://www.embest-tech.cn 23
 MaaXBoard-Linux-Yocto-UM-V1.1

3.16

Yocto MP4 4K

root@imx8mqevk:~# gst-play-1.0 4ktest.mp4

http://www.embest-tech.cn 24
 MaaXBoard-Linux-Yocto-UM-V1.1

4 Demo Application

demo demo

HDMI MIPI-LVDS

Demo

Wayland Terminal
QtFM
Chromium
WiFi_Config
Camera
Video
3D Example
QT Examples

http://www.embest-tech.cn 25
 MaaXBoard-Linux-Yocto-UM-V1.1

4.1 Wayland Terminal

http://www.embest-tech.cn 26
 MaaXBoard-Linux-Yocto-UM-V1.1

4.2 QtFM

QT

http://www.embest-tech.cn 27
 MaaXBoard-Linux-Yocto-UM-V1.1

4.3 Chromium

http://www.embest-tech.cn 28
 MaaXBoard-Linux-Yocto-UM-V1.1

4.4 WiFi_Config

WiFi_Config Wi-Fi Wi-Fi

WiFi SSID Wi-Fi Wi-Fi Wi-Fi

http://www.embest-tech.cn 29
 MaaXBoard-Linux-Yocto-UM-V1.1

4.5 Camera

Camera USB Camera MIPI-CSI Camera Yocto Camera

Camera

http://www.embest-tech.cn 30
 MaaXBoard-Linux-Yocto-UM-V1.1

4.6 Video

Video mp4 avi 4K

http://www.embest-tech.cn 31
 MaaXBoard-Linux-Yocto-UM-V1.1

http://www.embest-tech.cn 32
 MaaXBoard-Linux-Yocto-UM-V1.1

4.7 3D Example

3D Example 8 3D Esc

Esc

http://www.embest-tech.cn 33
 MaaXBoard-Linux-Yocto-UM-V1.1

4.8 QT Examples

QT Examples 4 QT

http://www.embest-tech.cn 34
 MaaXBoard-Linux-Yocto-UM-V1.1

5.1 Windows SD
1. 8G SD
2. https://sourceforge.net/projects/win32diskimager/ Win32 Disk Imager PC

3. MaaXBoard-LinuxShipmentImage-Yocto-V1.0.6r07.img

4. Write

http://www.embest-tech.cn 35
 MaaXBoard-Linux-Yocto-UM-V1.1

5.2 Linux SD

Ubuntu Debian bmap-tool SD

MaaXBoard-LinuxShipmentImage-Yocto-V1.0.6r07.img

1. bmap-tools

$ sudo apt install bmap-tools

2. SD sdc

$ ls /dev/sd*
/dev/sda /dev/sda2 /dev/sdb /dev/sdb2 /dev/sdc /dev/sdc2
/dev/sda1 /dev/sda5 /dev/sdb1 /dev/sdb5 /dev/sdc1

3. SD

$ sudo umount /dev/sdc1

$ sudo umount /dev/sdc2

4.

$ bmaptool create -o burn.map MaaXBoard-LinuxShipmentImage-Yocto-V1.0.6r07.img

$ sudo bmaptool copy --bmap burn.map MaaXBoard-LinuxShipmentImage-Yocto-V1.0.6r07.img
/dev/sdc

5.3 EMMC

USB0 HUB1 USB USB0 PC

uuu MaaXBoard EMMC

http://www.embest-tech.cn 36
 MaaXBoard-Linux-Yocto-UM-V1.1

6.1

MaaXBoard

http://www.embest-tech.cn 37
 MaaXBoard-Linux-Yocto-UM-V1.1

7.1

7.2

12

http://www.embest-tech.cn 38
 MaaXBoard-Linux-Yocto-UM-V1.1

( )

http://www.embest-tech.cn 39
 MaaXBoard-Linux-Yocto-UM-V1.1

+86-755-33190846/33190847/33190848

support@embest-tech.com

chinasales@embest-tech.com

+86-755-25616057

http://www.embest-tech.cn

4093 4 B

http://www.embest-tech.cn 40