Avnet MaaXBoard Mini User Manual

Avnet MaaXBoard Mini User Manual

Yocto lite user manual
Hide thumbs Also See for MaaXBoard Mini:

Advertisement

Quick Links

MaaXBoard Mini
Yocto Lite User Manual
V1.1

Advertisement

Table of Contents
loading

Summary of Contents for Avnet MaaXBoard Mini

  • Page 1 MaaXBoard Mini Yocto Lite User Manual V1.1...
  • Page 2 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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.
  • Page 3 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Revision History Rev. Description Author Date V1.0 Initial version Sandy 20200903 V1.1 Updated Yocto 3.0 Nick 20210322 http://www.embest-tech.com...
  • Page 4: Table Of Contents

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Catalog Chapter 1 Introduction ..........................7 Package Content ........................7 Feature List ..........................8 Chapter 2 Quick Start ..........................9 Boot from SDCard ........................9 Boot from eMMC ........................10 Login system ..........................11 2.3.1 Login Directly ........................11 2.3.2 Login from Debug Serial ....................11 2.3.3 Login from SSH ......................
  • Page 5 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Gigabit Ethernet Interface ....................... 22 3.8.1 Network Test ........................ 22 3.8.2 Set Static IP ......................... 22 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 ..................
  • Page 6 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Chapter 6 Technical Support and Warranty ..................37 Technical Support ........................37 Warranty Conditions ........................ 37 Chapter 7 Contact Information ......................39 http://www.embest-tech.com...
  • Page 7: Chapter 1 Introduction

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Chapter 1 Introduction 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-Yocto-ReleaseNote-Vxx.pdf │ └─EN MaaXBoard-Mini-Hardware_UserManual-Vxx.pdf │...
  • Page 8: Feature List

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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 &...
  • Page 9: Chapter 2 Quick Start

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Chapter 2 Quick 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.
  • Page 10: Boot From Emmc

    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.
  • Page 11: 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.
  • Page 12: Login From Ssh

    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: root@192.168.2.98. Enter 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:...
  • Page 13 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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. http://www.embest-tech.com...
  • Page 14 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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:~# http://www.embest-tech.com...
  • Page 15: Chapter 3 Feature Configuration & Introduction

    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...
  • Page 16 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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...
  • Page 17: Displayer

    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...
  • Page 18: Mipi-Dsi Screen

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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 >...
  • Page 19: Audio

    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...
  • Page 20 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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...
  • Page 21: Video

    Yocto system support play video file in mp4 format, the largest support resolution is 4K (use with 4K HDMI Displayer), use the following command: root@maaxboard-mini:~# gst-play-1.0 embest.mp4 3.7 Camera MaaXBoard Mini support USB Camera and MIPI-CSI Camera. This part will introduce how to preview, photograph and record video under Command line. 3.7.1 Check Device ID root@maaxboard-mini:~# ls /dev/video* /dev/video0 /dev/video1 In default, MIPI-CSI camera is /dev/video0, USB Camera is /dev/video1.
  • Page 22: Record Video

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 3.7.4 Record Video Use the following instruction to record a video in mp4 format and saved to specific location. root@maaxboard-mini:~# gst-launch-1.0 -e v4l2src device=/dev/video0 num-buffers=100 ! video/x-raw,format=YUY2,framerate=30/1, width=640, height=480 ! videoconvert ! x264enc ! video/x-h264, profile=baseline ! mp4mux ! filesink location=output.mp4 In above command, modify the camera device ID, the width and height of the video, the path and name of saved file, etc.
  • Page 23: Usb 2.0 Interface

    3.9 USB 2.0 Interface MaaXBoard Mini support 4 USB Interfaces, the lower one in J2 is USB0, the upper one in J2 is USB3, the lower one in J4 is USB2, the upper one in J4 is USB1. 4 USB 2.0 interfaces support USB HOST function, only USB0 support USB Device function.
  • Page 24: Usb Device

    Connect USB0 and PC before power on the board. The system will not boot normally, it will enter burning mode. Then users could burn the system image to the development board using uuu tools. For the detail information, refer to MaaXBoard Mini UUU Burning Guide. 3.9.2.2 USB NETWORK ADAPTER To use USB0 as USB slave device: network adapter, users should modify the value of fdt_file in uEnv.txt...
  • Page 25 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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. Open Control Panel, in the search box, type adapter, and then, under Network and Sharing Center, select View network connections, you will find a new Local Area Connection as shown below 4.
  • Page 26: Wi-Fi

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 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 The information shown above indicates the network connection is working properly. 3.10 Wi-Fi The on-board Wi-Fi module support 2.4G/5G network and hotspot. 3.10.1 Connect WIFI Execute the following instructions on the serial terminal to search Wi-Fi network: root@maaxboard-mini:~# iwlist wlan0 scan It will print the information for all available network.
  • Page 27: Auto Connect Wi-Fi Network

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 IE: WPA Version 1 Group Cipher : TKIP Pairwise Ciphers (2) : CCMP TKIP Authentication Suites (1) : PSK Connect Wi-Fi network: root@maaxboard-mini:~# nano /etc/wpa_supplicant.conf Add following info into this file: network={ ssid=" Embest_WiFi " psk="12345678" Then execute the following command: root@maaxboard-mini:~# wpa_supplicant -B -i wlan0 -c /etc/wpa_supplican Successfully initialized wpa_supplicant rfkill: Cannot open RFKILL control device...
  • Page 28: Wi-Fi Hotspot

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 3.10.3 Wi-Fi Hotspot To open a Wi-Fi hotspot, disconnect Wi-Fi connection, connect the network cable to J13, and execute the following instructions on the serial terminal: Download and Install create_ap, root@maaxboard-mini:~# git clone --depth 1 https://github.com/oblique/create_ap.git root@maaxboard-mini:~# cd create_ap root@maaxboard-mini:~# make install Enable Wi-Fi hotspot root@maaxboard-mini:~# create_ap wlan0 eth0 MyAccessPoint MyPassPhrase --no-dns &...
  • Page 29: Bluetooth 4.2

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 3.11 Bluetooth 4.2 3.11.1 Initialize the Bluetooth Module Execute the following instructions on the serial terminal: root@maaxboard-mini:~# hciattach /dev/ttymxc3 bcm43xx 3000000 bcm43xx_init Set Controller UART speed to 3000000 bit/s Flash firmware /etc/firmware/BCM4345C0.1MW.hcd Set Controller UART speed to 3000000 bit/s Setting TTY to N_HCI line discipline Device setup complete root@maaxboard-mini:~# hciconfig hci0 up...
  • Page 30: Uart

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 In above instructions, 94:87:E0:DF:90:2D is the address of target device, change it according to your device. 3.12 UART MaaXBoard Mini supports 2 UART interface. MaaXBoard Mini (CPU) Interface Type UART1 UART TTL (Debug Interface) UART2 UART TTL 3.12.1 UART 2 In the Yocto system, the node for UART2 is /dev/ttymxc1.
  • Page 31 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 GPIO5_IO4 GPIO/PWM2 GPIO4_IO28 GPIO/PCM_FS GPIO GPIO3_IO16 GPIO1_IO10 GPIO GPIO/PCM_DIN GPIO4_IO30 GPIO/PCM_DOUT GPIO5_IO1 Here we use PIN 11 as an example: 1. In above table, find the GPIO Number of PIN11, which is 17. 2. Set the function of Pin11 to be GPIO output. root@maaxboard-mini:~# echo 17 >/sys/class/gpio/export root@maaxboard-mini:~# echo out >/sys/class/gpio/gpio17/direction 3.
  • Page 32: Chapter 4 Burn Or Update The System Image

    MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Chapter 4 Burn or update the system Image 4.1 Burn the System Image to SD Card under Windows OS 1. Firstly, you should prepare a SD card, which is no less than 8GB. 2. Then, download and install “Win32 Disk Imager” from: https://sourceforge.net/projects/win32diskimager/.
  • Page 33: Burn The System Image To Sd Card Under Linux Os

    USB0 (The lower one in USB interface HUB1) support burning mode. Connect USB0 and PC before power on the board. The system will enter burning mode. Then users could burn the system image to the development board using uuu tools. For the detail information, refer to “MaaXBoard Mini UUU Burning Guide”.
  • Page 34 Close the pop out message, disconnect the USB connection between USB0 and PC, power down MaaXBoard Mini, power on the board again, then the board will boot with the new system image. If you meet some problem or need help on how to modify the file name and path of system image, refer to MaaXBoard Mini UUU Burning Guide.
  • Page 35: Chapter 5 Appendix

    MaaXBoard Mini Android Software Development Guide 5.3 USB Burning MaaXBoard Mini support burn image through USB port, refer to “MaaXBoard Mini UUU Burning Guide”. 5.4 Verified Device List Unless otherwise specified, peripherals supported by this software, such as HDMI displays, Wi-Fi devices, etc., are compatible with common types of devices.
  • Page 36 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 SD:Raspberry Pi 16G, SanDisk Ultra 16G/64G Power Supply: Pisen TypeC, ZMI TypeC http://www.embest-tech.com...
  • Page 37 6.2 Warranty Conditions 12-month free warranty on the PCB under normal conditions of use since the sales of the product; The following conditions are not covered by free services; Avnet Manufacturing Services will charge accordingly: Customers fail to provide valid purchase vouchers or the product identification tag is damaged, unreadable, altered or inconsistent with the products;...
  • Page 38 Products purchased from unauthorized sales; Warranty (including verbal and written) that is not made by Avnet Manufacturing Services and not included in the scope of our warranty should be fulfilled by the party who committed. Avnet Manufacturing Services has no any responsibility.
  • Page 39 MaaXBoard-Mini-Linux-Yocto-Lite-UM-V1.1 Chapter 7 Contact Information Tel: +86-755-33190846/33190847/33190848 E-mail: Technical support: support@embest-tech.com Sales contact: globalsales@embest-tech.com Fax: +86-755-25616057 Website: http://www.embest-tech.com/ Address: Tower B 4/F, Shanshui Building, Nanshan Yungu Innovation Industry Park, Liuxian Ave.No.4093,Nanshan District, Shenzhen, Guangdong, China http://www.embest-tech.com...

Table of Contents