The I_EditorMachine Machine Editor supports you in managing your Machines.

A Machine element represents a physical or virtual machine that the Adaptive Applications will run on. Its purpose is to provide machine-specific configuration settings, such as describing what resources will be available on the machine (processing units, memory, etc.).

The Machine element also offers the possibility to map Adaptive Application Processes to a machine, the Services they consume or provide, and the IP addresses to be used for this flow of information.

Open Machine Editor

<CTRL> + <SHIFT> + <D>, <M>

Open Editor

To open the Machine Editor, expand your DaVinci Adaptive project in the DaVinci Project Explorer and double click on I_DaVinciDeveloperAdaptive Open Project Dashboard. The Project Frame opens showing the Project Home. You can then open the Machine Editor as follows:

The Machine Editor opens in a new tab of the Project Frame.

Functionality

The Machine Editor provides the functionalities listed below. If not otherwise mentioned, the functionalities available in the I_DetailsMode_FormMode Form mode are described. If you want to manage the properties of an element textually, switch to the I_DMLEditor DML mode via the toolbar and refer to DaVinci Modeling Language Editor for more information.

Machine Editor Functionality

Tree View Structure

Description of Functionalities

I_Machine <Machine>

Select a Machine 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 Machine. Edit the field to change the name.
  • Description: Displays the description of the Machine. Edit the field to change the description.

Machine Design Area

In the Machine Design area, you can change the referenced Machine Design and modify or add Network and Service Discovery Settings of the Machine Design:

  • Reference: Displays the target reference to the Machine Design.
  • I_Reference Select Reference Target: Click this icon to select or modify the reference to the Machine Design.
  • I_SkeletonModelWizard Create Reference Target with the Skeleton Model Wizard.
  • I_GoToReferenceTarget Go to Reference Target: Click this icon to open the referenced Machine Design in the AUTOSAR Model Explorer.
  • Network Settings:
    • I_Create Add Network: Click this icon and follow the Create Network Endpoint wizard to create a Network Endpoint for the Machine Design.
    • I_Edit Edit Network Settings: Click this icon to open a dialog in which the network settings can be edited.
  • Service Discovery Settings:
    • I_Create Add SOME/IP Service Discovery: Click this icon and follow the Create Machine Design wizard to create a SOME/IP Service Discovery for the Machine Design.
    • I_Edit Edit Network Settings: Click this icon to open a dialog in which the network settings can be edited.

Environmental Variables Area

In this area, you can modify or add Environment Variables of the Machine:

  • I_Create Create Environment Variable: Click this icon to add an Environment Variable to the Machine. The created Environment Variable is then listed in the table.
  • Name and Value: To change a name or a value of an Environment Variable, double click on the respective field in the table and enter the new value.

Security and Access Control

  • Enable Remote Access Control for <Machine Name>: Check the checkbox if you want to use Remote Access Control for the machine.

General Functions

  • I_Delete 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.

I_TreeViewStructure_ChildElementI_Processors Processors

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

The table lists all Processes of the Machine as well as the Processor Cores. To map or unnmap a Process to a Processor Core, double click on the respective Processor Core field and cycle through the following states:

  • I_Selectrun: Select this state if the Process shall run on this Core.
  • I_Delete not run: Select this state if the Process shall not run on this Core.
  • Not specified (empty): Leave this field empty to specify no mapping.

I_TreeViewStructure_ChildElementI_TreeViewStructure_ChildElementI_Processor <Processor>

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

The Processor can be modified as follows:

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

Cores Area

  • I_Create Create Processor Core: Click this icon to add a Processor Core to the Processor. The created Processor Core is then listed in the table.
  • I_Delete Delete Processor Core: Click this icon to delete a selected Processor Core.
  • Name and Id: To change a name or a value of a Processor Core, double click on the respective field in the table and enter the new value.

I_TreeViewStructure_ChildElementI_Processes Processes

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

The left table lists all Processes that are not mapped to the current Machine. If a Process is already mapped to another Machine, the mapped Machine is displayed in the column Machine. The right table lists all Processes that are mapped to the current Machine. The mapping can be modified as follows:

  • I_Create Create Process: Click this icon and follow the Create Process wizard to create a Process for the Machine.
  • I_Delete Delete Process: Click this icon to delete a selected Process.
  • I_MapMap: Click this icon to map the selected Process to the current Machine.
  • I_UnmapUnmap: Click this icon to unmap a selected Process from the Machine.
  • I_Clone Clone: Click this icon to clone the selected Process and map the cloned Process automatically to the current Machine.

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.
    • 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 I_Delete Delete.
    • Note: requires MICROSAR BSW r11.25.08 or newer.
  • Selection States for Elements:
    • I_Checkbox_Selected: A single element or the element and all its children are selected.
    • I_Checkbox_allChildrenSelected: Not all children of the element are selected.
    • I_Checkbox_notSelected: A single element or the element and all its children are not selected.
    • I_Checkbox_notSelected / I_Checkbox_notAllChildrenSelected / I_Checkbox_notSelected_readOnly: 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.

I_TreeViewStructure_ChildElementI_TreeViewStructure_ChildElementI_Processes <Process>

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:

  • I_Reference Select Reference Target: Opens the Select Reference Target dialog in which the new target reference can be selected.
  • I_GoToReferenceTarget Go to Reference Target: Opens the referenced target in the AUTOSAR Model Explorer.

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

Startup Configuration Tab

The Startup Configuration can be added or modified as follows:

  • I_Create 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 the 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.
      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.

Logging Tab

In the Logging table, the Log Channels that are used by the Process can be configured. Click I_Add 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.

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 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 Processes row above this one.

General Functions

  • I_Delete 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.

I_TreeViewStructure_ChildElementI_Services Services

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

SOME/IP

The SOME/IP Service Mapping can be modified as follows:

  • I_Create Add Service Mapping: Click this icon to open a dialog in which the Service Instance can be mapped to a Communication Connector.
  • I_Delete Remove Service Mapping: Click this icon to delete a selected Service Mapping.
  • I_Edit Edit: Click this icon to open the selected Service Instance in the Service Editor.

IPC

The IPC Mapping is derived from the Service Instance to Process Mapping and to which Machine the Process is mapped. Since there is no IPC Communication Connector, this is an implicit mapping.
To modify a Service Instance, select a Service Instance and click the I_EditEdit icon. The Safety Layer can also be modified in the grid by double clicking the corresponding cell and selecting the Safety Level from the drop-down list.

I_TreeViewStructure_ChildElementI_Logging Logging

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

If no logging has been configured for this Machine, open the context menu on the Logging node in the tree view and click I_AddCreate Log And Trace Instantiation.

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

  • Dlt ECU Id: Displays the DLT ECU ID. Edit the field to change the value.
  • Queue Size: Displays the configured Queue Size. Edit the field to change the value. Click dec or hex to select whether the value to be displayed in decimal or hexadecimal.
  • Session Id Support: Defines whether the Session ID is used or not. Activate the check box to enable Session ID support.

Log Channels

In this area, you can add or delete the Log Channels of the Machine. In the table, all existing Log Channels of the Machine are displayed as well as the Process that uses the Log Channel. To create a new Log Channel, click I_CreateAdd Log Channel. The new Log Channel is added to the table. Modifications of the Log Channels must be done on the page of the respective subelement.

Log Messages

In this area, you can configure the DLT Log Messages and DLT Message Collection Sets. Defined Log Messages and Message Collection Sets are globally available and can therefore also be used by other Machines.

  • Dlt Message Collection Set: Displays the selected DLT Message Collection Set. Click the arrow if you want to select a different existing DLT Message Collection Set.
  • I_Add Add Collection: Click this icon to open a dialog in which a new DLT Message Collection Set can be created.
  • Dlt Log Messages: In the table, all existing DLT Log Messages are displayed. To change a value of a DLT Log Message, double click on the respective field.
  • I_Add Add Message: Click this icon to add a new DLT Log Message to the table.

General Functions

  • I_Delete 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.

I_TreeViewStructure_ChildElementI_TreeViewStructure_ChildElementI_LogChannel <Log Channel>

Select a Log Channel 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 Log Channel. Edit the field to change the name.
  • DLT Log Channel Design: Displays the referenced DLT Log Channel Design.
    • I_Reference Select Reference Target: Click this icon to select or modify the reference to the DLT Log Channel Design.
    • I_GoToReferenceTarget Go to Reference Target: Click this icon to open the referenced DLT Log Channel Design in the AUTOSAR Model Explorer.

Log Item Identities

This area displays the following information:

  • Application ID: Displays the Application ID. Edit the field to change the value.
  • Context ID: Displays the Context ID. Edit the field to change the value.
  • Session ID: Displays the Session ID. Edit the field to change the value. Click dec or hex to select whether the value to be displayed in decimal or hexadecimal.

ID Description

Click the plus icon to show the Application Description and Context Description. Edit the fields to change the description.

Logging Configuration

This area consists of the following tabs Logging Behavior and Log Messages:

  • Logging Behavior: In this tab, the Log Level and Log Sink (e.g. file or console) can be configured:
    • Log Level: Displays the initial log reporting level. Click the arrow to select a Log Level.
    • Non-Verbose Mode: Displays whether the Log Channel supports non-verbose DLT messages. Activate the check box to enable the non-verbose mode.
    • Console: Displays whether the Logging information is passed to the console or not. Activate the check box to enable the logging information to be displayed in the console.
    • File: Displays whether the Logging information is passed to a file or not. Activate the check box to enable the logging information to be passed to the file that is specified in the attribute File Path.
    • File Path: Displays the file path that is used for the logging information if the attribute File is enabled.
    • Network: Displays whether the Logging information is transmitted to a VLAN network or not. Activate the check box to enable the transmission to the VLAN network as specified in the attribute End Point Configuration.
    • End Point Configuration: Displays the referenced network configuration that is used for the transmission of the logging information if the attribute Network is enabled.
    • I_Reference Select Reference Target: Click this icon to select or modify the reference to the network configuration.
    • I_GoToReferenceTarget Go to Reference Target: Click this icon to open the referenced network configuration in the AUTOSAR Model Explorer.
  • Log Messages:
  • The Log Messages table displays all DLT Message Collection Sets and their contained DLT Messages.

General Functions

  • I_Delete 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.

 

MICROSAR Adaptive Parameters Area

This area contains MICROSAR Adaptive Parameters that are specified as Model Extensions (MEX) in the MICROSAR Adaptive BSW Package. Parameters for the selected AUTOSAR model element are displayed in the table of the MICROSAR Adaptive Parameters area on the respective pages of the Machine Editor. Select a parameter in the table to view the editing options.

notice

For more information on the MICROSAR Adaptive Parameters, refer to the Technical Reference in the .\Doc\TechnicalReferences folder of your MICROSAR Adaptive BSW Package.