Add toolchain section, update various articles

Author: kolerov

docs/assets/favicon.ico

@@ -43,7 +43,16 @@ with `snps_iotdk.cfg` configuration file. Here is an example:
 
 ```text
 $ openocd -f board/snps_iotdk.cfg
-...
+Open On-Chip Debugger 0.9.0-dev-g8ee31a5 (2023-09-27-21:15)
+Licensed under GNU GPL v2
+For bug reports, read
+ http://openocd.sourceforge.net/doc/doxygen/bugs.html
+adapter speed: 8000 kHz
+Info : clock speed 8000 kHz
+Info : JTAG tap: arc-em.cpu tap/device found: 0x200444b1 (mfg: 0x258, part: 0x0044, ver: 0x2)
+Info : JTAG tap: arc-em.cpu tap/device found: 0x200444b1 (mfg: 0x258, part: 0x0044, ver: 0x2)
+target state: halted
+target state: halted
 ```
 
 Then connect to the server using GDB:

docs/baremetal/hardware/iotdk.md

@@ -8,7 +8,7 @@ There is no a definite match between TCF templates for nSIM and `-mcpu` values f
 If you want to build a program using GNU toolchain and run it on nSIM simulator , then you have two
 ways of finding right nSIM options:
 
-1. Find proper nSIM options in [a compatibility table](../../general/compatibility.md).
+1. Find proper nSIM options in [a compatibility table](../../toolchain/compatibility.md).
 2. Use default TCF templates and additional nSIM options.
 
 There is a table with an a rough matching between `-mcpu` values and TCF templates with additional options:

docs/baremetal/simulators/nsim.md

@@ -26,7 +26,7 @@ GCC option `-mcpu=` supports both `hs34` and `hs38` values, but they are differe
 more features, like `-mll64` which are not present in `hs34`. ARC HS IPlib template `hs38` doesn’t
 contain double-word load/store, therefore -mcpu=hs38 is not compatible with this template.
 `-mcpu=hs34`, however, is compatible and that is why TCF generator uses this value. Refer
-[Target Specific Options](general/target-options.md) page for a full list of possible `-mcpu`
+[Multiplication Options](../toolchain/mpy-options.md) page for a full list of possible `-mcpu`
 values and what IPlibrary templates they correspond to.
 
 ## There are `can’t resolve symbol` error messages when using `gdbserver` on Linux for ARC targets

docs/faq.md renamed to docs/home/faq.md

@@ -13,4 +13,6 @@ Here is a list of other useful resources regarding Free and Open Source Software
 (FOSS) for DesignWare ARC Processors:
 
 * [Release page of GNU toolchain](https://github.com/foss-for-synopsys-dwc-arc-processors/toolchain/releases)
-* [The old embARC web page](https://embarc.org)
+* [The old GNU toolchain documentation](https://foss-for-synopsys-dwc-arc-processors.github.io/toolchain/)
+* [The old embARC web page (second)](https://embarc.org)
+* [THe old embARC web page (first)](https://foss-for-synopsys-dwc-arc-processors.github.io/)

docs/general/processors.md renamed to docs/home/processors.md

@@ -6,7 +6,7 @@
 
 !!! info
 
- * Follow [How to Get The Toolchain](../../general/toolchains.md#how-to-get-the-toolchain)
+ * Follow [How to Get The Toolchain](../../toolchain/index.md#how-to-get-the-toolchain)
   guide to get the latest ARC GNU toolchain. Linux toolchain for ARC HS3x/4x (with uClibc or glibc)
   is required.
  * Refer to the original [U-Boot README for HSDK](https://github.com/Screenly/u-boot/blob/master/board/synopsys/hsdk/README)

docs/index.md

@@ -134,11 +134,26 @@ excp_info
 Run the virtual machine to produce a trace file:
 
 ```shell
-$ qemu-system-arc --trace events=events.trc ...
+qemu-system-arc --trace events=events.trc ...
 ```
 
 Pretty-print the binary trace file (override `<pid>` with QEMU process id for you session):
 
 ```text
-$ <QEMU-source-tree-path>/scripts/simpletrace.py <QEMU-source-tree-path>/target/arc/trace-events trace-<pid>
+<QEMU-source-tree-path>/scripts/simpletrace.py <QEMU-source-tree-path>/target/arc/trace-events trace-<pid>
+```
+
+## Running Tests
+
+TCG is the internal language that powers QEMU. There are some assembly tests
+that validate the basic function of several instructions in QEMU.
+
+Firstly, make sure that QEMU if configured with `--cross-cc-arc=arc-elf32-gcc`
+and `--cross-cc-arc64=arc64-elf-gcc` options. Then after building QEMU use these
+commands to run TCG tests:
+
+```shell
+make clean-tcg
+make build-tcg
+make check-tcg
 ```