Getting Started with EM Starter Kit
===================================

Creating Hello World project for ARC EM Starter Kit
---------------------------------------------------

1. Select **File >New >C Project**

.. figure:: images/creating_project/creating_new_c_project.png

   Creating a new C project

   The **C Project** window should have several ARC project types:
   **ARC Cross ELF32 Target Application**, **ARC Cross ELF32 Target Static
   Library**, **AXS10x Projects** and **EM Starter Kit Projects**. Select
   **EM Starter Kit Projects**. This project type is available only if ARC EM
   toolchain compiler can be found either in ``PATH`` environment variable or
   in ``../bin/`` directory relative to Eclipse executable.

2. Enter a project name

.. figure:: images/creating_project/c_project_creation_dialog.png

   C Project Creation Dialog

   1. Under **EM Starter Kit Projects** select **Hello World for EM SK
      2.1 Project** (or **Hello World for EM SK 1.1** depending on your EM Starter Kit
      version). This Hello World project is an example project that
      comes with the EM Starter Kit Software and uses the UART on the EM Starter
      Kit to display output. To see output printer to UART, connection to serial
      port should be established. By default Eclipse for ARC will automatically
      connect to available serial port, but that feature can be disabled and in
      that case refer to the EM Starter Kit Getting Started for instructions on
      how to connect to the UART on the EM Starter Kit board using Putty.

   2. Fill in project name and click **Finish** or **Next** if you want to
      fill in additional information.

   The resulting Hello World project created in Eclipse is:

.. figure:: images/creating_project/c_project_for_emsk.png

   Final Hello World Project in Eclipse


Building the project
--------------------

1. Right click on the `Hello World project` and select **Build Project** from the pop-up menu

.. figure:: images/building/building_a_project.png

   Building a Project

2. Review the build output log in the Eclipse console tab to confirm success:

.. figure:: images/building/build_output.png

   Build Output


Debugging the project
---------------------

Once the project is successfully compiled by ARC GCC, you can debug the
resulting executable on the EM Starter Kit board.

.. note::

   If you are using Windows platform, please configure drivers for your EM Starter
   Kit before you begin debug process. For the instructions see
   :ref:`How to use OpenOCD on Windows <how-to-use-openocd-on-windows>`.

To debug the project, create a new debug configuration.

1. Select **Debug Configurations**  from the  **Run**  menu or by clicking on
   the down arrow next to the bug icon:

.. figure:: images/debugging/debug_configurations.png

   Debug Configurations

2. Double click on the **ARC C/C++ Application**  or click on the top left icon
   to create a new debug configuration for the project:

.. figure:: images/debugging/arc_debug_configurations.png

   ARC Embedded Debug Configurations

3. Select a name for the new debug configuration (by default, it equals the
   project name followed by "Debug").

.. figure:: images/debugging/openocd/debug_configuration.png

   New debug Configuration

4. Click the **Debugger** tab and select **Gdbserver Settings** page.

.. figure:: images/debugging/debugger_tab_default.jpg

   Default values in the Debugger tab for JTAG via OpenOCD

   Select **EM Starter Kit v2.x** or **EM Starter Kit v1.x** as development
   system depending on your EM Starter Kit version.

   Open **Terminal** tab and select COM Port. For Linux choose
   **/dev/ttyUSB1**. For Windows COM Port should match the port number in
   "Device and Printers" as shown below.

.. figure:: images/debugging/serial_port_window.png

   Digilent USB Serial COM Port

.. figure:: images/debugging/openocd/com_port.png

   USB Serial COM Port

5. Click the **Debug** button in the **Debug configurations** dialog to
   initiate debug session.

   This action automatically launches the Serial terminal and OpenOCD
   applications in the background and   connects to the UART on the EM Starter
   Kit board.

6. Click **Yes** in the confirmation dialog to switch to the Debug perspective

.. figure:: images/debugging/perspective_switch.png

   Perspective Switch


.. figure:: images/debugging/openocd/debugging_process.png

   Debugging Process