Getting Started

Use this guide to get started with your embARC OSP development.

Checking Out the embARC OSP source code

The embARC OSP source code is hosted in a GitHub repository that supports cloning via git. There are scripts and such in this repo that you’ll need to set up your development environment, and we’ll be using Git to get this repo. If you don’t have Git installed, please refer to the beginning of the host OS-specific getting started instructions below for help.

We’ll begin by using Git to clone the repository anonymously.

# On Windows
cd %userprofile%
# On Linux
cd ~

git clone https://github.com/foss-for-synopsys-dwc-arc-processors/embarc_osp.git embarc_osp

You have successfully checked out a copy of the source code to your local machine.

If you are not familiar with git or git doesn’t work, you can also download the embARC OSP code through http. The latest release of embARC OSP is here.

Setting Up the Development Environment

The embARC OSP platform supports, but not limited to, the following development machine operating systems:

• Microsoft Windows 10 / Windows 7

• Ubuntu 16.04

Use the following procedure to create a new development environment. Please DO follow the instructions introduced in the document below in order to acquire third party middleware.

• Software Requirement

Note

The embARC OSP uses make/gmake as a build tool and these are provided as part of the ARC development tools.

Building a Sample Application

Using the blinky example, the following steps, which contains the commands used for the ARC GNU toolchain in a Windows environment, will describe how to build an embARC OSP application. Please use the appropriate commands for your OS.

1. Make sure the ARC GNU toolchain is installed in your environment, see Software Requirement.

2. Navigate to example_blinky example located at embARC OSP directory.

cd embarc_osp\example\baremetal\blinky

3. Build the example_blinky example for the EMSK 2.3 board and ARC EM11D.

make TOOLCHAIN=gnu BOARD=emsk BD_VER=23 CUR_CORE=arcem11d

Note

make for ARC GNU toolchain, gmake for MetaWare toolkit. For more details of commands, see Makefile Manual

Hardware Preparation

Use the following procedures to prepare your ARC board to run/debug the embARC applications.

• Getting started with EM starter kit

• Getting started with HS development kit

• Getting started with IoT Development kit

• Getting started with ARC EM Software Development Platform

See the following procedures to check peripherals and board settings. The peripherals are not required for all the embARC OSP examples.

• Hardware Requirement
• Peripheral Preparation

Running a Sample Application

Follow these steps to run the sample application.

1. Make sure the blinky example has been built successfully in Building a Sample Application. Get the .elf file blinky_gnu_arcem11d.elf in <blinky>\obj_emsk_23\gnu_arcem11d.

2. Follow to steps in Programming and Debugging to set and connect EMSK 2.3 with EM11D to your local machine.

3. Navigate to the embARC OSP directory and run example_blinky example.

cd embarc_osp\example\baremetal\blinky
make TOOLCHAIN=gnu BOARD=emsk BD_VER=23 CUR_CORE=arcem11d run

Note

No peripheral modules are required to run the blinky example. If there are LEDs on boards, these LED will be used to blink; If there are no LEDs on boards, a blink message will be output in the UART.

See the following manual for information on make/gmake command and embARC makefile system.

• Makefile Manual

Advanced Topics

For advance topics related to application development, please refer Application Development.