Via technologies Artigo a3000 User manual

QUICK START GUIDE

VIA ARTiGO A3000

Yocto 3.1 EVK

1.00-07092023

No part of this document may be reproduced, transmied, transcribed, stored in a retrieval system, or translated into any language, in any

form or by any means, electronic, mechanical, magnec, opcal, chemical, manual or otherwise without the prior wrien permission of

VIA Technologies, Incorporated.

Trademarks

All brands, product names, company names, trademarks and service marks are the property of their respecve holders.

Disclaimer

VIA Technologies makes no warranes, implied or otherwise, in regard to this document and to the products described in this document.

The informaon provided in this document is believed to be accurate and reliable as of the publicaon date of this document. However,

VIA Technologies assumes no responsibility for the use or misuse of the informaon (including use or connecon of extra device/

equipment/add-on card) in this document and for any patent infringements that may arise from the use of this document. The informaon

and product specicaons within this document are subject to change at any me, without noce and without obligaon to nofy any

person of such change.

VIA Technologies, Inc. reserves the right the make changes to the products described in this manual at any me without prior noce.

iii

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

Revision History

Version Date Remarks

1.00 07/09/2023 Inial release

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

Table of Contents

1. Introducon.................................................................................................................................................... 1

1.1 EVK Package Contents........................................................................................................................... 1

1.1.1 Firmware Folder Contents ............................................................................................................. 1

1.1.2 Document Folder Contents............................................................................................................ 1

1.1.3 Tool Folder Contents...................................................................................................................... 1

1.2 Version Informaon and Supported Features....................................................................................... 2

2. Image Installaon .......................................................................................................................................... 3

2.1 Installing with the Fastboot Mode........................................................................................................ 3

3. Hardware Funcons ....................................................................................................................................... 5

3.1 Enabling ADB Debugging ...................................................................................................................... 5

3.2 Changing the Kernel Debug Level ......................................................................................................... 5

3.3 Checking the BSP Version...................................................................................................................... 5

3.4 DVFS...................................................................................................................................................... 6

3.5 Video playback...................................................................................................................................... 6

3.6 Audio Output and Recording ................................................................................................................ 6

3.7 Wi-Fi...................................................................................................................................................... 7

3.8 Bluetooth .............................................................................................................................................. 8

3.9 MTK NeuroPilot AI APU Hardware Acceleraon ................................................................................... 9

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

1. Introducon

This Quick Start Guide provides an overview of how to boot the Yocto image for the VIA ARTiGO A3000 and

congure the supported hardware funcons in the build.

The VIA ARTiGO A3000 Yocto 3.1 EVK is developed based on the MediaTek Yocto 3.1 BSP, and it enables the

hardware features of the VIA ARTiGO A3000.

1.1 EVK Package Contents

There are three folders in the package listed as below.

Firmware folder Descripon

VIA_ARTiGO_A3000_Yocto_3.1_EVK.zip Yocto evaluaon image

Document folder Descripon

VIA_ARTiGO_A3000_Yocto_3.1_EVK_Quick_Start_Guide.pdf Quick Start Guide

Tool folder Descripon

VIA_Android_USB_Driver.zip VIA USB driver

np3.0.tgz A sample test program

1.1.1 Firmware Folder Contents

VIA_ARTiGO_A3000_Yocto_3.1_EVK.zip: Contains the precompiled Yocto image for evaluang the VIA ARTiGO

A3000.

1.1.2 Document Folder Contents

VIA_ARTiGO_A3000_Yocto_3.1_EVK_Quick_Start_Guide.pdf: This Quick Start Guide provides an overview on

how to boot the Yocto image for the VIA ARTiGO A3000 and congure the supported hardware funcons in the

build.

1.1.3 Tool Folder Contents

VIA_Android_USB_Driver.zip: The VIA driver for ADB-over-USB.

np3.0.tgz: A sample program to test MTK NeuroPilot AI APU hardware acceleraon..

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

1.2 Version Informaon and Supported Features

• Kernel version: 4.14.87

• Evaluaon image: Yocto 3.1

• Development based on MediaTek Yocto 3.1 BSP

• Supports eMMC boot

• Supports HDMI display

• Supports HDMI audio output

• Supports COM port as RS-232 mode (TX/RX)

• Supports 10/100Mbps Ethernet port

• Supports MediaTek MT6357 Line-out and Mic-in

• Supports MediaTek MT6631 Wi-Fi 802.11ac and Bluetooth 5.0

• Supports VIA EMIO-2573 (EC25) 4G LTE mobile broadband miniPCIe module

• Supports MediaTek NeuroPilot AI APU hardware acceleraon

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

2. Image Installaon

This secon explains the setup procedures for boong from the eMMC.

The precompiled images are provided in the "Firmware" folder.

2.1 Installing with the Fastboot Mode

Follow the steps below to install Yocto EVK image:

Step 1

Prepare the "fastboot tool" and install the "VIA USB driver" into your Windows 10 host machine.

To get the "fastboot tool" for Windows, please refer to the "SDK Plaorm Tools release notes" chapter on the

Android developer website hps://developer.android.com/studio/releases/plaorm-tools.

To install the "VIA USB driver", right-click "android_winusb" and select "Install".

Then click "Install" when the installer opens.

When the installer nishes, it will show a conrmaon message "The operaon completed successfully".

Step 2

Connect the Windows 10 host machine and the VIA ARTiGO A3000 through the Micro USB 2.0 port using the

Micro USB cable.

Micro USB 2.0 OTG

Micro USB 2.0 port diagram

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

Step 3

Plug in the AC-to-DC power adapter to power on the VIA ARTiGO A3000.

If the EVK image is not installed, the VIA ARTiGO A3000 will stop at "fastboot: processing commands" as shown

in the debug console below. Proceed to step 4 directly.

Fastboot Mode

If the EVK image is already installed, use the following command to enter the Fastboot Mode on your Windows

10 host machine.

D:\platform-tools>adb shell reboot bootloader

Note:

Make sure the Windows 10 host machine detects the VIA ARTiGO A3000 as an ADB device.

Step 4

Extract the VIA_ARTiGO_A3000_Yocto_3.1_EVK.zip les on your Windows 10 host machine.

To install the image, use the following command:

D:\VIA_ARTiGO_A3000_Yocto_3.1_EVK>set PATH=D:\platform-tools;%PATH%

D:\VIA_ARTiGO_A3000_Yocto_3.1_EVK>viaash.exe --yocto

VIA: Operating system is Yocto

VIA: erasing preloader partition

VIA: installing bl2.img

VIA: installing MBR_EMMC

VIA: installing tee.img

VIA: erasing tee_b partition

VIA: installing boot.img

VIA: erasing boot_b partition

VIA: installing system.img

VIA: erasing system_b partition

VIA: installing userdata.ext4

VIA: rebooting target system

D:\VIA_ARTiGO_A3000_Yocto_3.1_EVK>

Step 5

Unplug the AC-to-DC power adapter to power o the VIA ARTiGO A3000.

Step 6

Unplug the Micro USB cable, press the Power Buon for 2 seconds, then release it to power on the VIA ARTiGO

A3000.

When the boot process has completed, you will see the Yocto 3.1 desktop.

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

3. Hardware Funcons

This secon explains how to enable and test the hardware funcons precompiled in the Yocto 3.1 EVK.

3.1 Enabling ADB Debugging

Follow the steps below to enable ADB debugging:

Step 1

Connect the Windows 10 host machine and the VIA ARTiGO A3000 through the Micro USB 2.0 port using the

Micro USB cable.

Micro USB 2.0 OTG

Micro USB 2.0 port diagram

Step 2

Power on the VIA ARTiGO A3000 to iniate the boot process.

Step 3

When the VIA ARTiGO A3000 has completed boong, use the following command to open ADB debugging.

E:\platform-tools>adb shell

3.2 Changing the Kernel Debug Level

To disable the kernel messages, modify the debug level using the following command:

root@aiv8365m1v1-aiot-emmc:~# echo 3 > /proc/sys/kernel/printk

3.3 Checking the BSP Version

To check the BSP version, use the following command:

root@aiv8365m1v1-aiot-emmc:~# cat /proc/version

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

3.4 DVFS

To verify the DVFS (Dynamic Voltage Frequency Scaling) funcon and list all the supported features, use the

following commands:

root@aiv8365m1v1-aiot-emmc:~# ls -al /sys/devices/system/cpu/cpu0/cpufreq/

total 0

drwxr-xr-x 4 root root 0 Aug 26 11:15 .

drwxr-xr-x 3 root root 0 Aug 26 11:15 ..

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 affected_cpus

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 cpuinfo_cur_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 cpuinfo_max_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 cpuinfo_min_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 cpuinfo_transition_latency

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 related_cpus

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_available_frequencies

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_available_governors

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_cur_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_driver

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_governor

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_max_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_min_freq

-rwxr-xr-x 1 root root 4096 Aug 26 11:15 scaling_setspeed

drwxr-xr-x 2 root root 0 Aug 26 11:15 schedutil

drwxr-xr-x 2 root root 0 Aug 26 11:15 stats

To check the supported and current CPU frequency, use the following commands:

:~# cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_available_frequencies

850000 918000 987000 1056000 1125000 1216000 1308000 1400000 1466000 1533000 1633000 1700000

1767000 1834000 1917000 2001000

:~# cat /sys/devices/system/cpu/cpu0/cpufreq/cpuinfo_cur_freq

1308000

3.5 Video playback

The VIA ARTiGO A3000 supports H.265 and H.264 video decoding up to 1080p@60fps/40Mbps.

To playback video, use the following command:

root@aiv8365m1v1-aiot-emmc:~# gst-launch-1.0 -q playbin uri=le:/data/sda1/test.

mp4 ags=0x42 video-sink="mtkmdp width=640 height=480 ! video/x-raw,format=I420 !

mtkwaylandsink" audio-sink="autoaudiosink"

3.6 Audio Output and Recording

To set up the HDMI audio output, use the following command:

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='O00 I05 Switch' 1

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='O01 I06 Switch' 1

root@aiv8365m1v1-aiot-emmc:~# aplay /data/sda1/test.wav

To disable the HDMI audio output, use the following command:

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='O00 I05 Switch' 0

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='O01 I06 Switch' 0

To set up the headphone and the speaker audio output, use the following command:

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='Audio_Amp_R_Switch' 1

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='Audio_Amp_L_Switch' 1

root@aiv8365m1v1-aiot-emmc:~# aplay /data/sda1/test.wav

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

To disable the headphone and the speaker audio output, use the following command:

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='Audio_Amp_R_Switch' 0

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='Audio_Amp_L_Switch' 0

Note:

Before changing to dierent audio output device, make sure the previous audio output device is disabled.

To change the audio volume, use the following command:

root@aiv8365m1v1-aiot-emmc:~# amixer -c0 cset name='Headset_PGAR_GAIN' 30

numid=35,iface=MIXER,name='Headset_PGAR_GAIN'

; type=ENUMERATED,access=rw------,values=1,items=32

; Item #0 '8Db'

; Item #1 '7Db'

; Item #2 '6Db'

; Item #3 '5Db'

; Item #4 '4Db'

; Item #5 '3Db'

; Item #6 '2Db'

; Item #7 '1Db'

; Item #8 '0Db'

; Item #9 '-1Db'

; Item #10 '-2Db'

; Item #11 '-3Db'

; Item #12 '-4Db'

; Item #13 '-5Db'

; Item #14 '-6Db'

; Item #15 '-7Db'

; Item #16 '-8Db'

; Item #17 '-9Db'

; Item #18 '-10Db'

; Item #19 '-11Db'

; Item #20 '-12Db'

; Item #21 '-13Db'

; Item #22 '-14Db'

; Item #23 '-15Db'

; Item #24 '-16Db'

; Item #25 '-17Db'

; Item #26 '-18Db'

; Item #27 '-19Db'

; Item #28 '-20Db'

; Item #29 '-21Db'

; Item #30 '-22Db'

; Item #31 '-40Db'

: values=30

root@aiv8365m1v1-aiot-emmc:~#

To set up the Mic-in audio recording, use the following command:

root@aiv8365m1v1-aiot-emmc:~# setup_mic

root@aiv8365m1v1-aiot-emmc:~# arecord -D hw:0,3 -f S16_LE -r 16000 /data/sda1/t1.wav

3.7 Wi-Fi

To verify the Wi-Fi funcon, use the following command:

root@aiv8365m1v1-aiot-emmc:~# wpa_cli -i wlan0 -p /tmp/wpa_supplicant add_network

root@aiv8365m1v1-aiot-emmc:~# wpa_cli -i wlan0 -p /tmp/wpa_supplicant set_network 0 ssid

'"via_test"'

root@aiv8365m1v1-aiot-emmc:~# wpa_cli -i wlan0 -p /tmp/wpa_supplicant set_network 0 psk

'"12345678"'

root@aiv8365m1v1-aiot-emmc:~# wpa_cli -i wlan0 -p /tmp/wpa_supplicant set_network 0 key_mgmt

WPA-PSK

root@aiv8365m1v1-aiot-emmc:~# wpa_cli -i wlan0 -p /tmp/wpa_supplicant select_network 0

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

Note:

Change the Wi-Fi AP "ssid" and "psk" to the desired values. "ssid" is "via_test" and "psk" is "12345678" in this

example.

To verify that the Wi-Fi connecon works, enable the interface with the following command:

root@aiv8365m1v1-aiot-emmc:~# udhcpc -b -i wlan0

udhcpc: started, v1.31.1

udhcpc: sending discover

udhcpc: sending select for 192.168.0.100

udhcpc: lease of 192.168.0.100 obtained, lease time 3600

/etc/udhcpc.d/50default: Adding DNS 8.8.8.8

Then use the "ping" command to verify the network connecon:

root@aiv8365m1v1-aiot-emmc:~# ping 8.8.8.8

3.8 Bluetooth

To enter "interacve mode" for Bluetooth funcon vericaon, use the following commands:

root@aiv8365m1v1-aiot-emmc:~# btmw-rpc-test

increase the priority of btmw_rpc_test.i4_ret:0 @ main

set btmw_rpc_test priority done

[Client]Func:main Line:665--->: IPC/RPC initialize

YZ rpc_init is called

...

<I> [BTMW_RPC_TEST] init ok Normal Mode

<I> [BTMW_RPC_TEST] running.

btmw_test_cli>

For the example below, use a Bluetooth speaker to test.

First, get the Bluetooth speaker MAC address, which is "41:42:FC:81:75:7F" in this example.

To verify the Bluetooth funcon, use the following commands (using the speaker's MAC address in line 4 and

line 5):

btmw_test_cli> MW_RPC_GAP power 1

...

btmw_test_cli> MW_RPC_GAP set_conn_disc 1 1

...

btmw_test_cli> MW_RPC_GAP name mtk350

...

btmw_test_cli> MW_RPC_GAP pair 41:42:FC:81:75:7F 1

...

btmw_test_cli> MW_RPC_A2DP_SRC connect 41:42:FC:81:75:7F

...

btmw_test_cli> MW_RPC_A2DP_SRC write_stream /data/sda1/test.wav

...

btmw_test_cli>

VIA ARTiGO A3000 Yocto 3.1 EVK Quick Start Guide

3.9 MTK NeuroPilot AI APU Hardware Acceleraon

We recommend running the "quant_mobilenet_v1_224_model.lite" program included in the "np3.0.tgz"

package for tesng MTK NeuroPilot AI APU hardware acceleraon. To install the program, follow the steps

below:

1. Copy the "np3.0.tgz" package to a USB drive and connect the USB drive to the VIA ARTiGO A3000

system.

2. Next, extract the "np3.0.tgz" package and run the "quant_mobilenet_v1_224_model.lite" program

using the following commands:

root@aiv8365m1v1-aiot-emmc:~# cp /data/sda1/np3.0.tgz .

root@aiv8365m1v1-aiot-emmc:~# tar zxvf np3.0.tgz

root@aiv8365m1v1-aiot-emmc:~# ncc-tite --arch=vpu -e ./quant_mobilenet_v1_224_model.tite

-c 11 --use-random-inputs | grep 'Inference time'