lisa v 2.x user's guide - etas · 12 lisa functions figure 3-3: lisa sensor position dialog...
TRANSCRIPT
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