E-Sys 3.0.2 Coding - UserManual v1.4 (07.2007) PDF
E-Sys 3.0.2 Coding - UserManual v1.4 (07.2007) PDF
Coding
and
Vehicle Configuration Management
User Manual
Version: 1.4
Valid as of E-Sys Version: 3.0.2
Date: 30.07.2007
Authors: Markus Wolf, EG-75 (Coding)
Dr. Christian Süß, EG-75 (VCM)
Hendrik Spila, Bertrandt for EG-75 (Tutorial)
Number of pages 51
User Manual Coding with E-Sys
_________________________________________________________________________________________________________________
Contents
1 Overview ............................................................................................................................ 3
2 Expert Mode Coding .......................................................................................................... 4
2.1 Graphical User Interface (GUI).................................................................................. 4
2.1.1 Vehicle data........................................................................................................ 5
2.1.2 Software variant table tree.................................................................................. 7
2.1.3 SVT/SVKactual.................................................................................................. 8
2.1.4 KIS ..................................................................................................................... 8
2.1.5 Coding ................................................................................................................ 9
2.1.6 Filter ................................................................................................................... 9
2.2 Operation .................................................................................................................... 9
2.2.1 Coding control unit/vehicle with vehicle order.................................................. 9
2.2.2 Reading out control units ................................................................................. 12
2.2.3 Coding control unit with FDL.......................................................................... 13
2.2.4 Coding control unit to as-delivered condition.................................................. 14
2.2.5 Read CPS.......................................................................................................... 14
3 FDL Editor and CAF Viewer ........................................................................................... 16
3.1 GUI........................................................................................................................... 16
3.2 Tree structure and tree contents ............................................................................... 17
3.3 Operation .................................................................................................................. 20
3.3.1 Editing function values..................................................................................... 21
3.3.2 Editing coding values ....................................................................................... 22
4 Expert Mode Coding Verification.................................................................................... 23
4.1 GUI........................................................................................................................... 23
4.2 Verification of individual Coding Application Files................................................ 24
4.3 Verification by SVT/KIS ......................................................................................... 26
4.3.1 Verification by SVT ......................................................................................... 26
4.3.2 Verification by KIS .......................................................................................... 27
5 FA Editor.......................................................................................................................... 28
5.1 GUI........................................................................................................................... 28
5.2 Operation .................................................................................................................. 29
6 Expert Mode Vehicle Configuration Management (VCM) ............................................. 31
6.1 GUI........................................................................................................................... 31
6.2 Operation .................................................................................................................. 34
6.2.1 File operations .................................................................................................. 34
6.2.2 VCM Master operations ................................................................................... 35
6.2.3 VCM backup operations................................................................................... 36
7 List of abbreviations......................................................................................................... 38
A Coding Tutorial ................................................................................................................ 39
A.1 Coding uncoded control unit without KIS support .................................................. 39
A.2 Creating/editing and coding FDL............................................................................. 46
1 Overview
This Manual describes the procedures for handling all tool components of E-Sys required for
coding control units and entire vehicle electrical systems. These tool components include:
• Expert Mode Coding for writing (coding), reading and modifying coding data of elec-
tronic control units (ECUs) or vehicles.
• Function Data List Editor (FDL Editor) for modifying coding data in control units
• CAF Viewer for viewing Coding Application Files
• Expert Mode Coding Verification for virtual verification (without control units) of
Coding Application Files (CAFs) and for generating system variant tables from KIS
• Vehicle Order Editor for creating and editing vehicle orders
• Expert Mode Vehicle Configuration Management (VCM) for reading and writing ve-
hicle configuration data.
In addition, the Appendix contains a tutorial illustrating the individual steps required for cod-
ing an uncoded control unit without KIS and using the FDL functionality.
This document does not discuss the option of coding control units in pure TAL mode.
E-Sys is used both to code control units developed in accordance with the Coding Specifica-
tions SAP No. 10001491 or that use Standard Core 6.xx and to code carry over control units
for the BN2000 environment in a BN2010 vehicle bus system.
Note: It is advisable to use a colour printer for printed copies of this User Manual since vari-
ous E-Sys displays are colour displays and are unsuitable for monochrome printouts.
The display area uses frames to allow the size of the displays for FA, FP and SVT to be
matched individually
Expert Mode Coding view contains the following components:
• Vehicle data
• SVT
• SVT/SVKactual
• KIS
• Coding
• Filter
The individual components are explained in further detail in the sections that follow.
If an FA list has been read or loaded, the user must initially select an FA and activate it for
further actions. This is done using the context menu (right mouse button) or by double-
clicking (FA entry is marked active). The vehicle profile is then determined for the activated
FA and it is updated in the tree at the right. At the same time, the FA and the VIN are checked
for validity. If the checksum of the VIN at the 9th position is incorrect, work on the selection
cannot continue.
Only one FA may be active at any one time. If an FA is activated and another FA entry from
the list is activated, the currently activated FA is deactivated and the other FA is activated.
The vehicle profile is calculated with the aid of an assignment table (FA2FP) that is a part of
the PDX package. This also includes a check of the activated FA with respect to the FA2FP.
If the FA contains elements (SAs or model codes etc.) that are not contained in the FA2FP,
the selected FA is invalid and work cannot continue. In this case, the errored elements must
be corrected with the FA Editor (see Chapter 5 FA Editor).
The vehicle profile is extracted from the FA. It contains all optional extras and country spec
packages (SALAs) and other information derived from model code, build level, supplemen-
tary and trade organisation words (E words and HO words) and their readable meaning. This
information is broken down within permanently predefined categories as criteria [see also
Performance Specification VCM SAP No.10000908]. For example, this includes the follow-
ing in the vehicle profile shown:
Drive-side category with criterion LL for left-hand drive or
Engine category with criterion N57D30 or
Fuel category with criterion DIESEL etc.
The numerical values in the square brackets represent the machine-readable values of the ca-
tegories and criteria.
The vehicle profile is used when coding for evaluation of the Coding Application Files
(CAFs). The function conditions in CAF files are based on Boolean logic operations of vehi-
cle profile elements and, consequently, only indirectly on vehicle order elements.
The save button can be used to save the displayed FA list as an XML file. The edit button
opens the displayed FA list automatically in the FA Editor (see Chapter 5 FA Editor) for edit-
ing. The vehicle profile can not be saved in this view (see Chapter 6 Expert Mode Vehicle
Configuration Management (VCM) for saving).
CAF identifiers (process class CAFD) are also marked with a symbol providing information
on codability of a control unit in relation to the current configuration. CAFD entries with a
green check mark can be used to code a control unit in the current configuration. Entries with
a red cross cannot. The buttons in the Coding frame can also be used accordingly. Determin-
ing this codability status for coding or read-out of a control unit is based on the following
rules:
1. A control unit can always be coded/read out if CAFD entries are present in the actual
configuration (SVTactual), unless all non-coding process classes, i.e. all other classes
apart from CAFD, are identical and the target configuration (SVTtarget) prescribes a
different CAFD, e.g. with a higher version.
2. A control unit can always be coded/read out if all non-coding process classes in target
and actual configuration are identical.
3. A control unit can never be coded if a basic variant occurs only in the target configura-
tion (control unit not fitted).
4. A control unit cannot be coded if at least one non-coding process class has differences
in target and actual configuration and if there is no CAFD entry in the actual configu-
ration. In this case, the control unit must first be set to the required software build by
flash-programming.
One other special feature of the SVT view in the Coding Expert GUI is fitting function data
lists (FDLs) beneath CAFD elements. FDLs contain the interpreted, read-out coding data of a
control unit in machine-readable form (see also Chapter 2.2.3 Coding control unit with FDL).
• Read-out of a control unit FDL is fitted automatically by E-Sys (see also Chapter
2.2.2 Reading out control units)
• Using the context menu NewFDL on a CAFD entry and selecting an existing FDL
using the File dialog box
2.1.3 SVT/SVKactual
Actual configurations can be read from control units or loaded from a file in section
SVT/SVKist (SVT/SVKactual). If a Vehicle Configuration Management (VCM) is available,
the read (VCM) button can be used to read the entire SVT of a vehicle from its VCM. Identi-
fication of individual control units is performed with read (ECU). In this case, E-Sys sends
functional request read_SVK. The button load can be used to load an SVTactual from a file.
The result is displayed in the SVT tree in all cases (in blue font colour unless an SVTtarget
was already present). The edit button can be used to edit the SVTactual with the SVT Editor,
and save can be used to save the SVTactual to a file.
2.1.4 KIS
Target configurations for control units or control unit networks (vehicle) can be calculated on
the basis of the vehicle order (FA) and a target integration step or can be loaded from a file in
section KIS. The result is shown in the SVT tree in both cases (in font colour red unless an
SVTactual was already present). The edit button can be used to edit the SVTtarget with the
SVT Editor, and save can be used to save the SVTtarget to a file.
Alternatively, there is the option of determining the CAF for individual software units of a
basic variant without specifying an integration step directly using the detect CAF for SWE
function. This function can be applied to SWFL entries or basic variants in the SVT tree.
Note: All KIS functions can be used only if a KIS knowledge base is available. The KIS
knowledge base is installed only on PDX import of an integration step container.
2.1.5 Coding
The buttons in the Coding frame are described in 2.2 Operation.
2.1.6 Filter
The filter can be used to filter the SVT tree by process classes of the SGBM. For example,
only entries with coding data process class CAFD can be displayed. Button SVT Reset deletes
all contents of the SVT tree.
2.2 Operation
Expert Mode Coding basically offers many options for coding control units or entire vehicle
electrical systems. The GUI offers major flexibility depending on application (control unit
development or vehicle commissioning etc.) but also poses risks if operated incorrectly.
1. Read SVTactual from connected control units functionally (button read (ECU)) or VCM
(button read (VCM))
or
load SVTactual from file: This method is suitable only for test purposes and should nor-
mally not be applied.
If the connected control unit is already coded (CAFD entry present in SVTactual), it can
be coded again with the CAF specified in the SVTactual (but, for instance, with a differ-
ent vehicle order).
2. Determine SVTtarget from KIS with button Calculate specifying a target integration Step
(possible only if an integration step container with a KIS knowledge base has been im-
ported)
or
load SVTtarget from file (button load). This is possible only if the required SVTtarget has
been created beforehand with the SVT Editor.
or
detect CAF for SWE via the KIS function. For this purpose, an SVTactual must be read or
loaded. The assigned CAFs can be determined by marking the basic variant or individual
SVT tree contents of process class SWFL by pressing button detect CAF for SWE. The in-
If both SVTactual and SVTtarget have been determined, E-Sys displays both SVTs in the
SVT view merged:
In the case shown, only the CAF from the SVTtarget (red entry) can be used to code the con-
trol unit (green check mark). The control unit is now coded by marking the CAFD entry and
then clicking on button Code (or with Code in the context menu). E-Sys then automatically
generates the required transaction list (TAL) and initiates processing of this list.
A status report on success of the action is displayed at the end of the coding operation:
The report is generated separately for each basic variant. Green font colour shows that the
coding operation was successful and red font colour shows that the coding operation was er-
rored. In the example, basic variant EVALBOARD at address 7E was coded successfully with
cafd-0000006e-001-004-000.
Error:
The illustration below shows that the control unit can be coded only with the actual version of
the CAF in accordance with the rules from Chapter 2.1.2 Software variant table tree. If the
target version is to be coded, the control unit must first be programmed with the target soft-
ware build (SWFL_0000009B_003_000_005).
Coding of individual control units, control unit networks or in the total vehicle is controlled
via marking in the SVT view. The actions triggered with button Code relate to
Parallel TAL execution and stopping of TAL execution in the event of an error:
If switch Parallel TAL-execution has been set when coding at level ECUs (total coding-
related content of the SVT tree) or in the case of multi-selected basic variants, coding of all
selected control units is performed in parallel.
Switch Stop TAL on Error allows you to force an abort of TAL processing after the first error.
Otherwise, errors that occur during the sequence are not displayed in the report until the end
of TAL processing.
The precondition for read-out of control units, as is also the case with coding, is that the CAFs
required in accordance with the SVT view be present in the file system.
The result of read-out operations is a net-coded data file (NCD) and a function data list file
(FDL) per CAF. After read-out, both files are saved automatically to the file system. The
FDLs are also appended in the SVT view as sub-elements of the related CAFD entries in font
colour orange.
The FDL generated can then be opened in the FDL Editor and edited using the context menu
Edit FDL (see Chapter 3 FDL Editor)
S00A0000FF000000010401F0
S206300000663E25
S208300100ACE80F0F14
S20C30210005FF00000001040198
S22430220000000020D62448E9626B1CD69C941DF7470ED8A011063F88DF0ACCAD693
3FFA5EE
S224302220C62ADCC6C7AB18801BC853AABD3D9B94152DEF5495CA0A76C0C9A5C
08D2601AC12
S2243022403F5B71E2B3356EE9BFA5D77C7F4CAA93E04A94C379200D60DF59DC736
A76C6E9C1
S224302260D037FD2F4A0699F61530A6EEEF59C297EDD0E6347F4DDF82B36568C1692
8CE04F5
S2083022802BB83841C9
S503000EEE
Role Description
BASIC Is required in order to open CAFs with read access with the Caf Editor
ADVANCED Is required in order to allow coding with FDLs in E-Sys
EXPERT Is required in order to edit CAFs with the Caf Editor
In order to be able to code a control unit with an FDL, it must initially be created. This is done
either by read-out of the control unit (see Chapter 2.2.2 Reading out control units) or using
the context menu in the SVT view with the NewFDL function with an existing FDL file.
Both procedures can be applied only to individual CAFD entries in the SVT view.
The FDL is displayed as a sub-element of the relevant CAFD entry in font colour orange after
the action has been executed.
The FDL can be opened and edited in the FDL Editor using the context menu edit FDL (see
Chapter 3 FDL Editor and CAF Viewer).
In order to code a control unit with FDL, mark the FDL entry beneath the CAFD entry in the
SVT view and use the code FDL button to trigger the action. If this function has been called
for the first time after E-Sys is launched, you are prompted to enter your personal PIN.
When coding a control unit with FDL, only coding data described in the FDL under the ele-
ments Ausgelesen/Werte (Read-out/Values) are written (see Chapter 3 FDL Editor and CAF
Viewer).
Notes: A vehicle order with valid VIN number must be loaded and activated in order to allow
you to write a valid coding check stamp for the code FDL function. The vehicle order itself is
not used for coding in this case.
Coding of a control unit with FDL works only if the valid CAF on which the FDL is based is
found in the E-Sys data path (identical SGBM ID and versions).
Function Code Default Values can be applied only to individual CAFD entries in the SVT
tree.
Note: The CPS is not set to as-delivered condition (0xFF) when this function is run.
Function read CPS reads the CPS from control units. The SVT tree must be populated and at
least one control unit in it must be marked at Basic Variants level for this:
The result of the read-out operation is displayed as ASCII string (e.g. [RH09567]) behind the
diagnostic address of the basic variant in square brackets.
Alternatively, this function can also be applied to a total vehicle electrical system. For this
purpose, mark level ECU in the SVT tree and then trigger the CPS determination process with
button read CPS. Only control units having the SGBM process class CAFD for coding in the
SVT tree are read out.
If all CPSs have been read out, the user can check whether all codable control units have been
coded to match the vehicle in which they are fitted as well. An automatic check for identical
CPSs is not supported by E-Sys.
Both Coding Application Files and function data lists are XML files and are based on the
same XML schema. An FDL is the result of a read-out operation of coding data of a control
unit and always corresponds to the CAF that was used to read out the coding data but ex-
tended with the values read out and their interpretation in the logical coding data layout.
FDL Editor and CAF Viewer differ only in respect of the content of the tree view (FDL has
additional sub-branches with coded values read out) and are described together under a gen-
eral heading at this point.
3.1 GUI
The FDL Editor is used to edit coding data of control units without reference to a vehicle or-
der. The CAF Viewer is used to view CAF files. Both modules can be found in the module
bar at the left beneath Editors and viewers. The view of the FDL Editor or CAF Viewer is
shown in the illustration below.
FDL Editor and CAF Viewer have the following controls and display elements:
• File Name text field and button for opening an FDL or a CAF from the file system
with the File dialog box
• Text field and button for searching for codable function names in an FDL or CAF
• Filter unit for controlling display of FDL/CAF contents
• Tree view for editing or displaying the contents of FDLs or CAFs
Header
Allgemein (general)
Ersteller (originator)
Kommentar (comment)
Datum (date)
EcuName
Speicherlayout (memory layout)
Allgemeiner Anlieferzustand (general as-delivered condition)
NCD-Sig-Block
BN2000
CodingJobList Version
CAF-Identifikator
PK
ID
MV
SV
PV
Fahrzeugprofil-Info (vehicle profile information)
Baureihenverbund (main series)
PK
ID
MV
SV
PV
Daten [Layout: Byte] (data)
Data-Identifier Datagroup datagroup name, lenght of datagroup (bytes)
Aktivbedingung (Activation condition)
main series condition; description
Funktionen (functions)
Function name
Kommentar (comment)
Speicher-Info (storage info)
Start (start)
Ende (end)
Größe (size)
Maske (mask)
Anlieferungswerte (as-delivered value)
function value
Kommentar (comment)
Bedingung (condition)
X-Path
Werte (values)
Prüfschritt-ID (test step ID) (optional)
• Codable function: the term Codable Function means a control unit function that, if
changed by coding, influences the behaviour of the control unit.
• Function value: a codable function has one or more Function Values precisely one of
which is assigned to it by coding. This assignment can be made by selecting a Func-
tion Value from a set of possible Function Values in accordance with a coding condi-
tion or by calculating the Function Value with a calculation job (e.g. active, not_active
etc.).
• Coding value: each function value is represented in the control unit by a Coding
Value. This may be an individual numeric expression or a set of numeric expressions
that are actually written to a control unit (e.g. 0xFF, 0x10 etc.)
• Header/CAF identifier
o PK: process class for coding data (CAFD)
o ID: SGBM ID of the CAF
o MV: main version of the CAF
o SV: secondary version of the CAF
o PV: patch version of the CAF
• Data
o Data identifier of the data group with which the coding data of this data group
is transferred to the control unit
o Active condition, main series: contains a Boolean expression indicating
whether the data group for a main series is to be transferred to the control unit
or not. The expression may be vehicle profile-dependent or job-dependent
o Functions: bracket element around all codable functions of a data group
o Function: designation of the codable function
o Comment: comment on the codable function
o Storage information: information on the position of the codable function in the
memory layout
Start: byte number of the start of the codable function in a data group
End: byte number of the end of the codable function in a data group
Size: describes the ratio of memory mapping of a codable function to a
memory unit (1 byte). This may either be less than, greater than the
memory unit or precisely one memory unit (less than unit, greater than
unit, equal to unit)
Mask: describes position and size of the codable function in a memory
unit
o As-delivered values: this describes the specific coding values of a codable
function used by E-Sys for functionality “Code as-delivered condition”.
o Function value: designation of a function value of a codable function
Comment: free comment on a function value
Condition: description of the dependences of the function value on the
vehicle profile
• X-Path: Boolean expression from vehicle profile elements in X-
Path notation
Coding values: summary of the numerical (hexadecimal) values that a
codable function for the function value may assume.
Test step ID: reference ID for the function checklist, electrical system.
o Read out: element for accommodating the coding values of the codable func-
tion read out (only in the case of FDL).
Interpreted function value: name of the function value determined on
the basis of the coding value read out for a codable function value (as-
sumes value UNKNOWN if no correspondence is found between cod-
ing values in CAF and coding values read out from the control unit).
Read coding values: the numeric coding values actually read out from
the control unit
Test step ID: reference ID for the function checklist, electrical system
(as above)
3.3 Operation
The tree view is populated with the CAF or FDL data after a CAD/FDL is opened using the
File dialog box or from the context menu in Expert Mode Coding (edit FDL).
By default, when an FDL is opened, only the values read out from the control unit are shown
beneath element “Read out”. If necessary, the filter can be used to show the remaining infor-
mation from the underlying CAF.
You can search by function names in the FDL using the search mask (option for sub-text
search).
One exception relates to so-called calculated functions whose coding values are only deter-
mined by the system during runtime (e.g. coding date and paint code etc.) and cannot be
changed.
Only function value calculated value is displayed in the drop-down list of these functions.
This procedure can also be used to edit coding values of calculated functions.
Note: Editing coding values should be left to experts with adequate knowledge of a control
unit since this could otherwise allow invalid coding values to be written to a control unit and,
under certain circumstances, this could lead to damage the control unit software. Also, when
entering coding values, ensure that the number or quantity of coding values match the func-
tion mask. E-Sys does not conduct a consistency check in respect of the function mask. This
is done only during the coding operation by the programming system and leads to coding
abort.
The changes can be accepted in the tree view with icon in the bottom right-hand section
of the window.
The FDL must be saved (do not save it under a different name!) after the required changes are
complete. You can then switch back to Expert Mode Coding view and send the changes to the
control unit with the code FDL function (see Chapter 2.2.3 Coding control unit with FDL).
Expert Mode Coding Verification is primarily used to verify CAF files without access to con-
trol units (“Simulation mode”). Target users of these functionalities are primarily specialist
departments performing a corroboration function and control unit developers.
In Verification mode net coding data, function data lists and vehicle profiles for various vehi-
cle orders can be generated automatically and saved in Trace files for further use. In addition,
it is also possible to generate and save system variant tables for various vehicle orders from
KIS.
4.1 GUI
The verification module for coding can be found in the toolbar at the left under Expert Mode.
The GUI for coding verification is shown below:
The verification module contains the following controls and display elements:
• Vehicle Data view for opening, viewing and editing vehicle orders
• SVT tree for viewing logistic data in system variant tables with the option of filtering
for process classes and editing the SVT in the SVT Editor
• CAF Verification view for verifying individual CAFs with vehicle orders
• Total Verification view for verifying total I-Step content in relation to coding (net
coding data, SWE-CAF assignments in system variant tables)
• Settings view for configuring the Trace options
The next step is to load an FA list with at least one vehicle order in view Vehicle Data (button
load FA). Edit FA can be used to open the loaded vehicle order list in the Vehicle Order Edi-
tor if necessary for revision. The vehicle profile can be populated and displayed for individual
vehicle orders via the context menu (click with the right mouse button on FA entry calcu-
late FP) (the related vehicle order entry is marked in green).
Verification of CAFs refers to marked vehicle orders in the FA tree. Multi-selection (mouse
click + Ctrl/Shift key) allows any vehicle orders to be marked. If all vehicle orders of the
loaded list are to be used for verification, the root element in the FA tree (FAList) must be
selected.
If all boundary conditions are met (CAF files to be verified have been selected and vehicle
order entries have been marked), verification can be started with button Start Verification. All
specified CAFs with all marked vehicle orders are verified.
The scope of checks conducted when verifying CAFs is dependent on the Trace settings.
• No Trace recoding activated (no checkbox selected): the vehicle profile and the net coding
data without recording are calculated (suitable for short checks).
• NCD Trace activated: the generated net coding data is saved as a file in S-Record format
in the path (as specified under Trace Director).
Naming convention:
[Absolute position of the FA in the list with which the CAF was evalu-
ated]_[FAName]_[SGBMID].ncd
Example: 13_Testfaxyz_cafd_01020304_001_000_002.ncd
FDL Trace activated: the generated net coding data is back-interpreted to an FDL and
saved as a file in the path (as specified under Trace Directory).
Naming convention:
[Absolute position of the FA in the list with which the CAF was evaluated]_
[FAName]_[SGBMID].fdl
Example: 13_Testfaxyz_cafd_01020304_001_000_002.fdl
• FP Trace activated: the vehicle profile taken as a basis for generation of the net coding
data is saved as a file in the path (as specified under Trace Directory).
Naming convention:
[Absolute position of the FA in the list with which the FP was generated]_[FAName].fpl
Example: 1_Testfaxyz.fpl
• Setting SVT Trace does not influence verification of individual CAF files (see Chapter 4.3
Verification by SVT/KIS).
Note: If at least one Trace recording is activated, a Trace directory must be specified to allow
verification to be started.
The result of a verification run is displayed in the form of a report at the end. If at least one
Trace recording is activated, the report is also saved as a text file in the Trace directory (VRe-
port_Date_Time.txt)
The illustration below shows a verification report:
Determining net coding data in the dry run serves firstly to reveal zero hits and double hits in
the function conditions of a CAF and secondly to check correctness of the conditions used. A
CAF can be used successfully to code a control unit only if precisely one function value and,
consequently, one coding value exists for each function occurring in a CAF after evaluation
via a vehicle order. All other results, such as multiple function values (double hits) or no func-
tion value (zero hits) lead to abort of coding of the control unit.
Consequently, the informative value of verification greatly depends on the input variable Ve-
hicle Order (FA). The more FA elements (or FP elements) are used for control of coding of a
control unit, the greater will be the number of differing vehicle orders required to cover the
combinatorial analysis. Ideally, one vehicle order should be created and used for verification
for each vehicle profile element used in the CAF.
In the illustration above showing a verification report, the process of determining the parame-
ter to be coded for function GURTSTRAFFER_BEIFAHRER_1 has failed since no parameter
was found for the underlying vehicle order.
The CAF files in list Available CAF can be displayed using the context menu Open in the
CAF Viewer.
5 FA Editor
5.1 GUI
Vehicle orders can be edited with the Vehicle Order Editor (FA Editor). The FA Editor can be
found in the toolbar at the left under Editors and Viewers. The GUI of the Editor is shown in
the illustration below:
5.2 Operation
New FA lists can be created and saved and existing FA lists can be opened and closed via the
toolbar.
If creating a new FA list (“Sheet of paper” symbol), a blank FA framework is created auto-
matically, and mandatory entries to be made in it are marked with a red cross.
The relevant fields can be populated with the context menu Edit. When doing this, note the
required length of the relevant entry. To assist you, E-Sys shows the entry fields bordered in
red until the entry is complete.
For example, field Typschlüssel (Model Code) requires precisely 4 alphanumeric characters.
The VIN number must be entered, including checksum, in the Header field Vinlong. How-
ever, E-Sys does not offer the option of calculating the checksum!
The SALAPA contents can be entered either in the entry text field SALAPA-Element beneath
the FA tree or via the context menu NewSALAPA-Element. The individual entries must
comprise precisely 3 alphanumeric characters. If the SALAPA Elements entry text field be-
neath the FA tree is used, the contents must be separated by commas. Incorrect entries or in-
complete entries are shown by a red border around the entry field.
If a valid vehicle order exists, the vehicle profile is shown in the vehicle profile tree in the
right-hand section of the window. Errored entries (unknown SAs, model codes or build level)
are displayed as an error message.
Note: Vehicle orders can be edited and new vehicle orders can be created conveniently with
tool FA-Generator (FA Generator) that is also distributed through GIS since all FA elements
of a main series including description are available in this case.
The VCM Expert view is used to read, display and edit the VCM data from the VCM in the
vehicle or from files and write the VCM data in the vehicle or to files. The VCM data in-
cludes: vehicle order (FA), vehicle profile (FP), system variant table target status (SVTtarget),
SVTactual and I-Steps.
The VIN is not a part of the actual data stock of the VCM. It is saved in the ZGW primarily
for vehicle recognition via Ethernet. The Master VIN of the vehicle is saved in the VIN Mas-
ter control unit (CAS). The ZGW automatically fetches the Master VIN in the case of each
SwitchToPower, consequently overwriting the ZGW VIN. A diagnostic service can be used to
prompt the ZGW to update its VIN with the Master VIN.
The VCM data has already essentially been described in the section on vehicle data. In addi-
tion, some of the functions are identical or similar to the functions of Expert Mode Coding
and are described in more detail there.
6.1 GUI
The VCM GUI is subdivided into a display area and a control area. The display area is located
in the upper section of the VCM GUI, and the control area is located on several tabs beneath.
The controls in the control area are arranged so that they correspond to the arrangement of the
related data display in the display area.
Display area
The lettering above the displays for FA, FP, SVT and VIN indicates the origin of the data
displayed:
• From a file (FA, FP, SVT)
• From the VCM (FA, FP, SVT, I-Steps, VIN)
• From the VCM backup partner (FA, I-Steps, VIN)
• From a calculation (FP)
The display area is structured with views so that the sizes of the displays for FA, FP and SVT
can be adapted individually.
There is a cross at the top right for each display for rejecting the currently loaded data and
deleting the displays.
The File menu, Reset menu entry, can be used to reject all data and delete the contents of all
views.
If the FA file has been edited in the FA Editor, the current file is opened, the current FP is
reset and the FP display is cleared when you switch back to the VCM Expert view.
If the SVT file has been edited, the current file is opened and, consequently, the SVT display
in the VCM Expert view is updated as soon as you switch to the VCM Expert view. An SVT
may also contain control unit identification blocks of BN2000 control units besides the SVKs
of the BN2010 control units. The PSdZ maps these identification blocks over the structure of
an SVK. These control units can be seen in an SVT by the fact that bit ISO14229 is not set in
the “ecuDetailInfo” byte. These control units are marked specially in the SVT. An FA from
the FA list can be activated via a context menu. It makes no difference in this case from where
the FA was loaded/read (file, ECU).
The SVT display allows two SVTs to be loaded simultaneously and compared. An assignment
is always made in this case to SVTtarget (red display) and SVTactual (blue display). The ele-
ments that are identical in SVTtarget and SVTactual are shown in black.
If a SVTtarget is read from the VCM, the assignment to the SVTtarget in the SVT display is
made automatically. The same applies accordingly to the SVTactual. There is no automatic
assignment to SVTtarget and SVTactual in the case of SVTs saved in files. In this case, the
assignment is made indirectly by opening the file in the corresponding field SVTtarget or
SVTactual respectively. In this way, it is then also possible to compare two SVTtargets re-
spectively two SVTactuals with each other.
The SVT display offers a filter function for evaluating the displayed SVTs. The filter settings
can be opened with the icon in the top right-hand corner of the SVT display.
There are three primary filters that are each mutually AND-ed and that can be activated indi-
vidually via a checkbox.
Filter “Only SVK” offers the option of displaying only a selected process class for a control
unit.
“Ecu Info” allows only the control units on which a specific “EcuDetailInfo” respectively
“EcuStatusInfo” bit is displayed. The control units contained in the SVTactual but not in the
SVTtarget can be shown with setting “NotInSvtSoll_EcuRespToSVK”.
A third “Bus Info” filter offers the option of displaying only control units of a specific com-
munication bus.
Note: The filter settings are not reset by clearing the display.
Activating an FA automatically calculates the related FP and displays it. The text field in
which the VIN is displayed cannot be edited.
A related status is shown in the status bar for each of the actions executed.
6.2 Operation
This tab contains the buttons for loading and saving data from/to a file. The data loaded is
shown in the display area.
This tab contains the buttons for reading and writing data from/to the VCM. The data read is
shown in the display area.
I-Steps
Read reads the entire I-Step data record from the VCM.
Write writes the I-Step data record displayed/entered in the display area to the VCM.
SVTtarget
Read SVT reads the SVTtarget from the VCM and displays it in the SVT display.
Write SVT writes the current SVTtarget to the VCM. If an attempt is made to write a SVTtar-
get with a wrong version to the VCM (this is checked by PSdZ and prevented), a correspond-
ing error message is displayed in E-Sys. Directly following writing of the SVTtarget, the
PSdZ triggers initialisation of the serial number reference list in the VCM. If one of these
procedures fails, a corresponding error message is displayed in E-Sys. If an attempt is made to
read the SVTtarget if no SVTtarget is saved in the VCM, the query is acknowledged with a
negative response. A corresponding error message with a reference to the fact that there is no
SVTtarget is displayed in E-Sys.
SVTactual
Read SVT reads the SVTactual from the VCM and displays it in the SVT display.
Generate SVT starts a routine in the VCM that generates the SVTactual from the SVKs of the
individual control units signalled back. The result of the SVTactual generation respectively
the differences between SVTtarget and SVTactual can be shown in the SVT display and ana-
lysed via the filter function.
If an attempt is made to read the SVTactual if there is no SVTactual saved in the VCM, the
query is acknowledged with a negative response. A corresponding error message with refer-
ence to the fact that there is no SVTactual is displayed in E-Sys.
Note: The control unit list respectively a SVTactual may also contain control units that are not
contained in the SVTtarget.
Tab VCM Backup offers the option of saving VCM data (FA, I-Steps) in a backup partner
control unit (CAS) and restoring it from the backup partner back in the VCM. This tab con-
tains the buttons for reading and writing data from/to the VCM and from/to the backup part-
ner CAS.
VCM data
Read Data reads all backup-related data (FA, I-Steps) from the VCM and displays it in the
display area. The VIN is also read indirectly and assigned to the FA.
Write Data writes all loaded/displayed, backup-related data (FA, calculated FP, I-Steps) to the
VCM. The VCM data cannot be written until after a valid FA-FP combination has been cre-
ated, i.e. until after a FP has been calculated for an FA read from the backup partner control
unit.
Note: If applicable, a SVTtarget appropriate for the data restored from the backup must be
created separately and written to the VCM.
7 List of abbreviations
Abbreviation Significance
ASBC Automotive Security Backup Center
CAF Coding Application File
CAFD Process class designation of the CAF
EST Developer Soft Token
FA Fahrzeugauftrag = Vehicle order
FA2FP Assignment table of vehicle order to vehicle profile
FDL Function data list
FP Vehicle profile
I-Step Integration Step for software updates
KIS Configuration information system
NCD Net coding data
ODX Open Diagnostic Data Exchange
PDX Packaged ODX
SALAPA Optional extra, country spec. package/(equipment) packages
SGBM-ID Control unit description model identification number
SVK Software variant code
SVT System variant table
TAL Transaction list
VCM Vehicle Configuration Management
VIN Vehicle Identification Number (VIN number)
A Coding Tutorial
It is assumed that a connection has been set up to a control unit/vehicle electrical system for
the procedures described below.
• The Save File dialog box is displayed. Enter the file name (e.g. SVT_ACTUAL) and
click on the Save button.
• The system variant table of the control unit is displayed in the SVT Editor. Expand
StandardSVT and then StandardSVK in the tree.
• Mark StandardSVK in the tree and select New PartIdentification via the context
menu (click with the right mouse button).
• The Save File dialog box is displayed. Enter the file name (e.g. SVT_TARGET) and
click on the Save button.
• The Open File dialog box is displayed. Select the file (e.g. SVT_SOLL) and click on
the Open button.
• The display of the system variant table is updated. The CAF to be coded is displayed
in red font (TARGET status).
• The Open File dialog box is displayed. Select the file with the required vehicle order
(or vehicle order list) and click on the Open button.
• The vehicle order is set to active and the vehicle profile is calculated and displayed.
• Mark the required CAF in the displayed system variant table of the control unit.
• An FDL is created in the system variant table beneath the marked CAF. Mark this
element and select edit FDL via the context menu (click with the right mouse button).
o Select a function value in the selection dialog box displayed. The function val-
ues defined in the CAF are available in the selection dialog box.
o Edit the value in the bottom area of the window under Values from ECU and
accept it with .
• The Open File dialog box is displayed. Select the file with the required vehicle order
(or vehicle order list) and click on the Open button.
• The vehicle order is set active and the vehicle profile is calculated and displayed.
• If no EST has yet been selected, select Options Settings... EST in the menu bar
and enter the file location of the EST.
• Enter the PIN for the personal, loaded EST and confirm with OK.