A Simple Example Arriba IDE Project

Using Arriba is practically as easy as opening a workspace and selecting the build button! This chapter discusses building and running an entire example project from start to finish.

Arriba comes complete with a variety of examples.

For the sake of this brief introduction, we will focus on the example of a standalone PIC32 application.

Getting Started

Simply run Arriba via the “Start” button or via the Arriba icon on the desktop.

1

Workspace Selection

At this point you will observe the Arriba Workspace Launcher dialog. Select a directory on your host computer that Arriba can use to store projects and the workspace. Ensure that you have write permission for this directory.

More on Eclipse projects and the workspace can be found in the Eclipse documentation: http://help.eclipse.org/kepler/index.jsp

ArribaWiki.1.3.01.jpg
Click image to enlarge.

2

Arriba Welcome Screen

If you have selected a new workspace, Arriba will start at the welcome screen.

  • ArribaWiki.1.3.03.jpg Shows a quick overview of Arriba for PIC MCUs
  • ArribaWiki.1.3.04.jpg Shows the web resources available with Arriba for PIC MCUs. You can, for example, download versions of the MPLAB XC C compiler from this resource.
  • ArribaWiki.1.3.05.jpg Enter the Arriba workbench.
ArribaWiki.1.3.02.jpg
Click image to enlarge.

Creating a Project

1

New Project Dialog

From the Arriba workbench, you can begin to create a project for a PIC MCU. Start by selecting File->New->Project to show the New Project Dialog.

Select “C Project” and click “Next” to continue.

ArribaWiki.1.3.06.jpg
Click image to enlarge.

2

Project Types Selection Dialog

Arriba will now present a list of project types to choose from. You may need to check/uncheck the “Show project types and toolchains…” checkbox to show all-available project types for PIC MCUs.

Select “PIC32 Sample” for this exercise and enter “PIC32” for Project name. Click “Next” to move to the C Project Dialog.

ArribaWiki.1.3.07.jpg
Click image to enlarge.

3

C Project Dialog

Arriba presents a list of configurations to create for this project. Select “Next” to continue.

ArribaWiki.1.3.08.jpg
Click image to enlarge.

4

Device and Hardware Tools

Arriba will now require that you specify some information about the PIC MCU target on which the resulting code generated by the project will execute. By default, no information is specified for the project and you’re required to enter the device family, device, and hardware tools associated with the newly created project.

Note that you can always modify these choices after the project has been created.

For this exercise, click on “Configure” to select these data and Arriba will open the Device and Hardware Tools Configuration Dialog.

ArribaWiki.1.3.09.jpg
Click image to enlarge.

5

Device and Hardware Tools Configuration Dialog

Again for this exercise, we recommend that you keep the default options specified in this dialog, and simply click “OK” to close the Hardware Tools Configuration Dialog. Then click on “Finish” to create the project.

Arriba will offer to open the “C” perspective. Click "Yes".

ArribaWiki.1.3.10.jpg
Click image to enlarge.
ArribaWiki.1.3.11.jpg

Building the Project

You should see the following Arriba desktop:

ArribaWiki.1.3.12.jpg

Arriba C/C++ Perspective

Note that:

  • You can select “C/C++” button to view the C perspective at all time
  • Edit/view source files by double-clicking on it under the Project Explorer
  • Arriba Connect status indicator should show “active” in the lower left hand corner. If not, your Arriba installation is not properly running; contact Viosoft support.

At this point, you’re ready to build the PIC32 project. Note that you must install the MPLAB XC32 C compiler toolchain prior to using Arriba in order to build this PIC32 application. (For other PIC MCUs, you may need to select a different MPLAB XC C compiler.)

Building is simply done by clicking on the build button in the toolbar:

ArribaWiki.1.3.13.jpg

Build Button in Toolbar

You should see the following messages in the Console view:

ArribaWiki.1.3.14.jpg

Console View

Debugging the Project

Before you debug, it is recommended that you select the PIC32 entry in the Project Explorer, as shown below, before opening the Debug Configuration Dialog. Doing so will enable eclipse to automatically fill out the necessary debug configuration information.

ArribaWiki.1.3.15.jpg

Debug Configuration Dialog

Now you can debug the “PIC32” application by selecting Run->Debug Configurations, or by clicking on the tiny down arrow next to the cockroach and select “Debug Configurations” as shown in Figure below.

ArribaWiki.1.3.16.jpg

Opening Debug Configuration Dialog

From the Debug Configuration Dialog:

  • Select Microchip Config in the launch list
  • Double click on the plus icon in the toolbar to create a new debug configuration for the PIC32 project

You should see the Main Debug Tab shown below:

ArribaWiki.1.3.17.jpg

Main Debug Tab

At this point, Arriba should offer the Debug perspective and you shall accept, as shown below.

ArribaWiki.1.3.18.jpg

Switching to Debug Perspective

From the Debug perspective shown in Figure 28, you can press “Resume” button to resume execution, or “Halt” to suspend execution. Notice that the debug view should annotate your current program location within the execution flow. In addition, breakpoints, register, and memory viewing are all available with just a few mouse clicks!

ArribaWiki.1.3.19.jpg

Debugging of Application in Debug Perspective

The project building and execution facilities of Arriba are discussed in greater detail in subsequent chapters of this guide. Hopefully, this chapter illustrates just how easy it is to get a project up and running with Arriba!

For more information on working with Arriba, consult the Arriba User Guide that comes with the product, or the online help.

20th Annual
Microchip MASTERs Conference 2016
Register now - Deadline: July 29

JW Marriott Desert Ridge Resort-Phoenix, AZ

© 2016 Microchip Technology, Inc.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.