Changeset 55d69ad in rtems-docs


Ignore:
Timestamp:
12/27/19 12:01:46 (2 years ago)
Author:
G S Niteesh <gsnb.gn@…>
Branches:
5, am, master
Children:
565df31
Parents:
d412c5b
git-author:
G S Niteesh <gsnb.gn@…> (12/27/19 12:01:46)
git-committer:
Christian Mauderer <oss@…> (01/07/20 18:32:38)
Message:

Updated docs to use the standalone SIS simulator, instead of GDB inbuilt SIS for the erc32 BSP.

Location:
user
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • user/start/bsp-test.rst

    rd412c5b r55d69ad  
    2222
    2323    cd $HOME/quick-start/build/b-erc32
    24     rtems-test --rtems-bsp=erc32 --rtems-tools=$HOME/quick-start/rtems/5 .
     24    rtems-test --rtems-bsp=erc32-sis --rtems-tools=$HOME/quick-start/rtems/5 .
    2525
    2626This command should output something like this (omitted lines are denoted by
     
    3131
    3232    RTEMS Testing - Tester, 5.0.not_released
    33      Command Line: $BASE/rtems/5/bin/rtems-test --rtems-bsp=erc32 --rtems-tools=$BASE/rtems/5 .
     33     Command Line: $BASE/rtems/5/bin/rtems-test --rtems-bsp=erc32-sis --rtems-tools=$BASE/rtems/5 .
    3434     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)]
    3535    Host: FreeBSD-12.0-RELEASE-p2-amd64-64bit-ELF (FreeBSD Build_FreeBSD12 12.0-RELEASE-p2 FreeBSD 12.0-RELEASE-p2 GENERIC amd64 amd64)
  • user/tools/tester.rst

    rd412c5b r55d69ad  
    110110The run command is the GDB simulator without the GDB part.
    111111
    112 Running the example using GDB:
     112Running the example using SIS:
     113
     114.. code-block:: none
     115
     116    $ sparc-rtems5-sis sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
     117    SIS - SPARC/RISCV instruction simulator 2.20,  copyright Jiri Gaisler 2019
     118    Bug-reports to jiri@gaisler.se
     119    ERC32 emulation enabled
     120
     121    Loaded sparc-rtems5/c/erc32/testsuites/samples/hello.exe, entry 0x02000000
     122
     123    sis> run
     124
     125
     126    *** BEGIN OF TEST HELLO WORLD ***
     127    *** TEST VERSION: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
     128    *** TEST STATE: EXPECTED-PASS
     129    *** TEST BUILD: RTEMS_POSIX_API
     130    *** TEST TOOLS: 7.5.0 20191114 (RTEMS 5, RSB 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
     131    Hello World
     132
     133    *** END OF TEST HELLO WORLD ***
     134
     135
     136    *** FATAL ***
     137    fatal source: 0 (INTERNAL_ERROR_CORE)
     138    fatal code: 5 (INTERNAL_ERROR_THREAD_EXITTED)
     139    RTEMS version: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
     140    RTEMS tools: 7.5.0 20191114 (RTEMS 5, RSB 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
     141    executing thread ID: 0x08a010001
     142    executing thread name: UI1
     143    cpu 0 in error mode (tt = 0x101)
     144        116401  02009ae0:  91d02000   ta  0x0
     145
     146    sis> q
     147
     148The examples can also be run using GDB with SIS as the backend. SIS can be connected to
     149gdb through a network socket using the gdb remote interface.
     150
     151Either start SIS with ``-gdb``, or issue the ``gdb`` command inside SIS, and connect
     152gdb with ``target remote:1234``. The default port is ``1234``, the port can be changed
     153using the ``-port`` option.
     154
     155Open a terminal and issue the command:
     156
     157.. code-block:: none
     158
     159    $ sparc-rtems5-sis -gdb
     160    SIS - SPARC/RISCV instruction simulator 2.20,  copyright Jiri Gaisler 2019
     161    Bug-reports to jiri@gaisler.se
     162    ERC32 emulation enabled
     163
     164    gdb: listening on port 1234
     165
     166Now open another terminal and issue the command:
    113167
    114168.. code-block:: none
    115169
    116170    $ sparc-rtems5-gdb sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
    117     GNU gdb (GDB) 7.12
    118     Copyright (C) 2016 Free Software Foundation, Inc.
     171    GNU gdb (GDB) 8.3
     172    Copyright (C) 2019 Free Software Foundation, Inc.
    119173    License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
    120174    This is free software: you are free to change and redistribute it.
    121     There is NO WARRANTY, to the extent permitted by law.  Type "show copying"
    122     and "show warranty" for details.
     175    There is NO WARRANTY, to the extent permitted by law.
     176    Type "show copying" and "show warranty" for details.
    123177    This GDB was configured as "--host=x86_64-linux-gnu --target=sparc-rtems5".
    124178    Type "show configuration" for configuration details.
     
    126180    <http://www.gnu.org/software/gdb/bugs/>.
    127181    Find the GDB manual and other documentation resources online at:
    128     <http://www.gnu.org/software/gdb/documentation/>.
     182        <http://www.gnu.org/software/gdb/documentation/>.
     183
    129184    For help, type "help".
    130185    Type "apropos word" to search for commands related to "word"...
    131     Reading symbols from
    132     sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe...done.
    133     (gdb) target sim
    134     Connected to the simulator.
     186    Reading symbols from sparc-rtems5/c/erc32/testsuites/samples/hello.exe...
     187    (gdb) target remote:1234
     188
     189The ``target remote:1234`` will tell gdb to connect to the sis simulator. After this
     190command the output of the first terminal will change to
     191
     192.. code-block:: none
     193
     194    $ sparc-rtems5-sis -gdb
     195    SIS - SPARC/RISCV instruction simulator 2.20,  copyright Jiri Gaisler 2019
     196    Bug-reports to jiri@gaisler.se
     197    ERC32 emulation enabled
     198
     199    gdb: listening on port 1234 connected
     200
     201Before running the executable, it must be loaded, this is done using the
     202``load`` command in gdb, and to run, issue ``continue`` command.
     203
     204.. code-block:: none
     205
     206    $ sparc-rtems5-gdb sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
     207    GNU gdb (GDB) 8.3
     208    Copyright (C) 2019 Free Software Foundation, Inc.
     209    License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
     210    This is free software: you are free to change and redistribute it.
     211    There is NO WARRANTY, to the extent permitted by law.
     212    Type "show copying" and "show warranty" for details.
     213    This GDB was configured as "--host=x86_64-linux-gnu --target=sparc-rtems5".
     214    Type "show configuration" for configuration details.
     215    For bug reporting instructions, please see:
     216    <http://www.gnu.org/software/gdb/bugs/>.
     217    Find the GDB manual and other documentation resources online at:
     218        <http://www.gnu.org/software/gdb/documentation/>.
     219
     220    For help, type "help".
     221    Type "apropos word" to search for commands related to "word"...
     222    Reading symbols from sparc-rtems5/c/erc32/testsuites/samples/hello.exe...
     223    (gdb) target remote:1234
     224    Remote debugging using :1234
     225    0x00000000 in ?? ()
    135226    (gdb) load
    136     (gdb) r
    137     Starting program: sparc-rtems5/c/erc32/testsuites/samples/hello/hello.exe
     227    Loading section .text, size 0x17170 lma 0x2000000
     228    Loading section .rtemsroset, size 0x40 lma 0x2017170
     229    Loading section .data, size 0x600 lma 0x20181c0
     230    Start address 0x2000000, load size 96176
     231    Transfer rate: 4696 KB/sec, 270 bytes/write.
     232    (gdb) continue
     233    Continuing.
     234
     235You can see your executable running in the first terminal.
     236
     237.. code-block:: none
     238
     239    SIS - SPARC/RISCV instruction simulator 2.20,  copyright Jiri Gaisler 2019
     240    Bug-reports to jiri@gaisler.se
     241
     242    ERC32 emulation enabled
     243
     244    gdb: listening on port 1235 connected
     245    X2000000,0:#40
    138246
    139247
    140248    *** BEGIN OF TEST HELLO WORLD ***
     249    *** TEST VERSION: 5.0.0.c6d8589bb00a9d2a5a094c68c90290df1dc44807
     250    *** TEST STATE: EXPECTED-PASS
     251    *** TEST BUILD: RTEMS_POSIX_API
     252    *** TEST TOOLS: 7.5.0 20191114 (RTEMS 5, RSB 83fa79314dd87c0a8c78fd642b2cea3138be8dd6, Newlib 3e24fbf6f)
    141253    Hello World
     254
    142255    *** END OF TEST HELLO WORLD ***
    143     [Inferior 1 (process 42000) exited normally]
    144     (gdb) q
     256
     257    ^Csis> q
     258
     259
     260For more information on the sis simulator refer to this doc: https://gaisler.se/sis/sis.pdf
    145261
    146262The command ``r`` is used to debug set break points before issuing the GDB
Note: See TracChangeset for help on using the changeset viewer.