Update almost all hardware related articles and add EM SDP guide

Author: kolerov

docs/baremetal/hardware/emsdp.md

@@ -67,54 +67,11 @@ Here is a list of all available `specs` files:
 
 ## Running an Application
 
-Create a configuration file for OpenOCD and name it `emsdp.cfg`. It's necessary
-because it's not included in OpenOCD distribution yet:
-
-```tcl
-# Configure JTAG cable
-# EM SDP has built-in FT2232 chip, which is similar to Digilent HS-1.
-adapter driver ftdi
-
-# Only specify FTDI serial number if it is specified via
-# "set _ZEPHYR_BOARD_SERIAL 12345" before reading this script
-if { [info exists _ZEPHYR_BOARD_SERIAL] } {
- ftdi_serial $_ZEPHYR_BOARD_SERIAL
-}
-
-ftdi vid_pid 0x0403 0x6010
-ftdi layout_init 0x0088 0x008b
-ftdi channel 0
-
-# EM11D requires 10 MHz.
-adapter speed 10000
-
-# ARCs support only JTAG.
-transport select jtag
-
-source [find cpu/arc/em.tcl]
-
-set _CHIPNAME arc-em
-set _TARGETNAME $_CHIPNAME.cpu
-
-# EM SDP IDENTITY is 0x200444b1
-jtag newtap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -expected-id 0x200044b1
-
-set _coreid 0
-set _dbgbase [expr {0x00000000 | ($_coreid << 13)}]
-
-target create $_TARGETNAME arcv2 -chain-position $_TARGETNAME \
- -coreid 0 -dbgbase $_dbgbase -endian little
-
-# There is no SRST, so do a software reset
-$_TARGETNAME configure -event reset-assert "arc_em_reset $_TARGETNAME"
-
-arc_em_init_regs
-```
-
-Start OpenOCD using `emsdp.cfg` configuration file:
+Follow [Using OpenOCD](../../platforms/use-openocd.md) guide and start OpenOCD
+with `snps_em_sk_v2.3.cfg` configuration file. Here is a possible output:
 
 ```text
-$ openocd -f ./emsdp.cfg
+$ openocd  -f board/snps_em_sk_v2.3.cfg
 Open On-Chip Debugger 0.12.0+dev-gffa52f0e0 (2023-08-02-10:41)
 Licensed under GNU GPL v2
 For bug reports, read

docs/baremetal/hardware/emsk.md

@@ -80,8 +80,7 @@ Here is a list of all available `specs` files:
 ## Running an Application Using OpenOCD
 
 Follow [Using OpenOCD](../../platforms/use-openocd.md) guide and start OpenOCD
-with 49101 port and `snps_em_sk_v2.2.cfg` configuration file. Here is
-a possible output:
+with `snps_em_sk_v2.2.cfg` configuration file. Here is a possible output:
 
 ```text
 $ openocd -f board/snps_em_sk_v2.2.cfg

docs/eclipse/getting-started/emsdp.md

@@ -0,0 +1,93 @@
+# Getting Started with EM Software Development Platform
+
+!!! info
+
+ Consider reading these guides firstly:
+
+ * [Configuring EM Software Development Platform](../../platforms/board-emsdp.md)
+ * [Installing WinUSB driver on Windows](../../platforms/winusb.md)
+
+## Creating the Project
+
+Select **File** → **New** → **Project..** and choose **C Project**.
+A list of ARC projects will appear. Choose any ARC EM Starter Kit
+"Hello World" project from the **ARC EM SDP Projects** group.
+
+![ARC EM SDP Projects](./images/emsdp-projects.png)
+
+After creating the project, a simple "Hello, World!" program will be created:
+
+```c
+/* Print a greeting on UART output and exit. */
+
+#include <stdio.h>
+
+int main(int argc, char *argv[])
+{
+ printf("Hello, World!\n\r");
+ return 0;
+}
+```
+
+## Building the Project
+
+Do right click on a project in **Project Explorer** ans choose **Build Project**.
+The project will be built with this output:
+
+```text
+make all 
+Building file: ../src/main.c
+Invoking: ARC GNU C Compiler
+/SCRATCH/ykolerov/tools/arc-2023.09/ide_fixed/bin/arc-elf32-gcc -mcpu=em4_fpuda -mcode-density -mdiv-rem -mswap -mnorm -mmpy-option=6 -mbarrel-shifter -mfpu=fpuda_all --param l1-cache-size=16384 --param l1-cache-line-size=32 -include /SCRATCH/ykolerov/ARC_GNU_IDE_Workspace/emsdp/Debug/core_config.h -O0 -g3 -Wall -c -fmessage-length=0 -gdwarf-2 -Wa,-adhlns="src/main.o.lst" -MMD -MP -MF"src/main.d" -MT"src/main.o" -o "src/main.o" "../src/main.c"
+Finished building: ../src/main.c
+ 
+Building target: emsdp.elf
+Invoking: ARC GNU C Linker
+/SCRATCH/ykolerov/tools/arc-2023.09/ide_fixed/bin/arc-elf32-gcc -mcpu=em4_fpuda -mcode-density -mdiv-rem -mswap -mnorm -mmpy-option=6 -mbarrel-shifter -mfpu=fpuda_all --param l1-cache-size=16384 --param l1-cache-line-size=32 -specs=emsdp1.1.specs -Wl,-Map,emsdp.map -o "emsdp.elf" ./src/main.o 
+Finished building target: emsdp.elf
+```
+
+## Creating a Debug Configuration
+
+Do right click on projects's name in **Project Explorer** and choose
+**Debug As** → **Debug Configurations...**. Then do right click on
+**ARC C/C++ application** and choose **New Configuration**. Here is a main window of
+the debug configuration:
+
+![Debug Configuration - Main](./images/emsdp-debug-conf-main.png)
+
+Ensure that a correct project and binary are selected. Navigate to **Main** tab
+and **Gdbserver Settings** inner tab:
+
+![Debug Configuration - GDB](./images/emsdp-debug-conf-gdb.png)
+
+Choose **JTAG via OpenOCD** as ARC GDB Server and **EM Software Development Platform** as
+a development system (use a corresponding one for your case). Then click on **Apply**.
+
+## Configuring a Serial Terminal
+
+Navigate to **Terminal** inner tab of **Main** tab and select a COM port for
+the board. Eclipse automatically detects all available COM ports. In my case
+it's `/dev/ttyUSB6`.
+
+![Debug Configuration - Terminal](./images/emsdp-debug-conf-terminal.png)
+
+On Windows you can find the exact number in **Device Manager** (it corresponds
+to **USB Serial Port** device):
+
+![Debug Configuration - Port](./images/emsk-debug-conf-port.png)
+
+On Linux a serial device for EM Software Development Platform is usually `/dev/ttyUSB1`
+if there are no other serial devices connected to the host.
+
+## Debugging the Project
+
+Open the debug configuration in **Debug Configurations** windows and click
+on **Debug** button. The **Debug** perspective will be opened:
+
+![Debug - Perspective](./images/emsdp-debug-perspective.png)
+
+Use **Step Over** button to step over `printf` function and select **Terminal**
+in the bottom of the window. "Hello world!" string will be printed:
+
+![Debug - Output](./images/emsdp-debug-output.png)

docs/eclipse/getting-started/emsk.md

@@ -4,7 +4,7 @@
 
  Consider reading these guides firstly:
 
- * [Configuring EM Starter Kit](https://github.com/foss-for-synopsys-dwc-arc-processors/ARC-Development-Systems-Forum/wiki/ARC-Development-Systems-Forum-Wiki-Home#arc-em-starter-kit-1)
+ * [Configuring EM Starter Kit](../../platforms/board-emsk.md)
  * [Installing WinUSB driver on Windows](../../platforms/winusb.md)
 
 ## Creating the Project
@@ -19,11 +19,13 @@ Suppose, EM11D project is chosen.
 After creating the project, a simple "Hello, World!" program will be created:
 
 ```c
+/* Print a greeting on UART output and exit. */
+
 #include <stdio.h>
 
 int main(int argc, char *argv[])
 {
- printf("Hello world!\n\r");
+ printf("Hello, World!\n\r");
  return 0;
 }
 ```
@@ -78,7 +80,8 @@ to **USB Serial Port** device):
 
 ![Debug Configuration - Port](./images/emsk-debug-conf-port.png)
 
-On Linux a serial device for EM Starter Kit is usually `/dev/ttyUSB1`.
+On Linux a serial device for EM Starter Kit is usually `/dev/ttyUSB1`
+if there are no other serial devices connected to the host.
 
 ## Debugging the Project
 

docs/eclipse/getting-started/hsdk.md

@@ -4,24 +4,29 @@
 
  Consider reading these guides firstly:
 
- * [Configuring HS Development Kit](https://github.com/foss-for-synopsys-dwc-arc-processors/ARC-Development-Systems-Forum/wiki/ARC-Development-Systems-Forum-Wiki-Home#arc-hs-development-kit-1)
- * [Configuring HS Development Kit 4xD](https://github.com/foss-for-synopsys-dwc-arc-processors/ARC-Development-Systems-Forum/wiki/ARC-Development-Systems-Forum-Wiki-Home#arc-hs4xhs4xd-development-kit-1)
+ * [Configuring HS Development Kit](../../platforms/board-hsdk.md)
+ * [Configuring HS Development Kit 4xD](../../platforms/board-hsdk-4xd.md)
  * [Installing WinUSB driver on Windows](../../platforms/winusb.md)
 
 ## Creating the Project
 
 Select **File** → **New** → **Project..** and choose **C Project**.
 A list of ARC projects will appear. Choose any **ARC HS Development Kit Hello World Project**
-from the **ARC EM Starter Kit Projects** group:
+from the **ARC HS Development Kit Projects** group:
 
 ![HS Development Kit Projects](./images/hsdk-projects.png)
 
 An empty project will be created. Add a new C source file with name `main.c`
 in `src` directory in **Project Explorer**:
 
 ```c
+/* Print a greeting on UART output and exit. */
+
+#include <stdio.h>
+
 int main(int argc, char *argv[])
 {
+ printf("Hello, World!\n\r");
  return 0;
 }
 ```
@@ -76,7 +81,8 @@ to **USB Serial Port** device):
 
 ![Debug Configuration - Port](./images/emsk-debug-conf-port.png)
 
-On Linux a serial device for HS Development Kit is usually `/dev/ttyUSB0`.
+On Linux a serial device for HS Development Kit is usually `/dev/ttyUSB0`
+if there are no other serial devices connected to the host.
 
 ## Debugging the Project