samples: debug/gdbstub: update instructions to run

This corrects the directory pointing to sample in the README
file. Also changes the TCP port number for the second serial
port exposing the GDB stub. This allows QEMU itself to expose
GDB interface through port 1234, and Zephyr's GDB stub at
port 5678.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>
This commit is contained in:
Daniel Leung 2021-10-14 15:03:38 -07:00 committed by Anas Nashif
commit 917b3cf7c0
2 changed files with 8 additions and 8 deletions

View file

@ -3,7 +3,7 @@
cmake_minimum_required(VERSION 3.20.0)
if(BOARD MATCHES "qemu_x86")
list(APPEND QEMU_EXTRA_FLAGS -serial tcp:127.0.0.1:1234,server)
list(APPEND QEMU_EXTRA_FLAGS -serial tcp:127.0.0.1:5678,server)
endif()
find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})

View file

@ -1,13 +1,13 @@
.. _debug_sample:
.. _gdb_debug_sample:
Debug Sample
############
GDB Debug Sample
################
Overview
********
A simple sample that can be used with qemu to show debug using gdb
remote serial protocol capabilities.
A simple sample that can be used with QEMU to show debug using GDB
Remote Serial Protocol (RSP) capabilities.
Building and Running
********************
@ -15,7 +15,7 @@ Building and Running
This application can be built and executed on QEMU as follows:
.. zephyr-app-commands::
:zephyr-app: samples/debug
:zephyr-app: samples/subsys/debug/gdbstub
:host-os: unix
:board: qemu_x86
:goals: run
@ -26,6 +26,6 @@ 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
(gdb) target remote :5678
Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.