zephyr/samples/debug/gdbstub
Flavio Ceolin 179e184e30 samples: debug: Add a simple gdbstub sample
Sample example built with gdbstub enabled. Two serials are used, one for
normal output and another one that is used talk with gdb in the host
machine.

Signed-off-by: Flavio Ceolin <flavio.ceolin@intel.com>
2020-09-02 20:54:57 -04:00
..
src samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00
CMakeLists.txt samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00
README.rst samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00
prj.conf samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00
run.gdbinit samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00
sample.yaml samples: debug: Add a simple gdbstub sample 2020-09-02 20:54:57 -04:00

README.rst

.. _debug_sample:

Debug Sample
############

Overview
********

A simple sample that can be used with qemu to show debug using gdb
remote serial protocol capabilities.

Building and Running
********************

This application can be built and executed on QEMU as follows:

.. zephyr-app-commands::
   :zephyr-app: samples/debug
   :host-os: unix
   :board: qemu_x86
   :goals: run
   :compact:

Open a new terminal and use gdb to connect to the running qemu as follows:

.. code-block:: bash

    gdb build/zephyr/zephyr.elf
    (gdb) target remote :1234

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.