History Configuration
Click to open the history configuration file ltt_history_config.xml. Be aware that after a fresh installation, this file is not present and will be created after you start the LTT GUI for the first time.
For training or demonstration purposes you can take the default history configuration and go on with your setup.
The history configuration defines what columns and in which order they should be written to the history files.
The LTT GUI creates a so called history log file for every station (DUT) and test order. The main purpose of the history files is to log failed limit tests during test execution. But also other generic status information will be logged to the history files. You can create custom history log entries by yourself from any TestStand sequence.
Each history log entry is put into a separate line in the history file and is accompanied by a number of auxiliary information, such as date, time, climatic chamber temperature and so on.
You can choose what additional information are logged with each log entry and in which order they should appear in the file.
Available Column IDs
There is a predefined set of available data, which you can pick by using a certain identifier. The following table gives a list of all possible data you can pick.
| ID | Meaning |
|---|---|
| DATE | The current date. |
| TIME | The current time. |
| INFORMATION | The actual log message. This is either an error message (limit or runtime error) or a custom log message (how to create a log entry?). |
| MEASUREMENT_VALUE | The actual measurement value, in case this log entry is a limit error. |
| MEASUREMENT_UNIT | The measurement value unit, in case this log entry is a limit error. |
| LIMIT_MIN | The measurement value min. limit, in case this log entry is a limit error. |
| LIMIT_MAX | The measurement value max. limit, in case this log entry is a limit error. |
| MEASUREMENT_ID | The measurement ID, in case this log entry is a limit error (more info). |
| ERROR_COUNTER | The count of how many times this measurement already had a limit violation (more info). |
| OPERATION_MODE | The current operation mode (more info). |
| STATUS | The current station status (more info). |
| TEST_CYCLES | The current test cycle (more info). |
| TCC | The current TCC value (more info). |
| DUT_VOLTAGE | The current DUT voltage (more info). |
| CHAMBER_TEMPERATURE | The current climatic chamber temperature (more info). |
| CHAMBER_HUMIDITY | The current climatic chamber humidity. This value is only available if your temperature sensor also supports measuring humidity (for example the Omega iThx) (more info). |
| STEP_TIME | The time passed since the station status was last updated (more info). |
| TOTAL_TEST_TIME | The time this test had run in total so far. |
| ELECTRICAL_TEST_TIME | The time this test had run in total so far, but only in electrically active operation modes (more info). |
| TEST_STATION | The test station index (more info). |
| DUT_NAME | The DUT name (more info). |
| DUT_TYPE | The DUT type (more info). |
| CABLE_ID | The cable ID (more info). |
| VIBRATION_AXIS | The vibration axis, if applicable (more info). |
| COMMENT | A custom comment, which can be set afterwards (more info). |
| CUSTOM | Used for custom columns (see below) |
For each history column you write a line
<HistoryColumn ID=[SOME_ID] name="MyColumnHeader" />
where you set the ID to one of those in the table above and provide a name for the column header. The default history configuration already contains all available columns in a certain order. You can change the order and/or maybe remove some unwanted columns or add additional custom columns.
Format Specifier
You can also add an optional format attribute to each HistoryColumn entry.
<HistoryColumn ID=[SOME_ID] name="MyColumnHeader" format="F2" />
The following format specifier are available:
| ID | Meaning |
|---|---|
| Fx | Floating point number with x digits after the decimal separator, examples: F1, F2, F3 |
| D | Decimal number |
| dd.MM.yyyy | date format |
| HH:mm:ss.fff | time format |
If no format is specified, string is assumed.
History File Split Size
Usually history files will be split into several chunks if the file size exceeds a certain limit. The default file split size is 1 MB (1048576 bytes). You can change this value by adding a size_limit attribute to the top level <LttHistoryColumnConfig> element.
<LttHistoryColumnConfig size_limit=10485760>
The above will set the file split size to 10 MB.
History File Column Separator
By default the history columns are separated by a semicolon ;. You can change the column separator with the following attribute:
<LttHistoryColumnConfig separator="|">
The above will set | as a column separator.
Custom Columns
You can define any number of custom columns for the history files. To do so add HistoryColumn entries with the ID CUSTOM. The provided name will be the column header.
<HistoryColumn ID="CUSTOM" name="HV Voltage" />
<HistoryColumn ID="CUSTOM" name="HV Current" />
<HistoryColumn ID="CUSTOM" name="U_Kl30_Sense" format="F2" ShowInStationPanel="false" />
Custom columns get their values from TestStand. Those so called runtime values are displayed in GUI for each station display as well as inserted into the history file's custom column with the matching name.
If you do not want to have such a runtime value to be displayed in GUI but only be shown in history file you can add a
ShowInStationPanel="false"attribute to thatHistoryColumnelement.