ASAM XIL Integration

This section describes the Typhoon HIL implementation of the ASAM XIL standard.

ASAM XIL in the Typhoon HIL toolchain

ASAM XIL consists of standardized API functions defined by the Association for Standardization of Automation and Measuring systems. More information about the standard can be found at: https://www.asam.net.

The Typhoon HIL implementation of ASAM XIL can be used through scripts or by any third party tools which supports this standard and provides an opportunity to use Typhoon HIL real time devices. The Typhoon HIL API is automatically available with installation of Typhoon HIL Control Center (THCC) and doesn’t require any additional setup.

Supported ASAM Standard

ASAM XIL-MA or MAPort (Model Access Port) is implemented. This port specifies the necessary functions required for accessing and controlling the HIL model. Read/write functionalities, simulation control functions, and capturing functionalities are implemented. The current implementation of the ASAM XIL standard within the Typhoon HIL toolchain uses the C# programming language. At the moment, ASAM XIL 2.1.0 version is supported.

Using ASAM XIL in Typhoon HIL Control Center

In order to execute tests, Typhoon HIL Control Center (THCC) needs to be installed. Once a test is executed, THCC is automatically started in headless mode. During test execution it is possible to open all tools (e.g. Schematic Editor) except HIL SCADA.

If a HIL device is not present, VHIL will be automatically started.

ASAM XIL Model File

The model file is used to specify the path to the schematic (.tse) and configuration (.runx) files. This is an XML file with paths specified through tags: schematic_path and model_settings.

Example:

<?xml version='1.0'?>
<root>
 <schematic_path>schematic_absolutepath\file_name.tse</schematic_path>
 <model_settings>model_settings_absolutepath\file_name.runx</model_settings >
</root>

The schematic_path always needs to be defined. The model_settings path can be omitted if the .runx file is not used.

ASAM XIL Features and Limitations

  • Read/write access to the model variables is available through the dynamic part of the model. This means that model variables cannot be read or changed in the schematic part of the model.
  • Simulation control. Start and stop functionalities are implemented. Simulation pause is not available.
  • Capturing is available through streaming signals. MDF4 and CSV file formats are supported. Triggering options are not supported.
  • Watchers are not supported.
  • Signal stimulation is not supported.
  • HIL and VHIL are supported.

ASAM XIL Supported Functions

List of currently supported functions:

  • IMAPort.Configure
  • IMAPort.CreateCapture
  • IMAPort.Disconnect
  • IMAPort.GetDataType
  • IMAPort.GetVariableInfo
  • IMAPort.IsReadable
  • IMAPort.IsWritable
  • IMAPort.LoadConfiguration
  • IMAPort.Read
  • IMAPort.StartSimulation
  • IMAPort.StopSimulation
  • IMAPort.TaskNames
  • IMAPort.VariableNames
  • IMAPort.Write
  • IMAPortFactory.CreateMAPort
  • ICapture.Start
  • ICapture.Stop
  • ICapture.getState
  • ICapture.getVariables
  • ICapture.setVariables
  • ICapturingFactory.CreateCaptureResultMDFWriterByFileName