diff options
author | Chris Johns <chrisj@rtems.org> | 2018-05-20 08:32:42 +1200 |
---|---|---|
committer | Chris Johns <chrisj@rtems.org> | 2018-11-03 16:36:32 +1100 |
commit | 8b67c9135cb78abc394d43e449ccc6387c73f014 (patch) | |
tree | 6d4a21905a43cc4f476a1d6013baf151ce39ade5 /user/testing/gdb-jtag.rst | |
parent | waf: Add support to build PlantUML and Ditaa images. (diff) | |
download | rtems-docs-8b67c9135cb78abc394d43e449ccc6387c73f014.tar.bz2 |
user: Add RTEMS executable and test documentation.
Diffstat (limited to 'user/testing/gdb-jtag.rst')
-rw-r--r-- | user/testing/gdb-jtag.rst | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/user/testing/gdb-jtag.rst b/user/testing/gdb-jtag.rst new file mode 100644 index 0000000..367d1a2 --- /dev/null +++ b/user/testing/gdb-jtag.rst @@ -0,0 +1,28 @@ +.. comment SPDX-License-Identifier: CC-BY-SA-4.0 + +.. comment: Copyright (c) 2018 Chris Johns <chrisj@rtems.org> +.. comment: All rights reserved. + +GDB and JTAG +------------ +.. index:: GDB, JTAG, Testing + +GDB with JTAG provides a low level way to runs tests on hardware with limited +resources. The RTEMS Tester runs and controls an instance of GDB per test and +GDB connects via the GDB remote protocol to a GDB server that interfaces to the +JTAG port of a target. + +.. _fig-tester-gdb-jtag: + +.. figure:: ../../images/user/test-gdb-jtag.png + :width: 35% + :alt: RTEMS Tester using GDB and JTAG + :figclass: align-center + + RTEMS Tester using GDB and JTAG + +The :ref:`fig-tester-gdb-jtag` figure shows the structure of RTEMS Testing +using GDB and JTAG. The executables are built and the ``rtems-test`` command is +run from the top of the build directory. The RTEMS Tester executes the BSP +architecture's GDB and expects the user to provide a ``gdb-script`` to connect +t the JTAG GDB server. |