Download
Share
Print this page
  1. Manuals
  2. Brands
  3. Avnet Manuals
  4. Computer Hardware
  5. MaaXBoard8ULP
  6. User manual

Avnet MaaXBoard8ULP User Manual

Hide thumbs

Advertisement

Quick Links

Download this manual
MaaXBoard 8ULP
Yocto User Manual
V3.1

Advertisement

loading
Need help?

Need help?

Do you have a question about the MaaXBoard8ULP and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Avnet MaaXBoard8ULP

Summary of Contents for Avnet MaaXBoard8ULP

  • Page 1 MaaXBoard 8ULP Yocto User Manual V3.1...

  • Page 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.

  • Page 3: Revision History

    V1.0 Initial version Lily 2022/10/28 Updated Yocto kirkstone(4.0), BSP_VERSION V2.0 Lily 2023/05/16 lf-5.15.71-2.2.0, Converts the file format to markdown V3.0 Updated Yocto to Langdale(4.1), BSP_VERSION to lf-6.1.1-1.0.0 Lily 2023/06/21 V3.1 Lily 2023/10/25 Updated Yocto to mickledore(4.2), BSP_VERSION to lf-6.1.22-2.0.0 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 4 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 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 5 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 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 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 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...

  • Page 7: Chapter 1 Introduction

    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.
  • Page 8 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  https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 9 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 Executing uuu.exe in Command Prompt, The specific commands are as follows:...
  • Page 10 -b emmc u-boot-maaxboard-8ulp.bin 2.1.3 Program Entire System Image 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.
  • Page 11 UARTS on MaaXBoard 8ULP Interface Type The first two Reserved The third UART A35 Debug Interface The last UART M33 Debug Interface The following is an example, when connect J4 of MaaXBoard 8ULP to the PC USB, view the Device https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...

  • Page 12: Login System

    2.4.2 Login from Debug Serial Install the Serial Communication software (e.g. PUTTY), select the corresponding port number  (Obtained from Device Manager refer to 2.3 Debug UARTS), baud rate as 115200, data bits as 8, stop bits as 1, parity as none. https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 13  When the system boots up, the serial terminal of A35 debug interface will print the following  information: NXP i.MX Release Distro 6.1-mickledore maaxboard8ulp ttyLP1 maaxboard8ulp login: Enter username as “root”, login without password.  When the system boots up, the serial terminal of M33 debug interface will print the following ...
  • Page 14 SSH, such as PuTTY, WinSCP, etc. 2.4.3.1 Preparation Check the IP of MaaXBoard 8ULP: The IP will be used in SSH login. root@maaxboard8ulp:~# ifconfig eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.2.151 netmask 255.255.255.0 broadcast 192.168.2.255 inet6 fe80::54c2:6ff:fece:1c8f prefixlen 64 scopeid 0x20<link>...
  • Page 15 MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0 Run PUTTY, in Connection->SSH->Kex, Change the sequence of algorithm.  In Session, enter IP address, e.g. 192.168.2.151, port 22, and Connection type SSH, Then click  Open. In the first connection, click Y in the pop-up window.  https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 16 MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0 Enter username as “root” to login, enter exit to logout.  https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 17 Here is the default setting in uEnv.txt: # Refer to readme.txt for more information on setting up U-Boot Env # Device tree base file fdt_file=maaxboard-8ulp.dtb # Camera can support ov5640 #dtoverlay_camera=ov5640 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 18 After the modification, execute sync and reboot commands to make it effect. root@maaxboard-8ulp:~# sync root@maaxboard-8ulp:~# reboot 3.2 USER LED(RGB) User can control the Tri-color LED indicators, LED1 on MaaXBoard 8ULP. Execute the following instructions in serial terminal to control them. https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...

  • Page 19: Button Switches

    MaaXBoard-8ULP-Linux-Yocto-UserManual-V3.0 LED lights on and off blue: root@maaxboard8ulp:~# echo 1 > /sys/class/leds/ledblue/brightness root@maaxboard8ulp:~# echo 0 > /sys/class/leds/ledblue/brightness LED lights on and off red: root@maaxboard-8ulp:~# echo 1 > /sys/class/leds/ledred/brightness root@maaxboard-8ulp:~# echo 0 > /sys/class/leds/ledred/brightness LED lights on and off green: root@maaxboard-8ulp:~# echo 1 > /sys/class/leds/ledgreen/brightness root@maaxboard-8ulp:~# echo 0 >...

  • Page 20: Display Output

    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@maaxboard8ulp:~# echo 0 > /sys/class/backlight/pwm-backlight/brightness root@maaxboard8ulp:~# echo 5 > /sys/class/backlight/pwm-backlight/brightness root@maaxboard8ulp:~# echo 9 > /sys/class/backlight/pwm-backlight/brightness 3.5 Touchscreen...
  • Page 21 Event type 3 (EV_ABS) Event code 0 (ABS_X) Value Event code 1 (ABS_Y) Value 1279 Event code 47 (ABS_MT_SLOT) Value Event code 48 (ABS_MT_TOUCH_MAJOR) Value Event code 50 (ABS_MT_WIDTH_MAJOR) Value Event code 53 (ABS_MT_POSITION_X) Value Event code 54 (ABS_MT_POSITION_Y) https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 22 3.5mm headset to J9 to use it. Use command aplay -l to check that the device id is 0, device name is da7212audio. root@maaxboard-8ulp:~# aplay -l **** List of PLAYBACK Hardware Devices **** card 0: da7212audio [da7212-audio], device 0: rpmsg hifi da7213-hifi-0 [] https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 23 = use audio card 0 to record (device id of the codec-connected MIC), Use command arecord -l and aplay -l to check the device ID. Change those parameters according to your device. 3.6.3 Play Audio File root@maaxboard-8ulp:~# pulseaudio -D -v root@maaxboard-8ulp:~# aplay audio_sample.wav https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 24 When using above commands, Audio will play from the default device (on-board audio output interface). Use the following command to view the current available sound cards and the default sound card: root@maaxboard8ulp:~# pacmd list-sinks | egrep '(index|name):' index: 0 name: <alsa_output.platform-imx-audio-rpmsg.3.auto.stereo-fallback>...
  • Page 25 In above command, modify the camera device ID, the width and height of the video, the path and name of the saved file, etc. The video file can be copied to other devices, such as computer to display, or use gst-play-1.0 to display it on the screen directly. root@maaxboard-8ulp:~# gst-play-1.0 output.mp4 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 26 3.9.3 Set Static IP If you need to set a static IP, execute the following commands: Set Static IP info: use vi command to modify /etc/dhcpcd.conf, add following info. root@maaxboard-8ulp:~# vi /etc/systemd/network/01-eth0.network [Match] Name=eth0 [Network] Address=192.168.2.77/24 Gateway=192.168.2.1 DNS=8.8.8.8 DNS=114.114.114.114 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 27 [ 330.469793] sd 0:0:0:0: [sda] 122142720 512-byte logical blocks: (62.5 GB/58.2 GiB) [ 330.478513] sd 0:0:0:0: [sda] Write Protect is off [ 330.484573] sd 0:0:0:0: [sda] Write cache: disabled, read cache: enabled, doesn't support DPO or FUA [ 330.501911] sda: sda1 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 28 User can create wpa_supplicant.conf in /run/media/mmcblk0p1/ to load the Wi-Fi driver and firmware (take "TEST23"&"12345678" as an example), Run the following commands to start Wi-Fi: root@maaxboard-8ulp:~# vi /run/media/boot-mmcblk0p1/wpa_supplicant.conf ctrl_interface=/var/run/wpa_supplicant ctrl_interface_group=0 update_config=1 network={ scan_ssid=1 ssid="TEST23" psk="12345678" root@maaxboard-8ulp:~# systemctl enable wpa-conf.timer https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 29 TX packets 44 bytes 5756 (5.6 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 root@maaxboard8ulp:~# ping www.avnet.com -I mlan0 PING www.avnet.com (184.50.90.49) 56(84) bytes of data. 64 bytes from a184-50-90-49.deploy.static.akamaitechnologies.com (184.50.90.49): icmp_seq=1 ttl=55 time=34.4 ms 64 bytes from a184-50-90-49.deploy.static.akamaitechnologies.com (184.50.90.49): icmp_seq=2 ttl=55 time=33.8 ms...
  • Page 30 [ 490.393642] woal_cfg80211_set_rekey_data return: gtk_rekey_offload is DISABLE Run the command to get the IP address: root@maaxboard-8ulp:~# udhcpc -i mlan0 -n -R root@maaxboard-8ulp:~# ifconfig mlan0 Test Wi-Fi network with ping command: root@maaxboard8ulp:~# ping www.avnet.com PING www.avnet.com (184.50.90.49) 56(84) bytes of data. https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 31 If you want to configure WPA2 for the AP using open source supplicant, need to add the following additional lines: wpa=2 wpa_key_mgmt=WPA-PSK rsn_pairwise=CCMP wpa_passphrase=123456789 Note: You can modify your ssid and wpa_passphrase in hostapd-5g.conf file. Create the configuration file for udhcp server: root@maaxboard-8ulp:~# vi /etc/udhcpd.conf https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 32 Bluetooth protocol layer. This command is mainly used to initialize the Bluetooth device: root@maaxboard-8ulp:~# hciattach /dev/ttyLP2 any 115200 Setting TTY to N_HCI line discipline Device setup complete Use hciconfig to check the Bluetooth address and start the Bluetooth: https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 33 Pair and connect the device: [bluetooth]# pair E8:EC:A3:21:57:6C [bluetooth]# trust E8:EC:A3:21:57:6C [bluetooth]# connect E8:EC:A3:21:57:6C [device name]# disconnect E8:EC:A3:21:57:6C Exit bluetoothctl. [bluetooth]# exit In above instructions, E8:EC:A3:21:57:6C is the address of the Bluetooth device, change it according to your device. https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 34 UUID: Audio Sink (0000110b-0000-1000-8000-00805f9b34fb) UUID: A/V Remote Control Target (0000110c-0000-1000-8000-00805f9b34fb) UUID: A/V Remote Control (0000110e-0000-1000-8000-00805f9b34fb) UUID: PnP Information (00001200-0000-1000-8000-00805f9b34fb) UUID: Generic Access Profile (00001800-0000-1000-8000-00805f9b34fb) UUID: Generic Attribute Profile (00001801-0000-1000-8000-00805f9b34fb) Connect Bluetooth device: root@maaxboard-8ulp:~# bluetoothctl [bluetooth]# power on [bluetooth]# pairable on https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 35 This chapter will provide the Control methods of 40 Pin interface, include GPIO, I2C, SPI and UART. 3.14.1 GPIO To use the GPIOs of the 40-pins interface, enable the following options in uEnv.txt : dtoverlay_gpio=1 System use /sys/class/gpio to control the GPIO pin, refer to the following table: https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 36 2. Set the function of PIN35 to be GPIO output. root@maaxboard-8ulp:~# echo 223 >/sys/class/gpio/export root@maaxboard-8ulp:~# echo out >/sys/class/gpio/gpio223/direction 3. Set the level of PIN35, 0 means low, 1 means high. root@maaxboard-8ulp:~# echo 1 >/sys/class/gpio/gpio223/value Measure the voltage of PIN35, the result is 3.3V. root@maaxboard-8ulp:~# echo 0 >/sys/class/gpio/gpio223/value https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 37 To use the SPI of the 40-pins interface, enable the following options in uEnv.txt : to uEnv.txt, then execute sync and reboot command to make it effect. dtoverlay_i2c=4 Connect SDA4 (#3), SCL4 (#5), VCC and GND to a IIC device, then execute i2cdetect, MaaXBoard https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 38 965M 0 965M 0% /dev/shm tmpfs 386M 8.9M 378M 3% /run tmpfs 4.0M 0 4.0M 0% /sys/fs/cgroup tmpfs 965M 288K 965M 1% /tmp tmpfs 965M 168K 965M 1% /var/volatile tmpfs 193M 4.0K 193M 1% /run/user/0 /dev/mmcblk0p1 52M 38% /run/media/boot-mmcblk0p1 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...
  • Page 39 965M 0 965M 0% /dev/shm tmpfs 386M 8.9M 378M 3% /run tmpfs 4.0M 0 4.0M 0% /sys/fs/cgroup tmpfs 965M 288K 965M 1% /tmp tmpfs 965M 168K 965M 1% /var/volatile tmpfs 193M 4.0K 193M 1% /run/user/0 /dev/mmcblk0p1 52M 38% /run/media/boot-mmcblk0p1 https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...

  • Page 40: Chapter 4 Appendix

    - Describes how to boo MaaXBoard 8ULP and aspects of the BSP functionality(This document) MaaXBoard 8ULP Linux Yocto Development Guide  - Detailed guidance on how to rebuild the Linux system image 4.3 Contact Information Product Webpage:  https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxb oard-8ulp/ https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/maaxboard/maaxboard-8ulp/...