2.2 Model Shell command-line options

Use options to tailor Model Shell behavior from the command line.

Table 2-1 Model Shell command line options

Long Short Description
--application file1 file2 -a
Load application list. Use -a [INST=]file to load an application to a system instance.
model_shell $MODEL -a multiprocessor.processor0=app1.axf -a multiprocessor.processor1=app2.axf
Use * to load the same application image into all the cores in a cluster.
model_shell $MODEL -a "multiprocessor.*=app.axf"
Unless you specify a core, Model Shell loads the image into the first cluster or instance that can run software.
--break address -b
Set program breakpoint at the address. Use -b [INST=][threadid:]address to set a breakpoint for the system instance. Multiple --breaks set multiple breakpoints.
--cadi-log -L
Log all CADI calls to an XML log file.
--cadi-server -S
Start a CADI server. This enables attaching a debugger to debug targets in the simulation. To shut down the server, return to the command window that you used to start the model and press Ctrl+C to stop the CADI server. The Model Shell process must be in the foreground before you can shut it down.
--cadi-trace -t
Enable diagnostic output from CADI calls and callbacks.
--config-file file -f
Use model parameters from configuration file file.
--cpulimit n -
Specify the maximum number of host seconds for the simulation to run, excluding simulation start-up and shut-down. Fractions of a second can be specified, but the remaining time is only tested to a resolution of 100ms. If n is omitted, the default is unlimited.
--cyclelimit n -
Specify the maximum number of cycles to run. If n is omitted, the default is unlimited.
--data file@address -
Specify raw data to load at this address. The full format is:
--data [INST=]file@[memspace:]address
--dump file@address,size -
Dump a section of memory into file, on model shut-down. Multiple --dumps are possible. The full format is:
-dump [INST=]file@[memspace:]address,size
--help -h
List the Model Shell command line options, and then exit.
--keep-console -K
Keep console window open after completion, on Microsoft Windows.
--list-instances -
List target instances.
--list-memory -
List memory information for the model to standard output.
--list-params -l
List target instances and their parameters. Use this to help identify the correct syntax for configuration files, and to find out what the target supplies.
--list-regs - List model register information to standard output.
--model file -m Model to load. Optional.
--output file -o
Redirect output from the --list-instances, --list-memory, --list-params, and --list-regs commands to a file.
The contents of the file are formatted correctly for use as input by the --config-file option.
--parameter [instance.]parameter=value -C
Set a parameter to this value. For hierarchical systems, specify the complete name of the parameter.
--plugin file -
Specify plugins. These plugins or those in environment variable FM_PLUGINS are loaded.
--prefix -P
Prefix semihosting output with the name of the target instance.
--quiet -q
Suppress Model Shell output.
--run -R
Run simulation on load, with a CADI server: -S --run. The default is to start the simulation in a stopped state.
--start address -
Initialize the PC to this application start address, overriding the .axf start. The full format is:
--start [INST=]address
--stat -
List statistics at end of simulation.
--timelimit n -T
Specify the maximum number of seconds to run as n. If n is omitted, the default is unlimited. If n is specified as 0, Model Shell initializes the system, loads all applications and data, sets breakpoints and PC, and exits immediately without running the model. Use this option to convert applications to raw binary. For example:
model_shell --timelimit 0 -m mymodel.dll -a app.axf --dump app.raw@0x8000,0x10000
--verbose -V
Enable verbose messages.
--version -v
List the Model Shell version number, then exit.
Related reference
2.5 Model Shell shutdown
Non-ConfidentialPDF file icon PDF versionARM DUI0841H
Copyright © 2014-2016 ARM. All rights reserved.