Creating signal groups and recording groups¶
Signal groups, signals, recording groups and recordings are managed via the tab Signal recordings. The tab Signal recordings is shown in the following figure with a sample package.
Example for the display of signal groups, recording groups, signals and recordings.¶
The tab Signal recordings lists all signal groups (“ECU1” and “Model” in the example). For each signal group the signal names (grouped in “Signals”), as well as the contained recordings assembled in recording groups (“Recording group ECU1” and “Recording group Model” in the example), are shown.
Five buttons are available for setting up elements:
Create signal group (3)
Add a measurement list (4)
Create signal (5)
Create recording group (6)
Create recording (7)
The currently selected element (signal group, signal, recording group, recording) can be deleted by another button (8). If a recording is selected, the button (9) allows jumping to it directly in tab Trace files (see Section Select traces and signals from trace files). Button (1) will show this help page. With Button (2), you can show or hide automatically adopted elements from default groups.
Setting up signal groups
Signals must be organized by the user in such a way that a signal group contains only the signal names of quantities of one device. Thus, if signals of three different devices are to be considered, three signal groups must be set up. Signal groups can be created either automatically when a signal is drag-and-dropped or using the button (3).
If a signal group is selected, the name and its descriptive text can be edited via the context menu (right-click).
Adding signals to signal group
If a signal group is selected, the list of its signal names can be edited. Signals can either be created via the corresponding button (5), be drag-and-dropped from the tab Mapping or be extracted directly from trace files (e.g. in MDF or CSV format, see Section Select traces and signals from trace files) or signal databases (e. g. Fibex or DBC, see Section Select signals from databases).
If a new signal is created via button (5), the signal name can be chosen freely. For recordings the system identifier and the mapping target can be set. For bus logging signals a selection of all pseudo signals being supported by trace.check is provided (see Supported file formats).
For every signal in a signal group there is a corresponding entry in tab Mapping of the package.
Adding a measurement list to a signal group
If you want to record a large number of signals, you can add a measurement list in the form of a .xam file (button (4)). Please note that only mapping targets from the .xam file are processed. There are no overrides, for example, by the global mapping. Only one measurement list can be set per signal group.
Adding the entire bus to signal group (SUT-only recording)
Alternatively, the entire bus can be inserted by dragging it from the Bus access tab into the list of signal recordings. This function is not available for signal-based systems.
Signal recording of the entire bus.¶
Setting up recording groups¶
With every signal group set up a corresponding recording group is created. Further recording groups can be added to a signal group via the button (6). Recording groups can be renamed via the context menu or by key F2.
It is necessary to use more than one recording group whenever recordings principally have signals with the same signal name (thus belonging to the same signal group) but are to be analyzed differently.
Synchronization of recordings
See Synchronization of traces.
Adding recordings¶
There are two possibilities of adding recordings from available trace files to a recording group for analysis: on the one hand the button (7) can be used, on the other, recordings can be drag-and-dropped from the Trace files tab (see Section Select traces and signals from trace files).
Using button (7) to add new recordings opens the following dialog:
In that dialog a supported trace file can be selected. All available signal groups are displayed in the left column, and the right column is used to determine the recordings of the selected signal group to be added. The recordings will be added to the currently selected recording group or the first recording group of the currently selected signal group.
For some recordings it is possible to supply further information. This information is stored in a string with the different settings separated by underscores. When creating or editing recordings in the tab Signal recordings, entering these settings is assisted by dialogs.
A more detailed overview is available at Supported file formats.
Info
Recordings added in the Signal recordings tab or by parameter sets are only taken into account, if no recordings are added in the test case.
Signal group “Assign automatically”¶
Each package already contains a special signal group named “Assign automatically”. Signals of this group are automatically assigned to other (existing) signal groups during execution. For this reason no recording groups can be added to this special signal group. Consequently, no recording control is available for this group.
The determination of the appropriate signal group is attempted based on the following rules in descending priority:
A signal group is already supplying the mapping. (For concrete mappings, name and target must match.)
A signal group is named after the SUT key of the addressed mapping target (e.g. ‘A-FlexRay’).
A signal group already supplies a mapping pointing to the same SUT.
For mappings of type “Trace file”: If there is only one signal group, it will be used.
If a signal cannot be assigned to a signal group or cannot be assigned unambiguously, a warning is displayed in the messages window. However, this has no effect on the result of the test case. If such a signal is to be used in a trace analysis, subsequent errors may occur.