incubator-nuttx/boards/arm/mps/mps3-an547

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