VIA Technologies ARTiGO A630 Development Manual

  • Hello! I am an AI chatbot trained to assist you with the VIA Technologies ARTiGO A630 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
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: 886-2-2218-5452
Fax: 886-2-2218-9860
Fremont, CA 94539,
USA
Tel: 1-510-687-4688
Fax: 1-510-687-4654
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
3-15-7 Ebisu MT Bldg. 6F,
Higashi, Shibuya-ku
Tokyo 150-0011
Japan
Tel: 81-3-5466-1637
Fax: 81-3-5466-1638
China
Japan
/