A.2.1. Using Model Shell to run the system model

To start the EB RTSM using Model Shell, change to the directory that contains your model file and enter the following at the command prompt:

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

where:

model_name

is the name of the model file. By default the filename for Debug versions is typically cadi_system_Windows-Debug-compiler.dll on Windows, or cadi_system_Linux-Debug-compiler.so on Linux, where compiler is the name of the compiler used to build the model.

filename

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

instance.parameter=value

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

app_filename

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

Note

On Windows, it might be necessary to add the directory that contains the Model Shell executable to your PATH. This location of the directory is typically:

C:\Program Files\ARM\ModelDebugger_4.0\bin

You can also start Model Shell from the System Canvas GUI.

For more information on all Model Shell options, see the ModelShell For Fast Models User Guide.

Starting the model opens the Real-Time System Model CLCD display as described in Using the CLCD window.

After the EB RTSM starts, you can connect to it using a CADI-compliant debugger such as Model Debugger or RealView Debugger. See Connecting to a running Model Shell using Model Debugger and Connecting to a running model using RealView Debugger.

Using a configuration file

To configure a model that you start from the command line with Model Shell, include a reference to an optional plain text configuration file as described in Using Model Shell to run the system model.

Comment lines in the configuration file must begin with a # character.

Each non-comment line of the configuration file contains:

  • the name of the component instance

  • the parameter to be modified and its value.

    Boolean values can be set using either true/false or 1/0. Strings must be enclosed in double quotes if they contain whitespace.

A typical configuration file is listed in Example A.1:

Example A.1. Configuration file

# Disable semihosting using true/false syntax
coretile.core.semihosting-enable=false
#
# Enable the boot switch using 1/0 syntax
baseboard.sp810_sysctrl.use_s8=1
#
# Set the boot switch position
baseboard.eb_sysregs_0.boot_switch_value=1
#
# Enable ARM Profiler data collection and set analysis file namecoretile.core.profiler-enable=true
coretile.core.profiler-output_file="test run output.apa"

Using the command line

You can define model parameters when you invoke the model by using the -C switch when starting Model Shell. You can also use --parameter as a synonym for the -C switch. See Using Model Shell to run the system model. Use the same syntax as for a configuration file, but each parameter must be preceded by the -C switch.

Copyright © 2007-2010 ARM Limited. All rights reserved.ARM DUI 0370K
Non-ConfidentialID110210