aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorRoland Pesch <pesch@cygnus>1994-03-26 02:25:09 +0000
committerRoland Pesch <pesch@cygnus>1994-03-26 02:25:09 +0000
commit2ded09f551117b8c08f03a7f250ee83d1742490d (patch)
tree5d0e0f35417a9a8c178b9e9b5e5f7c6823df3c1c /gdb/doc
parentc6889f632328e8254497f8fdfd5d391fc6000bab (diff)
downloadgdb-2ded09f551117b8c08f03a7f250ee83d1742490d.zip
gdb-2ded09f551117b8c08f03a7f250ee83d1742490d.tar.gz
gdb-2ded09f551117b8c08f03a7f250ee83d1742490d.tar.bz2
Updates for Hitachi targets.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/remote.texi71
1 files changed, 64 insertions, 7 deletions
diff --git a/gdb/doc/remote.texi b/gdb/doc/remote.texi
index d21ecb1..3abe483 100644
--- a/gdb/doc/remote.texi
+++ b/gdb/doc/remote.texi
@@ -1048,27 +1048,38 @@ the time of attachment.
@ifset H8
@node Hitachi Remote
-@subsection @value{GDBN} and Hitachi Microprocessors
+@subsection @value{GDBN} and Hitachi microprocessors
@value{GDBN} needs to know these things to talk to your
Hitachi SH, H8/300, or H8/500:
@enumerate
@item
that you want to use @samp{target hms}, the remote debugging interface
-for Hitachi microprocessors (this is the default when GDB is configured
-specifically for the Hitachi SH, H8/300, or H8/500);
+for Hitachi microprocessors, or @samp{target e7000}, the in-circuit
+emulator for the Hitachi SH and the Hitachi 300H. (@samp{target hms} is
+the default when GDB is configured specifically for the Hitachi SH,
+H8/300, or H8/500.)
@item
what serial device connects your host to your Hitachi board (the first
-serial device available on your host is the default);
+serial device available on your host is the default).
-@ignore
-@c this is only for Unix hosts, not currently of interest.
+@ifclear H8EXCLUSIVE
+@c this is only for Unix hosts, not of interest to Hitachi
@item
what speed to use over the serial device.
-@end ignore
+@end ifclear
@end enumerate
+@menu
+* Hitachi Boards:: Connecting to Hitachi boards
+* Hitachi ICE:: Using the E7000 In-Circuit Emulator
+* H8500 Special:: Special @value{GDBN} commands for the H8/500
+@end menu
+
+@node Hitachi Boards
+@subsubsection Connecting to Hitachi boards
+
@ifclear H8EXCLUSIVE
@c only for Unix hosts
@kindex device
@@ -1181,6 +1192,52 @@ to detect program completion.
In either case, @value{GDBN} sees the effect of a @sc{reset} on the
development board as a ``normal exit'' of your program.
+
+@node Hitachi ICE
+@subsubsection Using the E7000 in-circuit emulator
+
+@kindex target e7000
+You can use the E7000 in-circuit emulator to develop code for either the
+Hitachi SH or the H8/300H. Use one of these forms of the @samp{target
+e7000} command to connect @value{GDBN} to your E7000:
+
+@table @code
+@item target e7000 @var{port} @var{speed}
+Use this form if your E7000 is connected to a serial port. The
+@var{port} argument identifies what serial port to use (for example,
+@samp{com2}). The third argument is the line speed in bits per second
+(for example, @samp{9600}).
+
+@item target e7000 @var{hostname}
+If your E7000 is installed as a host on a TCP/IP network, you can just
+specify its hostname; @value{GDBN} uses @code{telnet} to connect.
+@end table
+
+@node Hitachi Special
+@subsubsection Special @value{GDBN} commands for Hitachi micros
+
+Some @value{GDBN} commands are available only on the H8/300 or the
+H8/500 configurations:
+
+@table @code
+@kindex set machine
+@kindex show machine
+@item set machine h8300
+@itemx set machine h8300h
+Condition @value{GDBN} for one of the two variants of the H8/300
+architecture with @samp{set machine}. You can use @samp{show machine}
+to check which variant is currently in effect.
+
+@kindex set memory @var{mod}
+@cindex memory models, H8/500
+@item set memory @var{mod}
+@itemx show memory
+Specify which H8/500 memory model (@var{mod}) you are using with
+@samp{set memory}; check which memory model is in effect with @samp{show
+memory}. The accepted values for @var{mod} are @code{small},
+@code{big}, @code{medium}, and @code{compact}.
+@end table
+
@end ifset
@end ifset