Update Documentation (#479)

## Fixes:
- Open-CMSIS-Pack/devtools#2265
- #303
- https://github.com/Open-CMSIS-Pack/cmsis-toolbox/issues/611

## Added:
- pyOCD Telnet option for file-in and file-out

Author: ReinhardKeil

docs/YML-Input-Format.md

@@ -1421,7 +1421,7 @@ The `images:` node under `target-set:` specifies the projects with build-type an
     [`load:`](#load)                   |   Optional   | Load mode of the image file for programmers and debug tools.
     `info:`                            |   Optional   | Brief description of the image file.
     [`type:`](#type)                   |   Optional   | Specifies an explicit file of the image type.
-    `load-offset:`                     |   Optional   | Offset applied to the binary content when loading the image file.
+    `load-offset:`                     |   Optional   | Offset applied when loading a image file with `type: bin` (pyOCD only).
     [`device:`](#device)               |   Optional   | For image files a pname can be specified to denote the processor that runs the image.
 
 !!! Notes
@@ -2465,7 +2465,7 @@ debugger:                         |             | Description
     [`reset:`](pyOCD-Debugger.md#reset)           |  Optional   | Extended Option: Reset type configuration for various cores.
     [`load-setup:`](pyOCD-Debugger.md#load-setup) |  Optional   | Extended Option: Reset type and Halt configuration for Load command.
 
-*Examples:**
+**Examples:**
 
 ```yml
 debugger:
@@ -2498,12 +2498,13 @@ The `telnet:` node configures:
 `- mode:`                                                 |**Required** | Redirect output: `off`, `server`, `file`, `console`, `monitor`.
     `pname:`                               |  Optional   | Identifies the processor (not requried for single core system).
     `port:`                                |  Optional   | Set TCP/IP port number of Telnet Server (default: 4444, 4445, ... incremented for each processor).
-&nbsp;&nbsp;&nbsp; `file:`                                |  Optional   | Explicit path and name of the telnet output file (default: ./out/\<solution-name\>+\<target-type\>.\<pname\>.out).
+&nbsp;&nbsp;&nbsp; `file-in:`                             |  Optional   | Explicit path and name of the telnet input file. Default: ./out/\<solution-name\>+\<target-type\>.\<pname\>.in
+&nbsp;&nbsp;&nbsp; `file-out:`                            |  Optional   | Explicit path and name of the telnet output file. Default: ./out/\<solution-name\>+\<target-type\>.\<pname\>.out
 
 Telnet Mode   | Description
 :-------------|:--------------------------------------
 `server`      | Serial I/O to Telnet server port
-`file`        | Serial output to text file (default: ./out/\<solution-name\>+\<target-type\>.\<pname\>.out).
+`file`        | Serial I/O to text files. Default: `./out/\<solution-name\>+\<target-type\>.\<pname\>.{in \| out}`
 `console`     | Serial output to console (Debug console in VS Code). 
 `monitor`     | Serial I/O via TCP/IP port to VS Code Serial Monitor.
 `off`         | Serial I/O disabled.
@@ -2541,9 +2542,9 @@ debugger:
     - pname: Core0          # enable Telnet service with default settings
       port: 4444
     - pname: Core1
-      mode: console         # route Telnet output to console 
+      mode: console         # route Telnet input/output to console 
     - pname: Core2
-      mode: file            # log Telnet output 
+      mode: file            # route Telnet input/output to files
 ```
 
 ### Arm Debugger
@@ -2651,7 +2652,7 @@ debugger:                         |             | Description
 ```yml
 debugger:
   name: J-Link Server
-  clock: 4000                    # 4000 kHz
+  clock: 4000000                  # 4000 kHz
   protocol: swd
 ```
 

docs/build-tools.md

@@ -22,7 +22,7 @@ There are several ways to configure the CMSIS-Pack repository:
 Orchestrate the overall build steps utilizing the various tools of the CMSIS-Toolbox and a CMake-based compilation process.
 
 ```txt
-cbuild: Build Invocation 2.11.0 (C) 2022-2025 Arm Ltd. and Contributors
+cbuild: Build Invocation 2.12.0 (C) 2022-2025 Arm Ltd. and Contributors
 
 Usage:
   cbuild [command] <name>.csolution.yml [options]
@@ -48,8 +48,16 @@ Options:
   -n, --no-schema-check    Skip schema check
   -O, --output arg         Base folder for output files, 'outdir' and 'tmpdir' (default "Same as '*.csolution.yml'")
   -p, --packs              Download missing software packs with cpackget
+  -j, --jobs int           Number of job slots for parallel execution (default 8)
+  -l, --load arg           Set policy for packs loading [latest | all | required] (default "required")
+      --log arg            Save output messages in a log file
+  -n, --no-schema-check    Skip schema check
+  -O, --output arg         Base folder for output files, 'outdir' and 'tmpdir' (default "Same as '*.csolution.yml'")
+  -p, --packs              Download missing software packs with cpackget
   -q, --quiet              Suppress output messages except build invocations
   -r, --rebuild            Remove intermediate and output directories and rebuild
+  -s, --schema             Validate project input file(s) against schema [deprecated]
+      --skip-convert       Skip csolution convert step
   -t, --target arg         Optional CMake target name
       --toolchain arg      Input toolchain to be used
       --update-rte         Update the RTE directory and files

docs/index.md

@@ -24,8 +24,6 @@ Thank you for using the **CMSIS-Toolbox** that provides command-line tools for:
 
 - [**Build Information Files**](YML-CBuild-Format.md) details the build information generated by the `csolution` tool. It includes license information for components and configuration for download and debug.
 
-- [**pyOCD Debugger**](pyOCD-Debugger.md) explains the usage of the [pyOCD](https://pyocd.io/) Debugger in combination with the CMSIS-Toolbox configuration features.
-
 - [**Theory of Operation**](build-operation.md) contains further details about the build process including CMake, West, generator (device configurators), and debugger integration for advanced users.
 
 - [**Pack Creation**](pack-tools.md) describes how to create software packs that optionally include examples and explains the pack creation tools `packchk` (software pack verification) and `svdconv` (SVD file verification and header file generator).
@@ -34,6 +32,10 @@ Thank you for using the **CMSIS-Toolbox** that provides command-line tools for:
 
 - [**Experimental Features**](Experimental-Features.md) for resource management of multi-project linker scripts, run and debug management.
 
+- **Debugger Support**
+    - [**pyOCD Debugger**](pyOCD-Debugger.md) explains the usage of the [pyOCD](https://pyocd.io/) Debugger in combination with the CMSIS-Toolbox configuration features.
+    - [**J-Link Debugger**](pyOCD-Debugger.md) explains the usage of the [J-Link GDB Server](https://www.segger.com/products/debug-probes/j-link/tools/j-link-gdb-server/about-j-link-gdb-server/) in combination with the CMSIS-Toolbox configuration features.
+
 - **Device Configuration Tools**
     - [**MCUXpresso for NXP Devices**](./MCUXpressoConfig.md) shows how to use [MCUXpresso Config Tools](https://www.nxp.com/configtools) to manage device and board configuration.
     - [**STM32CubeMX for STM32**](CubeMX.md) explains how to use [STM32CubeMX](https://www.st.com/en/development-tools/stm32cubemx.html) to manage device and board configuration.

mkdocs.yml

@@ -13,11 +13,13 @@ nav:
   - Create Applications: CreateApplications.md
   - Reference Applications: ReferenceApplications.md
   - Build Information Files: YML-CBuild-Format.md
-  - pyOCD Debugger: pyOCD-Debugger.md
   - Theory of Operation: build-operation.md
   - Pack Creation: pack-tools.md
   - Troubleshooting: Troubleshooting.md
   - Experimental Features: Experimental-Features.md
+  - Debugger Support:
+    - pyOCD Debugger: pyOCD-Debugger.md
+    - J-Link Debugger: JLink-Debugger.md
   - Device Configuration Tools:
     - MCUXpresso for NXP Devices: MCUXpressoConfig.md
     - STM32CubeMX for STM32 Devices: CubeMX.md