5.3.16 Preferences dialog

This section describes the Preferences dialog ( File > Preferences ), which configures the working environment of System Canvas.

Preferences - Appearance group

This group sets the appearance of System Canvas.

Show Tool Tips

Display all tool tips.

Display tool bar text labels

Display the status bar labels.

Word wrap in source windows

Wrap long lines to display them within the source window.

Show splash screen on startup

Show the splash screen on startup.

Reload recent layout on startup

Reload the layout settings from the last modified project.

Recent files and directories

Set the number of directories and files shown in System Canvas file dialogs and menus, up to 32 directories and 16 files.

Preferences - Applications group

This group sets the application paths.


  • On Microsoft Windows, environment variables appear as $MAXxxxx_HOME. You can use this format instead of %MAXxxxx_HOME%.
  • The different path specifications enable the use of different versions of Model Debugger and provide more flexibility for installing Model Debugger separately from System Canvas.
Simulator Generator Executable
Set the path to the simgen.exe file.
Command arguments
Set additional command line options.
Model Debugger Executable
Model Debugger
Set the path to the Model Debugger executable.
Command arguments
Set additional command line options.
Model Shell Executable
Model Shell
Set the path to the Model Shell executable.
Command arguments
Set additional command line options.
Run Model Shell asynchronously with output to console in separate window
Check to enable the starting of a separate Model Shell instance with its own output window.


To start simulation, select the Run in Model Shell entry on the Projects menu.
Path to Microsoft Visual Studio application ‘devenv.com’

Select the path to the Microsoft Visual Studio devenv.com file. This application is the development environment and builds the model.

Reset to Defaults
Click to reset the application paths.
Click to save the changes.


Under Linux, select the GCC C++ compiler that builds the model with the SimGen command-line option --gcc-path.
Run Model Shell asynchronously

Check to use the command line:

xterm -e <Model Shell Executable> optional_command_arguments_list -m model.so
Host Debugger Command Line

Set command-line options. The default text is:

xterm -e gdb --args %ISIM%

where %ISIM% is a placeholder for the isim_system executable file.

Preferences - External Tools group

This group sets the tools that display the documentation.

use operating system file associations
Check to inactivate the external tool edit fields and buttons. Clear to activate them.


This checkbox is not available on Linux.

Preferences - Fonts group

This group sets the application fonts.


The application font.

Base fixed font

The Source view font.

Block Diagram Component Name

The component title block font.

Fonts depend on $DISPLAY variable

Check to use the font set in the $DISPLAY variable.

Reset to base size

Reset all font sizes to the selected value.

Reset to defaults

Click to reset the fonts to the factory settings.


If non-Latin characters are used in LISA code, the base fixed font must support them. The default font might not support non-Latin characters.

Preferences - Default Model Repository group

This group sets the default model repositories for new projects.

Figure 5-2 Preferences dialog, Setup Default Model Repository
Preferences dialog, Set up Default Model Repository

To incorporate components into a system, System Canvas requires information about them, such as their ports, protocols, and library dependencies. For convenience, model repositories, such as sglib.sgrepo, group multiple components together and specify the location of the LISA files and the libraries that are needed to build them.

Default repositories are added by default to new projects. To add a repository to an existing project, use the Component window context menu.


To enable the immediate use of models in new projects, System Canvas has a default entry $(PVLIB_HOME)/etc/sglib.sgrepo. This entry is not deletable, but clearing the checkbox deactivates it.

Click Add to open a file selection dialog and add a new .sgrepo repository file to the list.

Select a directory to add all of the repositories in that directory to the list of repositories.

Edit Path

Select a repository and click Edit to edit the path to it.

The path to the default repository $(PVLIB_HOME)/etc/sglib.sgrepo is not editable.


Select a repository and click Remove to exclude the selected repository from new projects. This does not affect the repository itself.

The default repository $(PVLIB_HOME)/etc/sglib.sgrepo is not deletable.

File checkboxes

Check to automatically include the repository in new projects. Clear to prevent automatic inclusion, but to keep the path to the repository available.


Use the Up and Down buttons to change the order of repositories. File processing follows the repository order.

Preferences - Suppressed messages group

This group lists the suppressed messages and controls their re-enabling.

Enable selected messages

Click to enable selected suppressed messages.

Non-ConfidentialPDF file icon PDF version100965_1105_00_en
Copyright © 2014–2018 Arm Limited or its affiliates. All rights reserved.