44
EsysX Manual EsysX Team November 24, 2020 1

EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

  • Upload
    others

  • View
    5

  • Download
    0

Embed Size (px)

Citation preview

Page 1: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

EsysX ManualEsysX Team

November 24, 2020

1

Page 2: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Contents1 Introduction 5

2 What is EsysX 52.1 EsysX license types . . . . . . . . . . . . . . . . . . . . . . . . . . 52.2 EsysX types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.3 Compatibility with Esys and Windows . . . . . . . . . . . . . . . 5

3 Installing EsysX 73.1 Installing EsysX the first time . . . . . . . . . . . . . . . . . . . . 73.2 Updating an existing EsysX version . . . . . . . . . . . . . . . . 83.3 Upgrading an existing EsysX version . . . . . . . . . . . . . . . . 93.4 Possible errors while installing/updating EsysX . . . . . . . . . . 9

4 Configuration of EsysX/IspiHost Admin 104.1 IspiHost Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.1.1 EsysX Options . . . . . . . . . . . . . . . . . . . . . . . . 104.1.2 Ediabas Options . . . . . . . . . . . . . . . . . . . . . . . 124.1.3 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.2 IspiHost Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.3 EsysX 32/64 bit . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.4 Remote ENET Helper . . . . . . . . . . . . . . . . . . . . . . . . 14

5 Features 155.1 IspiHost Admin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

5.1.1 Navi FSC Generator . . . . . . . . . . . . . . . . . . . . . 175.1.2 8HP ISN Reset . . . . . . . . . . . . . . . . . . . . . . . . 195.1.3 FSC Explorer/FSC Store . . . . . . . . . . . . . . . . . . 225.1.4 Diag Devices . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.2 EsysX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245.2.1 Remapping of all function/parameter names & Remap-

ping of FAFP elements . . . . . . . . . . . . . . . . . . . . 255.2.2 Visual FA/VO editor for HO/E/SALAPA elements . . . . 255.2.3 Show conditional parameters in CAF/FDL viewer . . . . 275.2.4 Compare NCDs . . . . . . . . . . . . . . . . . . . . . . . . 285.2.5 FDL cheatsheets . . . . . . . . . . . . . . . . . . . . . . . 305.2.6 FDL scripting . . . . . . . . . . . . . . . . . . . . . . . . . 33

5.3 EsysX Expert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345.3.1 Series information in connection dialog . . . . . . . . . . . 345.3.2 Evaluation of conditions in CAF/FDL Viewer . . . . . . . 355.3.3 Construction preview SVT calculation . . . . . . . . . . . 365.3.4 NCD/FDL calculation with FA + SVT . . . . . . . . . . 37

5.4 EsysX 8HP ISN Reset . . . . . . . . . . . . . . . . . . . . . . . . 415.5 Remote ENET helper . . . . . . . . . . . . . . . . . . . . . . . . 41

2

Page 3: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

6 Update/Upgrade your EsysX License 426.1 Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426.2 Upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426.3 FSCs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

7 FAQs 44

3

Page 4: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Revision History

Revision Date Author(s) Description1.0 23.11.2020 EsysX Team Initial1.1 24.11.2020 EsysX Team Added license comparison table

4

Page 5: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

1 IntroductionThis document provides all necessary information on how to configure and runEsysX/IspiHost Admin as well as feature descriptions for them. Make sure toalways 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 historyon page 4.

2 What is EsysXEsysX is a Launcher for Esys to enable FDL Coding and to add the untrimmedparameter names and descriptions back to the CAFD files. EsysX is NOT Esysnor does it contain Esys. It just launches an installed Esys version and modifiesits code during runtime to enable more advanced features.

2.1 EsysX license typesThere are two types of licenses you can choose from:

EsysX Standard A software license which is bound to a single PC’s hardware.It does not work in virtualized environments (VMs)

EsysX Dongle A hardware (dongle) license which can be used on multiplePCs. It also works on VMs

2.2 EsysX typesEsysX can be purchased in different versions. You can compare any differenceon http://www.esysx.com/licenses

EsysX EsysX is the license for most people who only want to do coding on theircar. It contains all untrimmed parameters. For an overview of features,see section 5.

EsysX Expert EsysX Expert adds more advanced functions to EsysX likecalculating codings outside of a car. For an overview of features, seesubsection 5.3.

EsysX ISN Reset EsysX ISN Reset provides a feature to reset 8HP EGS. Tolearn how it works, see subsubsection 5.1.2

2.3 Compatibility with Esys and WindowsWhen buying EsysX in 2020, you will get 32 and 64-bit Esys compatibilityout of the box. If you have purchased it at times, where only Esys 32 bit wassupported, then you need an upgrade of your license to use 64-bit Esys Versions.You can use 64-bit EsysX if you have a 64-bit Esys version installed and if your

5

Page 6: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

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 needan update of your license. Refer to section 6 for updating your license.

6

Page 7: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

3 Installing EsysXThis 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 yourEsysX license as well as the password for the archive. Download it and unpackthe installer via e.g. 7zip.

3.1 Installing EsysX the first timeIf you are installing EsysX for the first time, just launch the installer and it willdo everything for you.Also, make sure to add us exception to the following folders, else your licensemight not work correctly:

• C:/Program/Files (x86)/IspiHost

• C:/ProgramData/IspiHost

As soon as the installer is done, you should see the IspiHost Admin servicestarting. You can open it by clicking its icon in the toolbar.Go to Settings -> Support and click the "Activate License" button to activateyour 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 EsysXis now ready to be configured. Continue with section 4 to do so.

7

Page 8: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 1: Activate your license via the "Activate License" button. If it is alreadyactivated, it will say "Reactivate License"

3.2 Updating an existing EsysX versionIf you are updating your EsysX license, then you must first uninstall your currentEsysX installation from control panel. To do so, open up the Windows controlpanel, search for "EsysX" and click uninstall. The uninstaller will be startedand will do everything for you. As soon as it closes, your current EsysX versionis removed.Continue by double clicking your new EsysX installer. It will take you throughthe steps of installation. As soon as it is done, your IspiHost Admin icon willpop up in the toolbar and your license should already be activated again. Ifnot, press the "Activate License" button in IspiHost Admin (see Figure 1).If your IspiHost service does not start after installing your update/upgrade,refer to subsection 3.4.

8

Page 9: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

3.3 Upgrading an existing EsysX versionIf 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.

3.4 Possible errors while installing/updating EsysX• Antivirus finds a "virus" during uninstalling EsysX: If you haven’t added

antivirus exceptions for EsysX folders like described in subsection 3.1,your antivirus program might put a temp file into quarantine while unin-stalling. If this is the case, you have to add the exception to your antivirusprogram first, then restart your pc before continuing with installation)

• IspiHost service fails to start: In some cases, after updating/upgradingyour license, the IspiHost service might fail to start. If this happens,remove the current EsysX version again from control panel, then restartyour PC and install it again. This happens, if the service fails to bestopped during uninstallation.

• An error pops up during installation, that EsysX cannot be installed inthe current environment. Contact support if this is the case.

9

Page 10: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

4 Configuration of EsysX/IspiHost AdminThis section describes how to configure EsysX and IspiHost Admin, as well asthe IspiHost Service. This section does not contain information on how to useIspiHost Tools or EsysX itself. All features are described in section 5.

EsysX contains of the following components:

IspiHost Admin IspiHost Admin is used for configuring EsysX. It checks foryour license priviliges and provides further tools which are described insubsection 5.1.

IspiHost Service Windows Service which acts as a bridge between IspiHostAdmin and the EsysX Servers (e.g. for license activation)

EsysX 32bit launcher The launcher which you have to use to launch a 32 bitEsys installations. If you have configured a 32 bit installation in IspiHostAdmin, you must use this launcher (icon) to start up EsysX. You will findit on your desktop after installation.

EsysX 64bit launcher The launcher which you have to use to launch a 64 bitEsys installation. If you have configured a 64 bit installation in IspiHostAdmin, you must use this launcher (icon) to start up EsysX. You will findit on your desktop after installation.

Remote ENET Helper A little helper tool which lets you connect your EsysXto a car connected to a clients computer over VPN

The configuration of each component is described in its own section below.

4.1 IspiHost AdminIf you open up IspiHost Admin from the toolbar and go to "settings", then youhave three configuration menus:

EsysX Options Configuration of EsysX. See subsubsection 4.1.1 for in-depthconfiguration.

Ediabas Options Configuration of Ediabas. Needed for ISN reset and FSCgenerator’s direct connection functions. See subsubsection 4.1.2 for indepth configuration.

Support Configuration of IspiHost Admin Windows service and lookup.xml.See subsubsection 4.1.3 for in depth configuration.

4.1.1 EsysX Options

All further configuration is described based on Figure 2

10

Page 11: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Before you can open up EsysX the first time, you have to choose your Esysinstallation which is either 32 bit or 64 bit. Of course, you can have multipleEsys installations on your computer but you have to choose one of them forEsysX to launch. You can have a 32 bit and 64 bit Esys installation configuredsimultaneously. All options below the 32/64 bit radio buttons are done for theselected 32/64 bit version.(If you do not have the 64 bit option yet, you may have purchased EsysX before64 bit was included in any license for free. If this is the case and you want torun 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 Esysroot 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 createa custom Est in order to fully use EsysX. If you want though, you can createone 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 scriptswhich will be shown in the Esys’ FDL editor.Enabling "FDL cheat codes" also enables you to "Merge Cheat Code Files" whichlets you choose 1-n cheat code files and merge them into a single file so you canuse 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 whichprovides a commandline runner and configure its commandline arguments. Todo 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 usedfor EsysX. The diff tool is configured globally for 32/64 bit.

11

Page 12: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 2: EsysX Options

4.1.2 Ediabas Options

All further configuration is described based on Figure 3

All vehicle based operations (FSC Explorer if reading out FSCs from vehicle;Toolset (currently only EGS ISN reset)) in IspiHost Admin use Ediabas. If youuse one of those functions, make sure to have a native Ediabas configurationand choose it via clicking the folder icon for "Bin Folder" as well as the "Ecufolder". Do further configuration below those options to your needs.

12

Page 13: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

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 installedEsysX 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, youcan use "On Demand" radio button to only have the service running if you wantit to. Default is "Automatic", which means that the service starts with windows.Navi Map Definitions, also known as Lookup.xml, are shipped with yourEsysX license but not updated after that. If you have a new "Lookup.xml", youcan load it via clicking the folder icon next to "Navi Map Definitions".Language setting is currently not used.

13

Page 14: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 4: EsysX Options

4.2 IspiHost ServiceIspiHost Service cannot be configured itself. All configuration is done withinIspiHost Admin -> Settings -> Support, which currently is only the startupbehaviour. Refer to subsubsection 4.1.3.

4.3 EsysX 32/64 bitAll EsysX (Expert, ISN Reset) related settings are configured in IspiHost Ad-min. Refer to subsubsection 4.1.1. Use one of the launch icons on your desktop,to start EsysX 32/64 bit.

4.4 Remote ENET HelperRemote ENET tool does not need to be configured. You can find it on yourcomputer at C:/Program Files (x86)/IspiHost.

14

Page 15: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

5 FeaturesThis section describes how to use any EsysX feature. This includes features inIspiHost Admin as well as EsysX itself. The availability of all features dependon 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, goto 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 upto date.If a feature for IspiHost Admin or EsysX is not present in your verion, you eitherneed an update or an upgrade depending on the wanted/missing feature. Referto section 6.

Features in this section are described by "Preconditions" which are conditionsthat have to be met in order to use that feature. Any feature in EsysX/IspiHostAdmin require an activated license as well as the running IspiHost service asprecondition (and of course, the feature must have been bought)."Usage" describes the actual use of that function if all preconditions are met.

15

Page 16: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 5: Each license has its own set of features

16

Page 17: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

5.1 IspiHost AdminIspiHost Admin provides multiple advanced tools (this list is based on IspiHostAdmin 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 andexport generated FSC codes by Navi FSC Generator as well as importedFSCs 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.

5.1.1 Navi FSC Generator

Preconditions:

• Enough credits for the map you want to generate an FSC for (number intop right corner in Figure 6). If you don’t have enough credits, refer tosubsection 6.3.

• Either connected to a car or having a local .fsc file on your PC for thedesired car

• If you want to read out an FSC from a connected car, Ediabas must beinstalled and configured

Usage

1. If you have a local .fsc file on your PC, click the Import button and selectit. 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, clickImport, 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 yourFscStore.

17

Page 18: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 6: Navi FSC Generator

18

Page 19: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 7: Read FSC from car

5.1.2 8HP ISN Reset

This section describes how to reset your 8HP EGS ISN with EsysX. Thoseare very short explanations. You can also find a full video tutorial on https://www.youtube.com/watch?v=TPUCplYzBi0.

Preconditions:

• EsysX 64 configured (not supported in 32 bit)

• Ediabas configured

• Connected to a car (or EGS in general)

• SWFL of EGS must be supported for ISN reset. Check www.esysx.com/licenses for a recent compatibility list.

Usage

1. Go to IspiHost Admin’s Toolset Window (Figure 8) and select Egs Unlockfrom the Tool dropdown if not selected yet.

2. If you don’t have full psdzdata, click "Download File Support" which willdownload all BTLD, SFWL and CAFD for supported EGS variants.

3. Click "Detect" and identify the EGS

19

Page 20: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

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 "..." buttonto 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 IspiHostAdmin.

11. Switch to EsysX and calculate a TAL for EGS flash as you would do whenupdating the car.

12. Flash the EGS again with an original TAL

13. Check EGS ISN state in IspiHost Admin and it should be locked again tothe new car

20

Page 21: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 8: 8HP ISN Reset

21

Page 22: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 9: EsysX 8HP ISN Reset TAL execution

5.1.3 FSC Explorer/FSC Store

The FSC Explorer or FSC Store stores all your imported FSCs from any carplus generated FSCs in one place for better overview:

Preconditions:

• None

Usage

• To import local stored FSCs, head over to the Navi FSC Generator (seeFigure 6) and click "Import", then select your .fsc file for example. Makesure 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 mainfolder icon (Figure 10) on the left "Vins" panel and choose "Import fromcar".

• You can also export any displayed folder by clicking its icon and selecting"Export as zip".

22

Page 23: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 10: FSC Explorer

5.1.4 Diag Devices

The Diag Devices tool is an ICOM manager like iToolRadar.

Preconditions:

• Connected ICOM

Usage

• Any function of that tool is self explaining from the button names. Thereisn’t any other hidden features (Figure 11).

23

Page 24: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 11: Diag Devices (ICOM tools)

5.2 EsysXThis 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

Page 25: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

5.2.1 Remapping of all function/parameter names & Remapping ofFAFP elements

Preconditions:

• Psdz data on your PC

Usage

• There is nothing to do for you. Any remapping/untrimming is done inmemory.

5.2.2 Visual FA/VO editor for HO/E/SALAPA elements

Preconditions:

• Psdz data on your PC

• Be in FA-Editor and have an FA/VO loaded

Usage

• To open the visual editor for SALAPA elements, select the "SALAPA-Element" node in the FAList tree, then click the little book icon next tothe SALAPA-Element header (see Figure 12)

• Top open the visual editor for HO or E words, select the HO-Wort orE-Wort node in the FAList tree, then right click it and click "edit" (seeFigure 13)

• In the visual editor, you see your current elements of your FA in the leftpanel and the available options on the right. Use the DEL key to removean option from FA or double click on an available option to add it to yourFA. You can also search for any option by code or name by using the"Search for" text box at the bottom

25

Page 26: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

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

Page 27: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

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"

5.2.3 Show conditional parameters in CAF/FDL viewer

Preconditions:

• Be in FDL/CAF Editor

• Have an NCD loaded

Usage

• Activate the "Activating Conditions" checkbox above the FDL to load allconditional expressions into the FDL tree (see Figure 14)

27

Page 28: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 14: You can enable conditional expressions by checking the "ActivatingConditions" checkbox

5.2.4 Compare NCDs

Preconditions:

• NcdDiffTool configured in IspiHost Admin (see subsubsection 4.1.1)

• Be in FDL/CAF Editor

• Have an NCD loaded

Usage

• Click the icon in the EsysX toolbar next to the question mark (with thetool file icons)

• Select the NCD which you want to compare your current loaded oneagainst and click "Open" (see Figure 15)

• Winmerge will automatically be opened with both files (see Figure 16)

28

Page 29: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 15: To compare your current loaded NCD to another one, click the iconwith the two sheets next to the question mark

29

Page 30: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 16: After selecting a second NCD, Winmerge is opened and you can seeall differences between both NCDs

5.2.5 FDL cheatsheets

Preconditions:

• FDL Cheatsheets activated and a cheatsheet selected in IspiHost Admin(see subsubsection 4.1.1)

• Your Cheatsheet must contain valid options for the current loaded NCD

• Be in FDL/CAF Editor

• Have an NCD loaded

Usage

• After your NCD is loaded, click the "Refresh" button to load all codes foryour 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 windowswill show all results of the automatically applied codings (see Figure 19)

30

Page 31: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 17: You can use your cheatsheets to apply different codings

31

Page 32: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 18: You can check the preview of changes which would be done by thecurrent loaded cheatsheet

32

Page 33: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 19: After applying, check the log output if everything worked

5.2.6 FDL scripting

Preconditions:

• FDL Scripts activated in IspiHost Admin (see subsubsection 4.1.1)

• Be in FDL/CAF Editor

• Have an NCD loaded

Usage

• After your NCD is loaded, load an existing script (.scr file) or just starttyping 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

Page 34: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 20: You can use FDL scripts to apply different codings to your currentloaded NCD

5.3 EsysX ExpertThis section describes all features which are present in EsysX Expert license.Expert license is an extension of the standard license. All features which arepresent in EsysX standard license as well, are not described in this section.Those are described in subsection 5.2.

• Series information in connection dialog

• Evaluation of conditions in CAF/FDL Viewer

• Construction preview SVT calculation

• NCD/FDL calculation with FA + SVT (“SVT-CAFD” / “FA-CAFD” In-tegration from NCDCAFD Tool) featuring 2 calculation modes and quickcompare (2 FA/VOs)

5.3.1 Series information in connection dialog

Preconditions:

• None

Usage

34

Page 35: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

• 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 connectiondialog

5.3.2 Evaluation of conditions in CAF/FDL Viewer

Preconditions:

• Bought 64 bit EsysX and using a 64 bit Esys version

• Be in FDL/CAF Editor

• Have an FDL loaded

• Checkbox "Activating Conditions" checked

Usage

• Click "Evaluate all conditions" button. Your FDL/CAFD will be reloadedafter the evaluation

• You can now see all conditions with their evaluated xpath expressions (seeFigure 22)

35

Page 36: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 22: All conditions will be validated to show the real condition containingHO/E words, SALAPA elements, time criteria and type codes

5.3.3 Construction preview SVT calculation

Preconditions:

• Be in TAL calculation or Coding window

• Have an active connection to a car or a fake connection by trying to con-nect to the non existing gateway, then ignore all warnings and a connectionwill be established without a real car

• Have an FA/VO loaded

Usage

• 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 shouldbe 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

Page 37: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 23: The construction preview SVT can be calculated by selection theoption and a shipment I-Step

5.3.4 NCD/FDL calculation with FA + SVT

Preconditions:

• Have the "SVT to CAFD Calculation" window opened under EsysX menu

• If you want to use any compare feature, NcdDiffTool must be configuredin IspiHost Admin (see subsubsection 4.1.1)

Usage of "Conditional evaluation" (see Figure 24)

• Load an FA/VO and SVT for the car you want to generate parametersfor

• Select ECUs of your choice for which the parameters should be calculatedfor

• Select "Conditional parameters" from the options. Conditional parametersare all parameters which are set by an explicit condition (xpath expres-sion).

• Select "Implicit parameters" if needed. Implicit parameters are all pa-rameters which are set by the model (set by FA/VO) regardless of anycondition. They are always true or false for the selected model.

• Click "Calculate"

37

Page 38: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

• 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 clickingthe "Save" button and selecting the appropriate option

Figure 24: By using the "conditional parameters" option, only parameters, whichexplicitly get set through FA elements, will be evaluated and shown in the resultpanel in .txt format

Usage of "Full Evaluation" (see Figure 25)

• Load an FA/VO and SVT for the car you want to generate parametersfor

• Select ECUs of your choice for which the parameters should be calculatedfor

• Select "All parameters" from the options. This will evaluate the completeNCD/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 perCAFD by clicking the "Save" button and selecting the appropriate option

38

Page 39: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

• 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 choosean NCD, it will get converted to FWL automatically. Winmerge will beopened up with both selected FWLs.

Figure 25: By using the "all parameters" option, all parameters, which get setthrough FA coding, will be evaluated and shown in the result panel in .fwlformat

Usage of "2 step calculation and comparison" (see Figure 26)

• Load an FA/VO and SVT for the car you want to generate parametersfor

• Load a second FA/VO for the same car with the retrofit/change of yourchoice

• Select ECUs of your choice for which the parameters should be calculatedfor

• Click "Calculate and compare". Chosen options in the right bottom cornerwill be ignored. Calculation will always be done with "All parameters"mode.

39

Page 40: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

• A 2 step calculation will be done. The result of the first calculation willbe shown in the result panel. The result of the second calculation will bekept 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 fileper CAFD or fwl file per CAFD by clicking the "Save" button and selectingthe 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 choosean NCD, it will get converted to FWL automatically. Winmerge will beopened up with both selected FWLs. )

Figure 26: You can do a 2 step calculation with comparison automatically byloading a second FA with any change and hitting "Calculate and compare".Winmerge will be opened with the comparison of both evaluations afterwards.

40

Page 41: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 27: All differences will be shown in Winmerge after both calculations

5.4 EsysX 8HP ISN ResetEven though this feature is partly implemented in EsysX, it is described underIspiHost Admin features, as you need IspiHost Admin in order to do the reset.Refer to subsubsection 5.1.2 for the feature description.

5.5 Remote ENET helperTo connect to a car which is connected to a client’s PC, you must to the follow-ing:

• Connect to the clients PC over any VPN tool

• Start Remote ENET on your clients PC

• 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 puttingin the client pc VPN address

41

Page 42: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

6 Update/Upgrade your EsysX LicenseThis section describes what an update/upgrade is and how to update or upgradeyour current EsysX license.

6.1 UpdateAn 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/ andbuy our "Update" product. Put your license number in and make sure to readthe product notes. You will receive a purchase confirmation mail with notes onwhat 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 UpgradeAn upgrade is for extending your license’s features. It also includes bug fixes orimprovements for your current license type.

To upgrade your license, go to your Shop at https://esysx.com/shop/ andbuy "Upgrade" product. Put your license number in and make sure to read theproduct notes. You will receive a purchase confirmation mail with notes onwhat 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 FSCsYou 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 FSCGenerator (see subsubsection 5.1.1). If you want to do so, go to our shop athttps://esysx.com/shop/ and buy the FSC product you need.

We have built a new feature into EsysX which lets you immediately add thebought FSC generations to your IspiHost Admin.

• If you don’t have the "Refresh" button in the "Navi FSC Generator" (seeFigure 28) within IspiHost Admin, then you will get an EsysX Updateat no cost automatically. Just wait for us to send you the Update (seesubsection 3.2) and install it, then you can use your new FSC generations.

• If you already have the updated version, then open up IspiHost Adminafter you have bought the FSC product over our shop and click "Refresh".Your counter should update and include the new generations.

42

Page 43: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

Figure 28: If you don’t have the refresh button yet, you will get an updatedEsysX version at no cost automatically

43

Page 44: EsysX Manual...If you are connected to a car and want to read out the .fsc file, click Import,then"ReadVehicle"inthebottomrightcorner(SeeFigure7). 2. Selectyouroptionslike"Lifetime",themapversion

7 FAQsThis section describes frequently asked questions (FAQs) and how to solve them.

Where can i buy new FSC generations for IspiHost Admin?Answer: Please check subsection 6.3.

How to update navi map definitions for the Navi FSC Generator inIspiHost Admin?Please check section 4.

Is it possible to upgrade a software license to a hardware/donglelicense?Unfortunately, this is not possible.

I have an error installing EsysXPlease have a look at subsection 3.4. Your error may be covered there. Ifnot, do not hesitate to contact us over our page’s contact form.

Can I use EsysX on a VM?Only hardware/dongle licenses do support VMs.

Where can I find my license number?Click the question mark on top of IspiHost Admin.

Can I use EsysX on my Mac?The dongle/hardware license version can be used on VM on Mac

If i get a new PC, can I use my software license on the new one?Only dongle/hardware license supports multiple PCs. The software licenseis tied to the PCs hardware on which you activated it

How can I get my free update?Any license comes with one free update. To claim it, contact us over oursite’s contact page. There is no product in our shop to cover free updates.

For how long can i use my EsysX license? Does it expire?No, EsysX does never expire.

44