Software Cluster Editor

The element Software Clusters is used for grouping and does not contain any modifiable properties.

Select a Software Cluster in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

• Name: Displays the name of the Software Cluster. Edit the field to change the name.
• Description: Displays the description of the Software Cluster. Edit the field to change the description.
• Software Cluster Category: Displays the category of the Software Cluster. Click the arrow to select a Software Cluster Category.
• Target Machine: The property Target Machine is provided as an extension to the AUTOSAR Adaptive standard. The Target Machine is used as a guidance when you add Processes to the selected Software Cluster and reference a Software Cluster Design. The selected Target Machine is stored in the Contained AR Element list.
  
  You can modify the reference to the Target Machine as follows:
• Select Reference Target: Click this icon to select or modify the reference to the Target Machine.
• Create Reference Target with the Skeleton Model Wizard.
• Go to Reference Target: Click this icon to open the referenced Target Machine in the AUTOSAR Model Explorer.
• Vendor Id: Displays the vendor ID of the Software Cluster. Edit the field to change the vendor ID.
• Version: Displays the version of the Software Cluster. Edit the field to change the version.
• Type Approval: Displays the Type Approval of the Software Cluster. Edit the field to change the Type Approval.
• Claimed Function Groups: Lists all claimed Function Groups.
  To claim a Function Group, click Claim Function Group and select one or more Function Groups to be claimed in the dialog that opens.

Diagnostic Information (only for root software cluster) Area

In the Diagnostic Information area, the reference to the Diagnostic Contribution Set can be selected or modified as follows:

• Diagnostic Contribution Set: Displays the target reference to the Diagnostic Contribution Set.
• Select Reference Target: Click this icon to select or modify the reference to the Diagnostic Contribution Set.
• Create Reference Target with the Skeleton Model Wizard.
• Go to Reference Target: Click this icon to open the referenced Diagnostic Contribution Set in the AUTOSAR Model Explorer.
• Diagnostic Addresses: Lists the Diagnostic Addresses. You can modify the Diagnostic Addresses as follows:
• Create Diagnostic Address: Click this icon to add a new diagnostic address to the table.
• Diagnostic Address: Displays the Diagnostic Address. Double click on the entry to modify the value.
• Type: Type is a read-only field that displays the Type of the Diagnostic Address.
• Address Semantics: Displays whether the address semantic is physical or functional. To change the value, double click on the entry and select the semantic to be used.

General Functions

• Delete: Click this icon to delete the properties of a respective field or a selected element, respectively. For fields that reference an element, only the reference is deleted but not the referenced element itself.

Software Clusters can also be cloned by clicking the Clone Software Cluster icon in the toolbar on the left side.

Select Software Cluster Overview in the tree view on the left side of the editor.

The page shows a graphical overview of all contained processes and their connections within a Software Cluster.

Get detailed information in section Software Cluster Overview.

Select Contained Processes in the tree view on the left side of the editor.

Add Process to this Software Cluster Tab

The left table lists all available Processes that are not mapped to the current Software Cluster. The right table lists all Processes that are mapped to the current Software Cluster. The mapping can be modified as follows:

• Create Process: Click this icon and follow the Create Process wizard to create a Process.
• Delete Process: Click this icon to delete a selected Process.
• Map: Click this icon to map the selected Process to the current Software Cluster.
• Unmap: Click this icon to unmap a selected Process from the Software Cluster.

Local Com Access Control Tab

In this tab, you can control the use of service interfaces and their deployment elements by using ComGrants for a machine. In the table you find a list of expandable processes and their elements, for which you can add ComGrants. ComGrants can be added or removed for the corresponding elements by selecting or deselecting them in the table via checkbox.

• Enable Local Com Access Control for <Machine Name>:
• Check the checkbox if you want to use Local Com Access Control for the machine.
• Note: The Local Com Access Control can only be enabled if all processes are mapped to the same machine. If not, the tab is displayed as read only.
• If Local Com Access Control is checked: Select the Type of Access Control (callout or policy-based).
• callout: the user provides the ruleset for the IAM Access Control e.g. as a database.
• policy-based: the generator creates one policy file defined per User ID.
• To remove the Access Control Type click Delete.
• Note: requires MICROSAR BSW r11.25.08 or newer.
• Selection States for Elements:
• : A single element or the element and all its children are selected.
• : Not all children of the element are selected.
• : A single element or the element and all its children are not selected.
• / / : Cannot be checked and is displayed as read only. The selection can either only be determined via a higher-level element or cannot be changed.
• Example: ComGrants for Events and Notifiers can only be added via Event Groups in SOME/IP ServiceInterfaceDeployments.

Select a Process in the tree view on the left side of the editor.

At the top of the form page, the general properties are displayed and can be modified:

• Name: Displays the name of the Process. Edit the field to change the name.
• Description: Displays the description of the Process. Edit the field to change the description.

General Area

In the General area, you can change the referenced Process Design, Executable, and Process States as follows:

• Select Reference Target: Opens the Select Reference Target dialog in which the new target reference can be selected.
• Create Reference Target with the Skeleton Model Wizard.
• Go to Reference Target: Opens the referenced target in the AUTOSAR Model Explorer.

Note that an Executable reference is not required if the Process Design reference contains an Executable.

Startup Configuration Tab

The Startup Configuration can be added or modified as follows:

• Create Startup Configuration: Click this icon to open a dialog in which a new Startup Configuration for the selected Process can be defined.
• Function Group States: This column displays the Function Group State in which the selected Process should be started. A Process can have one or more Function Group State configurations, which is displayed in multiline column.
  To edit the Function Group States, double click on the entry to open a dialog in which one or more States from one Function Group can be selected.
• Resource Group: This column displays the resource group reference configured for selected Startup Configuration.
  To edit the Resource Group, double click on the entry and select a Resource Group from the list. The list displays all Resource Groups configured for the selected Process.
• Startup Config: This column displays the Startup Configuration for the selected Process. The Process can have one or more Startup Configurations, which are displayed in a multiline column.
  To edit the Startup Parameters, double click on the entry to open a dialog in which the Startup Parameters that can be used by the selected Processes can be edited as follows:
• Startup Config Set: Click the arrow to select the Startup Configuration Set to be configured for the selected Process.
• Startup Parameters Table: All Startup Parameters of the above selected Startup Configuration Set are displayed in this table. To edit a Startup Parameter, double click the respective field:
  Name: Displays the name of the Startup Parameter.
  Priority: Displays the priority of the Startup Parameter.
  Scheduling Policy: Displays the Scheduling Policy of Startup Parameter.
  Process Arguments: Displays process arguments in <OptionName> <OptionArgument> manner for the Startup option presented in the Startup Parameter. One or more process arguments are possible, which are displayed in the column as multiline.
  Environment Variables: Displays the Environment Variable configured in <Key> <Value> manner for the Startup option presented in the Startup Parameter. One or more Environment Variable configurations are possible, which are displayed in the column as multiline. One or more Environment Variable configurations are possible, which are displayed in the column as multiline.
  Termination Behavior: Displays the specified termination behavior of the Process.
  Timeout: Displays the specified Enter and Exit Timeout of the Process.
  Execution Error: Displays the referenced Process Execution Error.
  Used By: Used by is a read-only field that displays the Processes configured for the selected Startup Parameter.
• Execution Dependency: The Execution Dependency configuration is shown as follows:
  "Target value<Process>" / "Context Value<Function Group State>".
  To edit an Execution Dependency, double click on the respective field to open a dialog in which all Processes are shown that are mapped to the same Machine and that aggregate a State Dependent Startup Configuration that refers to the same Function Group State. Multivalue configuration is supported.

Local Com Access Control Tab

If you select a single process, you can specify for which of its service interfaces and deployment elements ComGrants should be added.

Note: The tab has the same options as the tab under Contained Processes. However, only elements of the individual process are displayed here for selection.
For more details about the Local Com Access Control tab, refer to the description in the Contained Processes row above this one.

Logging Tab

In the Logging table, the Log Channels that are used by the Process can be configured. Click Map Log Channel to open a wizard in which existing Log Channels can be mapped to the Process. The Logging table displays all Log Channels that are mapped to the Process.

General Functions

• Delete: Click this icon to delete the properties of a respective field or a selected element, respectively. For fields that reference an element, only the reference is deleted but not the referenced element itself.

Select Software Cluster Design in the tree view on the left side of the editor.

The left table lists all available Software Cluster Designs that are not mapped to the current Software Cluster. The right table lists all Software Cluster Designs that are mapped to the current Software Cluster. The mapping can be modified as follows:

• Create Software Cluster Design: Click this icon to open a dialog in which a new Software Cluster Design can be defined.
• Delete Software Cluster Design: Click this icon to delete a selected Software Cluster Design.
• Map: Click this icon to map the selected Software Cluster Design to the current Software Cluster.
• Unmap: Click this icon to unmap a selected Software Cluster Design from the Software Cluster.

For each Software Cluster Design that is mapped to the Software Cluster, you can modify its properties in the DaVinci Modeling Language Editor on the respective subpage.

Select Depends on in the tree view on the left side of the editor.

On the form page, you can model dependencies to other Software Clusters that are required for installation.

To define new dependencies, a root node must be created first. Open the context menu of the <no formula> entry and click Add RootNode. On the left side of the form view, specify as follows:

• Logical Operator: Click the arrow and select whether the logical operator of the root node to be logical AND or OR.
• Category: Click the arrow and select whether the category (dependency type) of the root node to be structural or functional.
• Note:
  The category (dependency type) of the root node defines the dependency for all sub nodes. If both categories are required (structural and functional dependencies), the category must be defined on sub node level.

Sub nodes can be created and modified via the following context menu commands of a node:

• Add AND/OR: Adds a sub node in which the logical operator and category can be defined. Refer to the description of the root node above for information on the fields.
• Add Condition Expression: Adds a sub node in which a compare condition for a referenced Software Cluster can be defined.
• Software Cluster ref: Displays the reference to the Software Cluster to be compared.
• Select Reference Target: Click this icon to select or modify the reference to the Software Cluster.
• Create Reference Target with the Skeleton Model Wizard.
• Go to Reference Target: Click this icon to open the referenced Software Cluster in the AUTOSAR Model Explorer.
• Comparison Operator: Displays with which operator the Software Clusters are compared. Click the arrow to select or modify the comparison operator.
• Version: Displays the version to be compared. Edit the field to change the version.
• Consider Build Number: The check box indicates whether or not the build number is included in the comparison. Click the check box to enable or disable the consideration of the build number.

General Functions

• Delete: Click this icon to delete the properties of a respective field or a selected element, respectively. For fields that reference an element, only the reference is deleted but not the referenced element itself.

Select Conflicts to on in the tree view on the left side of the editor.

On the form page, you can model dependencies to other Software Clusters that are blocking the installation.

To define new dependencies, a root node must be created first. Open the context menu of the <no formula> entry and click Add RootNode. On the left side of the form view, specify as follows:

• Logical Operator: Click the arrow and select whether the logical operator of the root node to be logical AND or OR.
• Category: Click the arrow and select whether the category (dependency type) of the root node to be structural or functional.
• Note:
  The category (dependency type) of the root node defines the dependency for all sub nodes. If both categories are required (structural and functional dependencies), the category must be defined on sub node level.

Sub nodes can be created and modified via the following context menu commands of a node:

• Add AND/OR: Adds a sub node in which the logical operator and category can be defined. Refer to the description of the root node above for information on the fields.
• Add Condition Expression: Adds a sub node in which a compare condition for a referenced Software Cluster can be defined.
• Software Cluster ref: Displays the reference to the Software Cluster to be compared.
• Select Reference Target: Click this icon to select or modify the reference to the Software Cluster.
• Create Reference Target with the Skeleton Model Wizard.
• Go to Reference Target: Click this icon to open the referenced Software Cluster in the AUTOSAR Model Explorer.
• Comparison Operator: Displays with which operator the Software Clusters are compared. Click the arrow to select or modify the comparison operator.
• Version: Displays the version to be compared. Edit the field to change the version.
• Consider Build Number: The check box indicates whether or not the build number is included in the comparison. Click the check box to enable or disable the consideration of the build number.

General Functions

• Delete: Click this icon to delete the properties of a respective field or a selected element, respectively. For fields that reference an element, only the reference is deleted but not the referenced element itself.

The element Function Group Sets is used for grouping and does not contain any modifiable properties.

Select Function Group Sets in the tree view on the left side of the editor.

A Function Group Set is a container for Function Groups. You can modify a Function Group Set as follows:

• Name: Displays the name of the Function Group Set. Edit the field to change the name.
• Description: Displays the description of the Function Group Set. Edit the field to change the description.
• Function Groups: The table lists all Function Groups contained in the Function Group Set. Click Create Function Group to open a dialog in which a new Function Group can be defined.

General Functions

• Delete: Click this icon to delete the properties of a respective field or a selected element, respectively. For fields that reference an element, only the reference is deleted but not the referenced element itself.

Select a Function Group in the tree view on the left side of the editor.

The Function Group can be modified as follows:

• Name: Displays the name of the Function Group. Edit the field to change the name.
• Description: Displays the description of the Function Group. Edit the field to change the description.
• Mode Declaration: The Mode Declaration specifies the set of states of the Function Group.
• Select Reference Target: Click this icon to select or modify the reference to the Mode Declaration.
• Create Reference Target with the Skeleton Model Wizard.
• Edit: Click this icon to to open a dialog in which the referenced Mode Declaration can be modified.
• Go to Reference Target: Click this icon to open the referenced Mode Declaration in the AUTOSAR Model Explorer.
• Process Overview: The Process Overview table provides an overview of all Processes that reference this Function Group from their State Dependent Startup Configuration. It shows how the Processes are mapped to the states of the Mode Declaration and which Startup Configuration is used. If a state is referenced and there is a Startup Configuration specified in the State Dependent Startup Configuration, then the name of the Startup Configuration is shown. If a state is not referenced, then the cell is empty.