VIA Technologies ARTiGO A630 User manual

DEVELOPMENT GUIDE
ARTiGO A630
Linux EVK v1.0.1
1.00-08292017-093200

Copyright
Copyright ©2017 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.

Version Date Remarks
1.00 08/29/2017 Inial release.
Revision History
iii

ARTiGO-A630 Linux EVK v1.0.1 Quick Start Guide
Table of Content
1. Introducon....................................................................................................................... 1
1.1 BSP Package Content ............................................................................................................................ 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 .................................................................................................................... 1
1.2 VersionInformaonandSupportedFeatures ...................................................................................... 2
2. BuildEnvironmentSetup .................................................................................................. 3
2.1 ConguringLinuxHostMachine.......................................................................................................... 3
3. Image Build ....................................................................................................................... 4
3.1 ExtracngtheARTIGOA630BSP.......................................................................................................... 4
3.2 BuildingtheU-BootBinary................................................................................................................... 4
3.3 BuildingtheLinuxKernel...................................................................................................................... 5
iv

ARTiGO A630 Linux BSP v1.0.1 Development Guide
1
1. Introducon
ThisDevelopmentGuideexplainshowtobuildtheDebiansystemimagefortheARTIGOA630systeminorder
tobeginevaluangtheplaorm.
TheARTiGOA630LinuxBSPv1.0.1isdevelopedbasedonthedebian-8.6.0-lxde-player(Debian8.6)andit
enableshardwarefeaturesthataredenedontheARTiGOA630system.
1.1 BSP Package Content
Therearefourfoldersinthepackageaslistedbelow.
1.1.1 Source Code Folder Contents
ARTiGO_A630_Linux_source_code.zip:AcompleteandstacDebianBSPincludingtheARTiGOA630meta-
lesandallthepre-downloadedrequiredsowarepackagestoenableacompleteoinebuild.
1.1.2 Firmware Folder Contents
ARTiGO_A630_Linux_EVK_v1.0.1.zip:containsinstallaonscriptlesandtheprecompiledU-bootandimage
forevaluangtheARTiGOA630system.
1.1.3 Document Folder Contents
ARTiGO_A630_Linux_BSP_v1.0.1_ Development_Guide_v1.00_20170829.pdf:TheQuickStartGuideprovides
anoverviewonhowtoboottheLinuxEVKsystemimageontheARTiGOA630andcongurethesupported
hardwarefunconsinthebuild.
ARTiGO_A630_Linux_EVK_v1.0.1_ Quick_Start_Guide_v1.00_20170829.pdf:ThisDevelopmentGuide
explainshowtobuildtheDebiansystemimageontheARTiGOA630systeminordertobeginevaluangthe
plaorm.
1.1.4 Tools Folder Contents
arm_201103_gcc4.5.2.tgz:isatoolchain,whichisasetofsowaredevelopmenttoolsforbuildingimagesfor
theARTiGOA630system.
Source code folder Descripon
ARTiGO_A630_Linux_source_code.zip KernelsourcecodeandU-Bootsourcecode
Firmware folder Descripon
ARTiGO_A630_Linux_EVK_v1.0.1.zip DebianEVKsystemimageandinstallaon
scriptles
Document folder Descripon
ARTiGO_A630_Linux_BSP_v1.0.1_Development_
Guide_v1.00_20170829.pdf
Developmentguide
ARTiGO_A630_Linux_EVK_v1.0.1_Quick_Start_
Guide_v1.00_20170829.pdf
Quick Start Guide
Tools folder Descripon
arm_201103_gcc4.5.2.tgz Toolchain

ARTiGO A630 Linux BSP v1.0.1 Development Guide
2
1.2 VersionInformaonandSupportedFeatures
• U-Bootversion:1.1.4
• Kernel version: 3.4.5
• Evaluaonimage:Debian8.6
• DevelopmentbasedonWM8980
• SupportsSPIwitheMMCboot
• SupportsHDMIdisplay
• SupportsHDMIaudiooutput
• SupportsMicroUSB2.0OTGport
• SupportsDebugUARTconnector
• Supports10/100MbpsEthernet
• SupportsLine-outandMic-in
• SupportsEMIO-5531USBWi-Fi&Bluetoothmodule
ºSupportsBluetoothA2DPandSPPprole
• SupportsEMIO-2531miniPCIeWi-Fi&Bluetoothmodule
ºSupportsBluetoothA2DPandSPPprole
• SupportsEMIO-2550miniPCIeMobileBroadbandmodule
• SupportsGPIO,UARTandWatchdogmer

ARTiGO A630 Linux BSP v1.0.1 Development Guide
3
2. BuildEnvironmentSetup
Thisseconguidesyouthroughsengupthebuildenvironmentfordevelopmentonthehostmachine.All
instruconsarebasedonUbuntu14.04LTSx64.
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Linuxdevelopmentenvironment.Therequiredpackagescanbe
installedusingthecommandsbelow.
Extractthe arm_201103_gcc4.5.2.tgz leto/usr/local/arm/(Ifthisfolderdoesnotexistinthesystem,please
createitmanually).
Thecrosscompilerwillbefoundinthe/usr/local/arm/arm_201103_gcc4.5.2/directory.
Addthetoolchainpathin ~/.bashrcle.
Makesurethatthehostmachineisconnectedtothenetworkandrunthepackagesupdate.
Installtherequiredsowarepackagesforcross-compilaon.
$ sudo tar –xzvf arm_201103_gcc4.5.2.tar.gz -C /usr/local/arm/
$ vi ~/.bashrc
export PATH=/usr/local/arm/arm_201103_gcc4.5.2/mybin/:$PATH
$ sudo apt-get update
$ sudo apt-get install git-core gnupg ex bison gperf build-essential \
zip curl zlib1g-dev libc6-dev lib32ncurses5-dev lib32z1 lib32ncurses5 lib32bz2-1.0 \
x11proto-core-dev libx11-dev libgl1-mesa-dev g++-multilib mingw32 tofrodos \
python-markdown libxml2-utils u-boot-tools

ARTiGO A630 Linux BSP v1.0.1 Development Guide
4
3. Image Build
ThisseconexplainshowtobuildU-BootandKernelbinaryfortheARTiGOA630system.
3.1 ExtracngtheARTiGOA630BSP
TheARTiGO_A630_Linux_source_code.zipincludesu-boot-1.1.4.tar.gzandKernel_3.4.5.tar.gz.
UsethefollowingcommandtoextractthecontentsoftheBSP.
3.2 BuildingtheU-BootBinary
ThissecondescribeshowtobuildtheU-Bootimagefromthesourcecode.
UsethefollowingcommandtoextracttheU-Bootsourcecode.
Inordertousethedefaultconguraonstypethefollowingcommand.
TobuildtheU-bootimagewiththeARMcrosscompiler.
Whentheprocessiscompleted,thezuboot.binlewillbestoredintheu-boot-1.1.4directory.
$ unzip ARTiGO_A630_Linux_source_code.zip
$ tar -xzvf u-boot-1.1.4.tar.gz
$ cd /u-boot-1.1.4
$ make wmt_cong
$ make -j8 zuboot

ARTiGO A630 Linux BSP v1.0.1 Development Guide
5
3.3 BuildingtheLinuxKernel
Thissecondescribeshowtobuildthekernelbinaryfromthesourcecode.
Tobegin,extractthekernelsourcecode.
Tousethedefaultconguraonandcompilethekerneltypethefollowingcommand:
Whenthecompilaonprocessiscompleted,theuzImage.binlewillbestoredintheKernel_3.4.5directory.
Aerthecompilaon,the/u-boot-1.1.4/and/Kernel_3.4.5/directorywillcontaintheresulngbinaryles,as
showninthetablebelow.
Binary les generated
InordertoinstalltheLinuxsystemontheARTiGOA630system,pleasefollowthecommandsbelowonhowto
copythebinarylesintotheARTiGO_A630_Linux_EVK_V1.0.1folder.
First,changetheselenamesfromzuboot.bintou-boot.bin.
Next,extractthepackagefromtheARTiGO_A630_Linux_EVK_V1.0.1.zip,andthencopyu-boot.binand
uzImage.binlesintotheARTiGO_A630_Linux_EVK_V1.0.1folder.
$ tar -xzvf Kernel_3.4.5.tar.gz
$ cd /Kernel_3.4.5
$ make vab630_linux_defcong
$ make clean
$ make -j8 ubin
Binary les Descripon
zuboot.bin U-Bootbootloader
uzImage.bin Kernel for ARTiGO A630
$ cd /u-boot-1.1.4
$ mv zuboot.bin u-boot.bin
$ cd /u-boot-1.1.4
$ cp –f u-boot.bin ARTiGO_A630_Linux_EVK_v1.0.1/bspinst/u-boot.bin
$ cd /Kernel_3.4.5
$ cp –f boot.img ARTiGO_A630_Linux_EVK_v1.0.1/bspinst/uzImage.bin

1F, 531 Zhong-zheng Road,
Xindian Dist., New Taipei City 231
Taiwan
Tel: [phone]
Fax: [phone]
Email: [email protected]om.tw
940 Mission Court
Fremont, CA 94539,
USA
Tel: [phone]
Fax: [phone]
Email: [e-mail]
Email: [e-mail]
Taiwan Headquarters
USA
Europe
Tsinghua Science Park Bldg. 7
No. 1 Zongguancun East Road,
Haidian Dist., Beijing, 100084
China
Tel: [phone]
Fax: [phone]
Email: [e-mail]
3-15-7 Ebisu MT Bldg. 6F,
Higashi, Shibuya-ku
Tokyo 150-0011
Japan
Tel: [phone]
Fax: [phone]
Email: [e-mail]
China
Japan