| 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.
|
