LiSA V2.8 User's guide

Copyright

The information in this document may not be changed without special permission of

ETAS GmbH. Furthermore, ETAS GmbH undertakes no further obligations with this

document. The software presented in this document is provided based on a general

licensing agreement or an individual license.

Use and duplication is permitted only in accordance with the contractual agreements.

No part of this publication may be copied or duplicated in any form,

stored in a retrieval system or translated into another language under any

circumstances without the written approval of ETAS GmbH.

© Copyright 2016 - 2019 ETAS GmbH, Stuttgart

The designations and names used are trademarks or trade names of their respective

owners.

Document AS_LiSA_V2_UG_EN (F-00K-107-368) R4.0.0 EN

2 Introduction and Summary

Contents

1 Introduction and Summary 7

2 Terms and Definitions 9

3 LiSA Functions 11

3.1 The LiSA User Interface 11

3.2 LiSA Result Output Formats 12

3.3 LiSA Results Output 12

3.4 Verification Method 14

3.5 EGS-LI-Sensor Signal Naming Convention 16

3.6 Signal Names and EGS-LI-Sensor Positions 17

3.7 Measurement Data Formats 18

4 ELiS4 CANDB Generator 19

5 Installation 20

6 Licensing 22

6.1 The License File 22

7 Release Notes, Documentation and Safety Instructions 23

8 ETAS contact information 24

Introduction and Summary 3

Figures

Figure 3-1: User Interface LiSA ................................................................................................................... 11

Figure 3-2: LiSA Progress bar ...................................................................................................................... 11

Figure 3-3: LiSA Sensor position dialog ........................................................................................................ 12

Figure 3-4: LiSA Export menu ..................................................................................................................... 12

Figure 3-5: LiSA Table of sensor positions and sensor module serial numbers.................................................. 12

Figure 3-6: LiSA Result Table ...................................................................................................................... 13

Figure 3-7: LiSA Result Diagram .................................................................................................................. 13

Figure 3-8: Regular Temperature and Heating Power time series. .................................................................. 14

Figure 3-9: Peak Indication of a False Positive Droplet .................................................................................. 15

Figure 3-10: Oscillation Indication of a False Positive Droplet ......................................................................... 16

Figure 3-11: Oscillation Indication of a False Positive Droplet ......................................................................... 16

Figure 3-12: Signal Naming Convention ....................................................................................................... 17

Figure 4-1: User Interface of the ELiS4 CANDB-Generators ............................................................................ 19

Figure 5-1: Installation (1) .......................................................................................................................... 20

Figure 5-2: Installation (2) .......................................................................................................................... 20

Figure 5-3: MATLAB Runtime installation (1) ................................................................................................ 20

Figure 5-4: MATLAB Runtime installation (2) ................................................................................................ 21

Figure 5-5: MATLAB Runtime installation (3) ................................................................................................ 21

Figure 6-1: ETAS License Manager, server-based permanent LiSA license ....................................................... 22

4 Introduction and Summary

Figure 7-1: Viewing the LiSA’s User’s Guide, Safety Advice and Release Notes ................................................. 23

Introduction and Summary 5

Tables

6 Introduction and Summary

Introduction and Summary 7

1 Introduction and Summary

This document describes the software application LiSA and is valid for versions 2.8.

LiSA implements the evaluation of measured data taken on an ensemble of droplet sensors of type EGS-Li as provided by Robert Bosch GmbH. It is assumed the sensors are fitted to the exhaust system of a vehicle with an internal combustion engine.

Each sensor provides several electrical signals. An electronic module (AS_ELiS4) converts the signals into a time series of values and periodically sends those data to a measurement application on a CAN-Bus. The configuration of the CAN-Bus is implemented in a CAN-DB file. This CAN-DB file may be generated by a software tool outside LiSA (CANDB-Generator), provided by ETAS. The generator tool collects the EGS-Li sensor serial number (S/N) as well as other information about the position of the sensor in the exhaust system to generate the database and the CAN-Bus signal names. A naming convention correlates measured values to individual sensors in defined positions in the exhaust gas system. The sensor signals are then collected by a measurement system (i.e. INCA) and stored as a file using a standardised format (MDF).

The software application described in this document is useful for evaluating the so collected data. A

droplet detection algorithm provided by Robert Bosch GmbH, PS-EC/EBI6 extracts individual droplet events from the measured data. These events are listed in tabular and/or graphical form.

Warning!

Droplets with an evaporation duration of less than 15ms are ignored!

Warning!

Possible droplets at a sensor temperature > 250 °C and a droplet volume < 0.5 µl are ignored because they are not relevant for Bosch TSP sensors.

Warning!

The liquid sensor is calibrated for volumes up to 40 µl, therefore droplets above this threshold can be bigger than displayed.

8 Introduction and Summary

Terms and Definitions 9

2 Terms and Definitions

Term Description

EGS LI Robert Bosch (Exhaust Gas) Liquid Sensor, Robert Bosch GmbH

AS_ELiS4 Electronic module for EGS LI, ETAS GmbH, Germany

MDF Standardised measurement data format, ASAM e.V.

MATLAB® Analysis- und simulation tool published by The MathWorks Inc., USA

INCA® Measurement and calibration tool published by ETAS GmbH, Germany

CANDB-Generator Software generator tool for CAN-Bus signals, ETAS GmbH, Germany

HTML standardised mark-up language for web browsers

CSV ASCII data format „Comma Separated Values“

10 Terms and Definitions

LiSA Functions 11

3 LiSA Functions

3.1 The LiSA User Interface

The graphical user interface of LiSA shows the following dialog and allows for the interactions:

1. Show LiSA version number 2. Select one measurement file (file name of an MDF-file) or a measurement set by selecting more

than one file. 3. Select a folder to store the results 4. Select one of two output formats (HTML or CSV) 5. Switch on immediate display of the results in a browser when output format is HTML 6. Start the evaluation process by hitting “Start Detection”

7. Cancel LiSA execution by pressing

Figure 3-1: User Interface LiSA

After confirmation of the selected file(s) by pressing “Start Detection” a progress bar appears showing the percentage of processed data and the estimated remaining time.

Figure 3-2: LiSA Progress bar

In case the signal names do not specify the Liquidsensor position correctly (see 3.6 Signal Names and EGS-LI-Sensor Positions), the LiSA requests the user to define the sensor position with the following dialog.

12 LiSA Functions

Figure 3-3: LiSA Sensor position dialog

After the end of the data evaluation the progress bar disappears and LiSA program execution returns to the LiSA Main Dialog. If “HTML” or “consolidated HTML” is selected as export format, the default web browser will be opened, showing the evaluation results.

3.2 LiSA Result Output Formats

The output of LiSA is one or more files in either HTML or CSV format. A graphical diagram showing droplet size and deduced liquid flow will appear in the HTML format only. The CSV output is intended for further

processing in a customer tool chain.

Choose the export format using the ‘Export’ drop down menu in the LiSA main dialog window.

Figure 3-4: LiSA Export menu

The HTML export format will produce one output html-file per input file, listing all droplets of all sensors sorted by sensor.

The consolidated HTML export format will produce a single output html-file named “LiSA-consolidated Results.html”. It lists all droplets of all sensors and all selected measurement file sorted by sensor S/N. This is one table of results for each ELIS4 sensor with one line per droplet plus one diagram for the same ELIS4 sensor giving the volume and corresponding liquid flow for each droplet. Droplets flagged with ‘Warning’ in the table are circled red in the diagram.

The ‘Export to data folder’ menu item when checked allows you to automatically store the results in the same folder as the selected data. You can still override the result folder in the edit field below the data file

list after selecting data files and before clicking “Start Detection”. But whenever new data files are

selected the result folder entry will be replaced to point to the new data files folder.

3.3 LiSA Results Output

In the results documentation you will see:

1. Date and Time of the evaluation run 2. Version number LiSA 3. Version number of evaluation algorithms 4. Table of sensor positions, sensor module serial numbers

ELiS S/N 7301 7302 7309 7316

Position S1b1 S2b1 S1b2 S2b2

Figure 3-5: LiSA Table of sensor positions and sensor module serial numbers

LiSA Functions 13

5. For each sensor a table is printed with a. Droplet running number b. File ID

c. Name of Measurement file d. Sensor module serial number e. Hit time of droplet f. Droplet volume g. Volume Flow h. Warning i. Number of droplet hits on primary side j. Number of droplet hits on secondary side

Figure 3-6: LiSA Result Table

Droplets with the value of 1 in the column ‘Warning’ have a lower level of confidence and have to be verified using the manual verification method as described in chapter 3.4. Droplets with the value of 2 in the column ‘Warning’ are larger than 40 µl. Due to the measurement principle of the liquid sensor the accuracy is reduced for droplets above 40 µl. These droplets may be larger, than what the numeric value indicates. In order to highlight such droplets in the HTML export, the background colour of the respective cell in the ‘Warning’ column is marked in red. The respective symbols in the plot are circled red. For each sensor LiSA’s graphical output shows one diagram with „Liquid Flow“ and „Droplet Volume“ over time (time after start of data recording).

Figure 3-7: LiSA Result Diagram

14 LiSA Functions

3.3.1 Droplet Volume

This is the volume of liquid computed from an impact event on the liquid sensor. This value is valid for this

impact event only and makes no statement about liquid flow.

Detection limits are 0.1 µl under laboratory conditions and approx. 0.2 µl in a vehicle’s exhaust. Accuracy is ±0.2 µl below 1 µl droplet volume, and ±16 % above. The upper limit of an accurate result is 40 µl.

3.3.2 Liquid Flow

For each impact event, a volume liquid flow is computed using the volume of liquid of the droplet. The computed value is the liquid flow an A/F sensor of type BOSCH TSP would be exposed to, if it were placed in this location in the exhaust gas system. Under the assumption that the liquid flow is uniform over the entire cross section of the exhaust pipe, the value can be scaled to compute the total liquid flow knowing the cross section of the TSP sensor and the exhaust pipe. Because the uniformity of the liquid flow cannot be checked by the EGS-LI sensor, INCA or LiSA, no warranty can be granted for such results.

The Liquid flow is calculated based on time between two droplets and droplet volumes. For the first droplet no time difference is available, therefore no liquid flow calculation is possible.

3.4 Verification Method

This chapter describes a manual method to check the plausibility of droplet event recognition based on liquid sensor measurements.

Manual verification is necessary for droplets marked ‘1’ in the ‘Warning’ column in the ‘Table of Results’. It is also strongly recommended for projects with high gas dynamics, e.g. exhaust systems without turbocharger or sensor positions close to the engine.

The false positive events discussed below can not be identified automatically by the LiSA tool and therefor require manual verification. This verification needs visualisation tools like ETAS MDA to inspect the ELiS4 sensor signals.

A typical time series measurement at 200°C sensor temperature is depicted in Fig. 3-8.

Figure 3-8: Regular Temperature and Heating Power time series.

Please also see the description of the signal characteristic in the document ‘ELIS4 CAN Interface Manual’ available in the download area on www.etas.com.

LiSA Functions 15

3.4.1 Description of False Positive Event

False positive events are those events, in which the LiS signals are falsely identified as a droplet, caused by exhaust gas dynamic. In this case the event must not be considered for the evaluation for the release of sensor heating. As a result a manual verification is necessary to ensure the correct evaluation.

The following conditions may indicate a false positives event:

Both LiS temperatures Tprim and Tsek are greater than 250 °C at droplet event (Warning Level 1)

Similar shape of temperature signal on primary and secondary side at droplet event

Repeated sensor temperature behaviour during several tip-ins

Figures 3-9, 3-10 and 3-11 show typical recordings.

Figure 3-9: Peak Indication of a False Positive Droplet

16 LiSA Functions

Figure 3-10: Oscillation Indication of a False Positive Droplet

Figure 3-11: Oscillation Indication of a False Positive Droplet

3.5 EGS-LI-Sensor Signal Naming Convention

When reading data from a measurement file, LiSA will ignore all data, not recognized as liquid sensor data.

Liquid sensor data are identified by their names. Only channels whose names start with “Tprim_”, “Tsek_” and “Ph_” are considered. After that part the tool requires a serial number, consisting of 4 to 6 digits. Signals of one or more sensors are supported, if all of the three sensor signals are present in a measurement file.

LiSA Functions 17

First LiSA will identify all signal names starting with “Tprim_”, then LiSA checks the existence of further signal names starting with “Tsek_” and “Ph_” having the same name suffix as the corresponding signal “Tprim_”. If a matching “Tsek_” and “Ph_”signal is found for each detected “Tprim_” signal, evaluation

will continue. Otherwise an error message is printed, identifying the missing signal and LiSA terminates execution.

For identifying the location of the sensor in the exhaust system a naming convention as outlined in chapter “3.6 Signal Names and EGS-LI-Sensor Positions” is used. In case no further information is given, LiSA will assume that the location is exhaust bank 1 and position “S1”.

3.6 Signal Names and EGS-LI-Sensor Positions

A signal name has 5 parts, separated by underscore: signal type, serial number of the sensor’s electronic module, exhaust bank number, position w/r to catalyst and a running number (currently not used by LiSA).

Figure 3-12: Signal Naming Convention

Examples: Tprim_7301_1_S1_1 Ph_7316_1_S1_1

To identify a specific sensor and its position in the exhaust system the following naming convention is

used.

The signal type identifies one of three possible signals a sensor generates. There are:

Tprim Temperature of primary side of sensor Tsek Temperature of secondary side of sensor Ph Heating power of both sides of the sensor

The serial number of the sensor module (4 – 6 numeric characters 0-9), the serial number must be unique and must not start with a leading 0.

Serial number [1-9] [0-9] [0-9] [0-9] {[0-9] {[0-9]}}

Exhaust bank number

Exhaust bank n n = 1 ... 4

The position in the exhaust system consists of 2 alphanumeric characters

S1 before primary catalytic converter (former ‘v’) S2 after primary catalytic converter (former ‘f’) S3 after main catalytic converter (former ‘k’) S4 reserved for future use.

One digit for more than one sensor in the same position

Number of the sensor m m = 1 … 9

Serial number, exhaust bank number, sensor position and running sensor number are entries in the ELiS4 CANDB-generator software (see Figure 4-1: User Interface of the ELiS4 CANDB-Generators). It is

18 LiSA Functions

recommended to use the ELiS4 CANDB-generator software to create data bases for ELiS4 data recording.

3.7 Measurement Data Formats

LiSA V2.x supports measurement files complying with the “Measurement Data Format” (MDF) versions 3.0, 3.3, 4.0 or MDF 4.1.

ELiS4 CANDB Generator 19

4 ELiS4 CANDB Generator

The ELiS4 CANDB generator is an application that helps generate a CAN-Bus specification. The programme is available on the website of ETAS GmbH (see www.etas.com).

The ELiS4 CANDB generator lets you select the number of modules in your setup in the vehicle. You may select up to 10 modules in one CAN data base.

Figure 4-1: User Interface of the ELiS4 CANDB-Generators

Next, the interface lets you enter information about the ELiS4 serial number (printed on the module), the bank number and the position in in the exhaust steam. Hitting the OK button will start the process of data base generation and the programme will then terminate.

Please also see the description in the document ‘ELIS4.1 CANdb Generator’ available in the download area on www.etas.com.

20 Installation

5 Installation

LiSA is provided as an executable installation programme ‘LiSA-Setup.exe’ available via the ETAS website. The installation programme allows installing LiSA on a computer using the operating system Microsoft Windows 7 or Microsoft Windows 10 64-bit.

After starting, the installation program displays the following dialog in which you can select the installation location.

Figure 5-1: Installation (1)

The installation files are copied to a temporary folder and will be executed if necessary.

Figure 5-2: Installation (2)

The next step will install MATLAB Runtime required for standalone applications. Please confirm with ‚next‘ and ‘install’, respectively.

Figure 5-3: MATLAB Runtime installation (1)

Installation 21

Figure 5-4: MATLAB Runtime installation (2)

This installation step takes some minutes to complete. A progress bar will be shown during the installation. When done, please confirm the installation with ‚Finish‘.

Figure 5-5: MATLAB Runtime installation (3)

Now LiSA is installed on your workstation and ready to run. A respective icon has appeared on your

desktop (or will be displayed after you reboot).

22 Licensing

6 Licensing

LiSA requires an electronic license to run; i.e., a user needs a license key for LiSA. The key entitles the user to execute the software on exactly one workstation. It is valid for all user accounts on the respective workstation. Concurrent licenses are not offered. The ETAS Licence Manager (LiMa) allows a user to check for a valid license. In the Windows Start menu,

select Programs ￫ ETAS ￫ License Management ￫ ETAS License Manager.

Figure 6-1: ETAS License Manager, server-based permanent LiSA license

If your company has a tool coordinator and server-based license management for ETAS software, contact this person. Otherwise (in the case of a machine-named license) obtain a LiSA license from the ETAS license portal (the URL is shown on your Entitlement Certificate). There are several ways to create a software license key:

• Activation ID Once you have logged in, a specific activation is visible and can be managed – the activation ID is shown on your Entitlement Certificate.

• Entitlement ID All activations of the entitlement are visible and can be managed (e.g. for a company with just one entitlement).

• E-mail and password All activations of the entitlements assigned to the user account are visible and can be managed (e.g. for

a tool coordinator responsible for several entitlements). If you need help in the portal, click the Help link.

What Information is required? Information on the hosts must be entered to activate licenses:

Machine-named license The MAC address of the Ethernet adapter to which the license is to be bound.

6.1 The License File

To add a license file

In the Windows Start menu, select Programs ￫ ETAS ￫ License Management ￫ ETAS License

Manager.

• Select File ￫ Add Licensing File.

The "Install License" dialog window opens. • Next to the "Select License File" field, click the ... button.

• In the file selection window, select the license file and click Open. The "Install License" dialog window shows information on the selected license.

• Confirm with OK. • Close the ETAS License Manager.

Release Notes, Documentation and Safety Instructions 23

7 Release Notes, Documentation and Safety Instructions

Release Notes for every LiSA version inform you about hints and improvements over former versions, limitations, known issues and peculiarities of the respective version of LiSA.

The User’s Guide, Safety Advice and Release Notes can be opened via the Help menu.

Figure 7-1: Viewing the LiSA’s User’s Guide, Safety Advice and Release Notes

24 ETAS contact information

8 ETAS contact information

ETAS Main Office

ETAS GmbH

Borsigstraße 24 Phone: +49 711 3423-0

70469 Stuttgart Fax: +49 711 3423-2106

Germany WWW: www.etas.com

ETAS regional companies and technical support

Information about your local sales and local technical

support and the product hotlines is available on the Internet:

ETAS Regional companies WWW: www.etas.com/en/contact.php

ETAS Technical Support WWW: www.etas.com/en/hotlines.php