2.1.1 Launching from the command line

To launch Model Debugger from the command line, type modeldebugger, with options and arguments.

Table 2-1 Command line options

Short Long option Description
 
--cyclelimit cycles
Set a limit on the number of system cycles for a simulation in non-GUI mode.
The cyclelimit option is only enabled if the --nogui option is used.
 
--debug-isim isim_system
Start isim_system and connect Model Debugger remote to the simulation.
 
--debug-sysc systemc
Start systemc Simulation and connect Model Debugger remote to the simulation.
 
--timelimit time
Set a time limit for a simulation in non-GUI mode.
The timelimit option is only enabled if the --nogui option is used.
-a
--application filename
Load the application file filename. To target processors in multiprocessor systems, prefix the name with the path to the instance. For example, foo.bar.core=dhrystone.axf.
-C
--parameter parameter
Set a single parameter of the model. Parameters are specified as a path naming the instance and the parameter name using dot separators. For example, foo.bar.inst.parameter=1000. If it is necessary to set multiple parameters at once, use the --config-file option instead.
-c
--connect simulation_id
Connect to a remote CADI simulation. The simulation to connect to is specified by the simulation_id. Use the --list-connections option to display the list of available connections.
-E
--enable-verbose msgClass
Use verbose messages if displaying message text for message classes msgClass. if used without an argument, lists all classes.
-e
--env-connect
Connect to remote CADI simulation using the following environment variables:
  • CADI_CLIENTPORT_TCP – port number
  • CADI_INSTANCEID – component instance name
  • CADI_APPLICATIONFILENAME – application file name
-F
--stdout-to-file FILE
Print all application output to FILE instead of the StdIO pane in the Output Window.
-f
--config-file filename
Use model parameters from the configuration file filename.
-h
--help
Print the available options and exit.
-i
--instance
Specify the instance.
-L
--cadi-log
Log all CADI calls into an XML logfile CADILog-nnnn.xml, where nnnn is a set of four digits. The logfile is created in the same directory as the model.
-l
--list-connections
List possible connections to remote CADI simulations on the local machine and exit afterwards. Each simulation is given a unique simulation ID.
 
--list-instances
List target instances.
 
--list-params
List target instances and their parameters.
-m
--model filename
Load the model library in the file named filename.
-N
--nogui
Run the simulation without displaying the GUI.
Use the --script option to load and run a script on startup.
-n
--no-params-dialog
Do not display the parameter configuration dialog at startup.
-O
--stdout-to-stdout
Print all application output to stdout instead of the StdIO pane in the Output Window.
-p
--project filename
Load the project file filename.
-q
--quiet
Suppress all Model Debugger and Model Shell output.
-s
--script filename
Execute the commands from the script named filename.
 
--plugin
Specify trace plug-ins. All plug-ins specified with this command line option or in environment variable FM_TRACE_PLUGINS are loaded.
-V
--verbose
Equivalent to --enable-verbose “MaxView”.
-v
--version
Print the tool version and exit.
-x
--force-reg-hex
Force registers with initial integer display to be hexadecimal format instead.
-Y
--layout filename
Load the layout file filename.
-y
--no-target-dialog
Suppress the Select Target dialog box that normally appears when a model is loaded. Model Debugger automatically connects to targets that have the executes_software flag set. From the GUI, you can use the Other Settings check box in the Preferences dialog box to suppress the Select Target dialog box.
Non-ConfidentialPDF file icon PDF versionARM DUI0314Q
Copyright © 2007-2014 ARM. All rights reserved.