CCS Standardfunction   ECUMemDataStr [Str]
 

ECUMemDataStr [Str]

Container_Type [Str]

Session_Name [Str]

Data_Type [Str]

Data_Type_Name [Str]

Data_Attribute [Str]

PAV_Format [Str]

Characters [INT]

Description of Function

This function provides the facility for accessing data that is in the ECU memory container or is deducible from it. That data is related to the function LoadFile. A detailed list of the possible functions is given below.

The data does not have to be redetermined for every test. In order to minimize the access time, the data is retrieved once (or each time it is altered) from the ECU memory container and stored internally on the testing station in a form that allows rapid access. The conversion of the data into the internal format can also be performed manually which makes it possible to use the function before a valid ECU memory container is available.

The return value is always a string.

Testing Points

None

Parameters

Container_Type

Specifies the type of ECU memory container. Values currently allowed are FSW (vehicle software), TSW (test software) and WP (factory programming).

Session_Name

Specifies the name of the session in the ECU memory container from which the required data is to be read.

Data_Type

Specifies the type of the data to be read.

Data_Type_Name

Specifies the name of the required data type (if the entry is not accessible by name, Data_Type_Name is left blank).

Data_Attribute

Specifies which attribute of the data is to be returned.

PAV_Format

Specifies the format in which the data read is to be returned to the PAV. B=Binary, F=Floating-point number, H=Integer in hexadecimal format, I=Integer in decimal format, S=String. Data in the container starting with 0x and consisting of the strings of the characters 0..9, A..F are interpreted as hexadecimal numbers. In integer format, x.0 is accepted as a whole number but any other number with a decimal fraction produces an error message. Container data that cannot be formatted or interpreted unambiguously also produces an error message.

Characters

Specifies the number of characters to be returned. If the specified character string in the ECU memory container is shorter than the length specified by this parameter, the appropriate number of leading zeros is added. If the character string is longer than the number of characters specified by this parameter, an error message is generated. If no figure is specified or the number of characters specified is 0, the character string is returned unmodified.

The character - is not permissible as a specified number of characters.

In the case of format F (floating-point number), the specified number of characters is interpreted as the number of decimal places. Surplus decimal places are truncated without rounding the number.

In the case of format S, the container data is copied to the return string unmodified. If a figure is specified for the number of characters, the string is padded out to the required length by adding leading zeros.

The following table shows some examples of the representation of the measured data in the PAV line according to container data, the selected PAV format and the number of characters:

Runtime Parameter

Container Data

PAV_Format

No. of Characters

0x12

12

12.0

12.789

0xHallo

I

,18`

,12`

,12`

Error

Error

1

Error

Error

Error

Error

Error

4

,0018`

,0012`

,0012`

Error

Error

B

,10010`

,1100`

,1100`

Error

Error

3

Error

Error

Error

Error

Error

6

,010010`

,001100`

,001100`

Error

Error

H

,12`

,C`

,C`

Error

Error

4

,0012`

,000C`

,000C`

Error

Error

F

,18.0`

,12.0`

,12.0`

,12.789`

Error

2

,18.00`

,12.00`

,12.00`

,12.78`

Error

S

,0x12`

,12`

,12.0`

,12.789`

'0xHallo'

2

Error

,12`

Error

Error

Error

4

,0x12`

,0012`

,12.0`

Error

Error

7

,0000x12`

,0000012`

,00012.0`

,012.789`

'0xHallo'