From f002c26b1f260749741cb1d4f71fda78a0a55298 Mon Sep 17 00:00:00 2001
From: stnolting <22944758+stnolting@users.noreply.github.com>
Date: Sat, 15 Jun 2024 20:11:01 +0200
Subject: [PATCH] [eclipse] add serial terminal to UG

---
 docs/userguide/eclipse_ide.adoc | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/userguide/eclipse_ide.adoc b/docs/userguide/eclipse_ide.adoc
index 68c5d9482..ad9c89837 100644
--- a/docs/userguide/eclipse_ide.adoc
+++ b/docs/userguide/eclipse_ide.adoc
@@ -42,6 +42,11 @@ to a different location (makefile, NEORV32 sources, etc.).
 Make sure to adjust the binaries / installation folders of the RISC-V GCC toolchain
 and OpenOCD according to your installation. See the following chapter for more information.
 
+.Obtaining the Toolchain
+[TIP]
+I recommend the prebuilt binaries (RISC-V GCC and OpenOCD; for Windows and for Linux) from
+**The xPack Reproducible Build Framework**: https://github.com/xpack
+
 
 :sectnums:
 === Setup a new Eclipse Project from Scratch
@@ -140,6 +145,28 @@ the required `main.elf` file gets generated instead of _all_ executable files (l
 * In the **SVD Path** tab add the NEORV32 SVD file (`path/to/neorv32/sw/svd/neorv32.svd`).
 . Click **Apply** and then **Close**.
 
+==== Setup Serial Terminal
+
+A serial terminal can be added to Eclipse by installing it as a plugin.
+I recommend "TM Terminal" which is already installed in some Eclipse bundles.
+
+Open a TM Terminal serial console:
+
+[start=1]
+. Click on **Window > Show View > Terminal** to open the terminal.
+. A **Terminal** tab appears on the bottom. Click the tiny screen button on the right (or press Ctrl+Alt+Shift)
+to open the terminal configuration.
+. Select **Serial Terminal** in **Choose Terminal** and configure the settings according to the processor's
+UART configuration.
+
+Installing TM Terminal from the Eclipse market place:
+
+[start=1]
+. Click on **Help > Eclipse Marketplace...**.
+. Enter "TM Terminal" to the **Find** line and hit enter.
+. Select **TM Terminal** from the list and install it.
+. After installation restart Eclipse.
+
 === Eclipse Setup References
 
 * Eclipse help: https://help.eclipse.org/latest/index.jsp