Machine Editor

The editor-machine 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 da-vinci-developer-adaptive Open Project Dashboard. The Project Frame opens showing the Project Home. You can then open the Machine Editor as follows:

Open the Editor menu on the top right of the Project Dashboard and click the Machine Editor command.
Alternatively, use the context menu command Open Machine Editor of the Open Project Dashboard node in the DaVinci Project Explorer.
Alternatively, on the Dashboard page of the Project Home, click Machine Editor in the Comfort Editors area.
Alternatively, on the Dashboard page of the Project Home, click the arrow of the Current Focus drop-down list and select Machine Integration. In the Machines area, click the Edit button (this requires at least one created Machine).
Alternatively, use the context menu command Open in Machine Editor of a Machine, Machine Design, Service Interface or a Service Instance in the AUTOSAR Model Explorer.

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 details-mode-form-mode Form mode are described. If you want to manage the properties of an element textually, switch to the dml-editor DML mode via the toolbar and refer to DaVinci Modeling Language Editor for more information.

Table 1. Machine Editor Functionality

Tree View Structure

Description of Functionalities

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.
Select Reference Target: Click this icon to select or modify the reference to the Machine Design.
Create Reference Target with the Skeleton Model Wizard.
Go to Reference Target: Click this icon to open the referenced Machine Design in the AUTOSAR Model Explorer.
Network Settings:
- Add Network: Click this icon and follow the Create Network Endpoint wizard to create a Network Endpoint for the Machine Design.
- Edit Network Settings: Click this icon to open a dialog in which the network settings can be edited.
Service Discovery Settings:
- 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.
- 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:

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 check box if you want to use Remote Access Control for the machine.

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.

tree-view-structure-child-element 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 un-map a Process to a Processor Core, double click on the respective Processor Core field and cycle through the following states:

run: Select this state if the Process shall run on this Core.
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.

tree-view-structure-child-element 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

Create Processor Core: Click this icon to add a Processor Core to the Processor. The created Processor Core is then listed in the table.
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.

tree-view-structure-child-element 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:

Create Process: Click this icon and follow the Create Process wizard to create a Process for the Machine.
Delete Process: Click this icon to delete a selected Process.
Map: Click this icon to map the selected Process to the current Machine.
Unmap: Click this icon to unmap a selected Process from the Machine.
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 check box.

Enable Local Com Access Control for <Machine Name>:
- Check the check box 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 CM Access Control for example, as a database.
  
  policy-based: the generator creates one policy file defined per User ID.
- To remove the Access Control Type click Delete.
  MICROSAR BSW r11.25.08 or newer required.
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.

tree-view-structure-child-element 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:

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 referenced Process Design 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 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

Logging Sinks Area

If the selected process is not mapped to a Dlt Application, click Create Missing Model Elements to create missing elements like a Dlt Application, a Dlt Context, a Dlt Application to Process Mapping, a Dlt Log Sink to Port Prototype Mapping, a Log and Trace Instantiation and a Dlt ECU. The missing model elements can be created as follows:

Create Application
- Name: Edit the name of the Application that should be created.
- Application Id: Enter the Id for the Application that should be created.
Create DltContext:
- Name: Edit the name of the DltContext that should be created.
- Package: Select the AUTOSAR Package in which the DltContext should be created.
- File: If not selected automatically, select the ARXML file in which the DltContext should be created.
Create DltLogSinkToPortPrototypeMapping:
- Name: Edit the name of the DltLogSinkToPortPrototypeMapping that should be created.
- Package: The package should already be preselected with the selection of the previous step.
- File: The file should already be preselected with the selection of the previous step.
Select Port
- Select the Port you want to map to the mapping.

The missing model elements are now created.

Dlt Log Sink to Port Prototype Mapping: Displays the mapping element for mapping a Dlt Log Sink to a Port Prototype. Edit the mapping element by choosing one of the following interactions:
- Select Reference Target: Click this icon to select or modify the reference to the mapping element.
- Create Reference Target with the Skeleton Model Wizard.
- Go to Reference Target: Click this icon to open the referenced mapping element in the AUTOSAR Model Explorer.
Application ID: Displays the identifier of the mapped Application. To edit the value, click on the input field.

Some attributes for displaying and/or configuring Dlt Log Sink settings in the table are only available if certain Model Extensions (compare to MICROSAR Adaptive Parameters Area) are used.

Create: Click this icon to create a Dlt Log Sink.
Name: This table column displays the Names of Dlt Log Sinks. To edit the values, double click on the corresponding cells.
Category: This table column displays the Categories of Dlt Log Sinks. To edit the values, double click on the corresponding cell and choose one of the category values in the dropdown.
Log Threshold: This table column displays the Log Thresholds for Dlt Log Sinks. To edit the values, double click on the corresponding cell and choose one of the log thresholds in the dropdown.
Path: This table column displays the Paths of Dlt Log Sinks. To edit the values, double click on the corresponding cells.
Queue: This table column displays the Queues for Dlt Log Sinks. To edit the values, double click on the corresponding cells.

Logging Context Area

Some attributes for displaying and/or configuring Dlt Context settings in the table are only available if certain Model Extensions (compare to MICROSAR Adaptive Parameters Area) are used.

Create: Click this icon to create a Dlt Context.
Name: This table column displays the Name of the Dlt Context. To edit the values, double click on the corresponding cells.
Context Description: This table column displays the Dlt Context Description. To edit the values, double click on the corresponding cells.
Context ID: This table column displays the identifier of the Dlt Context. To edit the values, double click on the corresponding cells.

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.

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

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.

tree-view-structure-child-element 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:

Add Service Mapping: Click this icon to open a dialog in which the Service Instance can be mapped to a Communication Connector.
Remove Service Mapping: Click this icon to delete a selected Service Mapping.
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 Edit 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.

tree-view-structure-child-element 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 add New Log And Trace Instantiation. General settings for creating a new Log and Trace Instantiation and Dlt ECU can be specified:

Log And Trace Instantiation
- Name: Edit the name of the Log and Trace Instantiation that should be created.
Dlt ECU
- Name: Edit the name of the Dlt ECU that should be created.
- Package: Edit the AUTOSAR Package in which the Dlt ECU should be created.
- File: Edit the ARXML file in which the Dlt ECU should be created.

tree-view-structure-child-element log-channel <Log and Trace Instantiation>

Select a Log and Trace Instantiation in the tree view on the left side of the editor.

Log Demon Level Sinks Tab

Log And Trace Instantiation Area

Dlt ECU: Displays the Dlt ECU reference. Edit the Dlt ECU reference by choosing one of the following interactions:
- Select Reference Target: Click this icon to select or modify the reference to the Dlt ECU.
- Create Reference Target with the Skeleton Model Wizard.
- Go to Reference Target: Click this icon to open the referenced Dlt ECU in the AUTOSAR Model Explorer.
Dlt ECU ID: Displays the identifier of the referenced Dlt ECU for use within the Dlt protocol. To edit the value, click on the input field.
Time Source: Displays the Time Source reference. Edit the Time Source reference by choosing one of the following interactions:
- Select Reference Target: Click this icon to select or modify the reference to the Time Source.
- Create Reference Target with the Skeleton Model Wizard.
- Go to Reference Target: Click this icon to open the referenced Time Source in the AUTOSAR Model Explorer.

Process Mapping Tab

Dlt ECU Area

Processes in Machine: This table column displays all Processes for the dedicated Machine.
Application: This table column displays Dlt Applications that are mapped to dedicated Machines. To create/add and map a Dlt Application to a dedicated Process, double click on the corresponding cell.
Application ID: This table column displays the Application ID of a dedicated Dlt Application.

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.

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.

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