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.