2.2 Model Shell command-line options

Use these options to control 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 into 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. 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 startup and shutdown. 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 a file at model shutdown. 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. Microsoft Windows only.

--list-instances -

Print list of target instances to standard output.

--list-memory -

Print memory information for the model to standard output.

--list-params -l

Print list of target instances and their parameters to standard output. Use this to help identify the correct syntax for configuration files, and to find out what the target supplies.

--list-regs - Print 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.

--print-port-number - Prints the port number on which the CADI server is listening.
--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 -

Print statistics at the end of the simulation.

--timelimit n -T

Specify the maximum number of wall clock seconds for the simulator to run. 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

Print the Model Shell version number, then exit.

Non-ConfidentialPDF file icon PDF versionARM DUI0841K
Copyright © 2014–2017 ARM Limited or its affiliates. All rights reserved.