Using the tool#
Open the System Manager (SM) Configuration tool.
Open the Project Configuration wizard by pressing Project Settings button.
Set the configuration name.
Set the SM project location path (for example, downloaded from the GitHub repository ).
To create a new empty configuration, select a board supported by SM FW and click the Create a new configuration button (this option is suitable for developers of new or unsupported boards).
To import the existing board configuration, choose between the CFG and JSON file and click the corresponding button, then set the path with the file to be imported.
Project Settings button#
Note: Problems that occur during the configuration import are displayed in the report dialog that can be exported. If there are issues, review the report and adjust the configuration accordingly.
System and Details View#
For navigation through the general system configuration, use the System View that shows tree nodes settings. These are the main categories that can be configured.
Project Configuration – SM project configuration name and description, compiler Mak file configuration
Board Configuration – Board specific settings, SM debug options, Global Assignment Templates definition, creation of custom User Macro Resources
Logical Machines – LM specific settings (for example, RPC), Mode Select Configurations from LM’s perspective, Start-Stop Sequences configuration, Assignment Templates definition
Agents – SCMI Agent specific settings (for example, Mailbox), Assignment Templates definition
RPC Channels – Channel settings (for example, transport)
Domains – DOM specific settings, Assignment Templates definition
mSel Configurations Overview - Mode Select Configurations from mSel’s perspective
To configure a generic System Manager project setting, for example, Project Mak file or debug features, use the System View’s tree to select the desired node. Every selection of the tree node shows available configuration settings in the configuration Details View. Using the Expand/Collapse buttons on the System View’s header you can expand/collapse all child nodes of the active selection.
Configuring a selected element in System View (left) using the Details View (right)#
Resources View#
To assign a resource to a Resource Owner (LM, SCMI_AGENT, DOM), use the Resources View. Note: Every Resource Owner is related to a specific RDC domain (DOM).
Assign and configure Resource Parameters - Select the cell with the corresponding Resource (row) and the Resource Owner (column) in the Resources View. Then click the Assign button in the configuration Details view.
Assign a resource with pre-configured Assignment Templates. To do this, configure the Assignment Templates for your desired Resource owner using the System and Details Views and set the name (identifier) and Resource parameters that will be configured (parameters that do not relate to the assigning Resource are ignored). Note: Resource cells that cannot be assigned to a specific owner are greyed out.
Example of Resource assignment - V2X_SHE1 to Agent M7 using OWNER and automatic DFMT1 Assignment Template#
Create a new memory sector - Select the corresponding Resource (row) with the <MEM> suffix and the Resource Owner (column) in the Resources View. Double-click the desired cell and select Create a new memory sector. Then configure the memory sector parameters (Start Address, Size or End Address, and Permissions) in the Details View.
Assign an existing memory sector to a Resource owner - Expand the Resource (row) with the <MEM> suffix node, select the memory sector, and double-click the cell to select the template or assign the memory sector.
Example of Memory resource assignment - M7MIX<0x20380000-0x2047ffff> to ELE Domain#
To modify parameters of the resource assignment, select the resource and use the Details View:
Use the Template Assignment section to select and see the configured parameters assigned by the Assignment Template. It is possible to directly modify the Assignment Template parameters by setting a checkbox to enable editing. Note: updating the selected Assignment Template affects all Resources that are assigned to this template.
To configure additional parameters to the selected Assignment template, select the settings below the Assignment Template selection. The parameters that are not available are not related to the Resource. The parameters that are grayed are configured by the Assignment Template and cannot be overwritten. To change the grayed setting value you have to create new, choose another or update the selected Assignment Template.
To remove Resource assignment, select the cell with the corresponding Resource (row) and the Resource Owner (column) in the Resources View. Then click the Unassign button in the configuration Details view.
To find a desired Resource or to adjust the overview table, use the Filter or Search bar. To achieve that, combine selection of Resources and Owners filters with the search bar filtering. The search bar is case-sensitive and supports regular expression search, it can be enabled by clicking the buttons on the right side of the search bar. Note: To see all Atomic Resources that are included in the resource assignment, expand Macro Resources in the Resources View.
Filters and Search bar#
Boot View#
To configure a setting related to booting of the Logical Machines, use the Boot view.
To add or remove the mSel configuration, click the Add/Remove buttons in the header of the mSel Settings in the Boot View.
The mSel Section lists all available LMs
The boot order can be changed by Arrow buttons in the left side. When the Boot parameter is enabled, the index of the Logical Machine corresponds to the actual boot order (index 0 means that LM will not boot).
Configuration of the Skip flag suppresses an error invocation in case no image is available in the boot container.
Start and Stop Sequence of the LM is selected in the dropdown. To add, remove or modify a Start-Stop Sequence, select the LM to be affected from the desired mSel section and use the Details View.
Use plus/minus buttons to add or remove a Start-Stop Sequence
Double-click Start-Stop Sequence to open its configuration details to be modified
Modify the index (identifier) and user name of the Start-Stop Sequence
Use plus/minus buttons to add or remove a Resources Commands to be called in the sequence
Double click Resource Command to open its configuration details to be modified (selection of Resource Command, optional arguments, and unit test flag)
Boot View#