Pushed. Thanks.
On 27/12/2019 13:01, G S Niteesh 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 j...@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 j...@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 j...@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 j...@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. > _______________________________________________ devel mailing list devel@rtems.org http://lists.rtems.org/mailman/listinfo/devel
