eclipse-notes: update debug connection info, add yocto variant

It is much easier to use tcf-agent with eclipse and cross-remote
debugging. Since local plugin-mirrors and yocto instructions are
now available, update the documents to reflect this.

Using the old method (with ssh) probably still works, but is
definitely more work to get setup on the target.

Signed-off-by: John Ogness <john.ogness@linutronix.de>

2 files changed, 116 insertions, 1 deletions

diff --git a/schulung_tools/notes/HOWTO-eclipse-cross-remote.txt b/schulung_tools/notes/HOWTO-eclipse-cross-remote.txt
index 45c8d02..eee7325 100644
--- a/schulung_tools/notes/HOWTO-eclipse-cross-remote.txt
+++ b/schulung_tools/notes/HOWTO-eclipse-cross-remote.txt
@@ -16,6 +16,31 @@ File -> New -> C Project
 Project -> Properties
 C/C++ Build -> Settings
 
+===================
+ 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
+
+!!!
+!!! This "setup debug" section is outdated! It is better to cross-compile
+!!! the tcf-agent (https://www.eclipse.org/tcf/downloads.php) and setup
+!!! the debug connection like Yocto (HOWTO-eclipse-yocto.txt).
+!!!
+!!! NOTE: The '"Debugger" tab' part of the below instructions is still
+!!!       valid and necessary!
+!!!
+
 (setup debug)
 Run -> Debug Configurations
 "Create, manage, and run configurations" window
@@ -40,4 +65,4 @@ Run -> Debug Configurations
     "Main" sub-tab
         GDB debugger: /opt/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gdb
     "Gdbserver Settings" sub-tab
-        Port number: 12345
+        Port number: 2345
diff --git a/schulung_tools/notes/HOWTO-eclipse-yocto.txt b/schulung_tools/notes/HOWTO-eclipse-yocto.txt
new file mode 100644
index 0000000..f1e13c0
--- /dev/null
+++ b/schulung_tools/notes/HOWTO-eclipse-yocto.txt
@@ -0,0 +1,90 @@
+=================
+ 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