michaelh/zephyr
1
0
Fork 0
Code Releases Activity

board: nsim: doc update for debugging section

Browse source 
doc update for debugging dection for #17547 issue.

Signed-off-by: Watson Zeng <zhiwei@synopsys.com>
This commit is contained in:
Watson Zeng 2019-08-14 09:25:54 +08:00 • committed by Andrew Boie
commit 7064033473
1 changed files with 29 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

30
boards/arc/nsim/doc/index.rst
View file

@ -84,7 +84,35 @@ nsim, and display the following console output:
Debugging
=========
Refer to the detailed overview about :ref:`application_debugging`.
.. note::
The normal ``make debug`` command won't work for debugging
applications using nsim because both the nsim simulator and the
gdb debugger use the console for output. You need to use separate
terminal windows for each tool to avoid intermixing their output.
After building your application, cd to the build folder and open two
terminal windows. In terminal one, use nsim to start a GDB server
and wait for a remote connection:
.. code-block:: console
# for ninja build system:
ninja debugserver
# for make build system:
make debugserver
In terminal two, connect to the GDB server using :file:`arc-elf32-gdb`.
This command loads the symbol table from the elf binary file, for example
the :file:`./zephyr/zephyr.elf` file:
.. code-block:: console
..../path/to/arc-elf32-gdb zephyr/zephyr.elf
(gdb) target remote : 3333
(gdb) load
Now the debug environment has been set up, you can debug the application with gdb commands.
References
**********