=================
 Install Plugins
=================

open the software installation dialog:
  Help -> Install New Software

add the following repositories:
  - http://download.eclipse.org/releases/oxygen
  - http://download.eclipse.org/tm/updates/4.0
  - http://downloads.yoctoproject.org/releases/eclipse-plugin/2.4.2/oxygen

install the following software groups
  - Linux Tools
  - Mobile and Device Development
  - Yocto Project Documentation plug-in
  - Yocto Project SDK Plug-in


=================
 Setup Toolchain
=================

open the preferences dialog:
  Window -> Preferences

from "Yocto Project SDK" preferences:
  - Standalone pre-built toolchain
  - Toolchain Root Location: /opt/poky/2.4.2
  - Sysroot Location: /opt/poky/2.4.2/sysroots
  - External HW


=====================
 Create Test Program
=====================

create a Yocto hello example:
  File -> New -> Project
  C/C++ -> C Project
  Yocto Project SDK Autotools Project -> Hello World ANSI C Autotools Project
  Project Name: simple (all lowercase, no spaces, no minus, only a-z!!)

build the application
  Project -> Build Project


===================
 Create Connection
===================

open the new connection dialog:
  Target -> New Connection
  Generic Connection
  Connection Name: myboard
  Type: TCP
  Host: (ip address of board)

NOTE: The connection is activated immediately so the board must be online
      and tcf-agent must be running on the board. The connection can be
      controlled with:
        Target -> Connect/Disconnect


=====================
 Setup Debug Session
=====================

open the debug configurations dialog:
  Run -> Debug Configurations

choose the appropriate configuration:
  C/C++ Remote Application -> simple_gdb_...

choose the TCF launcher:
  "Select other..." (link near bottom on dialog)
  Use configuration specific settings
  GDB (DSF) Automatic Remote Debuggin via TCF/TE Launcher

set remote path:
  Remote Absolute File Path for C/C++ Application: /tmp/simple

set C/C++ application:
  Search Project

start debug session:
  Debug (connection must be active!)

open a terminal window to see debug output:
  Window -> Show View -> Terminal