Contents

1 Introduction

1.1 SGE Circus user manual

1.2 SGE CalcGuide user manual

1.3 SGE Circus videos (external)

2 Installation / Usage

3 Activation / Licensing

4 Help / Support

5 Supported hardware / software

5.1 MATLAB/ Simulink

5.2 CAN hardware interfaces

5.3 Calibration software

6 Data acquisition

6.1 Configuration

6.2 Time axis consideration

7 Block reference

7.1 Common

Realtime slowdown

7.2 ETAS INCA

ECU working page active

Set ECU active page

Get INCA values

Set INCA values

Get INCA online state

Start INCA recording

Stop INCA recording

Pause INCA recording

Activate Scenario

7.3 CAN Bus

Get CAN values

Send CAN values

8 General information



SGE Simulink Library – User Manual

www.sge-ing.de – Version 1.62.67 (2022-07-24 22:21)

1 Introduction

The Simulink Library SGE extends Mathworks Simulink and Stateflow with powerful interfaces and functions that communicate with ETAS INCA software and CAN bus networks.

By combining the extensive functions and intuitive operation of Mathworks Simulink and Stateflow with these interfaces, online functionalities, automation and control tasks that interact with ECUs and CAN bus networks can be implemented conveniently and quickly.

Various ETAS INCA features are supported, such as

Additionally signals can be received and transmitted in CAN bus networks.

This manual gives information about the topics regarding the SGE Simulink Library only. The SGE Simulink Library is part of the SGE Circus. For help topics regarding general features please refer to the corresponding documentation accessible using the links below.

1.1 SGE Circus user manual

The SGE Circus documentation makes available general information regarding data loading procedure, input handling, preferences, history and other topics concerning all tools.

1.2 SGE CalcGuide user manual

The SGE CalcGuide is a tool to implement calculation routines by creating graphical flow chart diagrams - included with all tools.

1.3 SGE Circus videos (external)

Videos and tutorials are available on the internet.


For information regarding the version dependent software changes please refer to the Release notes accessible using the corresponding menu item inside the SGE Circus.

2 Installation / Usage

For installation, the compressed file of the SGE Simulink Library is unpacked into a directory that is included in the search path of MATLAB. Alternatively, the path to the files must be added to the MATLAB path. Use the “Set path” toolbar entry or the “pathtool” command to edit the MATLAB path. Then, after updating (F5), the library is displayed in the Simulink Library Browser.

3 Activation / Licensing

You need a proper license file to run most of the blocks of the SGE Simulink Library. If you did not receive a license file yet please remove all portable hard drives and network interfaces from the computer to allow proper detection of the license id. When running blocks of the library you will receive a welcome message that enables to request a license.

4 Help / Support

A detailed help specific for each block is available when pressing the “Help” button in the block parameters dialog. The block parameters dialog is available by double clicking onto a block with the mouse.

If you need assistance regarding the installation or handling of the SGE Simulink Library or if you experience any problems do not hesitate to contact our support by sending us an email to support@sge-ing.de . A set of introduction documents and examples is available using the SGE Circus “?” menu item.

5 Supported hardware / software

The library supports interfaces to the following hardware and software versions:

5.1 MATLAB/ Simulink

5.2 CAN hardware interfaces

5.3 Calibration software

6 Data acquisition

In order to develop and test a simulation reliably, there is a comfortable way for measurement data acquisition. Simulink Signal logging feature allows you to select signals whose data is captured during simulation and stored in the workspace at the end of simulation. This data can then be automatically saved to a file that can be opened by the SGE Circus as a measurement data file.

6.1 Configuration

Proceed as follows to set up the signal acquisition:

As the following illustrations show, the Bouncing Ball Example from Simulink can be evaluated in this way with all the powerful capabilities of the SGE DataArtist.

6.2 Time axis consideration

The saved files contain the Simulink simulation time as time axis. This is determined by the settings regarding the solver and does not correspond to the actual time when using the "Realtime slowdown" block.

In order to evaluate the measurement files related the current time, the "Realtime slowdown" block offers the possibility to make the current time available as an output. This signal can also be acquired and then used to display the measurement data related the current time X-axis (xy display).

7 Block reference

The following section describes the function and parameters of all blocks of the SGE Simulink Library.

7.1 Common

7.1.1 Realtime slowdown

This block slows down the simulation to realtime and provides an output for the current simulation timestep and time.

Block parameters:

7.2 ETAS INCA

7.2.1 ECU working page active

This block reads the working page state from ETAS INCA via COM interface.

The output returns the active ECU page using the following definition:

Block parameters:

7.2.2 Set ECU active page

This block enables to set the active ECU page in ETAS INCA via COM interface.

Use the input to activate the page corresponding to the following definition:

Block parameters:

7.2.3 Get INCA values

This block supports to read numeric values from ETAS INCA via COM interface.

The elements must be measurement or calibration elements. Measurement elements to read will be added to the current experiment automatically. To read single elements of an array you need to append the array index (e.g. _[0]).

To retrieve values from INCA inside a callback use the following code. In this example the numeric value "VarData" of the experiment element "VarName" is retrieved:

Inca = SGEIncaBridge();

VarData = Inca.GetValue('VarName');

Block parameters:

7.2.4 Set INCA values

This block supports to write numeric calibration values to ETAS INCA via COM interface.

The elements must be calibration elements. Writing to measurement elements is only supported if this feature is activated in the INCA options.

To write values to INCA inside a callback use the following code. In this example the numeric value "VarData" is written to the experiment element named "VarName":

Inca = IncaBridge();

Inca.SetValue('VarName',VarData);

Block parameters:

7.2.5 Get INCA online state

This block reads the acquisition state from ETAS INCA via COM interface.

The output returns the data acquisition state using the following definition:

Block parameters:

7.2.6 Start INCA recording

This block starts the recording of ETAS INCA via COM interface. Use this block inside a triggered or enabled subsystem to start recording depending or an external signal or condition.

Block parameters:

7.2.7 Stop INCA recording

This block stops the recording of ETAS INCA and saves a measurement file via COM interface. Use this block inside a triggered or enabled subsystem to pause recording depending or an external signal or condition.

Block parameters:

7.2.8 Pause INCA recording

This block pauses the recording of ETAS INCA via COM interface. Use this block inside a triggered or enabled subsystem to stop recording depending or an external signal or condition.

Block parameters:

7.2.9 Activate Scenario

This block activates an existing calibration scenario in ETAS INCA via COM interface. Use this block inside a triggered or enabled subsystem to activate scenarios depending or an external signal or condition.

Block parameters:

7.3 CAN Bus

7.3.1 Get CAN values

This block supports to read values from a CAN bus using an ETAS ES581 or Intrepid ValueCAN3 adapter.

Block parameters:

7.3.2 Send CAN values

This block supports to send values to a CAN bus using an ETAS ES581.3 or Intrepid ValueCAN3 adapter.

Block parameters:

8 General information

Duplication, processing, distribution or any form of commercialization of the documents content beyond the scope of the copyright law shall require the prior written consent of the SGE Ingenieur GmbH. All trade and product names given in this document may also be legally protected even without special labeling (e.g. as a trademark).


The SGE Circus includes Third Party Software. For details please refer to the → SGE Circus documentation.


SGE Ingenieur GmbH – www.sge-ing.de

Copyright 2011-2022. All rights reserved.