Warning, /bsps/sh/shsim/README.md is written in an unsupported language. File is not indexed.
0001 shsim
0002 =====
0003
0004 Simple BSP for the SH simulator built into gdb.
0005
0006 Simulator Invocation
0007 --------------------
0008 ```shell
0009 sh-rtems[elf|]-gdb <executable>
0010 (gdb) target sim
0011 (gdb) set archi [sh|sh2]
0012 (gdb) load <executable>
0013 (gdb) run
0014 ```
0015
0016 Status
0017 ------
0018 * The simulator invocation procedure outlined above produces error messages
0019 with gdb-5.0, nevertheless seems to work. With gdb versions > 5.0 these
0020 error messages are gone. I.e. if you plan to seriously work with the gdb
0021 simulator better use gdb versions > 5.0.
0022
0023 * gdb's simulator is not able to correctly emulate memory areas esp. shadowing
0024 and non-consecutive memory. I.e. access to memory areas besides area 0 will
0025 (bogusly) generate SIGBUS exceptions. This includes access to area 5
0026 (On-chip peripherials) and prevents simulation of configuration and access
0027 to on-chip peripherials.
0028
0029 * Due to limitations of the simulator you will only be able to run
0030 applications which do not try to access any SH control registers.
0031
0032 Currently, this excludes all applications, which apply timers and serial
0033 devices, i.e. almost any real world application.
0034
0035 * This BSP supports 3 different console devices (cf. configure --help):
0036 - trap34, an interface base on gdb's trap34 emulation. Known to work with
0037 gdb-5.0.
0038 - gdbsci1, a stripped down sci device driver adapted to apply gdb's sci1
0039 emulation. This is known to fail with gdb-5.0, because of a bug in gdb-5.0's
0040 sh-sim, a patch is submitted, but .. ~==
0041 - devnull, redirection of console io to /dev/null. Try to single step this,
0042 if you want to understand the details on how SH-RTEMS console redirection
0043 works.
0044
0045 NOTE: the trap34 interface is incomplete and is temporarily disabled
0046 inside of configure.in.
