Professional Documents
Culture Documents
Esysx Manual
Esysx Manual
Esysx Manual
EsysX Team
November 24, 2020
1
Contents
1 Introduction 5
2 What is EsysX 5
2.1 EsysX license types . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 EsysX types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.3 Compatibility with Esys and Windows . . . . . . . . . . . . . . . 5
3 Installing EsysX 7
3.1 Installing EsysX the first time . . . . . . . . . . . . . . . . . . . . 7
3.2 Updating an existing EsysX version . . . . . . . . . . . . . . . . 8
3.3 Upgrading an existing EsysX version . . . . . . . . . . . . . . . . 9
3.4 Possible errors while installing/updating EsysX . . . . . . . . . . 9
5 Features 15
5.1 IspiHost Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5.1.1 Navi FSC Generator . . . . . . . . . . . . . . . . . . . . . 17
5.1.2 8HP ISN Reset . . . . . . . . . . . . . . . . . . . . . . . . 19
5.1.3 FSC Explorer/FSC Store . . . . . . . . . . . . . . . . . . 22
5.1.4 Diag Devices . . . . . . . . . . . . . . . . . . . . . . . . . 23
5.2 EsysX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5.2.1 Remapping of all function/parameter names & Remap-
ping of FAFP elements . . . . . . . . . . . . . . . . . . . . 25
5.2.2 Visual FA/VO editor for HO/E/SALAPA elements . . . . 25
5.2.3 Show conditional parameters in CAF/FDL viewer . . . . 27
5.2.4 Compare NCDs . . . . . . . . . . . . . . . . . . . . . . . . 28
5.2.5 FDL cheatsheets . . . . . . . . . . . . . . . . . . . . . . . 30
5.2.6 FDL scripting . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.3 EsysX Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.3.1 Series information in connection dialog . . . . . . . . . . . 34
5.3.2 Evaluation of conditions in CAF/FDL Viewer . . . . . . . 35
5.3.3 Construction preview SVT calculation . . . . . . . . . . . 36
5.3.4 NCD/FDL calculation with FA + SVT . . . . . . . . . . 37
5.4 EsysX 8HP ISN Reset . . . . . . . . . . . . . . . . . . . . . . . . 41
5.5 Remote ENET helper . . . . . . . . . . . . . . . . . . . . . . . . 41
2
6 Update/Upgrade your EsysX License 42
6.1 Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.2 Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.3 FSCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
7 FAQs 44
3
Revision History
4
1 Introduction
This document provides all necessary information on how to configure and run
EsysX/IspiHost Admin as well as feature descriptions for them. Make sure to
always have the latest version of this file which can be found on www.esysx.
com/manual. To check the current documents version, see the revision history
on page 4.
2 What is EsysX
EsysX is a Launcher for Esys to enable FDL Coding and to add the untrimmed
parameter names and descriptions back to the CAFD files. EsysX is NOT Esys
nor does it contain Esys. It just launches an installed Esys version and modifies
its code during runtime to enable more advanced features.
EsysX EsysX is the license for most people who only want to do coding on their
car. It contains all untrimmed parameters. For an overview of features,
see section 5.
EsysX Expert EsysX Expert adds more advanced functions to EsysX like
calculating codings outside of a car. For an overview of features, see
subsection 5.3.
EsysX ISN Reset EsysX ISN Reset provides a feature to reset 8HP EGS. To
learn how it works, see subsubsection 5.1.2
5
OS (Windows) is a 64-bit version.
EsysX 32-bit and 64-bit should be fully compatible with any windows version.
Windows 10 2004 modified system DLLs in a way that cause EsysX to crash.
If that happens to you and you are on Windows 10 2004 then you might need
an update of your license. Refer to section 6 for updating your license.
6
3 Installing EsysX
This section describes how to install or update/upgrade your EsysX (Stan-
dard/Dongle) on your laptop.
You should have received your EsysX License by mail. It contains a link to your
EsysX license as well as the password for the archive. Download it and unpack
the installer via e.g. 7zip.
• C:/Program/Files (x86)/IspiHost
• C:/ProgramData/IspiHost
As soon as the installer is done, you should see the IspiHost Admin service
starting. You can open it by clicking its icon in the toolbar.
Go to Settings -> Support and click the "Activate License" button to activate
your license (see Figure 1). If it is already activated, then the button says
"Reactivate License". In this case, you don’t have to do it again. Your EsysX
is now ready to be configured. Continue with section 4 to do so.
7
Figure 1: Activate your license via the "Activate License" button. If it is already
activated, it will say "Reactivate License"
8
3.3 Upgrading an existing EsysX version
If you have bought an upgrade, installation process is exactly the same as in-
stalling an update. Refer to subsection 3.2 to install your upgrade.
9
4 Configuration of EsysX/IspiHost Admin
This section describes how to configure EsysX and IspiHost Admin, as well as
the IspiHost Service. This section does not contain information on how to use
IspiHost Tools or EsysX itself. All features are described in section 5.
10
Before you can open up EsysX the first time, you have to choose your Esys
installation which is either 32 bit or 64 bit. Of course, you can have multiple
Esys installations on your computer but you have to choose one of them for
EsysX to launch. You can have a 32 bit and 64 bit Esys installation configured
simultaneously. All options below the 32/64 bit radio buttons are done for the
selected 32/64 bit version.
(If you do not have the 64 bit option yet, you may have purchased EsysX before
64 bit was included in any license for free. If this is the case and you want to
run a 64 bit Esys version then you have to buy a 64 bit Upgrade over our shop.)
After choosing 32/64 bit, click the little folder icon and navigate to your Esys
root folder in the opening popup, then click "choose folder" to select it.
Est Token can always remain on "Use Default", there is no need to create
a custom Est in order to fully use EsysX. If you want though, you can create
one with the "Create custom Est" and then selecting it in the Est Token menu.
You either have to choose between FDL cheat codes or FDL scripts
which will be shown in the Esys’ FDL editor.
Enabling "FDL cheat codes" also enables you to "Merge Cheat Code Files" which
lets you choose 1-n cheat code files and merge them into a single file so you can
use all of them in EsysX.
Enabling FDL scripts has no further option.
At the bottom right corner, you can enable a Diff Tool of your choice which
provides a commandline runner and configure its commandline arguments. To
do so, install e.g. Winmerge on your computer, then hit the "NcdDiff Tool"
button to configure the commandline arguments "<left> <right>" in there.
Hit Apply to finish configuration of your diff tool. It is now ready to be used
for EsysX. The diff tool is configured globally for 32/64 bit.
11
Figure 2: EsysX Options
All vehicle based operations (FSC Explorer if reading out FSCs from vehicle;
Toolset (currently only EGS ISN reset)) in IspiHost Admin use Ediabas. If you
use one of those functions, make sure to have a native Ediabas configuration
and choose it via clicking the folder icon for "Bin Folder" as well as the "Ecu
folder". Do further configuration below those options to your needs.
12
Figure 3: EsysX Options
4.1.3 Support
All further configuration is described based on Figure 4
The support page shows the current activation state of your installed
EsysX license. If your license is not automatically re-activated after an up-
date/upgrade, then you can click "Reactivace License" to do so.
USB Key shows the state of your dongle, if you are using a hardware (dongle)
EsysX license.
To prevent having the IspiHost Service always running in background, you
can use "On Demand" radio button to only have the service running if you want
it to. Default is "Automatic", which means that the service starts with windows.
Navi Map Definitions, also known as Lookup.xml, are shipped with your
EsysX license but not updated after that. If you have a new "Lookup.xml", you
can load it via clicking the folder icon next to "Navi Map Definitions".
Language setting is currently not used.
13
Figure 4: EsysX Options
14
5 Features
This section describes how to use any EsysX feature. This includes features in
IspiHost Admin as well as EsysX itself. The availability of all features depend
on your IspiHost Admin version as well as your bought license. The prerequi-
sites are described at the beginning of every features’ section.
To have a quick overview of which feature each EsysX license type supports, go
to www.esys.com/licenses and check the table at the beginning of the page.
While the same table is also added below (see Figure 5), our page is always up
to date.
If a feature for IspiHost Admin or EsysX is not present in your verion, you either
need an update or an upgrade depending on the wanted/missing feature. Refer
to section 6.
15
Figure 5: Each license has its own set of features
16
5.1 IspiHost Admin
IspiHost Admin provides multiple advanced tools (this list is based on IspiHost
Admin version 2.3.0.1). A quick overview:
Navi FSC Generator Found under Tools -> Applets -> Navi Fsc Generator.
Generates FSC codes for Champ2, CIC, EntryNav, NBT, NBTEvo ID4.
See subsubsection 5.1.1.
Toolset Found under Tools -> Applets -> Toolset. Set of advanced tools.
Currently only contains 8HP ISN Reset. See subsubsection 5.1.2.
FSC Explorer Found under Tools -> FSC Explorer. It lets you browse and
export generated FSC codes by Navi FSC Generator as well as imported
FSCs from car. See subsubsection 5.1.3.
ICOM Tools Found under Devices -> Diag Devices. Shows found ICOMS,
lets you reserve, configure and update them. See subsubsection 5.1.4.
• Enough credits for the map you want to generate an FSC for (number in
top right corner in Figure 6). If you don’t have enough credits, refer to
subsection 6.3.
• Either connected to a car or having a local .fsc file on your PC for the
desired car
• If you want to read out an FSC from a connected car, Ediabas must be
installed and configured
Usage
1. If you have a local .fsc file on your PC, click the Import button and select
it. The FSC will be selected and also imported in your FscStore.
If you are connected to a car and want to read out the .fsc file, click
Import, then "Read Vehicle" in the bottom right corner (See Figure 7).
2. Select your options like "Lifetime", the map version
3. Click "Generate", your new FSC will be displayed and also saved to your
FscStore.
17
Figure 6: Navi FSC Generator
18
Figure 7: Read FSC from car
Preconditions:
2. If you don’t have full psdzdata, click "Download File Support" which will
download all BTLD, SFWL and CAFD for supported EGS variants.
3. Click "Detect" and identify the EGS
19
4. Click "Create Tal" to generate the flash TAL for the reset
5. Launch EsysX, connect to the car and go to the TAL execution window
6. Check the "Unlock EGS" checkbox as seen in Figure 9
7. Check for software availability. If there are missing files, hit the "..." button
to import missing files into your psdzdata directory
8. Check for software again if you imported them previously
9. Proceed with the EGS flash
10. Switch back to IspiHost Admin and detect your EGS. Check the ISN state.
If reset successfully, restart the EGS by clicking "Restart EGS" in IspiHost
Admin.
11. Switch to EsysX and calculate a TAL for EGS flash as you would do when
updating the car.
20
Figure 8: 8HP ISN Reset
21
Figure 9: EsysX 8HP ISN Reset TAL execution
Preconditions:
• None
Usage
• To import local stored FSCs, head over to the Navi FSC Generator (see
Figure 6) and click "Import", then select your .fsc file for example. Make
sure to set the file type accordingly in the file chooser dialog (.fsc, .xml,
.zip).
• To import an FSC from a connected car, right click the FSC store’s main
folder icon (Figure 10) on the left "Vins" panel and choose "Import from
car".
• You can also export any displayed folder by clicking its icon and selecting
"Export as zip".
22
Figure 10: FSC Explorer
Preconditions:
• Connected ICOM
Usage
• Any function of that tool is self explaining from the button names. There
isn’t any other hidden features (Figure 11).
23
Figure 11: Diag Devices (ICOM tools)
5.2 EsysX
This section describes all features which are present in EsysX standard license.
To compare them to the other license types, please have a look at https:
//esysx.com/licenses/:
• Remapping of all function/parameter names in all CAFDs
• Remapping of HO/E/SALAPA elements in FAFPs
• Visual FA/VO editor for HO/E/SALAPA elements
• Show conditional parameters in CAF/FDL viewer
• Compare NCDs
• FDL cheatsheets
• FDL scripting
24
5.2.1 Remapping of all function/parameter names & Remapping of
FAFP elements
Preconditions:
• Psdz data on your PC
Usage
• There is nothing to do for you. Any remapping/untrimming is done in
memory.
• In the visual editor, you see your current elements of your FA in the left
panel and the available options on the right. Use the DEL key to remove
an option from FA or double click on an available option to add it to your
FA. You can also search for any option by code or name by using the
"Search for" text box at the bottom
25
Figure 12: To open up the editor for SALAPA elements, select the SALAPA-
Element node in the tree, then click the little book icon
26
Figure 13: To open the editor for E and HO words, click on the E-Wort/HO-
Wort node in the tree, then right click and select "edit"
27
Figure 14: You can enable conditional expressions by checking the "Activating
Conditions" checkbox
• Be in FDL/CAF Editor
• Have an NCD loaded
Usage
• Click the icon in the EsysX toolbar next to the question mark (with the
tool file icons)
• Select the NCD which you want to compare your current loaded one
against and click "Open" (see Figure 15)
• Winmerge will automatically be opened with both files (see Figure 16)
28
Figure 15: To compare your current loaded NCD to another one, click the icon
with the two sheets next to the question mark
29
Figure 16: After selecting a second NCD, Winmerge is opened and you can see
all differences between both NCDs
Usage
• After your NCD is loaded, click the "Refresh" button to load all codes for
your current NCD (see Figure 17)
• Check all FDLs which shall be automatically coded
• You can preview your codings by clicking the "Preview" button (see Fig-
ure 18)
• Click the "Apply" button to apply all selected codings. The log windows
will show all results of the automatically applied codings (see Figure 19)
30
Figure 17: You can use your cheatsheets to apply different codings
31
Figure 18: You can check the preview of changes which would be done by the
current loaded cheatsheet
32
Figure 19: After applying, check the log output if everything worked
• Be in FDL/CAF Editor
• Have an NCD loaded
Usage
• After your NCD is loaded, load an existing script (.scr file) or just start
typing one in the script panel (see Figure 20)
• Click the "Run" button to apply all codings within the script
• the log output will show you the result of applied codings
33
Figure 20: You can use FDL scripts to apply different codings to your current
loaded NCD
34
• Series information will automatically be shown as soon as you open it up
(see Figure 21)
Figure 21: You can see all used series for each vehicle project in the connection
dialog
35
Figure 22: All conditions will be validated to show the real condition containing
HO/E words, SALAPA elements, time criteria and type codes
• Choose "Construction Preview" from the right KIS options panel (see Fig-
ure 23)
• Choose the I-Step Shipment for which you want to calculate the SVT for
• Click the "Calculate" button
• The construction preview SVT will be shown in the SVT panel. It should
be almost, if not exactly, the same as the one which is on the selected car
(through the FA) from production plant for that I-Step.
36
Figure 23: The construction preview SVT can be calculated by selection the
option and a shipment I-Step
37
• The result will be shown in the result panel. The result type is .txt.
• You can save the result in a single txt file or txt file per CAFD by clicking
the "Save" button and selecting the appropriate option
Figure 24: By using the "conditional parameters" option, only parameters, which
explicitly get set through FA elements, will be evaluated and shown in the result
panel in .txt format
• Select "All parameters" from the options. This will evaluate the complete
NCD/FDL.
• Click "Calculate"
• The result will be shown in the result panel. The result type is .fwl.
• You can save the result in a single txt file, txt file per CAFD or fwl file per
CAFD by clicking the "Save" button and selecting the appropriate option
38
• You can also compare each fwl to another NCD or FWL of your choice.
Click the "Compare" button and select the CAFD you want to compare,
then select another NCD or FWL from the same ECU. If you choose
an NCD, it will get converted to FWL automatically. Winmerge will be
opened up with both selected FWLs.
Figure 25: By using the "all parameters" option, all parameters, which get set
through FA coding, will be evaluated and shown in the result panel in .fwl
format
39
• A 2 step calculation will be done. The result of the first calculation will
be shown in the result panel. The result of the second calculation will be
kept in memory.
• Winmerge will be opened with both results (see Figure 27)
• You can save the result of the first calculation in a single txt file, txt file
per CAFD or fwl file per CAFD by clicking the "Save" button and selecting
the appropriate option
• You can also compare each fwl to another NCD or FWL of your choice.
Click the "Compare" button and select the CAFD you want to compare,
then select another NCD or FWL from the same ECU. If you choose
an NCD, it will get converted to FWL automatically. Winmerge will be
opened up with both selected FWLs. )
40
Figure 27: All differences will be shown in Winmerge after both calculations
• As soon as you see the car’s vin in the Remote ENET tool, click activate
• Connect your program, e.g. EsysX, over the gateway url option by putting
in the client pc VPN address
41
6 Update/Upgrade your EsysX License
This section describes what an update/upgrade is and how to update or upgrade
your current EsysX license.
6.1 Update
An update is mainly for implementing new psdz data mappings into your cur-
rent EsysX license. You can check our Changelog at https://esysx.com/
change-log/ if there is new mappings since you have bought your license.
An update also includes bug fixes or improvements for your license type.
To update your license, go to your Shop at https://esysx.com/shop/ and
buy our "Update" product. Put your license number in and make sure to read
the product notes. You will receive a purchase confirmation mail with notes on
what to do next. Please read them.
After your update is built, you will receive it per mail. Install the update
(see subsection 3.2) and you are good to go.
6.2 Upgrade
An upgrade is for extending your license’s features. It also includes bug fixes or
improvements for your current license type.
To upgrade your license, go to your Shop at https://esysx.com/shop/ and
buy "Upgrade" product. Put your license number in and make sure to read the
product notes. You will receive a purchase confirmation mail with notes on
what to do next. Please read them.
After your upgrade is built, you will receive it per mail. Install the update
(see subsection 3.3) and you are good to go.
6.3 FSCs
You can also buy FSC generations for NBTEvo ID4 and Route maps (life-
time codes are not supported for Route maps) for IspiHost Admin’s Navi FSC
Generator (see subsubsection 5.1.1). If you want to do so, go to our shop at
https://esysx.com/shop/ and buy the FSC product you need.
We have built a new feature into EsysX which lets you immediately add the
bought FSC generations to your IspiHost Admin.
• If you don’t have the "Refresh" button in the "Navi FSC Generator" (see
Figure 28) within IspiHost Admin, then you will get an EsysX Update
at no cost automatically. Just wait for us to send you the Update (see
subsection 3.2) and install it, then you can use your new FSC generations.
• If you already have the updated version, then open up IspiHost Admin
after you have bought the FSC product over our shop and click "Refresh".
Your counter should update and include the new generations.
42
Figure 28: If you don’t have the refresh button yet, you will get an updated
EsysX version at no cost automatically
43
7 FAQs
This section describes frequently asked questions (FAQs) and how to solve them.
How to update navi map definitions for the Navi FSC Generator in
IspiHost Admin?
Please check section 4.
Is it possible to upgrade a software license to a hardware/dongle
license?
Unfortunately, this is not possible.
I have an error installing EsysX
Please have a look at subsection 3.4. Your error may be covered there. If
not, do not hesitate to contact us over our page’s contact form.
44