VIA Technologies ARTiGO A820 Development Manual

DEVELOPMENT GUIDE

VIA ARTiGO A820

Android BSP v5.0.6

1.00-11222018-153700

Copyright

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.

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

Version Date Remarks

1.00 11/22/2018 Inial release

Revision History

iii

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

Table of Contents

1. Introducon �� 1

1�1 BSP Package Contents �� 1

1�1�1 Source Code Folder Contents �� 1

1�1�2 Firmware Folder Contents �� 1

1�1�3 Document Folder Contents �� 1

1�1�4 Tools Folder Contents �� 2

1.2 VersionInformaonandSupportedFeatures �� 3

2. BuildEnvironmentSetup �� 4

2.1 ConguringLinuxHostMachine �� 4

3� Image Build �� 5

3.1 ExtracngtheVIAARTiGOA820BSP �� 5

3.2 DownloadingtheSourceCodeofAndroid6.0.1 �� 5

3.3 InstallingtheSourceCodePatch �� 5

3.4 BuildinganAndroidImage �� 5

iv

1

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

1� Introducon

ThisDevelopmentGuideexplainshowtosetupthenecessarybuildenvironmentinorderforuserstocustomize

theAndroidsourcecodeandcreatetheirownsystemimagefortheVIAARTiGOA820system.

TheVIAARTiGOA820AndroidBSPv5.0.6isdevelopedbasedontheNXPandroid_M6.0.1_1.0.0-ga(Android

6.0Marshmallow)andenableshardwarefeaturesthataredenedontheVIAARTiGOA820system.

1�1 BSP Package Contents

Therearefourfoldersinthepackageaslistedbelow.

VIA ARTiGO A820 Android BSP contents

1�1�1 Source Code Folder Contents

ARTiGO_A820_Android_ source_code_patch.zip: IncludesAndroid6.0.1sourcecodedownloadscriptles,

NXPAndroidpatchleandroid_M6.0.1_1.0.0-ga_core_source.tar.gz,theVIAARTiGOA820Androidsource

codepatchleandImagebuildingscriptles.

Smart_ETK_v1.0_SourceCode.zip:istheSmartETKdemoprogramsourcecode.

1�1�2 Firmware Folder Contents

Images_autoinstall_sd.zip:TheAndroidEVKsystemimageandinstallaonscriptles.

1�1�3 Document Folder Contents

ARTiGO_A820_Android_EVK_v5.0.6_Quick_Start_Guide _v1.00_20181122.pdf: TheQuickStartGuide

providesanoverviewofhowtoboottheAndroidEVKsystemimageontheVIAARTiGOA820systemand

congurethesupportedhardwarefunconsinthebuild.

ARTIGO_A820_Android_BSP_v5.0.6_Development_Guide _v1.00_20181122.pdf: TheDevelopmentGuide

explainshowtosetupthenecessarybuildenvironmentinorderforuserstocustomizetheAndroidsourcecode

andcreatetheirownsystemimagefortheVIAARTiGOA820system.

Source code folder Descripon

ARTiGO_A820_Android_source_code_patch.zip AndroidsourcecodepatchlesandImage

buildingscriptles

Smart_ETK_v1.0_SourceCode.zip SmartETKdemoprogramsourcecode

Firmware folder Descripon

Images_autoinstall_sd.zip AndroidEVKsystemimageandinstallaon

scriptles

Document folder Descripon

ARTiGO_A820_Android_EVK_v5.0.6_Quick_

Start_Guide_v1.00_20181122.pdf

QuickStartGuide

ARTiGO_A820_Android_BSP_v5.0.6_

Development_Guide_v1.00_20181122.pdf

DevelopmentGuide

Smart_ETK_SDK_Programming_Guide_v1.00_

20170811

SmartETKSDKProgrammingGuide

Tools folder Descripon

ARTiGO_A820_Smart_ETK_Demo_v1.0.apk SmartETKdemoprogram

BluetoothSPPTest.apk BluetoothSPPtesngprogram

2

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

Smart_ETK_SDK_Programming_Guide_v1 .00_20170811.pdf: TheProgrammingGuideexplainshowtobuild

theSmartETKprogramandintroducesafullyfunconalsetofAPIforthedierentVIAboardsorsystems.

1�1�4 Tools Folder Contents

ARTIGO_A820_Smart_ETK_Demo_v1.0.apk: istheSmartETKdemoprogram.

BluetoothSPPTest.apk:istheBluetoothSPPproletestprogram.

3

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

1�2 VersionInformaonandSupportedFeatures

• U-Bootversion:2015.04

• Kernelversion:3.14.52

• Evaluaonimage:AndroidMarshmallow6.0

• DevelopmentbasedonNXPandroid_M6.0.1_1.0.0-ga(Android6.0Marshmallow)

• SupportsSPIwitheMMCboot

• SupportsHDMIdisplay

• SupportsHDMIaudiooutput

• SupportsCOM1(RS-232/RS-485),onboardCOMdebugconnector

• SupportsGigabitEthernet(LAN1)

• Supports10/100MbpsEthernet(LAN2)

• SupportsVIAVNT9271USBWi-Fidongle

• SupportsVIAEMIO-1541miniPCIeWi-Fimodule

• SupportsVIAEMIO-2531miniPCIeWi-Fi&Bluetoothmodule

º SupportsBluetoothA2DPandSPPprole

• SupportsVIAEMIO-2550miniPCIeMobileBroadbandmodule

• SupportsSmartETKv1.0:WatchdogTimer,GPIO,andUART(RS-232/RS-485)

• SupportsOTA(Over-The-Airtechnology)

• SupportsshutdownoponinQuickSengs

• SupportsEthernetconguraoninSengs

4

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

2� BuildEnvironmentSetup

Thisseconguidesyouthroughsengupthebuildenvironmentfordevelopment.Allinstruconsarebased

onusingUbuntu14.04LTS(64-bit).

Tomakesurethatthebuildprocesscompletessuccessfully,werecommendatleast120GBofdiskspaceand

15GBofcombinedmemoryandswapspaceonthehostmachine.

2�1 ConguringLinuxHostMachine

ThefollowingpackagesarerequiredfortheAndroiddevelopmentenvironment.Therequiredpackagescanbe

installedusingthecommandsbelow.Togetmoreinformaon,pleasevisittheAndroidwebsiteat

hps://source.android.com/setup/build/inializing�

TheOpenJDK7isnotincludedintheUbuntu14.04defaultinstallaon.Therststepistoaddanewserver

manuallybyusingthefollowingcommands:

ToinstalltheOpenJDK7,usethefollowingcommands:

ThefollowingpackagesarerequiredfortheAndroiddevelopmentenvironment.Toinstalltherequired

packagesontheUbuntu14.04,usethefollowingcommand:

$ sudo apt-get install openjdk-7-jre

$ sudo apt-get install openjdk-7-jdk

$ sudo apt-get install git gnupg ex bison gperf build-essential zip curl zlib1g-dev libc6-

dev libncurses5-dev x11proto-core-dev libx11-dev:i386 libreadline6-dev:i386 libgl1-mesa-

glx:i386 libgl1-mesa-dev g++-multilib mingw32 tofrodos python-markdown libxml2-utils xsltproc

zlib1g-dev:i386 uuid-dev liblzo2-dev libz-dev libc6-dev-i386 lib32z1 gcc g++ lzop u-boot-tools

$ sudo add-apt-repository ppa:webupd8team/java

$ sudo apt-get update

5

VIA ARTiGO A820 Android BSP v5.0.6 Development Guide

3� Image Build

TheseconexplainshowtobuildtheU-BootbinaryandAndroidlesystemfortheVIAARTiGOA820system.

3�1 ExtracngtheVIAARTiGOA820BSP

UsethefollowingcommandtoextractthecontentsoftheBSP.

3�2 DownloadingtheSourceCodeofAndroid6.0.1

DownloadingtheAndroid6.0.1sourcecodetotheBSP/srcfoldercantakeseveralhoursdependingonyour

internetconnecon.

*Note: YouneedtosetupaGitaccountbeforedownloadingthesourcecode.

UsethefollowingcommandstodownloadthesourcecodeofAndroid6.0.1:

3�3 InstallingtheSourceCodePatch

UsethefollowingcommandtoinstalltheNXPandVIAARTiGOA820sourcecodepatch.

3�4 BuildinganAndroidImage

UsethefollowingcommandstobuildtheAndroidimage,thecompilingprocesswilltakeseveralhours.

Aerthecompilaon,the src/out/target/product/argo_a820_6dl/directorywillcontaintheresulng

binaries,asshowninthetablebelow.

Binary les generated

$ unzip ARTiGO_A820_Android_source_code_patch.zip

$ ./patch_fsl_via.sh

Binary Descripon

u-boot-a820-6dl.imx U-Bootbootloader

bspinst.img BSP auto install image

boot-a820-6dl.img Kernelimage

system�img Androidsystemimage

recovery-a820-6dl.img RecoveryimageforiMX6DL

$ git cong –-global user.email [email protected]

$ git cong –-global user.name “Your Name”

$ cd ARTIGO A820_Android_source_code_patch/Script

$ ./download_source_Android6.0.sh

$ cd ../src

$ source build/envsetup.sh

$ lunch artigo_a820_6dl-userdebug

$ make –j8

1F, 531 Zhong-zheng Road,

Xindian Dist., New Taipei City 231

Taiwan

Tel: 886-2-2218-5452

Fax: 886-2-2218-9860

Email: [email protected]

940 Mission Court

Fremont, CA 94539,

USA

Tel: 1-510-687-4688

Fax: 1-510-687-4654

Email: embedded@viatech.com

Email: [email protected]

Taiwan Headquarters USA

Europe

Tsinghua Science Park Bldg. 7

No. 1 Zongguancun East Road,

Haidian Dist., Beijing, 100084

China

Tel: 86-10-59852288

Fax: 86-10-59852299

Email: embedded@viatech.com.cn

3-15-7 Ebisu MT Bldg. 6F,

Higashi, Shibuya-ku

Tokyo 150-0011

Japan

Tel: 81-3-5466-1637

Fax: 81-3-5466-1638

Email: embedded@viatech.co.jp

China

Japan

VIA Technologies ARTiGO A820 Development Manual

VIA Technologies ARTiGO A820 Development Manual

Related papers

Other documents