2.2. Getting started with Model Shell

This section describes how to use the Model Shell application to start VE and MPS RTSMs. To configure VE and MPS RTSMs, see Configuring the RTSM. An example of loading and executing an application is documented separately. See Loading and running an application on the VE RTSM.

The RTSM can be started with its own CADI debug server. This enables the model to run independently of a debugger. However, it does mean that you must configure your model using arguments that are passed to the model at start time.

To start the RTSM using Model Shell, change to the directory where your model file is located and enter the following at the command prompt:

model_shell --cadi-server --model model_name [--config-file filename] [--parameter instance.parameter=value] [--application app_filename]



is the name of the model file. By default this file name is typically RTSM_VE_processor.dll or RTSM_MPS_processor.dll on Microsoft Windows or RTSM_VE_processor.so or RTSM_MPS_processor.so on Linux.


is the name of your optional plain-text configuration file. Configuration files simplify managing multiple parameters. See Using a configuration file.


is the optional direct setting of a configuration parameter. See Using the command line.


is the file name of an image to load to your model at startup.

Example 2.1 shows the format for using Model Shell to load and run an image from an ELF file:

Example 2.1. Load and run an image from an ELF file

# Load and run from an ELF image file
model_shell \
    --parameter "motherboard.vis.rate_limit-enable=0" \
    --application test_image.axf \


On Microsoft Windows, it might be necessary to add to your PATH the directory in which the Model Shell executable is found. This location is typically:


You can use * to load the same image into all the sub-cores in one CPU cluster, for example:

model_shell $MODEL -a "cluster0.*=image.axf"


You must quote the argument as shown if you are using csh, or if you have spaces in the filename, otherwise the shell tries to expand the * instead of passing it to the application.

For more information on all Model Shell options, see the Model Shell for Fast Models Reference Manual.

Starting the model opens the RTSM CLCD display. See Using the CLCD window. For an example of starting and configuring a RTSM using Model Shell, see Example 2.3. After the RTSM starts, you can use your debugger if it has a CADI interface to connect to the RTSM.

Copyright © 2011 ARM. All rights reserved.ARM DUI 0575C