Avnet MaaXBoard Mini User manual

MaaXBoard Mini
Yocto Lite User Manual
V1.1

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 2
Copyright Statement:
The MaaXBoard Mini single board computer and its related intellectual property are owned by Avnet
Manufacturing Services.
Avnet Manufacturing Services has the copyright of this document and reserves all rights. Any part of
the document should not be modified, distributed or duplicated in any approach and form without the
written permission issued by Avnet Manufacturing Services.
Disclaimer:
Avnet Manufacturing Services does not take warranty of any kind, either expressed or implied, as to
the program source code, software and documents provided along with the products, and including,
but not limited to, warranties of fitness for a particular purpose; The entire risk as to the quality or
performance of the program is with the user of products.
Regulatory Compliance:
MaaXBoard Mini single board computer has passed the CE, FCC & SRRC certification.

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 3
Revision History
Rev. Description Author Date
V1.0 Initial version Sandy 20200903
V1.1 Updated Yocto 3.0 Nick 20210322

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 4
Catalog
Chapter 1 Introduction............................................................................................................................. 7
1.1 Package Content....................................................................................................................... 7
1.2 Feature List ............................................................................................................................... 8
Chapter 2 Quick Start.............................................................................................................................. 9
2.1 Boot from SDCard..................................................................................................................... 9
2.2 Boot from eMMC ..................................................................................................................... 10
2.3 Login system ............................................................................................................................11
2.3.1 Login Directly ................................................................................................................11
2.3.2 Login from Debug Serial...............................................................................................11
2.3.3 Login from SSH ........................................................................................................... 12
Chapter 3 Feature Configuration & Introduction ................................................................................... 15
3.1 USER LED .............................................................................................................................. 15
3.2 Button ...................................................................................................................................... 15
3.3 Displayer ................................................................................................................................. 17
3.3.1 MIPI-DSI Screen .......................................................................................................... 18
3.4 Touchscreen ............................................................................................................................ 18
3.5 Audio ....................................................................................................................................... 19
3.5.1 Play Audio file .............................................................................................................. 19
3.5.2 Supported Devices ...................................................................................................... 19
3.6 Video ....................................................................................................................................... 21
3.7 Camera.................................................................................................................................... 21
3.7.1 Check Device ID .......................................................................................................... 21
3.7.2 Preview ........................................................................................................................ 21
3.7.3 Take Photo................................................................................................................... 21
3.7.4 Record Video ............................................................................................................... 22

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 5
3.8 Gigabit Ethernet Interface ....................................................................................................... 22
3.8.1 Network Test ................................................................................................................ 22
3.8.2 Set Static IP ................................................................................................................. 22
3.9 USB 2.0 Interface.................................................................................................................... 23
3.9.1 USB Host ..................................................................................................................... 23
3.9.2 USB Device.................................................................................................................. 24
3.10 Wi-Fi ........................................................................................................................................ 26
3.10.1 Connect WIFI............................................................................................................... 26
3.10.2 Auto Connect Wi-Fi Network ....................................................................................... 27
3.10.3 Wi-Fi Hotspot ............................................................................................................... 28
3.11 Bluetooth 4.2 ........................................................................................................................... 29
3.11.1 Initialize the Bluetooth Module..................................................................................... 29
3.11.2 Connect Bluetooth Device ........................................................................................... 29
3.11.3 Send Files .................................................................................................................... 29
3.12 UART....................................................................................................................................... 30
3.12.1 UART 2 ........................................................................................................................ 30
3.13 Control 40 Pin Interface .......................................................................................................... 30
3.13.1 GPIO ............................................................................................................................ 30
Chapter 4 Burn or update the system Image ........................................................................................ 32
4.1 Burn the System Image to SD Card under Windows OS ....................................................... 32
4.2 Burn the System Image to SD Card under Linux OS ............................................................. 33
4.3 Update System Image in eMMC ............................................................................................. 33
Chapter 5 Appendix............................................................................................................................... 35
5.1 Hardware................................................................................................................................. 35
5.2 Software .................................................................................................................................. 35
5.3 USB Burning............................................................................................................................ 35
5.4 Verified Device List.................................................................................................................. 35

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 6
Chapter 6 Technical Support and Warranty .......................................................................................... 37
6.1 Technical Support.................................................................................................................... 37
6.2 Warranty Conditions................................................................................................................ 37
Chapter 7 Contact Information .............................................................................................................. 39

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 7
Chapter 1Introduction
1.1 Package Content
The content of software release package is subject to the actual release sources. For the file structure
and instructions, refer to the following table:
Release Folder tree
├─01Doc
││MaaXBoard-Mini-Linux-Yoc to -ReleaseNote-Vxx.pdf
│└─EN
│MaaXBoard-Mini-Hardware_UserManual-Vxx.pdf
│MaaXBoard-Mini-Linux-Yocto-Development_Guide-Vxx.pdf
│MaaXBoard-Mini-UUU_Burning_Guide-Vxx.pdf
│MaaXBoard-Mini-Linux-Yocto-UserManual-Vxx.pdf
└─04Linux Yocto Lite
│├─01LinuxSourceCode
││MaaXBoard-Mini-LinuxSourceCode-Vxx.rar
│├─02LinuxShipmentImage
││MaaXBoard-Mini-LinuxShipmentImage-Yocto-Vxx.rar
│└─03LinuxTools
│MaaXBoard-Mini-LinuxTools-Vxx.rar
01Doc Description
MaaXBoard-Mini-Linux-Yocto-ReleaseNote-Vxx.pdf Release Note
MaaXBoard-Mini-Linux-Yocto-UserManual-Vxx.pdf User Manual
MaaXBoard-Mini-Linux-Yocto-DevelopmentGuide-Vxx.pdf Development Guide
01LinuxSourceCode Description
MaaXBoard-Mini-LinuxSourceCode-Vxx.rar MaaXBoard source code package
02LinuxShipmentImage Description
lite-image-maaxboard-mini-ddr4-2g-sdcard-**.rootfs.sdcard.bz2 Yocto image with firmware, system image
file
imx-boot-maaxboard-mini-ddr4-2g-sdcard-sd.bin-flash_ddr4_evk U-boot image, used to burn eMMC board
03LinuxTools Description
xxx Other tools

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 8
1.2 Feature List
Yocto version: Zeus (3.0), based on NXP SDK version: imx-5.4.24-2.1.0
U-Boot version: 2020.04
Kernel version: 5.4.24
Evaluation image: Yocto Lite Image
Development based on NXP i.MX 8M Mini
Micro SD boot
1 Gigabit Ethernet (RJ45)
3 x USB 2.0 Host and 1 x USB 2.0 OTG
2 UART (TTL) include debug port
External interfaces(I2C, UART,SPI and GPIO)
WIFI & BLE 4.2
MIPI-DSI display
MIPI camera/USB Camera

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 9
Chapter 2Quick Start
The default version of MaaXBoard support boot up from SD Card only. To burn the image to SD Card,
refer to Chapter 4 Burn or update the system Image. For the hardware connection and accessories
details, please check the QSG.
2.1 Boot from SDCard
Install the Serial Communication software (e.g. PuTTY), select the corresponding port number,
baudrate as 115200, data bits as 8, stop bits as 1, parity as none.
Connect the debug interface to PC with USB to TTL converter. Pin 6, 8 and 10 of J1 to the GND, RXD
and TXD pin of the USB to TTL converter.
Insert the SD card (with pre-burned image) into the card slot J10.
Powered the board with a 5V, 2A, Type-C interface power (to J11).
When the system boot up, the serial terminal will print the following information:
NXP i.MX Release Distro 5.4-zeus maaxboard-mini ttymxc0
Maaxboard-mini login:

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 10
Enter username as “root”, password as “avnet” to login.
Maaxboard-mini login: root
Password:
Last login: Mon Mar 1 04:41:54 UTC 2021 on tty7
root@maaxboard-mini:~#
Users could also connect keyboard and mouse to MaaXBoard Mini to login Yocto system.
2.2 Boot from eMMC
If you are using the eMMC version, the boot process is the same with boot from SD card, just ignore insert
SD Card step.

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 11
2.3 Login system
Yocto Lite system support the following login methods: login directly, login from debug serial, login from
SSH.
2.3.1 Login Directly
Connect screen and keyboard to MaaXBoard Mini, username as “root”, password as “avnet” to login
Yocto system.
2.3.2 Login from Debug Serial
Install the Serial Communication software (e.g. PUTTY), select the corresponding port number,
baudrate as 115200, data bits as 8, stop bits as 1, parity as none.
Connect the debug interface to PC with USB to TTL converter. Pin 6, 8 and 10 of J1 to the GND, RXD
and TXD pin of the USB to TTL converter.
Enter username as “root”, password as “avnet” to login.

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 12
2.3.3 Login from SSH
Yocto OS install and startup SSH service automatically by default. Connect to internet, then login the
system using SSH. Use scp to transfer files.
Linux system support ssh in default, in windows OS, you can install ssh by yourself, or use other software
which support ssh or scp, such as PuTTY, WinSCP, etc.
2.3.3.1 Preparation
In default situation, users are not allowed to login from SSH as root user, so you need to modify the
configuration file or create a common user and login.
Modify methods:
Add following info to the configuration file /etc/ssh/sshd_config:
PermitRootLogin yes
Then, check the IP of MaaXBoard: The IP will be used in ssh login.
root@maaxboard-mini:~# ifconfig eth0
eth0 Link encap:Ethernet HWaddr 02:ea:0d:13:7f:29
inet addr:192.168.2.98 Bcast:192.168.2.255 Mask:255.255.255.0
inet6 addr: fe80::5eca:67bc:7e2e:2d45/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:14 errors:0 dropped:0 overruns:0 frame:0
TX packets:38 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:1903 (1.8 KiB) TX bytes:7633 (7.4 KiB)
2.3.3.2 Login Command line
In this example, the IP of MaaXBoard is 192.168.2.98, enter following command in command line window
to connect: ssh root@192.168.2.98. Enter yes in the first connection, then enter password “avnet” to
login, enter exit to logout.
embest@compiler:~$ ssh root@192.168.2.98
root@192.168.2.98's password:
Last login: Thu Sep 3 02:21:11 2020
root@maaxboard-mini:~#
To copy files using scp command, enter the following command and password:
Copy file from computer to MaaXBoard:
embest@compiler:~$ scp test.txt [email protected].2.98:/root/1.txt
Copy file from MaaXBoard to computer:
embest@compiler:~$ scp root@192.168.2.98:/root/1.txt ./1.txt

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 13
2.3.3.3 PuTTY
PuTTY support SSH, setting method as follows:
1. Run PUTTY, in Connection->SSH->Kex, change the sequence of algorithm.
2. In Session, enter IP address, e.g. 192.168.2.98, port 22, and Connection type SSH, then click Open.

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 14
3. In the first connection, click Y in the popout window.
4. Enter username as “root”, password as “avnet” to login, enter exit to logout.
login as: root
root@192.168.2.98's password:
Last login: Mon Mar 1 04:41:54 UTC 2021 from 192.168.2.72
root@maaxboard-mini:~#

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 15
Chapter 3Feature Configuration & Introduction
First of all, please refer to the previous chapter and boot up the system. Then configure or use the
functions according to the following guidance.
3.1 USER LED
User can control the 2 single color LED indicators, LED0 and LED1 (corresponding to usr_led and
sys_led) on MaaXBoard Mini. Execute the following instructions in serial terminal to control them.
Light out LED:
root@maaxboard-mini:~# echo 0 | tee /sys/class/leds/usr_led/brightness
root@maaxboard-mini:~# echo 0 | tee /sys/class/leds/sys_led/brightness
Light up LED:
root@maaxboard-mini:~# echo 1 | tee /sys/class/leds/usr_led/brightness
root@maaxboard-mini:~# echo 1 | tee /sys/class/leds/sys_led/brightness
3.2 Button
MaaXBoard Mini support 3 button: BACK, HOME and PWR.
1. Test BACK and HOME button with following instructions:
Enter evtest command, then choose the event id for gpio_keys
root@maaxboard-mini:~# evtest
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0: 30370000.snvs:snvs-powerkey
/dev/input/event1: fts_ts
/dev/input/event2: gpio_keys
Select the device event number [0-2]: 2
Input driver version is 1.0.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 158 (KEY_BACK)

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 16
Event code 172 (KEY_HOMEPAGE)
Properties:
Testing ... (interrupt to exit)
Event: time 1599100203.232960, type 1 (EV_KEY), code 172 (KEY_HOMEPAGE), value 1
Event: time 1599100203.232960, -------------- SYN_REPORT ------------
Event: time 1599100203.454065, type 1 (EV_KEY), code 172 (KEY_HOMEPAGE), value 0
Event: time 1599100203.454065, -------------- SYN_REPORT ------------
Event: time 1599100215.606083, type 1 (EV_KEY), code 158 (KEY_BACK), value 1
Event: time 1599100215.606083, -------------- SYN_REPORT ------------
Event: time 1599100215.852946, type 1 (EV_KEY), code 158 (KEY_BACK), value 0
Event: time 1599100215.852946, -------------- SYN_REPORT ------------
2. Press PWR button for 8s, system will enter suspend mode, press PWR again for 1s, the system will
reboot.
Users could also test short press PWR button using evtest command:
root@maaxboard-mini:~# evtest
No device specified, trying to scan all of /dev/input/event*
Available devices:
/dev/input/event0: 30370000.snvs:snvs-powerkey
/dev/input/event1: gpio_keys
/dev/input/event2: bd718xx-pwrkey
Select the device event number [0-2]: 0
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 1596184675.913800, type 1 (EV_KEY), code 116 (KEY_POWER), value 1
Event: time 1596184675.913800, -------------- SYN_REPORT ------------
Event: time 1596184676.169726, type 1 (EV_KEY), code 116 (KEY_POWER), value 0
Event: time 1596184676.169726, -------------- SYN_REPORT ------------

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 17
3.3 Displayer
MaaXBoard Mini supports MIPI-DSI screen display.
Users can connect the screen to the board before boot up the system according to the following table.
When the system boot up, the screen will print the related startup message and login UI. Users can
connect keyboard to login the MaaXBoard Mini file system. The default displayer is MIPI-DSI screen.
Screen Type Screen Resolution Interface
MIPI-DSI 1280*720 J7
Display device could be chosen by modify the fdt_file value in uEnv.txt.
Modify methods:
Mount the first partition of SD card or eMMC to the system, then use nano or vi command to modify the
uEnv.txt. After the modification, execute sync and reboot command to make it effect.
root@maaxboard-mini:~# mkdir mount
root@maaxboard-mini:~# mount /dev/mmcblk0p1 mount/
root@maaxboard-mini:~# nano mount/uEnv.txt

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 18
3.3.1 MIPI-DSI Screen
Choose MIPI-DSI screen, the fdt_file value should be:
fdt_file=maaxboard-mini-mipi.dtb
MIPI-DSI supports backlight brightness adjustment. The backlight brightness has a range from 0 to 9, in
which 9 means highest brightness, 0 means lowest.
Execute the following instructions on the serial terminal to implement the backlight test:
root@maaxboard-mini:~# echo 7 > /sys/class/backlight/backlight/brightness
3.4 Touchscreen
The MIPI-DSI screen support touch screen. Use evtest command to test it.
root@maaxboard-mini:~# evtest /dev/input/touchscreen0
Input driver version is 1.0.1
Input device ID: bus 0x18 vendor 0x0 product 0x0 version 0x0
Input device name: "fts_ts"
Supported events:
Event type 0 (EV_SYN)
Event type 1 (EV_KEY)
Event code 102 (KEY_HOME)
Event code 139 (KEY_MENU)
Event code 158 (KEY_BACK)
Event code 330 (BTN_TOUCH)
Event type 3 (EV_ABS)
Event code 47 (ABS_MT_SLOT)
Value 0
Min 0
Max 9
Event code 48 (ABS_MT_TOUCH_MAJOR)
Value 0
Min 0
Max 255
Event code 53 (ABS_MT_POSITION_X)
Value 0
Min 0
Max 720
Event code 54 (ABS_MT_POSITION_Y)

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 19
Value 0
Min 0
Max 1280
Event code 57 (ABS_MT_TRACKING_ID)
Value 0
Min 0
Max 65535
Event code 58 (ABS_MT_PRESSURE)
Value 0
Min 0
Max 255
Properties:
Property type 1 (INPUT_PROP_DIRECT)
Testing ... (interrupt to exit)
Event: time 1597392253.449259, type 3 (EV_ABS), code 57 (ABS_MT_TRACKING_ID), value 19
Event: time 1597392253.449259, type 3 (EV_ABS), code 58 (ABS_MT_PRESSURE), value 63
Event: time 1597392253.449259, type 3 (EV_ABS), code 53 (ABS_MT_POSITION_X), value 31
Event: time 1597392253.449259, type 3 (EV_ABS), code 54 (ABS_MT_POSITION_Y), value 1024
Event: time 1597392253.449259, type 1 (EV_KEY), code 330 (BTN_TOUCH), value 1
Event: time 1597392253.449259, -------------- SYN_REPORT ------------
Event: time 1597392253.515228, type 3 (EV_ABS), code 57 (ABS_MT_TRACKING_ID), value -1
Event: time 1597392253.515228, type 3 (EV_ABS), code 58 (ABS_MT_PRESSURE), value 0
Event: time 1597392253.515228, type 1 (EV_KEY), code 330 (BTN_TOUCH), value 0
Event: time 1597392253.515228, -------------- SYN_REPORT ------------
3.5 Audio
3.5.1 Play Audio file
root@maaxboard-mini:~# aplay audio_sample.wav
root@maaxboard-mini:~# gst-play-1.0 audio_sample.wav
Note: aplay command support audio file in wav format, gst-play command support wav, mp3 and aac
format.
3.5.2 Supported Devices
MaaXBoard Mini support USB audio device and Bluetooth audio device. If multiple devices are connected
simultaneously, the priority is as follows:
USB audio device < Bluetooth audio device

MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1
http://www.embest-tech.com 20
3.5.2.1 USB Audio Device
MaaXBoard Mini could support USB audio device (which do not need specified driver) to play audio. You
can play audio from USB audio device.
root@maaxboard-mini:~# pulseaudio -D -v
root@maaxboard-mini:~# gst-play-1.0 audio_sample.wav
3.5.2.2 Bluetooth Audio
Yocto system also support play audio files via the Bluetooth audio device such as Bluetooth headset. For
detail, refer to Bluetooth part:
Pair and connect the Bluetooth device, then execute pulseaudio -D -v before play the audio or video
files.
root@maaxboard-mini:~# pulseaudio -D -v
root@maaxboard-mini:~# gst-play-1.0 embest.mp4
Currently we only support part of Bluetooth audio device.