Quick-start Tutorial

From Arctic Core - the open source AUTOSAR embedded platform

This tutorial contains three simple steps to get you started developing right away.

Prerequisites

• This tutorial assumes that you have Arctic Studio installed. If you don't, please go to the Installing Tools Tutorial first.

• If this is the first time you run Arctic Studio, it will prompt you for a workspace directory. This is the path on which your projects will be stored on disk. Please note that this path must not contain any spaces.
• Arctic Studio will also display the Welcome Screen. From it you have quick access to Arctic Core and Arctic Studio resources. When you want to dismiss the Welcome Screen, click Workbench. You can access the Welcome Screen at any time under Help --> Welcome

Clone Arctic Core

Checkouts in Mercurial are done by cloning a repository, thus setting up a local repository for you to work against.

• From the context menu (right-click) in the Project Explorer view in Arctic Studio, select Import...
• In the Import dialog select Mercurial / Clone repository using MercurialEclipse and click Next.
• Enter the URL to the repository you want to clone
  • Stable - the recommended repository for using Arctic Core:

    http://arccore.com/hg/arc-stable#tip

  • Bleeding edge - the repository used for development of Arctic Core:

    http://arccore.com/hg/arc

• In Clone directory name enter the name you want for the folder in your workspace, for example

  arc-stable

  or

  arc

• Click Next.
• If asked to select a "Working directory revision" then select the "v2" branch
• Click Next.
• Click Finish.
• Right-click the newly created project in the Project Explorer and select New --> Convert to a C/C++ Project.
• Under Toolchains, select Empty Toolchain and click Finish.

Install Core Builder toolchains

• Help --> Install New Software...
• In Work with select update site Arctic Studio Update site.
• Select which Core Builders you want to install.
• Click Next.
• Click Next.
• Accept the terms of license agreement and click Finish.

Trial license

If you have a trial license its time to install it. See [1]

Create your project

• From the context menu in the Project Explorer view in Arctic Studio, select New --> C Project.
• Enter a Project name, for instance "MyExample".
• In Project type select Makefile project / Empty Arctic Core Project.
• In Toolchains select one of the Core Builder toolchains (do not use the deprecated cygwin toolchain) and click Next. The toolchains available depend on which Core Builders you have installed. CW means that it will need a CodeWarrior Compiler installation to work.
• In Arctic Core source path enter the path to the Arctic Core source directory in your workspace. For instance:

C:\ArcticStudio\Studio\workspace\arc-stable

Tip: You can use the Eclipse macro workspace_loc to locate your workspace. Equivalent to entering the path above would be to enter:

${workspace_loc:/arc-stable}

• Click Finish.

You are now ready to start developing! If you want to take a startwith one of the xamples included in the Arctic Core source, follow the steps below:

• The newly created project by default builds the board mpc5516it. In the Arctic Core source tree (from Clone Arctic Core above) find the path boards/mpc5516it/examples/os_simple
• Copy the entire contents in the directory boards/mpc5516it/examples/os_simple/ (or one of the other examples) into the root of your newly created project (MyExample). Choose to overwrite all when prompted. When this is done the workspace should look like this image.

First build

If you chose to copy an Arctic Core example in the previous step, you are ready to build the code.

• Make sure that Build Automatically is NOT checkd in the Project menu.
• Select your project in the Project Explorer an click build in the top toolbar. You will get some warnings in the build output, but all should go well and the build ends by telling you

>>>>>>>  DONE  <<<<<<<<<

Your build is now set up for the mpc5516it board and you can find the target binary .elf file in your project in obj_mpc5516it/. More information can be found in Target Boards and Arctic Studio build settings.

Troubleshooting

If you encounter problems while following this tutorial please refer to Arctic Studio Troubleshooting.