Line 357... |
Line 357... |
in those two locations is used. Failure to find the file is a
|
in those two locations is used. Failure to find the file is a
|
fatal error. *Note Configuration: Configuration, for detailed
|
fatal error. *Note Configuration: Configuration, for detailed
|
information on configuring Or1ksim.
|
information on configuring Or1ksim.
|
|
|
`--nosrv'
|
`--nosrv'
|
Do not start up the debug server. This overrides any setting
|
Do not start up the "Remote Serial Protocol" debug server. This
|
specified in the configuration file. This option may not be
|
overrides any setting specified in the configuration file. This
|
specified with `--srv'. If it is, a rude message is printed and
|
option may not be specified with `--srv'. If it is, a rude
|
the `--nosrv' option is ignored.
|
message is printed and the `--nosrv' option is ignored.
|
|
|
`--srv'
|
`--srv'
|
|
|
`--srv=N'
|
`--srv=N'
|
Start up the debug server. If the parameter, N, is specified, use
|
Start up the "Remote Serial Protocol" debug server. This
|
that as the TCP/IP port for the server, otherwise a random value
|
overrides any setting specified in the configuration file. If the
|
from the private port range (41920-65535) will be used. This
|
parameter, N, is specified, use that as the TCP/IP port for the
|
option may not be specified with `--nosrv'. If it is, a rude
|
server, otherwise a random value from the private port range
|
message is printed and the `--nosrv' option is ignored.
|
(41920-65535) will be used. This option may not be specified with
|
|
`--nosrv'. If it is, a rude message is printed and the `--nosrv'
|
|
option is ignored.
|
|
|
`-d=CONFIG_STRING'
|
`-d=CONFIG_STRING'
|
`--debug-config=CONFIG_STRING'
|
`--debug-config=CONFIG_STRING'
|
Enable selected debug messages in Or1ksim. This parameter is for
|
Enable selected debug messages in Or1ksim. This parameter is for
|
use by developers only, and is not covered further here. See the
|
use by developers only, and is not covered further here. See the
|
Line 1560... |
Line 1562... |
disabled.
|
disabled.
|
|
|
Note: This enables the functionality of the debug unit (its
|
Note: This enables the functionality of the debug unit (its
|
registers etc) within the mode. It does not provide any
|
registers etc) within the mode. It does not provide any
|
external interface to the debug unit. For that, see
|
external interface to the debug unit. For that, see
|
`gdb_enabled' and `rsp_enabled' below.
|
`rsp_enabled' below.
|
|
|
`rsp_enabled = 0|1'
|
`rsp_enabled = 0|1'
|
If 1 (true), the GDB "Remote Serial Protocol" server is started,
|
If 1 (true), the GDB "Remote Serial Protocol" server is started,
|
provding an interface to an external GNU debugger, using the port
|
provding an interface to an external GNU debugger, using the port
|
specified in the `rsp_port' field (see below), or the
|
specified in the `rsp_port' field (see below), or the
|
Line 1574... |
Line 1576... |
For more detailed information on the interface to the GNU Debugger
|
For more detailed information on the interface to the GNU Debugger
|
see Embecosm Application Note 2, `Howto: Porting the GNU Debugger
|
see Embecosm Application Note 2, `Howto: Porting the GNU Debugger
|
Practical Experience with the OpenRISC 1000 Architecture', by
|
Practical Experience with the OpenRISC 1000 Architecture', by
|
Jeremy Bennett, published by Embecosm Limited (`www.embecosm.com').
|
Jeremy Bennett, published by Embecosm Limited (`www.embecosm.com').
|
|
|
Note: `rsp_enabled' may not be enabled with `gdb_enabled' (see
|
|
below). If both are enabled, a warning is issued and only
|
|
the "Remote Serial Protocol" interface is enabled.
|
|
|
|
`rsp_port = VALUE'
|
`rsp_port = VALUE'
|
VALUE specifies the port to be used for the GDB "Remote Serial
|
VALUE specifies the port to be used for the GDB "Remote Serial
|
Protocol" interface to the GNU Debugger (GDB). Default value
|
Protocol" interface to the GNU Debugger (GDB). Default value
|
51000. If the value 0 is specified, Or1ksim will instead look for
|
51000. If the value 0 is specified, Or1ksim will instead look for
|
a TCP/IP service named `or1ksim-rsp'.
|
a TCP/IP service named `or1ksim-rsp'.
|
Line 1589... |
Line 1587... |
Tip: There is no registered port for Or1ksim "Remote Serial
|
Tip: There is no registered port for Or1ksim "Remote Serial
|
Protocol" service `or1ksim-rsp'. Good practice suggests
|
Protocol" service `or1ksim-rsp'. Good practice suggests
|
users should adopt port values in the "Dynamic" or "Private"
|
users should adopt port values in the "Dynamic" or "Private"
|
port range, i.e. 49152-65535.
|
port range, i.e. 49152-65535.
|
|
|
`gdb_enabled = 0|1'
|
|
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 `server_port' field (see below), or the `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, `Howto: Porting the GNU Debugger
|
|
Practical Experience with the OpenRISC 1000 Architecture', by
|
|
Jeremy Bennett, published by Embecosm Limited (`www.embecosm.com').
|
|
|
|
Note: The OpenRISC Remote JTAG protocol is unique to
|
|
OpenRISC, and remains only for backward compatibility. New
|
|
users should adopt the standard GDB "Remote Serial Protocol"
|
|
interface (see `rsp_enabled' above) providing access to a
|
|
wider range of GDB functionality.
|
|
|
|
Note: `gdb_enabled' may not be enabled with `rsp_enabled'.
|
|
If both are enabled, a warning is issued and only the "Remote
|
|
Serial Protocol" interface is enabled.
|
|
|
|
`server_port = VALUE'
|
|
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, Or1ksim will instead look for
|
|
a TCP/IP service named `or1ksim'.
|
|
|
|
Tip: There is no registered port for Or1ksim Remote JTAG
|
|
Interface or service `or1ksim'. Good practice suggests users
|
|
should adopt port values in the "Dynamic" or "Private" port
|
|
range, i.e. 49152-65535.
|
|
|
|
`vapi_id = VALUE'
|
`vapi_id = VALUE'
|
VALUE specifies the value of the Verification API (VAPI) base
|
VALUE specifies the value of the Verification API (VAPI) base
|
address to be used with the debug unit. *Note Verification API:
|
address to be used with the debug unit. *Note Verification API:
|
Verification API, for more details.
|
Verification API, for more details.
|
|
|
Line 3440... |
Line 3405... |
|