[PATCH] Updated docs to use the standalone SIS simulator, instead of GDB inbuilt SIS for the erc32 BSP.
Christian Mauderer
list at c-mauderer.de
Sat Jan 4 19:29:57 UTC 2020
Gedare acknowledged it so I'll push it together with the other RTEMS
patches in a few days.
On 04/01/2020 08:18, Niteesh wrote:
> Just a reminder, it's almost been a week since I sent the patch. I also
> sent it a month ago, but it slipped from everyone's eyes.
>
> On Thu, Jan 2, 2020 at 9:45 PM Gedare Bloom <gedare at rtems.org
> <mailto:gedare at rtems.org>> wrote:
>
> looks good to me.
>
> On Fri, Dec 27, 2019 at 5:02 AM G S Niteesh <gsnb.gn at gmail.com
> <mailto:gsnb.gn at gmail.com>> wrote:
> >
> > ---
> > user/start/bsp-test.rst | 4 +-
> > user/tools/tester.rst | 144
> ++++++++++++++++++++++++++++++++++++----
> > 2 files changed, 132 insertions(+), 16 deletions(-)
> >
> > diff --git a/user/start/bsp-test.rst b/user/start/bsp-test.rst
> > index 5278375..aefeeb9 100644
> > --- a/user/start/bsp-test.rst
> > +++ b/user/start/bsp-test.rst
> > @@ -21,7 +21,7 @@ Just run this command:
> > .. code-block:: none
> >
> > cd $HOME/quick-start/build/b-erc32
> > - rtems-test --rtems-bsp=erc32
> --rtems-tools=$HOME/quick-start/rtems/5 .
> > + rtems-test --rtems-bsp=erc32-sis
> --rtems-tools=$HOME/quick-start/rtems/5 .
> >
> > This command should output something like this (omitted lines are
> denoted by
> > ...). In this output the base directory
> :file:`$HOME/quick-start` was replaced
> > @@ -30,7 +30,7 @@ by ``$BASE``.
> > .. code-block:: none
> >
> > RTEMS Testing - Tester, 5.0.not_released
> > - Command Line: $BASE/rtems/5/bin/rtems-test --rtems-bsp=erc32
> --rtems-tools=$BASE/rtems/5 .
> > + Command Line: $BASE/rtems/5/bin/rtems-test
> --rtems-bsp=erc32-sis --rtems-tools=$BASE/rtems/5 .
> > Python: 2.7.15 (default, Jan 10 2019, 01:14:47) [GCC 4.2.1
> Compatible FreeBSD Clang 6.0.1 (tags/RELEASE_601/final 335540)]
> > Host: FreeBSD-12.0-RELEASE-p2-amd64-64bit-ELF (FreeBSD
> Build_FreeBSD12 12.0-RELEASE-p2 FreeBSD 12.0-RELEASE-p2 GENERIC
> amd64 amd64)
> > [ 1/589] p:0 f:0 u:0 e:0 I:0 B:0 t:0 i:0
> W:0 | sparc/erc32: dhrystone.exe
> > diff --git a/user/tools/tester.rst b/user/tools/tester.rst
> > index 609384b..c3c3fe2 100644
> > --- a/user/tools/tester.rst
> > +++ b/user/tools/tester.rst
> > @@ -109,39 +109,155 @@ the tests. Using the run with the ERC32 BSP
> the command is:
> >
> > The run command is the GDB simulator without the GDB part.
> >
> > -Running the example using GDB:
> > +Running the example using SIS:
> > +
> > +.. code-block:: none
> > +
> > + $ sparc-rtems5-sis
> sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
> > + SIS - SPARC/RISCV instruction simulator 2.20, copyright Jiri
> Gaisler 2019
> > + Bug-reports to jiri at gaisler.se <mailto:jiri at gaisler.se>
> > + ERC32 emulation enabled
> > +
> > + Loaded sparc-rtems5/c/erc32/testsuites/samples/hello.exe,
> entry 0x02000000
> > +
> > + sis> run
> > +
> > +
> > + *** BEGIN OF TEST HELLO WORLD ***
> > + *** TEST VERSION: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
> > + *** TEST STATE: EXPECTED-PASS
> > + *** TEST BUILD: RTEMS_POSIX_API
> > + *** TEST TOOLS: 7.5.0 20191114 (RTEMS 5, RSB
> 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
> > + Hello World
> > +
> > + *** END OF TEST HELLO WORLD ***
> > +
> > +
> > + *** FATAL ***
> > + fatal source: 0 (INTERNAL_ERROR_CORE)
> > + fatal code: 5 (INTERNAL_ERROR_THREAD_EXITTED)
> > + RTEMS version: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
> > + RTEMS tools: 7.5.0 20191114 (RTEMS 5, RSB
> 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
> > + executing thread ID: 0x08a010001
> > + executing thread name: UI1
> > + cpu 0 in error mode (tt = 0x101)
> > + 116401 02009ae0: 91d02000 ta 0x0
> > +
> > + sis> q
> > +
> > +The examples can also be run using GDB with SIS as the backend.
> SIS can be connected to
> > +gdb through a network socket using the gdb remote interface.
> > +
> > +Either start SIS with ``-gdb``, or issue the ``gdb`` command
> inside SIS, and connect
> > +gdb with ``target remote:1234``. The default port is ``1234``,
> the port can be changed
> > +using the ``-port`` option.
> > +
> > +Open a terminal and issue the command:
> > +
> > +.. code-block:: none
> > +
> > + $ sparc-rtems5-sis -gdb
> > + SIS - SPARC/RISCV instruction simulator 2.20, copyright Jiri
> Gaisler 2019
> > + Bug-reports to jiri at gaisler.se <mailto:jiri at gaisler.se>
> > + ERC32 emulation enabled
> > +
> > + gdb: listening on port 1234
> > +
> > +Now open another terminal and issue the command:
> >
> > .. code-block:: none
> >
> > $ sparc-rtems5-gdb
> sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
> > - GNU gdb (GDB) 7.12
> > - Copyright (C) 2016 Free Software Foundation, Inc.
> > + GNU gdb (GDB) 8.3
> > + Copyright (C) 2019 Free Software Foundation, Inc.
> > License GPLv3+: GNU GPL version 3 or later
> <http://gnu.org/licenses/gpl.html>
> > This is free software: you are free to change and
> redistribute it.
> > - There is NO WARRANTY, to the extent permitted by law. Type
> "show copying"
> > - and "show warranty" for details.
> > + There is NO WARRANTY, to the extent permitted by law.
> > + Type "show copying" and "show warranty" for details.
> > This GDB was configured as "--host=x86_64-linux-gnu
> --target=sparc-rtems5".
> > Type "show configuration" for configuration details.
> > For bug reporting instructions, please see:
> > <http://www.gnu.org/software/gdb/bugs/>.
> > Find the GDB manual and other documentation resources online at:
> > - <http://www.gnu.org/software/gdb/documentation/>.
> > + <http://www.gnu.org/software/gdb/documentation/>.
> > +
> > For help, type "help".
> > Type "apropos word" to search for commands related to "word"...
> > - Reading symbols from
> > - sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe...done.
> > - (gdb) target sim
> > - Connected to the simulator.
> > + Reading symbols from
> sparc-rtems5/c/erc32/testsuites/samples/hello.exe...
> > + (gdb) target remote:1234
> > +
> > +The ``target remote:1234`` will tell gdb to connect to the sis
> simulator. After this
> > +command the output of the first terminal will change to
> > +
> > +.. code-block:: none
> > +
> > + $ sparc-rtems5-sis -gdb
> > + SIS - SPARC/RISCV instruction simulator 2.20, copyright Jiri
> Gaisler 2019
> > + Bug-reports to jiri at gaisler.se <mailto:jiri at gaisler.se>
> > + ERC32 emulation enabled
> > +
> > + gdb: listening on port 1234 connected
> > +
> > +Before running the executable, it must be loaded, this is done
> using the
> > +``load`` command in gdb, and to run, issue ``continue`` command.
> > +
> > +.. code-block:: none
> > +
> > + $ sparc-rtems5-gdb
> sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
> > + GNU gdb (GDB) 8.3
> > + Copyright (C) 2019 Free Software Foundation, Inc.
> > + License GPLv3+: GNU GPL version 3 or later
> <http://gnu.org/licenses/gpl.html>
> > + This is free software: you are free to change and
> redistribute it.
> > + There is NO WARRANTY, to the extent permitted by law.
> > + Type "show copying" and "show warranty" for details.
> > + This GDB was configured as "--host=x86_64-linux-gnu
> --target=sparc-rtems5".
> > + Type "show configuration" for configuration details.
> > + For bug reporting instructions, please see:
> > + <http://www.gnu.org/software/gdb/bugs/>.
> > + Find the GDB manual and other documentation resources online at:
> > + <http://www.gnu.org/software/gdb/documentation/>.
> > +
> > + For help, type "help".
> > + Type "apropos word" to search for commands related to "word"...
> > + Reading symbols from
> sparc-rtems5/c/erc32/testsuites/samples/hello.exe...
> > + (gdb) target remote:1234
> > + Remote debugging using :1234
> > + 0x00000000 in ?? ()
> > (gdb) load
> > - (gdb) r
> > - Starting program:
> sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
> > + Loading section .text, size 0x17170 lma 0x2000000
> > + Loading section .rtemsroset, size 0x40 lma 0x2017170
> > + Loading section .data, size 0x600 lma 0x20181c0
> > + Start address 0x2000000, load size 96176
> > + Transfer rate: 4696 KB/sec, 270 bytes/write.
> > + (gdb) continue
> > + Continuing.
> > +
> > +You can see your executable running in the first terminal.
> > +
> > +.. code-block:: none
> > +
> > + SIS - SPARC/RISCV instruction simulator 2.20, copyright Jiri
> Gaisler 2019
> > + Bug-reports to jiri at gaisler.se <mailto:jiri at gaisler.se>
> > +
> > + ERC32 emulation enabled
> > +
> > + gdb: listening on port 1235 connected
> > + X2000000,0:#40
> >
> >
> > *** BEGIN OF TEST HELLO WORLD ***
> > + *** TEST VERSION: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
> > + *** TEST STATE: EXPECTED-PASS
> > + *** TEST BUILD: RTEMS_POSIX_API
> > + *** TEST TOOLS: 7.5.0 20191114 (RTEMS 5, RSB
> 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
> > Hello World
> > +
> > *** END OF TEST HELLO WORLD ***
> > - [Inferior 1 (process 42000) exited normally]
> > - (gdb) q
> > +
> > + ^Csis> q
> > +
> > +
> > +For more information on the sis simulator refer to this doc:
> https://gaisler.se/sis/sis.pdf
> >
> > The command ``r`` is used to debug set break points before
> issuing the GDB
> > ``run`` command.
> > --
> > 2.17.1
> >
> > _______________________________________________
> > devel mailing list
> > devel at rtems.org <mailto:devel at rtems.org>
> > http://lists.rtems.org/mailman/listinfo/devel
>
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
>
More information about the devel
mailing list