hartmannathan commented on code in PR #18264:
URL: https://github.com/apache/nuttx/pull/18264#discussion_r2742328085
##########
Documentation/platforms/arm/qemu/boards/qemu-armv7r/index.rst:
##########
@@ -0,0 +1,109 @@
+===========
+qemu-armv7r
+===========
+
+This board configuration will use QEMU to emulate generic ARM v7-R series
+hardware platform and provides support for these devices:
+
+* ARM Generic Timer
+* PL011 UART controller
+* VirtIO Device
+
+.. note::
+ The upstream QEMU does not support ARM Cortex-R virt machine. This board
Review Comment:
Did you mean 'virtual' instead of 'virt'?
```suggestion
The upstream QEMU does not support ARM Cortex-R virtual machine. This
board
```
##########
Documentation/platforms/arm/qemu/boards/qemu-armv7r/index.rst:
##########
@@ -0,0 +1,109 @@
+===========
+qemu-armv7r
+===========
+
+This board configuration will use QEMU to emulate generic ARM v7-R series
+hardware platform and provides support for these devices:
+
+* ARM Generic Timer
+* PL011 UART controller
+* VirtIO Device
+
+.. note::
+ The upstream QEMU does not support ARM Cortex-R virt machine. This board
+ uses the OpenVela QEMU fork which adds ARM Cortex-R support. You can find
+ the source code and prebuilt binaries at:
+ https://github.com/open-vela/platform_external_qemu/commits/trunk/
+
+Prerequisites
+=============
+
+Download and extract the prebuilt QEMU from OpenVela. For Linux x86_64,
download from:
+https://github.com/open-vela/prebuilts_qemu_linux-x86_64
+
+The QEMU binary path will be referred to as ``<QEMU_PATH>`` in the following
sections::
+
+ # Example path structure after extraction:
+ # <QEMU_PATH>/bin/qemu-system-arm
+ # <QEMU_PATH>/share/qemu/
+
+.. note::
+ The ``-L`` option is required because the QEMU shared resources are not
+ installed to system directories. It specifies the directory for the QEMU
+ BIOS and device tree files.
+
+Getting Started
+===============
+
+NSH (Flat Build)
+----------------
+
+Configuring NuttX and compile::
+
+ $ ./tools/configure.sh -l qemu-armv7r:nsh
+ $ make -j`nproc`
+
+Running with qemu::
+
+ $ <QEMU_PATH>/bin/qemu-system-arm \
+ -L <QEMU_PATH>/share/qemu \
+ -M virt -semihosting -nographic -cpu cortex-r5f \
+ -kernel ./nuttx
+
+PNSH (Protected Build)
+----------------------
+
+This is a configuration for testing the BUILD_PROTECTED configuration
+with MPU support::
+
+ $ cd nuttx
+ $ ./tools/configure.sh qemu-armv7r:pnsh
+ $ make -j`nproc`
+
+Running with qemu (note: both nuttx and nuttx_user must be loaded)::
+
+ $ <QEMU_PATH>/bin/qemu-system-arm \
+ -L <QEMU_PATH>/share/qemu \
+ -M virt -semihosting -nographic -cpu cortex-r5f \
+ -device loader,file=./nuttx_user \
+ -device loader,file=./nuttx
+
+Debugging with QEMU
+===================
+
+The nuttx ELF image can be debugged with QEMU.
+
+1. To debug the nuttx (ELF) with symbols, make sure the following change have
+ applied to defconfig::
Review Comment:
```suggestion
been applied to defconfig::
```
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
