Difference between revisions of "HANtune/Logging"
| Line 4: | Line 4: | ||
To start recording signals, enable it by going to “Communication -> Enable Datalogging” or click on the log file button at the bottom status bar. [[File:LogButton.png]] | To start recording signals, enable it by going to “Communication -> Enable Datalogging” or click on the log file button at the bottom status bar. [[File:LogButton.png]] | ||
| + | |||
| + | When logging is active, the log file button will display the logfile name: [[File:LogButtonActive.png|276px]] | ||
| + | |||
The name of the log file can partially be changed by going to “Communication -> Modify Datalog Filename”. | The name of the log file can partially be changed by going to “Communication -> Modify Datalog Filename”. | ||
| Line 10: | Line 13: | ||
The log file will be saved (default) in the “log” subfolder folder in the HANtune folder. If desired, this folder can be changed by going to "Preferences -> User Preferences". Type or browse your desired folder in the "Log Location" field. | The log file will be saved (default) in the “log” subfolder folder in the HANtune folder. If desired, this folder can be changed by going to "Preferences -> User Preferences". Type or browse your desired folder in the "Log Location" field. | ||
| + | |||
| + | Using a spreadsheet capable of reading .csv format, you can examine a log file. | ||
| + | |||
<b>Log File Contents</b> | <b>Log File Contents</b> | ||
| Line 22: | Line 28: | ||
Next to the header, the actual log values are written into the file. | Next to the header, the actual log values are written into the file. | ||
| − | Each line starts with a timestamp (in Seconds), followed by all the values of the signals received at that time. Each signal value is separated by a semicolon (;). | + | Each line starts with a timestamp (in Seconds), followed by all the values of the signals received at that time. Each signal value is separated by a semicolon (;). A dot (.) or a comma (,) (depending on your language settings) denotes a decimal separator. A thousands separator is not used. |
| − | A dot (.) or a comma (,) (depending on your language settings) denotes a decimal separator. A thousands separator is not used | ||
| − | |||
| − | |||
| − | |||
<b>Reading Log File</b> | <b>Reading Log File</b> | ||
| − | + | HANtune is capable of reading and showing values of a previously recorded logfile. The data from that logfile will be displayed on the signal elements on screen. | |
| + | |||
| + | To start reading a logfile go to "File -> Read Logfile..." and select the desired logfile. | ||
| + | After selecting a logfile, a dialog will appear on the HANtune screen: | ||
Revision as of 14:00, 16 February 2020
HANtune has the option to write and read data received from target communication into a log file. The logged parameter values are written into a .csv file.
To start recording signals, enable it by going to “Communication -> Enable Datalogging” or click on the log file button at the bottom status bar. 
When logging is active, the log file button will display the logfile name: 
The name of the log file can partially be changed by going to “Communication -> Modify Datalog Filename”.
The current date and time will automatically be appended to the filename each time a new logging is started.
The log file will be saved (default) in the “log” subfolder folder in the HANtune folder. If desired, this folder can be changed by going to "Preferences -> User Preferences". Type or browse your desired folder in the "Log Location" field.
Using a spreadsheet capable of reading .csv format, you can examine a log file.
Log File Contents
A log file consists of two parts: a header and log values. Both are in human readable format. The header contains additional information as:
- The name of the project
- The name of the ECU currently connected
- The sample frequency of each DAQ list
- The time and date of the log file
- 2 lines containing a description of signals logged per column. First line contains the protocol used. Second line contains the name of each signal.
Next to the header, the actual log values are written into the file. Each line starts with a timestamp (in Seconds), followed by all the values of the signals received at that time. Each signal value is separated by a semicolon (;). A dot (.) or a comma (,) (depending on your language settings) denotes a decimal separator. A thousands separator is not used.
Reading Log File HANtune is capable of reading and showing values of a previously recorded logfile. The data from that logfile will be displayed on the signal elements on screen.
To start reading a logfile go to "File -> Read Logfile..." and select the desired logfile. After selecting a logfile, a dialog will appear on the HANtune screen:
