Avnet MaaXBoard8ULP User manual

MaaXBoard 8ULP
Yocto User Manual
V3.1

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
2
Copyright Statement:
The MaaXBoard 8ULP 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.

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
3
Revision History
Rev.
Description
Author
Date
V1.0
Initial version
Lily
2022/10/28
V2.0
Updated Yocto to kirkstone(4.0), BSP_VERSION to
lf-5.15.71-2.2.0, Converts the file format to markdown
Lily
2023/05/16
V3.0
Updated Yocto to Langdale(4.1), BSP_VERSION to lf-6.1.1-1.0.0
Lily
2023/06/21
V3.1
Updated Yocto to mickledore(4.2), BSP_VERSION to lf-6.1.22-2.0.0
Lily
2023/10/25

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
4
Catalog
Chapter 1 Introduction ....................................................................................................................................7
1.1 Target Board: MaaXBoard 8ULP ......................................................................................................7
1.2 Introduction ....................................................................................................................................... 7
1.3 Feature List ....................................................................................................................................... 7
Chapter 2 Boot up System .............................................................................................................................9
2.1 Program images into MaaXBoard 8ULP ..........................................................................................9
2.1.1 Preparation for programming .................................................................................................9
2.1.2 Only Program u-boot Image ...................................................................................................9
2.1.3 Program Entire System Image .............................................................................................10
2.2 Boot from eMMC .............................................................................................................................10
2.3 Debug UARTs ................................................................................................................................. 11
2.4 Login system ...................................................................................................................................12
2.4.1 Login Directly ........................................................................................................................12
2.4.2 Login from Debug Serial ...................................................................................................... 12
2.4.3 Login from SSH ....................................................................................................................13
Chapter 3 Feature Configuration & Introduction ......................................................................................... 17
3.1 Settings in uEnv.txt ......................................................................................................................... 17
3.2 USER LED(RGB) ............................................................................................................................18
3.3 Button Switches .............................................................................................................................. 19
3.4 Display output ................................................................................................................................. 20
3.4.1 MIPI-DSI Screen .................................................................................................................. 20
3.5 Touchscreen ....................................................................................................................................20
3.6 Audio ............................................................................................................................................... 22
3.6.1 Check Audio Device IDs ...................................................................................................... 22
3.6.2 Record Audio ........................................................................................................................23

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
5
3.6.3 Play Audio File ......................................................................................................................23
3.7 Video ............................................................................................................................................... 24
3.8 Camera ........................................................................................................................................... 24
3.8.1 Check Device ID ...................................................................................................................25
3.8.2 Preview .................................................................................................................................25
3.8.3 Take Photo ............................................................................................................................25
3.8.4 Record Video ........................................................................................................................25
3.9 100M Ethernet Interface .................................................................................................................26
3.9.1 Network Test .........................................................................................................................26
3.9.2 Set MAC Address .................................................................................................................26
3.9.3 Set Static IP ..........................................................................................................................26
3.9.4 Set Dynamic IP .....................................................................................................................27
3.10 Storage ......................................................................................................................................... 27
3.10.1 eMMC ................................................................................................................................. 27
3.11 USB 2.0 Interface ..........................................................................................................................27
3.11.1 USB Host ............................................................................................................................ 27
3.12 Wi-Fi ..............................................................................................................................................28
3.12.1 Enable Wi-Fi .......................................................................................................................28
3.12.2 Connect Wi-Fi Manually .....................................................................................................29
3.12.3 Wi-Fi Hotspot ......................................................................................................................31
3.13 Bluetooth 5.0 .................................................................................................................................32
3.13.1 Enable Bluetooth ................................................................................................................32
3.13.2 Connect Bluetooth Device ................................................................................................. 33
3.13.3 Configure A2DP sink or source ..........................................................................................34
3.14 Pi HAT 40 Pin Expansion Interface .............................................................................................. 35
3.14.1 GPIO ...................................................................................................................................35
3.14.2 SPI ......................................................................................................................................37

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
6
3.14.3 UART ..................................................................................................................................37
3.14.4 IIC ....................................................................................................................................... 37
3.15 Reserved Ports from M33 ............................................................................................................ 38
3.16 Procedure to Increase eMMC Partition Size ............................................................................... 38
Chapter 4 Appendix ......................................................................................................................................40
4.1 Hardware ........................................................................................................................................ 40
4.2 Software ..........................................................................................................................................40
4.3 Contact Information ........................................................................................................................ 40

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
7
Chapter 1 Introduction
1.1 Target Board: MaaXBoard 8ULP
MaaXBoard 8ULP is a development board developed by Avnet, Which featuresthe NXP i.MX 8ULP
processor to achieve ultra-low power, EdgeLock® secured intelligent edge applications.
MaaXBoard 8ULP is engineered as two PCBs, a small SOM (43mm x 36mm) connected via 2x100-pin
connectors to a baseboard (BB) in compact Raspberry Pi form-factor, which supports a versatile set of I/O
interfaces. These include 100M Ethernet, two USB 2.0 host interfaces, plus separate USB 2.0 device
interface, MIPI DSI display and MIPI CSI camera interfaces, a Pi-HAT compatible 40-pin header, MikroE
Click 16-pin header plus ADC/DAC 6-pin header.
1.2 Introduction
This document provides a guide to prepare MaaXBoard 8ULP to boot up with the Verified Linux Package
and introduces how to use the functions of MaaXBoard 8ULP.
1.3 Feature List
Yocto version: mickledore(4.2), based on NXP SDK version: imx-6.1.22-2.0.0

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
8
U-Boot version: 2023.04
Kernel version: 6.1.22
Evaluation image: Yocto Image
Development based on NXP i.MX 8ULP
eMMC boot
Device-tree Overlay support
Desktop (Weston 11.0.0)
100M Ethernet (RJ45)
2 x USB 2.0 Host
2 x UART debug ports from USB 2.0 Device
Pi HAT 40 Pin Expansion Interface (I2C,UART,SPI and GPIO)
WIFI & BLE 5.0
MIPI-DSI display
Audio playback
MIPI-CSI Camera/USB Camera

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
9
Chapter 2 Boot up System
MaaXBoard 8ULP supports boot up from eMMC, We will introduce how to program system images to
eMMC and boot from it in this chapter.
2.1 Program images into MaaXBoard 8ULP
2.1.1 Preparation for programming
1. Set SW1 Boot Switch on MaaXBoard-8ULP to Serial Download Mode:
1(CFG0)
2(CFG1)
3(CFG4)
4(MOD0)
5(MOD1)
6(SEL)
Serial Download Mode：
0
0
0
ON
0
0
Internal Boot Mode：
0
0
0
0
ON
0
2. Connect J7（USB0/POWER）and J4(USB for Debug) to PC USB port, connect J8 to a network cable.
3. Download the program tool uuu.exe from the network, The recommended website is:
https://github.com/nxp-imx/mfgtools/releases/tag/uuu_1.5.21
4. Put the built files: u-boot image, entire system image, and uuu.exe into a same folder.
After completing the preparations, take the following images as an example:
u-boot image: u-boot-maaxboard-8ulp.bin
entire system image: avnet-image-full-maaxboard-8ulp.wic
2.1.2 Only Program u-boot Image
1. Executing uuu.exe in Command Prompt, The specific commands are as follows:

MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0
https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/
10
uuu -b emmc u-boot-maaxboard-8ulp.bin
2.1.3 Program Entire System Image
1. Executing uuu.exe in Command Prompt, The specific commands are as follows:
uuu -b emmc_all u-boot-maaxboard-8ulp.bin avnet-image-full-maaxboard-8ulp.wic
NOTE: To program the entire system image, the boot image must be programmed at the same time.
2.2 Boot from eMMC
Set SW1 Boot Switch on MaaXBoard-8ULP to Internal Boot Mode.
1(CFG0)
2(CFG1)
3(CFG4)
4(MOD0)
5(MOD1)
6(SEL)
Serial Download Mode：
0
0
0
ON
0
0
Internal Boot Mode：
0
0
0
0
ON
0