diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2018-04-25 15:06:08 +0200 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2018-04-26 07:17:57 +0200 |
commit | eb36d1198cdf9dc1e2f776ef6e1e38755f6d13c5 (patch) | |
tree | 14177ad7a58c06a3c537d1e55dae7bc369a1a4b9 /bsps/sh/shsim/README | |
parent | bsps: Remove unmaintained times files (diff) | |
download | rtems-eb36d1198cdf9dc1e2f776ef6e1e38755f6d13c5.tar.bz2 |
bsps: Move documentation, etc. files to bsps
This patch is a part of the BSP source reorganization.
Update #3285.
Diffstat (limited to 'bsps/sh/shsim/README')
-rw-r--r-- | bsps/sh/shsim/README | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/bsps/sh/shsim/README b/bsps/sh/shsim/README new file mode 100644 index 0000000000..866fedafa2 --- /dev/null +++ b/bsps/sh/shsim/README @@ -0,0 +1,42 @@ +Simple BSP for the SH simulator built into gdb. + +Simulator Invocation +==================== +sh-rtems[elf|]-gdb <executable> +(gdb) target sim +(gdb) set archi [sh|sh2] +(gdb) load <executable> +(gdb) run + +Status +====== + +* The simulator invocation procedure outlined above produces error messages +with gdb-5.0, nevertheless seems to work. With gdb versions > 5.0 these +error messages are gone. I.e. if you plan to seriously work with the gdb +simulator better use gdb versions > 5.0. + +* gdb's simulator is not able to correctly emulate memory areas esp. shadowing +and non-consecutive memory. I.e. access to memory areas besides area 0 will +(bogusly) generate SIGBUS exceptions. This includes access to area 5 +(On-chip peripherials) and prevents simulation of configuration and access +to on-chip peripherials. + +* Due to limitations of the simulator you will only be able to run +applications which do not try to access any SH control registers. + +Currently, this excludes all applications, which apply timers and serial +devices, i.e. almost any real world application. + +* This BSP supports 3 different console devices (cf. configure --help): +- trap34, an interface base on gdb's trap34 emulation. Known to work with + gdb-5.0. +- gdbsci1, a stripped down sci device driver adapted to apply gdb's sci1 +emulation. This is known to fail with gdb-5.0, because of a bug in gdb-5.0's +sh-sim, a patch is submitted, but .. ~== +- devnull, redirection of console io to /dev/null. Try to single step this, +if you want to understand the details on how SH-RTEMS console redirection +works. + +NOTE: the trap34 interface is incomplete and is temporarily disabled +inside of configure.in. |