ARC labs handbook

101 Pages·2017·8.3 MB·English

ARC labs handbook
Release 2018.09
Synopsys
2021

Contents:
1 Overview 1
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 SupportedHardwarePlatform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
2 GettingStarted 3
2.1 SoftwareRequirement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2 InstallSoftwareTools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.3 FinalCheck. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.4 LearnMore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
3 Hands-onlabs 9
3.1 Basiclabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.2 Advancedlabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
3.3 Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
4 Appendix 93
4.1 Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
5 Indicesandtables 95
i
ii
1
CHAPTER
Overview
1.1 Introduction
This is a handbook for ARC labs which is a part of ARC university courses. The handbook is written to help
studentswhoattendtheARCuniversitycourse. AnyoneinterestedinDesignWare®ARC®processorscanalso
take this handbook as a quick start-up to get started in DesignWare® ARC® processors development. In this
handbook,allthebasicelementsofARCaredescribedinthelabswithastep-by-stepapproach.
This handbook can be used as a Lab teaching material for ARC university courses at undergraduate or gradu-
ate level with majors in Computer Science, Computer Engineering, Electrical Engineering, or for professional
engineers.
Thishandbookincludesaseriesoflabs(morelabswillbeaddedinthefuture),whichareroughlyclassifiedinto
3levels:
• Level1: ARCbasic
The labs in this level cover the basic topics of DesignWare® ARC® processors. For example, the installation
andusageofhardwareandsoftwaretools,softwareorhardwaredevelopmentkits,thefirsthelloworldexample,
interrupthandlingandinternaltimersofDesignWare®ARC®processors,andsoon.
• Level2: ARCadvanced
The labs in this level cover the advanced topics of DesignWare® ARC® processors. For example, Real-Time
OperatingSystem(RTOS),customizedlinkage,compileroptimization,basicapplications,DesignWare®ARC®
processorsDSPfeature,andsoon.
• Level3: ARCexploration
ThelabsinthislevelcoversomecomplexapplicationsofDesignWare®ARC®processors. Forexample,Internet
ofThings(IoT)application,embeddedmachinelearning,andsoon.
MostofthelabsarebasedontheembARCOpenSoftwarePlatform(OSP)whichisanopensoftwareplatformto
facilitatethedevelopmentofembeddedsystemsbasedonDesignWare®ARC®processors.
ItisdesignedtoprovideaunifiedplatformforDesignWare®ARC®processorsusersbydefiningconsistentand
simple software interfaces to the processor and peripherals together with ports of several well known Free and
open-sourcesoftware(FOSS)embeddedsoftwarestackstoDesignWare®ARC®processors.
FormoredetailsaboutembARCOSP,pleaseseeitsonlinedocs.
1
ARClabshandbook,Release2018.09
1.2 Supported Hardware Platform
ThefollowingDesignWare®ARC®processorsbasedhardwareplatformsaresupportedinthishandbook.
• ARCEMStarterKit
• ARCIoTDevelopmentKit
Youcanclicktheabovelinkstogettheplatform’sdatasheetandusermanualasareference.
1.3 Reference
Item Name
1 ARCEMDatabook
2 MetaWaredocs
3 ARCEMStarterKitUserGuide
4 ARCGNUdocs
2 Chapter1. Overview
2
CHAPTER
Getting Started
UsethisguidetogetstartedwithyourARClabsdevelopment.
2.1 Software Requirement
• ARCDevelopmentTools SelectMetaWareDevelopmentToolkitorGNUToolchainforARCProcessors
fromthefollowinglistaccordingtoyourrequirement.
– MetaWareDevelopmentToolkit
* PremiumMetaWareDevelopmentToolkit(2018.06). TheDesignWareARCMetaWareDevelop-
mentToolkitbuildsupona25-yearlegacyofindustry-leadingcompileranddebuggerproducts.
It is a complete solution that contains all the components needed to support the development,
debugging,andtuningofembeddedapplicationsfortheDesignWareARCprocessors.
* DesignWare ARC MetaWare Toolkit Lite (2018.06). A demonstration or evaluation version of
theMetaWareDevelopmentToolkitisavailableforfreefromtheSynopsyswebsite. MetaWare
LiteisafunctioningdemonstrationoftheMetaWareDevelopmentToolkitwithrestrictionssuch
as code-size limit of 32 Kilobytes and no runtime library sources. It is available for Microsoft
Windowsonly.
– GNUToolchainforARCProcessors
* Open Source ARC GNU IDE (2018.03). The GNU Toolchain for ARC Processors offers all of
the benefits of open source tools such as complete source code and a large install base. The
ARCGNUIDEInstallerconsistsofEclipseIDEwithARCGNUpluginforEclipse,ARCGNU
prebuilttoolchain,andOpenOCDforARC.
• DigilentAdeptSoftwareforDigilentJTAG-USBcabledriver. Allthesupportedboardsareequippedwith
onboardUSB-JTAGdebugger. OneUSBcableisrequiredandexternaldebuggerisnotrequired.
• TeraTermorPuTTYforserialterminalconnection. Theserialconfigurationsare115200baud,8bitsdata,
1stopbit,andnoparity(115200-8-N-1)bydefault.
Note: If using embARC with GNU toolchain on Windows, please install Zadig to replace FTDI driver with
WinUSB driver. See How to Use OpenOCD on Windows for more information. If you want to switch back to
Metawaretoolchain,makesureyouswitchbacktheusb-jtagdriverfromWinUSBtoFTDIdriver.
3
ARClabshandbook,Release2018.09
2.2 Install Software Tools
2.2.1 Install MetaWare Development Toolkit
InstallingMetaWareDevelopmentToolkit(2017.09).
1. Doubleclickthemw_dekit_arc_i_2017_09_win_install.exeandclickNext.
2. SelectIacceptandclickNext.
3. SelectTypicalinstallationandclickNext.
4 Chapter2. GettingStarted
ARClabshandbook,Release2018.09
4. Settheinstallpath(makesureyouuseEnglishletterswithoutanyspace)andclickNextuntiltheinstallation
iscomplete.
5. Setthelicensefile(SNPSLMD_LICENSE_FILE)forMetaWareDevelopmentToolkit. Itcanbearealfile
containinglicenseoralicenseserver.
• ForWindows,gotoComputer>Properties>Advanced>EnvironmentVariables>SystemVariables
>New.
2.2. InstallSoftwareTools 5
ARClabshandbook,Release2018.09
• ForLinux,addSNPSLMD_LICENSE_FILEintoyoursystemvariables.
6. TesttheMetaWareDevelopmentToolkitandthelicense
Atthecommandprompt,compileandlinkinonestep.
Forexample,findthequeens.cinthedemosfolderofMetaWareDevelopmentToolkitinstallationdirectory.
# On Windows
cd C:\ARC\MetaWare\arc\demos
ccac queens.c
If you get the following message without any error, then the MetaWare Development Toolkit is successfully
installed.
MetaWare C Compiler N-2017.09 (build 005) Serial 1-799999.
(c) Copyright 1987-2017, Synopsys, Inc.
MetaWare ARC Assembler N-2017.09 (build 005)
(c) Copyright 1996-2017, Synopsys, Inc.
MetaWare Linker (ELF/ARCompact) N-2017.09 (build 005)
(c) Copyright 1995-2017, Synopsys, Inc.
2.2.2 Install GNU Toolchain for ARC Processors
Click (https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases) to get the latest version of
GNUToolchainforARCProcessors.
TouseandinstallGNUToolchainforARCProcessors,pleasesee(http://embarc.org/toolchain/ide/index.html).
ItisrecommendedtoinstallGNUToolchainforARCProcessorsinthepath(windows: C:\arc_gnu\,linux:
~/arc_gnu/)andaddarc_gnu/bininto$PATHvariable.
2.2.3 Install embARC OSP
The embARC OSP source code is hosted in a GitHub repository that supports cloning through git. There are
scriptsinthisrepothatyouareneedtosetupyourdevelopmentenvironment,andGitisusedtogetthisrepo. If
youdonothaveGitinstalled,seethebeginningoftheOS-specificinstructionsbelowforhelp.
UsingGittoclonetherepositoryanonymously
# On Windows
cd %userprofile%
# On Linux
cd ~
git clone https://github.com/foss-for-synopsys-dwc-arc-processors/embarc_osp.git
embarc_osp
˓→
Youhavesuccessfullycheckedoutacopyofthesourcecodetoyourlocalmachine.
2.2.4 Install ARC labs code
The source codes of ARC labs are assumed to work with embARC OSP. Please use git to clone or download
theARClabstotherootfolderofembARCOSP.Ifthedownloadissuccessful,thefollowingfolderstructureis
displayed:
cd path/to/embarc_osp
git clone https://github.com/foss-for-synopsys-dwc-arc-processors/arc_labs.git arc_
labs
˓→
6 Chapter2. GettingStarted