OpenCores
URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [or1ksim/] [doc/] [or1ksim.texi] - Diff between revs 224 and 235

Go to most recent revision | Show entire file | Details | Blame | View Log

Rev 224 Rev 235
Line 441... Line 441...
error.  @xref{Configuration, , Configuration}, for detailed information
error.  @xref{Configuration, , Configuration}, for detailed information
on configuring @value{OR1KSIM}.
on configuring @value{OR1KSIM}.
 
 
@item --nosrv
@item --nosrv
@cindex @code{--nosrv}
@cindex @code{--nosrv}
Do not start up the debug server.  This overrides any setting specified
@cindex Remote Serial Protocol, @code{--nosrv}
in the configuration file.  This option may not be specified with
Do not start up the @dfn{Remote Serial Protocol} debug server.  This
@code{--srv}.  If it is, a rude message is printed and the
overrides any setting specified in the configuration file.  This
@code{--nosrv} option is ignored.
option may not be specified with @code{--srv}.  If it is, a rude
 
message is printed and the @code{--nosrv} option is ignored.
 
 
@item --srv
@item --srv
@item --srv=@var{n}
@item --srv=@var{n}
@cindex @code{--srv}
@cindex @code{--srv}
Start up the debug server.  If the parameter, @var{n}, is specified,
@cindex Remote Serial Protocol, @code{--srv}
use that as the TCP/IP port for the server, otherwise a random value
Start up the @dfn{Remote Serial Protocol} debug server.  This
from the private port range (41920-65535) will be used.  This option
overrides any setting specified in the configuration file.  If the
may not be specified with @code{--nosrv}.  If it is, a rude message is
parameter, @var{n}, is specified, use that as the TCP/IP port for the
printed and the @code{--nosrv} option is ignored.
server, otherwise a random value from the private port range
 
(41920-65535) will be used.  This option may not be specified with
 
@code{--nosrv}.  If it is, a rude message is printed and the
 
@code{--nosrv} option is ignored.
 
 
@item -d=@var{config_string}
@item -d=@var{config_string}
@itemx --debug-config=@var{config_string}
@itemx --debug-config=@var{config_string}
@cindex @code{-d}
@cindex @code{-d}
@cindex @code{--debug-config}
@cindex @code{--debug-config}
Line 1909... Line 1913...
 
 
@quotation Note
@quotation Note
This enables the functionality of the debug unit (its registers etc) within
This enables the functionality of the debug unit (its registers etc) within
the mode.  It does not provide any external interface to the debug unit.
the mode.  It does not provide any external interface to the debug unit.
For
For
that, see @code{gdb_enabled} and @code{rsp_enabled} below.
that, see @code{rsp_enabled} below.
@end quotation
@end quotation
 
 
@item rsp_enabled = 0|1
@item rsp_enabled = 0|1
@cindex @code{rsp_enabled} (debug interface configuration)
@cindex @code{rsp_enabled} (debug interface configuration)
@cindex Remote Serial Protocol
@cindex Remote Serial Protocol
Line 1926... Line 1930...
For more detailed information on the interface to the GNU Debugger see
For more detailed information on the interface to the GNU Debugger see
Embecosm Application Note 2, @cite{Howto: Porting the GNU Debugger Practical
Embecosm Application Note 2, @cite{Howto: Porting the GNU Debugger Practical
Experience with the OpenRISC 1000 Architecture}, by Jeremy Bennett, published
Experience with the OpenRISC 1000 Architecture}, by Jeremy Bennett, published
by Embecosm Limited (@url{www.embecosm.com}).
by Embecosm Limited (@url{www.embecosm.com}).
 
 
@quotation Note
 
@code{rsp_enabled} may not be enabled with @code{gdb_enabled} (see
 
below).  If
 
both are enabled, a warning is issued and only the @dfn{Remote Serial
 
Protocol} interface is enabled.
 
@end quotation
 
 
 
@item rsp_port = @var{value}
@item rsp_port = @var{value}
@cindex @code{rsp_port} (debug interface configuration)
@cindex @code{rsp_port} (debug interface configuration)
@var{value} specifies the port to be used for the GDB @dfn{Remote Serial
@var{value} specifies the port to be used for the GDB @dfn{Remote Serial
Protocol} interface to the GNU Debugger (GDB).  Default value 51000.  If
Protocol} interface to the GNU Debugger (GDB).  Default value 51000.  If
the value 0 is specified, @value{OR1KSIM} will instead look for a TCP/IP
the value 0 is specified, @value{OR1KSIM} will instead look for a TCP/IP
Line 1947... Line 1944...
There is no registered port for @value{OR1KSIM} @dfn{Remote Serial Protocol}
There is no registered port for @value{OR1KSIM} @dfn{Remote Serial Protocol}
service @code{or1ksim-rsp}.  Good practice suggests users should adopt port
service @code{or1ksim-rsp}.  Good practice suggests users should adopt port
values in the @dfn{Dynamic} or @dfn{Private} port range, i.e.  49152-65535.
values in the @dfn{Dynamic} or @dfn{Private} port range, i.e.  49152-65535.
@end quotation
@end quotation
 
 
@item gdb_enabled = 0|1
 
@cindex @code{gdb_enabled} (debug interface configuration)
 
If 1 (true), the OpenRISC Remote JTAG protocol server is started, provding an
 
interface to an external GNU debugger, using the port specified in the
 
@code{server_port} field (see below), or the @code{or1ksim} TCP/IP
 
service.  If
 
0 (the default), the server is not started, and no external interface is
 
provided.
 
 
 
For more detailed information on the interface to the GNU Debugger see
 
Embecosm Application Note 2, @cite{Howto: Porting the GNU Debugger Practical
 
Experience with the OpenRISC 1000 Architecture}, by Jeremy Bennett, published
 
by Embecosm Limited (@url{www.embecosm.com}).
 
 
 
@quotation Note
 
The OpenRISC Remote JTAG protocol is unique to OpenRISC, and remains only for
 
backward compatibility.  New users should adopt the standard GDB @dfn{Remote
 
Serial Protocol} interface (see @code{rsp_enabled} above) providing access to
 
a wider range of GDB functionality.
 
@end quotation
 
 
 
@quotation Note
 
@code{gdb_enabled} may not be enabled with @code{rsp_enabled}.  If both are
 
enabled, a warning is issued and only the @dfn{Remote Serial Protocol}
 
interface is enabled.
 
@end quotation
 
 
 
@item server_port = @var{value}
 
@cindex @code{server_port} (debug interface configuration)
 
@var{value} specifies the port to be used for the OpenRISC Rmote JTAG
 
protocol interface to the GNU Debugger (GDB).  Default value 51000.  If
 
the value 0 is specified, @value{OR1KSIM} will instead look for a TCP/IP
 
service named @code{or1ksim}.
 
 
 
@quotation Tip
 
@cindex TCP/IP port range for @code{or1ksim} service
 
There is no registered port for @value{OR1KSIM} Remote JTAG Interface
 
or service @code{or1ksim}.  Good practice suggests users should adopt
 
port values in the @dfn{Dynamic} or @dfn{Private} port range,
 
i.e.  49152-65535.
 
@end quotation
 
 
 
@item vapi_id = @var{value}
@item vapi_id = @var{value}
@cindex @code{vapi_id} (debug interface configuration)
@cindex @code{vapi_id} (debug interface configuration)
@var{value} specifies the value of the Verification API (VAPI) base
@var{value} specifies the value of the Verification API (VAPI) base
address to be used with the debug unit.  @xref{Verification API, ,
address to be used with the debug unit.  @xref{Verification API, ,
Verification API}, for more details.
Verification API}, for more details.

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.