User Manual
EasyTrac64
Log-File Analysis & Evaluation Tool
www.decontev.com
 info@decontev.com
 ,ü
 *
 ,Tools for 
 Development
 Testing
 Maintenance
 


 


History........................................................................... 7

Abbreviations................................................................. 7

1    Introduction.............................................................. 8

1.1  Before Starting.......................................................................................... 9

1.2  Installation................................................................................................ 9

1.2.1   MS Windows.......................................................................................... 9

1.2.2   Linux................................................................................................... 9

1.3  License.................................................................................................... 10

1.4  Update.................................................................................................... 12

1.4.1   Windows............................................................................................. 12

1.4.2   Linux.................................................................................................. 12

2    Operation................................................................ 13

2.1  Application Window.................................................................................. 13

2.2  Main Toolbar............................................................................................ 14

2.3  Filter Toolbar........................................................................................... 16

2.3.1   'Flt' Button.......................................................................................... 16

2.3.1.1   Filter Toolbar - Log-File Window........................................................ 16

2.3.1.2   Filter Tool – Filter-Result Window....................................................... 17

2.3.2   Filter 01..15......................................................................................... 17

2.3.3   Filter Configuration............................................................................... 18

2.3.3.1   Toolbar........................................................................................ 18

2.3.3.2   Filter Configuration Panels................................................................ 19

2.3.3.3   Load Filter-Configuration.................................................................. 20

2.3.4   Fast Filter Configuration......................................................................... 22

2.3.5   Filter Reset.......................................................................................... 22

2.4  Main Status-Bar....................................................................................... 23

2.5  Filter-Result Toolbar................................................................................. 23

2.5.1   Add Lines Tool...................................................................................... 24

2.6  EasyTrac64 Operation.............................................................................. 25

2.6.1   Shortcuts / Hotkeys.............................................................................. 25

2.6.2   Open Log-File....................................................................................... 26

2.6.3   Open File-List....................................................................................... 26

2.6.4   Open Log-File with Pre-Processor............................................................. 26

2.6.5   Open several Log-Files simultaneously...................................................... 28

2.6.6   Save current Log-Data.......................................................................... 29

2.6.7   Clear and Re-Open Loaded Log-File.......................................................... 29

2.6.8   Paste Data from Clipboard..................................................................... 29

2.6.9   Copy selected Line to Clipboard............................................................... 29

2.6.10    Line Coloring..................................................................................... 30

2.6.11    UTF8 Decoding.................................................................................. 30

2.6.12    Search............................................................................................ 30

2.6.13    Filter Area........................................................................................ 31

2.6.14    Column Cutter.................................................................................. 33

2.6.15    Decoder Tool.................................................................................... 34

2.6.16    Player Tool....................................................................................... 36

2.6.16.1  Player Window............................................................................... 36

2.6.16.2  IPC Connection.............................................................................. 37

2.6.16.3  Player Operation............................................................................ 38

2.6.16.4  Player Settings.............................................................................. 39

2.6.16.4.1   IPC Settings........................................................................... 39

2.6.16.4.2   Message Processor Settings...................................................... 39

2.6.16.4.3   Player Frequency Settings........................................................ 40

2.6.16.4.4   Status Panel.......................................................................... 40

2.6.17    Data Grabber Tool............................................................................. 41

2.6.17.1  Activation..................................................................................... 41

2.6.17.2  Data-Recorder............................................................................... 42

2.6.18    Live-Data......................................................................................... 43

2.6.19    Text Panel........................................................................................ 43

2.6.20    Select Area...................................................................................... 44

3    Configuration.......................................................... 46

3.1  General................................................................................................... 46

3.1.1   Input.................................................................................................. 46

3.1.2   Display Options.................................................................................... 47

3.1.3   Live Data............................................................................................ 47

3.1.4   Help................................................................................................... 47

3.1.5   Version-Update.................................................................................... 47

3.2  Decoding................................................................................................. 48

3.2.1   Decoder (Default)................................................................................. 48

3.2.2   Decoder Result..................................................................................... 48

3.2.3   Additional Decoder Buttons..................................................................... 49

3.3  Decoder Profiles...................................................................................... 50

3.3.1   Add / Edit Decoder Profile...................................................................... 51

3.3.1.1   General Data................................................................................. 51

3.3.1.2   Internal Pre-Processing................................................................... 52

3.3.1.3   Pre-Processor Library..................................................................... 52

3.3.1.4   Decoder Library............................................................................. 52

3.3.1.5   Post-Processor Library.................................................................... 52

3.3.1.6   Result-Viewer................................................................................ 52

3.3.2   Example............................................................................................. 53

3.4  Decoders................................................................................................. 55

3.4.1   Add / Edit Decoder................................................................................ 56

3.4.2   Test Decoder....................................................................................... 56

3.4.2.1   Decoder....................................................................................... 57

3.4.2.2   Input........................................................................................... 58

3.4.2.3   Message....................................................................................... 58

3.4.2.4   Parameter.................................................................................... 58

3.4.2.5   Log / Output / Result...................................................................... 58

3.5  Data Processors...................................................................................... 58

3.5.1   Add / Edit Data-Processor...................................................................... 58

3.5.2   Test Data-Processor.............................................................................. 59

3.5.2.1   Data-Processor.............................................................................. 60

3.5.2.2   Input........................................................................................... 61

3.5.2.3   Message....................................................................................... 61

3.5.2.4   Parameter.................................................................................... 61

3.5.2.5   Log / Output / Result...................................................................... 61

3.6  Result Viewers......................................................................................... 61

3.6.1   Add / Edit Result-Viewer........................................................................ 62

4    Decoders and Data-Processors................................. 64

4.1  API......................................................................................................... 65

4.1.1   StartDataProcessorMsg.......................................................................... 65

4.1.1.1   Pre-defined Parameters.................................................................. 66

4.1.2   GetDecoderMessages............................................................................ 67

4.1.3   GetDataProcessorDescription.................................................................. 68

4.1.4   Data-Processor Dialog........................................................................... 69

4.1.4.1   SetupDataProcessorDialog............................................................... 69

4.1.4.2   GetDataProcessorDialogHandle.......................................................... 70

4.1.4.3   InitDataProcessorDialog................................................................... 71

4.2  Data-Processors written in Python............................................................ 72

5    EasyTrac Result-Viewer........................................... 73

5.1  Toolbar.................................................................................................... 74

5.2  Result Tree-View...................................................................................... 74

5.3  Input-Data............................................................................................... 75

5.4  Value Panel.............................................................................................. 75

5.5  Description Panel..................................................................................... 75

5.6  Result XML............................................................................................... 76

 


 

Figure 1: 'new version available' dialog..................................................................... 12

Figure 2: decontev Downloader............................................................................... 12

Figure 3: Linux terminal window.............................................................................. 12

Figure 4: EasyTrac64 Application Window.................................................................. 13

Figure 5: Main-Toolbar left side............................................................................... 14

Figure 6: Main-Toolbar right side............................................................................. 15

Figure 7: Filter Toolbar.......................................................................................... 16

Figure 8: Filter Toolbar – Log-File Window................................................................. 16

Figure 9: Filter Toolbar – Log-File Window................................................................. 17

Figure 10: Filter Configuration Dialog........................................................................ 18

Figure 11: Filter Configuration – Toolbar................................................................... 18

Figure 12: Filter Configuration Panel......................................................................... 19

Figure 13: Sub-Filter Configuration Dialog.................................................................. 19

Figure 14: Sub-Filter Configuration........................................................................... 20

Figure 15: Load Filter-Configuration......................................................................... 20

Figure 16: edit Filter-Config properties...................................................................... 21

Figure 17: Fast Filter Configuration Dialog................................................................. 22

Figure 18: Main Status-Bar..................................................................................... 23

Figure 19: Filter-Result Window Toolbar.................................................................... 23

Figure 20: Add Lines Tool....................................................................................... 24

Figure 21: File-List................................................................................................ 26

Figure 22: Load Log-File with Pre-Processor............................................................... 27

Figure 23: Open several Log-files simultaneously........................................................ 28

Figure 24: Dialog for selected files........................................................................... 28

Figure 25: display file-number................................................................................. 29

Figure 26: Line Coloring......................................................................................... 30

Figure 27: UTF8 Decoding...................................................................................... 30

Figure 28: Search Dialog........................................................................................ 31

Figure 29: Filter Area Dialog................................................................................... 31

Figure 30: Copy Dialog for the Selected Area............................................................. 32

Figure 31: Column Cutter Dialog.............................................................................. 33

Figure 32: Example Column Cutter........................................................................... 34

Figure 33: Decoder Tool......................................................................................... 35

Figure 34: Example 1 - IPC Connection..................................................................... 37

Figure 35: Example 2 - IPC Connection..................................................................... 38

Figure 36: Player Settings Dialog............................................................................. 39

Figure 37: Player Status Panel................................................................................ 40

Figure 38: Data-Grabber Live-Source Selection.......................................................... 41

Figure 39: Data-Recorder....................................................................................... 42

Figure 40: Principal of Data-Grabbing....................................................................... 42

Figure 41: Live-Data Status-Panel............................................................................ 43

Figure 42: Additional Functions of the Live-Data Monitoring........................................... 43

Figure 43: opened Text-Panel................................................................................. 44

Figure 44: Selected Begin-Line................................................................................ 44

Figure 45: Dialog for copy the selected Area.............................................................. 44

Figure 46: General Settings.................................................................................... 46

Figure 47: Settings Decoding.................................................................................. 48

Figure 48: Additional Decoder Buttons...................................................................... 49

Figure 49: Decoder Button Configuration................................................................... 49

Figure 50: Settings - Decoder Profiles...................................................................... 50

Figure 51: Dialog Add/Edit Decoder Profile................................................................. 51

Figure 52: Result-Viewer........................................................................................ 55

Figure 53: Settings - Decoders................................................................................ 55

Figure 54: Add / Edit Decoder................................................................................. 56

Figure 55: Decoder Test........................................................................................ 57

Figure 56: Settings – Data Processors...................................................................... 58

Figure 57: Add/Edit Data-Processor.......................................................................... 59

Figure 58: Test Data-Processor............................................................................... 60

Figure 59: Settings - Result Viewers......................................................................... 61

Figure 60: Add / Edit Result-Viewer.......................................................................... 62

Figure 61: EasyTrac Result-Viewer........................................................................... 73

Figure 62: Toolbar................................................................................................ 74

Figure 63: Result Tree-View.................................................................................... 74

Figure 64: Input-Data............................................................................................ 75

Figure 65: Value Panel........................................................................................... 75

Figure 66: Description Panel................................................................................... 75