2.4.1. Setting model configuration options

The initial state of the EB RTSM can be controlled by configuration settings provided either on the command line or in the CADI properties for the model. If you are starting the model using a graphical tool such as Model Debugger or RealView Debugger, you can define the instantiation-time parameters through a GUI.

Valid user settings for the EB RTSM parameters and their effects are described elsewhere. See Model configuration parameters.

Using a configuration file

You can configure a model that you start from the command line with Model Shell by including a reference to an optional plain text configuration file. See Using Model Shell. Each line of the configuration file contains the name of the component instance, the parameter to be modified and its value. Comment lines begin with a # character. Boolean values can be set using either true/false or 1/0. Strings must be enclosed in double quotes if they contain whitespace. For example:

# 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 name
coretile.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. Use the same syntax as for a configuration file, but each parameter must be preceded by the -C switch.

Using a configuration GUI in Model Debugger

When you load a model in Model Debugger, you are given an opportunity to configure the model parameters. The Configure Model Parameters dialog shown in Figure 2.3 allows you to define instantiation-time parameters.

Figure 2.3. Configure Model Parameters dialog

Configure Model Parameters dialog

To view the configuration parameters, expand the tree view in the left hand Parameter category pane. Highlight the parameter category you want to modify. In the right hand pane, you can then select or deselect check boxes for boolean parameters, or enter data such as strings or addresses in fields. Hovering the mouse pointer over a parameter shows a description of the parameter as well as its default value. You can change the numeric display from the default hexadecimal to decimal by clearing the Hexadecimal display for numeric values box in the lower left corner.

Using a configuration GUI in RealView Debugger

In RealView Debugger, you can configure the EB RTSM parameters before you connect to and start the model. If you are in the process of adding the particular EB RTSM to the RealView Debugger Connect to Target list, then the Model Configuration Utility dialog box is presented automatically. Alternatively you can right click on your existing target in the Connect to Target list and select Configure... to open the same dialog.

To view the configuration parameters, you can scroll down the list of devices shown in the upper right pane. Selecting a device populates the lower right pane with the device parameters. To change a parameter value, select a boolean from the drop down list, or enter data such as strings or addresses by clicking in the relevant field. Hovering the mouse pointer over a device or parameter will show a description or additional information. You can change the numeric display from decimal to hexadecimal by right clicking on the parameter value in the lower right pane and selecting Hexadecimal Display from the resulting context menu.

Copyright © 2008 ARM Limited. All rights reserved.ARM DUI0424B
Non-ConfidentialUnrestricted Access