Advertisement

Quick Links

MaaXBoard Nano
Yocto Lite User Manual
V1.0

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Avnet MaaXBoard Nano

  • Page 1 MaaXBoard Nano Yocto Lite User Manual V1.0...
  • Page 2 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Copyright Statement: The MaaXBoard Nano 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-Nano-Linux-Yocto-Lite-UM-V1.0 Revision History Rev. Description Author Date V1.0 Initial version Sandy 20201028 http://www.embest-tech.com...
  • Page 4: Table Of Contents

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Catalog Chapter 1 Introduction ..........................7 Package Content ........................7 Feature List ..........................8 Chapter 2 Quick Start ..........................9 Boot from eMMC ........................9 Boot from SD Card ........................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-Nano-Linux-Yocto-Lite-UM-V1.0 3.7.4 Record Video ......................... 24 Gigabit Ethernet Interface ......................24 3.8.1 Network Test ........................24 3.8.2 Set Static IP........................24 Storage ............................. 25 3.9.1 SD Card ......................... 25 3.9.2 eMMC ..........................25 3.9.3 Flash ..........................25 3.10 USB 2.0 Interface ........................26 3.10.1 USB Host ........................
  • Page 6 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Software ........................... 34 Verified Device List........................34 Chapter 6 Technical Support and Warranty ..................35 Technical Support ........................35 Warranty Conditions ........................ 35 Chapter 7 Contact Information ......................37 http://www.embest-tech.com...
  • Page 7: Chapter 1 Introduction

    │ └─03LinuxTools │ MaaXBoard-Nano-LinuxTools-Vxx.rar 01Doc Description MaaXBoard-Nano-Linux-Yocto-Lite-ReleaseNote-Vxx.pdf Release Note MaaXBoard-Nano-Linux-Yocto-Lite-UserManual-Vxx.pdf User Manual MaaXBoard-Nano-Linux-Yocto-Lite-DevelopmentGuide-Vxx.pdf Development Guide 01LinuxSourceCode Description MaaXBoard Nano Linux Yocto source code MaaXBoard-Nano-LinuxSourceCode-Yocto-Lite-Vxx.rar package 02LinuxShipmentImage Description Yocto image with firmware, system image lite-image-maaxboard-nano-ddr4-1g-sdcard-*.rootfs.wic file 03LinuxTools Description Other tools http://www.embest-tech.com...
  • Page 8: Feature List

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 1.2 Feature List Yocto version: zeus (3.0.4), 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 Nano Micro SD boot eMMC boot 1 Gigabit Ethernet (RJ45) 4 x USB 2.0 Host 2 UART (TTL) include debug port External interfaces(I2C, UART,SPI and GPIO)
  • Page 9: Chapter 2 Quick Start

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Chapter 2 Quick Start MaaXBoard Nano has burned the system image to eMMC by default, so we can boot from eMMC directly. If you need to use the latest system image, refer to Chapter 4 Burn or update the system Image.
  • Page 10: Boot From Sd Card

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Users could also connect keyboard and mouse to MaaXBoard Nano to login Yocto system. 2.2 Boot from SD Card The boot process is almost the same with boot from SD card, but you need to execute the following 2 operations before power on the board: Insert the SD card into the card slot J10.
  • 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 Nano. When the system boot up, it will run the Weston Wayland Desktop Environment directly, click Wayland Terminal to operate the board. 2.3.2 Login from Debug Serial Install the Serial Communication software (e.g.
  • Page 12: Login From Ssh

    In this example, the IP of MaaXBoard is 192.168.2.108, enter following command in command line window to connect: root@192.168.2.108. Enter in the first connection, then enter password “avnet” to login, enter exit to logout. embest@compiler:~$ ssh root@192.168.2.108 The authenticity of host '192.168.2.108 (192.168.2.108)' can't be established.
  • Page 13 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 root@maaxboard-nano:~# To copy files using scp command, enter the following command and password: Copy file from computer to MaaXBoard: embest@compiler:~$ scp test.txt root@192.168.2.108:/root/1.txt Copy file from MaaXBoard to computer: embest@compiler:~$ scp root@192.168.2.108:/root/1.txt ./1.txt 2.3.3.3 PuTTY PuTTY support SSH, setting method as follows: 1.
  • Page 14 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 2. In Session, enter IP address, e.g. 192.168.2.108, port 22, and Connection type SSH, then click Open. 3. In the first connection, click Y in the popout window. http://www.embest-tech.com...
  • Page 15 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 4. Enter username as “root”, password as “avnet” to login, enter exit to logout. http://www.embest-tech.com...
  • Page 16: 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 Nano. Execute the following instructions in serial terminal to control them. Light out LED: root@maaxboard-nano:~# echo 0 | tee /sys/class/leds/usr_led/brightness...
  • Page 17 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 Properties: Testing ... (interrupt to exit) Event: time 1603702232.929224, type 1 (EV_KEY), code 256 (BTN_0), value 1 Event: time 1603702232.929224, -------------- SYN_REPORT ------------ Event: time 1603702233.205239, type 1 (EV_KEY), code 256 (BTN_0), value 0 Event: time 1603702233.205239, -------------- SYN_REPORT ------------ Press PWR button for 8s, system will enter suspend mode, press PWR again for 1s, the system will reboot.
  • Page 18: 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 Nano file system. Screen Type...
  • Page 19 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 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 Event code 48 (ABS_MT_TOUCH_MAJOR) Value Event code 53 (ABS_MT_POSITION_X) Value...
  • Page 20: Audio

    3.5.1.1 On-board Audio Output Interface The audio output interface J9 is the default audio output device of MaaXBoard Nano. Connect the audio device such as 3.5mm headset to J9 to use it. Use command aplay -l to check that the device id is 0, device name is cs4344audio.
  • Page 21: Record Audio

    3.5.1.3 USB Audio Device MaaXBoard Nano could support USB audio device (which do not need specified driver) to play audio. You can record and play audio from USB audio device. Use command arecord -l and aplay -l to check that the device id is 2.
  • Page 22: Play Audio File

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 You can also record audio from the on-board MIC and play it from on-board audio output interface, use the following command: here we use -c 2 because the audio output interface only support 2 channels. root@maaxboard-nano:~# arecord -f S16_LE -r 48000 -c 2 -Dhw:1 | aplay -Dhw:0 To adjust the volume of record audio, use the following command to open a GUI root@maaxboard-nano:~# alsamixer -c1 Use the Up-down-Left-Right button to adjust the volume of different channel, press Esc button to exit.
  • Page 23: Video

    Yocto system support play video file in mp4 format, the largest support resolution is 1080p, use the following command: root@maaxboard-nano:~# gst-play-1.0 embest.mp4 3.7 Camera MaaXBoard Nano 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-nano:~# ls /dev/video* /dev/video0 /dev/video1 In default, MIPI-CSI camera is /dev/video0, USB Camera is /dev/video1.
  • Page 24: Record Video

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 3.7.4 Record Video Use the following instruction to record a video in mp4 format and saved to specific location. root@maaxboard-nano:~# 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 25: Storage

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 uEnv.txt. After the modification, execute sync and reboot command to make it effect. root@maaxboard-nano:~# mkdir mount root@maaxboard-nano:~# mount /dev/mmcblk1p1 mount/ root@maaxboard-nano:~# nano mount/uEnv.txt For example: ethaddr=cb:3a:e1:44:62:2d 2. Set Static IP info: use nano command to modify /etc/dhcpcd.conf, add following info. interface eth0 static ip_address=192.168.2.100/24 static routers=192.168.2.1...
  • Page 26: Usb 2.0 Interface

    The storage node for U disk is /dev/sda1, uses could mount the storage device to the file system to read and write data. MaaXBoard Nano also supports other USB device such as key board, mouse, Camera, etc. 3.11 Wi-Fi The on-board Wi-Fi module support 2.4G/5G network.
  • Page 27 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 root@maaxboard-nano:~# iwlist mlan0 scan essid Embest_WiFi wlan: SCAN COMPLETED: scanned AP count=5 mlan0 Scan completed : Cell 01 - Address: 80:81:00:56:2F:88 ESSID:"Embest_WiFi" Mode:Master Frequency=2.437 GHz (Channel 6) Quality:3/5 Signal level:-66 dBm Noise level:-96 dBm Encryption key:on Bit Rates:1 Mb/s; 2 Mb/s; 5.5 Mb/s; 11 Mb/s; 6 Mb/s 9 Mb/s;...
  • Page 28: Auto Connect Wi-Fi

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 IPv6: ADDRCONF(NETDEV_CHANGE): mlan0: link becomes ready Test Wi-Fi network with ping command: root@maaxboard-nano:~# ping www.baidu.com -I mlan0 PING www.a.shifen.com (103.235.46.39) 56(84) bytes of data. 64 bytes from 103.235.46.39: icmp_seq=1 ttl=50 time=122 ms Auto Connect Wi-Fi Network 3.11.3 Auto Connect Wi-Fi To connect Wi-Fi after reboot automatically, use the following method: Prepare config file: mkdir -p /etc/wpa_supplicant...
  • Page 29: Send Files

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 [bluetooth]# pair E8:EC:A3:21:57:6C [bluetooth]# trust E8:EC:A3:21:57:6C [bluetooth]# connect E8:EC:A3:21:57:6C Exit bluetoothctl. [Mi Sports BT Earphones Basic]# quit In above instructions, E8:EC:A3:21:57:6C is the address of the Bluetooth device, change it according to your device. 3.12.2 Send Files Run the OBEXD daemon and connect to the target Bluetooth device root@maaxboard-nano:~# export $(dbus-launch) root@maaxboard-nano:~# /usr/libexec/bluetooth/obexd -r /home/root -a -d &...
  • Page 30: Uart

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 3.13 UART MaaXBoard Nano supports 2 UART interface. MaaXBoard Nano (CPU) Interface Type UART2 UART TTL (Debug Interface) UART4 UART TTL 3.13.1 UART 4 In the Yocto system, the node for UART4 is /dev/ttymxc3. Users could also write their own applications to control the uart.
  • Page 31 MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 GPIO5_IO3 GPIO/PWM2 GPIO4_IO31 GPIO/PCM_FS GPIO GPIO2_IO11 GPIO2_IO9 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 130. 2. Set the function of Pin11 to be GPIO output. root@maaxboard-nano:~# echo 130 >/sys/class/gpio/export root@maaxboard-nano:~# echo out >/sys/class/gpio/gpio130/direction 3.
  • Page 32: Chapter 4 Burn Or Update The System Image

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 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

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 4.2 Burn the System Image to SD Card under Linux OS In Ubuntu or Debian OS, you can use bmap-tool to burn the image to SD Card. Here we use lite-image-maaxboard-nano-ddr4-1g-sdcard-20201116084413.rootfs.wic as an example: Enter the following instructions in command line to check the SD Card ID, in this example is: sdc $ ls /dev/sd* /dev/sda /dev/sda2 /dev/sdb...
  • Page 34: Chapter 5 Appendix

    5.1 Hardware For the detail hardware introduction, please refer to MaaXBoard Nano Hardware user manual. 5.2 Software MaaXBoard Nano supports Linux Yocto system system, for the detail software introduction, please refer to related user manual. Linux MaaXBoard Nano Linux Software Release Note...
  • Page 35: Chapter 6 Technical Support And Warranty

    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 36 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 37: Chapter 7 Contact Information

    MaaXBoard-Nano-Linux-Yocto-Lite-UM-V1.0 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...

This manual is also suitable for:

Yocto lite

Table of Contents