Simplified doc-site generation

[AGL/documentation.git] / docs / ATTIC / 3_Developer_Guides / 4_X(cross)_Development_System:_User's_Guide / 3_Debugging_Your_First_AGL_Application / 3.4.3.4_Using_an_IDE.md

diff --git a/docs/ATTIC/3_Developer_Guides/4_X(cross)_Development_System:_User's_Guide/3_Debugging_Your_First_AGL_Application/3.4.3.4_Using_an_IDE.md b/docs/ATTIC/3_Developer_Guides/4_X(cross)_Development_System:_User's_Guide/3_Debugging_Your_First_AGL_Application/3.4.3.4_Using_an_IDE.md
new file mode 100644 (file)
index 0000000..c4b0341
--- /dev/null
+++ b/docs/ATTIC/3_Developer_Guides/4_X(cross)_Development_System:_User's_Guide/3_Debugging_Your_First_AGL_Application/3.4.3.4_Using_an_IDE.md
@@ -0,0 +1,94 @@
+---
+edit_link: ''
+title: Using an IDE
+origin_url: >-
+  https://git.automotivelinux.org/src/xds/xds-docs/plain/docs/part-1/debug-ide.md?h=master
+---
+
+<!-- WARNING: This file is generated by fetch_docs.js using /home/boron/Documents/AGL/docs-webtemplate/site/_data/tocs/devguides/master/xds-docs-guides-devguides-book.yml -->
+
+# Using an IDE
+
+This topic describes how to use `xds-gdb` from within an Interactive
+Development Environment (IDE) to debug your application.
+The topic uses the
+[NetBeans](https://netbeans.org/) IDE as an example.
+
+## Prerequisites
+
+Before using the IDE, you need to declare the project you want to debug
+on the `xds-server`.
+
+<!--section-note-->
+**NOTE:**
+
+The project you declare can also have been built using XDS.
+For information on building the project using XDS, see the
+"[Create your first AGL application](../../../#create-your-first-agl-application)"
+section.
+<!--end-section-note-->
+
+## NetBeans
+
+This section presents an example using NetBeans version 8.x:
+
+1. Select the **Options** item in the **Tools** menu.
+
+2. Open the **Build Tools** tab.
+
+3. Open the **C/C++** tab and click the **Add** button to reveal the "Add New
+   Tool Collection" dialog box:
+
+    ![Add new tool panel](./pictures/nb_newtool.png){:: style="width:90%; max-width:700px; margin:auto; display:flex"}
+
+4. Fill in the **Make Command** and **Debugger Command** fields so that they point to the XDS tools.
+   Following is an example:
+
+    ![Add new tool panel](./pictures/nb_xds_options.png){:: style="width:90%; max-width:700px; margin:auto; display:flex"}
+
+5. Click on **OK** button.
+
+6. Select the **Project Properties** item in the **File** menu to
+   update your debug settings.
+
+7. In the "Project Properties" dialog, be sure that the "Gen3 board"
+   appears in the "Configuration" field (i.e. active).
+
+8. In the "Categories" navigation pane, select **Run**.
+
+9. Set the following:
+
+   - Run Command: `target/start-on-root@renesas-gen3.sh`
+     <!--section-note-->
+     **NOTE:**
+
+     The script name could depend on the `RSYNC_TARGET`
+     variable you set in pre-build command.
+     <!--end-section-note-->
+
+   - Run Directory: `build_gen3`
+
+10. In the "Categories" navigation pane, select **Debug**.
+
+11. Set the following:
+
+    - Debug command: `/bin/true`
+
+    - Working Directory: Leave this field blank
+
+    - Gdb Init File: `target/gdb-on-root@renesas-gen3.ini`
+      <!--section-note-->
+      **NOTE:**
+
+      The script name could depend on the `RSYNC_TARGET`
+      variable you set in pre-build command.
+      <!--end-section-note-->
+
+      ![Select Model panel](./pictures/nb_project_debug-1.png){:: style="width:90%; max-width:700px; margin:auto; display:flex"}
+
+12. Click **Apply**.
+
+13. Click **OK** to save your settings.
+
+14. Start debugging your application by selecting the **Debug Project** item
+    in the **Debug** menu, or by entering the **CTRL+F5** shortcut.