Ecosim Pro adapter

EcosimPro adapter on GitHub

This section provides basic materials for use by CDF Domain Experts.

PURPOSE OF THE SOFTWARE

The EcosimPro adapter is a stand-alone application. It provides a way to exchange data between an ECSS-E-TM-10-25 hub data source and an OPC-UA server built from EcosimPro software. By meaning of providing connection to an OPC-UA server, the EcosimPro adapter allows the user to run or reset the experiment, which lives in the OPC-UA server and reading data updates on the fly as the variables affected by the experiment server change. The adapter is capable of writing values that have been selected from value set from the hub model to any OPC-UA variable that has write access. Since the experiment generates time tagged values for its variable, the adapter keeps track of them, and allows to transfer the whole set or a selection to a hub Parameter of type SampledFunctionParameterType. Between the setting up of the mapping and the transfer, the adapter provides a preview of mapped things by Highlighting changes in the relevant data trees and displaying representation of things that have been mapped. It is also possible to filter the preview by selection. The adapter keeps track of the mapping and saves in the ExternalIdentifierMap of the open Iteration. The EcosimPro Adapter eases the way engineer will use EcosimPro and COMET®, by providing easy data exchange and by allowing the run of experiment.

EXTERNAL VIEW OF THE SOFTWARE

The adapter needs two data sources to be operational.

  • A WSP or a COMET® server connected to a COMET® database.
  • An OPC-UA Server generated from EcosimPro. The OPC-UA server hosts the variables and the experiment which serves to generate the server binaries in EcosimPro.

OPERATIONS ENVIRONMENT

General

The EcosimPro adapter is stand-alone application, so no installation of the software itself is required. It is sufficient to run the executable “DEHPEcosimPro.exe” to get the adapter running. The software runs on windows system and on both 32bits and 64bits platform.

Hardware Configuration

The minimum hardware configuration is the following.

  • 1 GHz or faster processor
  • 512 MB of RAM (work with larger models will require larger RAM usage)
  • 50 MB of available hard disk space
  • A display with a minimum resolution of 800 pixels by 600 pixels

Software Configuration

Supported Operating System

The EcosimPro adapter is targeting .Net 4.7.2, therefore it is compatible with the following platform:

  • Windows 7 SP1 (x86 and x64)
  • Windows 8.1 (x86 and x64)
  • Windows 10 Anniversary Update (x86 and x64)
  • Windows Server 2008 R2 SP1 (x64)
  • Windows Server 2012 (x64)
  • Windows Server 2012 R2 (x64)
  • Windows Server 2016 (x64)

Runtime

The EcosimPro adapter requires that the Microsoft .NET Framework 4.7.2 runtime [RD1] is installed to run. Which is usually the case by default if you are running an up-to-date version of Windows 10.

EcosimPro and OPC UA

The EcosimPro adapter requires a connection to a OPC UA server to use the software at full potential. The OPC UA server can either be hosted elsewhere than locally, launched from EcosimPro or even from its binaries folder, in the case you received a compiled and ready to run OPC server. The OPC UA server should not contain any experiment integration at start up.

COMET® WebServices

The minimal version of the COMET® WebServices is version 7.0.5. The recommended version is 7.0.7.

Operational Constraints

Start-up

When the adapter starts, you can connect to a e-TM-10-25 model. Once this is done, you should be able to browse the ElementDefinition tree. You can then now open a connection to an OPC UA Server. After this step you can browse the Variable from the EcosimPro model.

Run the Experiment

After the adapter is connected to an OPC UA server. You can set-up the preciseness of the sample values resulting from the experiment by changing the CINT and the TSTOP values. You can also run/pause and reset the experiment.

Transfer and Mapping

The EcosimPro adapter lets you transfer values from and to an EcosimPro Model to A E-TM-10-25 model. To load a mapping configuration, select one on the provided list and proceed with clicking on the button next to the provided list. To create a new one, type the name of the mapping configuration that you want to create and proceed with the same action. Defined mappings are not editable after they has been saved. The persistence of a mapping is done after a transfer. Currently, there is no possibility to remove or modify a defined mapping. The mapping configuration is only able to add new mapping.

Impact view

The described functionalities in 2.4.3 register themselves in a process where once you have defined what value to transfer to what destination, you have the possibility to preview the impact on the target model, but also to filter those impact view based on a selection from the source model.

Then you can transfer your mapped values to their configured destination.

Transfer

When you choose to transfer, the mapped values are then transferred to the configured target model. In the case anything goes wrong at this stage, you can cancel, and it will delete every configured mapping.

Saved Mapping Configuration

When a transfer has been done, the mapping configuration is saved in the open E-TM-10-25 Iteration. This saved mapping configuration is applied each time you map one thing that have been mapped already. This mapping can be overridden.

Operations Basics

From the moment the adapter has started. In order you can

  • Connect to a E-TM-10-25 source.
  • Connect to an OPC UA server.
  • Run the experiment.
  • Map some value from the connected E-TM-10-25 Model to one OPC UA Variable
  • Preview the net change.
  • Transfer the mapped values.
  • Run the experiment.
  • Map some OPC UA Variable set of values to some-TM-10-25 Parameter.
  • Preview the net change.
  • Transfer.

Table of contents