From 5e5ddf79f1f54e8a32334003d5133777c909c34b Mon Sep 17 00:00:00 2001 From: Heinrich Schuchardt Date: Fri, 9 May 2025 08:42:07 +0200 Subject: [PATCH] doc: RISC-V supports semihosting Mention that RISC-V supports semihosting. Update the link to ARM's semihosting documentation Update SPDX identifier to current format. Signed-off-by: Heinrich Schuchardt --- doc/usage/semihosting.rst | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/doc/usage/semihosting.rst b/doc/usage/semihosting.rst index 9303a6364d5..728367ffaf5 100644 --- a/doc/usage/semihosting.rst +++ b/doc/usage/semihosting.rst @@ -1,14 +1,17 @@ -.. SPDX-License-Identifier: GPL-2.0+ +.. SPDX-License-Identifier: GPL-2.0-or-later .. Copyright 2014 Broadcom Corporation. Semihosting =========== -Semihosting is ARM's way of having a real or virtual target communicate -with a host or host debugger for basic operations such as file I/O, -console I/O, etc. Please see `Arm's semihosting documentation -`_ for more -information. +Semihosting is a technique to let a real or virtual target communicate with a +host or host debugger for basic operations such as file I/O, console I/O, etc. +Originally introduced by ARM it has also been adopted for RISC-V. Please, see +`Arm's semihosting documentation +`_ and +`RISC-V Semihosting +`_ +for more information. Platform Support ---------------- @@ -40,7 +43,7 @@ Foundation and Base fastmodel simulators. QEMU ^^^^ -Another ARM emulator which supports semihosting is `QEMU +Another emulator which supports semihosting is `QEMU `_. To enable semihosting, enable ``CONFIG_SERIAL_PROBE_ALL`` when configuring U-Boot, and use ``-semihosting`` when invoking QEMU. Adding ``-nographic`` can also be @@ -53,8 +56,8 @@ running QEMU, refer to the :doc:`board documentation OpenOCD ^^^^^^^ -Any ARM platform can use semihosting with an attached debugger. One such -debugger with good support for a variety of boards and JTAG adapters is +Any ARM or RISC-V platform can use semihosting with an attached debugger. One +such debugger with good support for a variety of boards and JTAG adapters is `OpenOCD `_. Semihosting is not enabled by default, so you will need to enable it:: -- 2.39.5