nuttx/Documentation/platforms/arm/mps/boards/mps2-an500/index.rst
Huang Qi 75e4bd1389 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>
2024-09-12 10:26:08 -03:00

49 lines
1.1 KiB
ReStructuredText

=================
MPS2 AN500 Board
=================
This board configuration will use QEMU to emulate generic ARM v7-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
Configuring NuttX and compile:
$ ./tools/configure.sh -l mps2-an500:nsh
$ make
Running with qemu
$ qemu-system-arm -M mps2-an500 -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 mps2-an500 -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