docs: Migrate MPS board documentation

Migrate docs of MPS board from its board directory to
common Documentation place.

Signed-off-by: Huang Qi <huangqi3@xiaomi.com>
This commit is contained in:
Huang Qi 2024-09-12 15:58:18 +08:00 committed by Alan C. Assis
parent 9bee10f05e
commit 75e4bd1389
4 changed files with 70 additions and 50 deletions

View File

@ -1,5 +1,6 @@
README.txt
==========
=================
MPS2 AN500 Board
=================
This board configuration will use QEMU to emulate generic ARM v7-M series
hardware platform and provides support for these devices:
@ -21,7 +22,7 @@ Getting Started
===============
1. Configuring and running
1.1 Single Core
Configuring NuttX and compile:
$ ./tools/configure.sh -l mps2-an500:nsh
$ make

View File

@ -0,0 +1,54 @@
=================
MPS3 AN547 Board
=================
The MPS3 AN547 board configuration uses QEMU to emulate a generic ARM v8-M series hardware platform and provides support for the following devices:
- ARM Generic Timer
- CMSDK UART controller
Getting Started
===============
Configuring and Running
-----------------------
### Single Core
1. **Configuring NuttX and Compiling:**
```bash
$ ./tools/configure.sh -l mps3-an547:nsh
$ make
```
2. **Running with QEMU:**
```bash
$ qemu-system-arm -M mps3-an547 -nographic -kernel nuttx.bin
```
Debugging with QEMU
===================
The NuttX ELF image can be debugged using QEMU.
1. **Enable Debug Symbols:**
Ensure the following change is applied to `defconfig`:
```bash
+CONFIG_DEBUG_SYMBOLS=y
```
2. **Run QEMU:**
```bash
$ qemu-system-arm -M mps3-an547 -nographic -kernel nuttx.bin -S -s
```
3. **Run GDB with TUI:**
```bash
$ arm-none-eabi-gdb -tui --eval-command='target remote localhost:1234' nuttx
```

View File

@ -0,0 +1,12 @@
====
MPS
====
Supported Boards
================
.. toctree::
:glob:
:maxdepth: 1
boards/*/*

View File

@ -1,47 +0,0 @@
README.txt
==========
This board configuration will use QEMU to emulate generic ARM v8-M series
hardware platform and provides support for these devices:
- ARM Generic Timer
- CMSDK UART controller
Contents
========
- Getting Started
- Status
- Platform Features
- Debugging with QEMU
- FPU Support and Performance
- SMP Support
- References
Getting Started
===============
1. Configuring and running
1.1 Single Core
Configuring NuttX and compile:
$ ./tools/configure.sh -l mps3-an547:nsh
$ make
Running with qemu
$ qemu-system-arm -M mps3-an547 -nographic -kernel nuttx.bin
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.
+CONFIG_DEBUG_SYMBOLS=y
2. Run QEMU(at shell terminal 1)
$ qemu-system-arm -M mps3-an547 -nographic -kernel nuttx.bin -S -s
3. Run gdb with TUI, connect to QEMU, load nuttx and continue (at shell terminal 2)
$ arm-none-eabi-gdb -tui --eval-command='target remote localhost:1234' nuttx