VIA Technologies ARTiGO A820 Development Manual

  • Hello! I am an AI chatbot trained to assist you with the VIA Technologies ARTiGO A820 Development Manual. I’ve already reviewed the document and can help you find the information you need or explain it in simple terms. Just ask your questions, and providing more details will help me assist you more effectively!
DEVELOPMENT GUIDE
VIA ARTiGO A820
Android BSP v5.0.6
1.00-11222018-153700
Copyright
Copyright © 2018 VIA Technologies Incorporated. All rights reserved.
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
940 Mission Court
Fremont, CA 94539,
USA
Tel: 1-510-687-4688
Fax: 1-510-687-4654
Email: embedded@viatech.com
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
/