Difference between revisions of "Signal Reader Assignment Editor"
(9 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
The Signal Reader Assignment Editor | The Signal Reader Assignment Editor can be found under the tab '''Assignment''' and allows the user to create new assignments for signal reader directly in the portal. This page will guide you through the basics of using the editor. | ||
==Edit/Create a signal reader assignment== | ==Edit/Create a signal reader assignment== | ||
The first tab that you are presented with is the '''Assignment global settings''' tab where you can add information about the assignment so that you can easily keep track of what this assignment is about. Creator and creation date are both automatically filled in and cannot be changed because of consistency. | |||
[[File:Measurement setup.png|none|thumb|608x608px|Measurement Setups]] | |||
Under the '''Measurements''' tab, see Figure "Measurement Setups", you are presented to a table of Measurement Setups and an information window. These measurement setups are the core of a signal reader assignment. They contain '''Triggers''' that activate and deactivate on certain conditions provided by the user. Each trigger can contain a '''Recorder''' that contains a list of certain signals that will be measured when the start condition for the respective trigger is met. A trigger can also be used to act as a '''setup switch'''.[[File:Measurement setup.png|none|thumb|608x608px|Measurement Setups]] | |||
When you feel finished with the assignment you can simply click the '''Save assignment''' button in the lower right corner to save the assignment in its current state. | When you feel finished with the assignment you can simply click the '''Save assignment''' button in the lower right corner to save the assignment in its current state. | ||
===Trigger=== | ===Trigger=== | ||
To add a trigger to a measurement setup, click the '''plus''' button for the respective measurement setup. This will create a new Trigger in the trigger table in the respective measurement setup and the information window will be filled with new settings for this trigger for you to add. | To add a trigger to a measurement setup, click the '''plus''' button for the respective measurement setup. This will create a new Trigger in the trigger table in the respective measurement setup and the information window will be filled with new settings for this trigger for you to add. In the window, trigger type can be set to different types: Recorder, Setup switch, Pause diagnostics, Start/stop CCP DAQ, Start/stop XCP DAQ and Upload. With Setup switch you will jump/end/restart when the start condition is met. | ||
Fill out the '''start trigger''' '''condition''' for the trigger. This is easiest to do in the '''Edit expression''' window that you can get to by clicking one of the '''Edit''' buttons. To find a new signal to add a condition for, use the '''Add signal''' button. Here, you can browse all signals available for this assignment. Use the dropdown to browse signals from different can-busses and Wice internal signals. If you want to browse the signals currently in use in the assignment for the selected signal source, check the '''Search in assignment''' box. If you want more information about a signal, select it and click '''More info'''. When you have found the signal you want, double click it or select it and click '''Add signal'''. Now you can use the '''Operators''' list to add a condition for the signal, for example " > 0". When you are satisfied with the start condition, you will notice that the Validate button has a yellow warning symbol on it. This means that the expression is unvalidated, press the button to validate the expression. The buttons icon now either turns red (expression is unvalid) or green (expression is correct). See Figure "Validate Button States" for the different state of the validate button. Click Save to save the expression. The list of operators supported in trigger condition is available [[Signal Reader Trigger Expressions|here]].[[File:ValidateButtonStates.png|thumb|Validate Button States|link=https://wiki.alkit.se/wice264/index.php/File:ValidateButtonStates.png|none]]A '''stop trigger condition''' is not required, but can be supplied to determine when the recording should stop. If the stop condition is not supplied, the settings for the recorder will tell when the recording should stop. | Fill out the '''start trigger''' '''condition''' for the trigger. This is easiest to do in the '''Edit expression''' window that you can get to by clicking one of the '''Edit''' buttons. To find a new signal to add a condition for, use the '''Add signal''' button. Here, you can browse all signals available for this assignment. Use the dropdown to browse signals from different can-busses and Wice internal signals. If you want to browse the signals currently in use in the assignment for the selected signal source, check the '''Search in assignment''' box. If you want more information about a signal, select it and click '''More info'''. When you have found the signal you want, double click it or select it and click '''Add signal'''. Now you can use the '''Operators''' list to add a condition for the signal, for example " > 0". When you are satisfied with the start condition, you will notice that the Validate button has a yellow warning symbol on it. This means that the expression is unvalidated, press the button to validate the expression. The buttons icon now either turns red (expression is unvalid) or green (expression is correct). See Figure "Validate Button States" for the different state of the validate button. Click Save to save the expression. The list of operators supported in trigger condition is available [[Signal Reader Trigger Expressions|here]].[[File:ValidateButtonStates.png|thumb|Validate Button States|link=https://wiki.alkit.se/wice264/index.php/File:ValidateButtonStates.png|none]]A '''stop trigger condition''' is not required, but can be supplied to determine when the recording should stop. If the stop condition is not supplied, the settings for the recorder will tell when the recording should stop. | ||
===Recorder=== | ===Recorder=== | ||
There a two types of recorder, SREC (Signal recorder) and DREC (Diagnostics recorder). Choose which one you want with the radio button at the top of the Recorder tab. | There a two types of recorder, SREC (Signal recorder) and DREC (Diagnostics recorder). Choose which one you want with the radio button at the top of the Recorder tab. | ||
====Recorder - DREC==== | |||
DREC (Diagnostics recorder) is used to send diagnostic requests onto the vehicle's communication buses and record the responses. The diagnostic requests are supplied in a sequence file uploaded by the user. The sequence file contains one diagnostic request per line, with the ECU id at the beginning of the line. There can optionally be other information as well. The syntax is the same as the one used for the IDC module, see [[IDC_Sequence_File_Syntax |Sequence File Syntax]]. The result from a DREC will be a diagnostic log file, a text file containing both the requests from the sequence file and the corresponding responses. | DREC (Diagnostics recorder) is used to send diagnostic requests onto the vehicle's communication buses and record the responses. The diagnostic requests are supplied in a sequence file uploaded by the user. The sequence file contains one diagnostic request per line, with the ECU id at the beginning of the line. There can optionally be other information as well. The syntax is the same as the one used for the IDC module, see [[IDC_Sequence_File_Syntax |Sequence File Syntax]]. The result from a DREC will be a diagnostic log file, a text file containing both the requests from the sequence file and the corresponding responses. | ||
====Recorder - SREC==== | ====Recorder - SREC==== | ||
SREC (Signal recorder) is used to record signals on the vehicle's communication buses. The result of an SREC is an MDF file containing the time series data of the selected signals. | SREC (Signal recorder) is used to record signals on the vehicle's communication buses. The result of an SREC is an MDF file containing the time series data of the selected signals. | ||
For signal recorder there is 3 tabs: | |||
* | |||
* Symbols - Add/Remove/view signals to record | |||
* Frames - Handle frame recorder on Passive CAN and Flexray busses. | |||
* Properties - Settings for the recorder. | |||
===== Symbols: ===== | |||
Buttons on the bottom strip: | |||
* Add Signal: Will open a window where signals can be added from. By selecting a signal source the list will be populated with signals available from that source. | |||
* Remove selected: Selected signals will be removed. This is also possible by right click on the list. | |||
* Edit Selected: To edit PLA-compressions (Read more [[PLA-compression window|here]].) and skip factor. Skip factor will be applied to all selected signals. | |||
* More info: Shows more info about passive and Flexrays signals. | |||
* Upload text file with signals names. If the signal does not have a module name it is expected to belong to the already selected signal source/module. | |||
* Paste signals name to be added. If the signal does not have a module name it is expected to belong to the already selected signal source/module. | |||
* Copy signals. In the new window it is possible to switch if it is only the filtered or all signals copied. | |||
[[File:Srec.png|none|thumb|955x955px]] | |||
''' | ====== Add Signals: ====== | ||
Click on the '''Add Signal''' button to show the window. Select modules/signal source and search up the signals that you want to add. Select those signals and click on "Add signals". | |||
=====Recorder - Properties===== | =====Recorder - Properties===== | ||
Under the recorder tab '''Properties''' you can select the properties for the recorder, see Figure "Recorder Properties". | Under the recorder tab '''Properties''' you can select the properties for the recorder, see Figure "Recorder Properties". | ||
Line 44: | Line 51: | ||
The '''recorder Setup switch''' is started when recorder has performed its number of shots and all other started recorders have at least fulfilled their minimum duration. It is, like the trigger setup switch, used to switch to/run a measurement setup. | The '''recorder Setup switch''' is started when recorder has performed its number of shots and all other started recorders have at least fulfilled their minimum duration. It is, like the trigger setup switch, used to switch to/run a measurement setup. | ||
You can also select the '''Pre trigg duration''' which determines the amount of data that will be saved in the flash before the start trigger condition is met. Range is 0 to | You can also select the '''Pre trigg duration''' which determines the amount of data that will be saved in the flash before the start trigger condition is met. Range is 0 to 2147483647 (2<sup>31</sup> -1). | ||
The '''Post trigg duration''' is much like the pre trigg duration and determines the amount of data that will be saved after the stop trigger condition is met. Range is 0 to | The '''Post trigg duration''' is much like the pre trigg duration and determines the amount of data that will be saved after the stop trigger condition is met. Range is 0 to 2147483647 (2<sup>31</sup> -1). | ||
The '''Minimum duration''' determines the minimum amount of data that needs to be recorded before it becomes possible to cancel the recording through either a stop trigger or a setup swtich started by a trigger or another recorder. | The '''Minimum duration''' determines the minimum amount of data that needs to be recorded before it becomes possible to cancel the recording through either a stop trigger or a setup swtich started by a trigger or another recorder. | ||
The '''Maximum duration''' determines, as the name suggest, the maximum amount of data that should be recorded. Range is 0 to | The '''Maximum duration''' determines, as the name suggest, the maximum amount of data that should be recorded. Range is 0 to 2147483647 (2<sup>31</sup> -1). | ||
The '''Unit''' for the four aforementioned durations can be set to seconds, samples or bytes. If you choose to set them to seconds, the device will use the timestamps of the incoming data to determine the four aforementioned durations.[[File:Recorder properties.png|thumb|600x600px|Recorder Properties|none|link=https://wiki.alkit.se/wice264/index.php/File:Recorder_properties.png]] | The '''Unit''' for the four aforementioned durations can be set to seconds, samples or bytes. If you choose to set them to seconds, the device will use the timestamps of the incoming data to determine the four aforementioned durations.[[File:Recorder properties.png|thumb|600x600px|Recorder Properties|none|link=https://wiki.alkit.se/wice264/index.php/File:Recorder_properties.png]] | ||
Line 114: | Line 121: | ||
This type of signals can then be used in triggers and recorder by finding the name that will be “UD.<Name>”. | This type of signals can then be used in triggers and recorder by finding the name that will be “UD.<Name>”. | ||
[[File:UD Editor2.png|none|thumb|483x483px]] | [[File:UD Editor2.png|none|thumb|483x483px]] | ||
== Import/Export assignment == | |||
Signal reader assignment can be exported and then be imported in another portal. Versions can mismatch with one version and still work. If it differs more, use it carefully. When importing an assignment and vehicle profile needs to be selected. This profile should be similar to that one the original assignment was based on. If some signals or signals source do not exist in the new profile that was used in assignment a warning message will be shown with information about what is missing. If missing signals were used in a trigger expression the state will be set as invalid. Today there is no way to export and import a vehicle profile. So these have to be done manually. | |||
== DAQ/Event-list == | |||
If the assignment contains signals source that are compatible with DAQ list or Event channels a tab with name “DAQ/Event” will be visible. After signals have been added to the recorder it can be added to the DAQ list. | |||
=== Add new DAQ-List === | |||
To add a new DAQ list click on green plus icon on specific Measurement setup and ECU name. The new window shows all the DAQ-list that was predefined in the a2l-file. '''NOTE! What information that will be shown depends on what transport protocol that is selected in the module settings.''' If there is no information the table will be empty. Choose either one from the list or select “New blank” to define DAQ-list yourself. | |||
[[File:AddNewDAQ.png|none|thumb|528x528px]] | |||
=== Manage DAQ-List === | |||
On “Edit DAQ” following settings can be made: | |||
* Name | |||
* DAQ number: Must be unique | |||
* Periodicity: Will not affect the real periodicity is only for information. | |||
* Max bytes/Max Frame: Depending on measurement is over can or ethernet. | |||
* Prescaler | |||
[[File:DAQList.png|none|thumb|542x542px]] | |||
=== Manage Event channel === | |||
Manage event channels is similar to DAQ-list. In DAQ list you add signals but in event channels you add DAQ-list. With “Edit event” following settings can be made: | |||
* Name | |||
* Channel number: Must be unique. | |||
* Periodicity: Will not affect the real periodicity is only for information. | |||
* Max DAQs: Note that 255 meaning infinity. | |||
* Max Size of DAQs: Max byte each DAQ list can contain. | |||
* Priority |
Latest revision as of 15:51, 13 May 2024
The Signal Reader Assignment Editor can be found under the tab Assignment and allows the user to create new assignments for signal reader directly in the portal. This page will guide you through the basics of using the editor.
Edit/Create a signal reader assignment
The first tab that you are presented with is the Assignment global settings tab where you can add information about the assignment so that you can easily keep track of what this assignment is about. Creator and creation date are both automatically filled in and cannot be changed because of consistency.
Under the Measurements tab, see Figure "Measurement Setups", you are presented to a table of Measurement Setups and an information window. These measurement setups are the core of a signal reader assignment. They contain Triggers that activate and deactivate on certain conditions provided by the user. Each trigger can contain a Recorder that contains a list of certain signals that will be measured when the start condition for the respective trigger is met. A trigger can also be used to act as a setup switch.
When you feel finished with the assignment you can simply click the Save assignment button in the lower right corner to save the assignment in its current state.
Trigger
To add a trigger to a measurement setup, click the plus button for the respective measurement setup. This will create a new Trigger in the trigger table in the respective measurement setup and the information window will be filled with new settings for this trigger for you to add. In the window, trigger type can be set to different types: Recorder, Setup switch, Pause diagnostics, Start/stop CCP DAQ, Start/stop XCP DAQ and Upload. With Setup switch you will jump/end/restart when the start condition is met.
Fill out the start trigger condition for the trigger. This is easiest to do in the Edit expression window that you can get to by clicking one of the Edit buttons. To find a new signal to add a condition for, use the Add signal button. Here, you can browse all signals available for this assignment. Use the dropdown to browse signals from different can-busses and Wice internal signals. If you want to browse the signals currently in use in the assignment for the selected signal source, check the Search in assignment box. If you want more information about a signal, select it and click More info. When you have found the signal you want, double click it or select it and click Add signal. Now you can use the Operators list to add a condition for the signal, for example " > 0". When you are satisfied with the start condition, you will notice that the Validate button has a yellow warning symbol on it. This means that the expression is unvalidated, press the button to validate the expression. The buttons icon now either turns red (expression is unvalid) or green (expression is correct). See Figure "Validate Button States" for the different state of the validate button. Click Save to save the expression. The list of operators supported in trigger condition is available here.
A stop trigger condition is not required, but can be supplied to determine when the recording should stop. If the stop condition is not supplied, the settings for the recorder will tell when the recording should stop.
Recorder
There a two types of recorder, SREC (Signal recorder) and DREC (Diagnostics recorder). Choose which one you want with the radio button at the top of the Recorder tab.
Recorder - DREC
DREC (Diagnostics recorder) is used to send diagnostic requests onto the vehicle's communication buses and record the responses. The diagnostic requests are supplied in a sequence file uploaded by the user. The sequence file contains one diagnostic request per line, with the ECU id at the beginning of the line. There can optionally be other information as well. The syntax is the same as the one used for the IDC module, see Sequence File Syntax. The result from a DREC will be a diagnostic log file, a text file containing both the requests from the sequence file and the corresponding responses.
Recorder - SREC
SREC (Signal recorder) is used to record signals on the vehicle's communication buses. The result of an SREC is an MDF file containing the time series data of the selected signals.
For signal recorder there is 3 tabs:
- Symbols - Add/Remove/view signals to record
- Frames - Handle frame recorder on Passive CAN and Flexray busses.
- Properties - Settings for the recorder.
Symbols:
Buttons on the bottom strip:
- Add Signal: Will open a window where signals can be added from. By selecting a signal source the list will be populated with signals available from that source.
- Remove selected: Selected signals will be removed. This is also possible by right click on the list.
- Edit Selected: To edit PLA-compressions (Read more here.) and skip factor. Skip factor will be applied to all selected signals.
- More info: Shows more info about passive and Flexrays signals.
- Upload text file with signals names. If the signal does not have a module name it is expected to belong to the already selected signal source/module.
- Paste signals name to be added. If the signal does not have a module name it is expected to belong to the already selected signal source/module.
- Copy signals. In the new window it is possible to switch if it is only the filtered or all signals copied.
Add Signals:
Click on the Add Signal button to show the window. Select modules/signal source and search up the signals that you want to add. Select those signals and click on "Add signals".
Recorder - Properties
Under the recorder tab Properties you can select the properties for the recorder, see Figure "Recorder Properties".
Number of shots is an important factor for a recorder. A shot is the term used for a single recording and number of shots is therefore the number of times we should record. A shot is only started when the start trigger condition is met and will continue until any of these events occur:
- The recording fulfills the maximum duration.
- The recording fulfills the minimum duration and the stop trigger condition is met.
- The recording fulfills the minimum duration and a trigger start a setup switch.
- The recording fulfills the minimum duration and another recorder starts a setup switch.
- A setup switch is started manually.
- The assignment is stopped manually.
The recorder Setup switch is started when recorder has performed its number of shots and all other started recorders have at least fulfilled their minimum duration. It is, like the trigger setup switch, used to switch to/run a measurement setup.
You can also select the Pre trigg duration which determines the amount of data that will be saved in the flash before the start trigger condition is met. Range is 0 to 2147483647 (231 -1).
The Post trigg duration is much like the pre trigg duration and determines the amount of data that will be saved after the stop trigger condition is met. Range is 0 to 2147483647 (231 -1).
The Minimum duration determines the minimum amount of data that needs to be recorded before it becomes possible to cancel the recording through either a stop trigger or a setup swtich started by a trigger or another recorder.
The Maximum duration determines, as the name suggest, the maximum amount of data that should be recorded. Range is 0 to 2147483647 (231 -1).
The Unit for the four aforementioned durations can be set to seconds, samples or bytes. If you choose to set them to seconds, the device will use the timestamps of the incoming data to determine the four aforementioned durations.
Active signals
An Active Signal is a signal that is created by polling an ECU for a numerical value at a predefined frequency. The polling is typically done using the ReadDataByIdentifier diagnostic service. To create an assignment with active signals, the vehicle profile has to have a diagnostic description. This is set in the vehicle profile settings here. There has to be a diagnostic description connected to the vehicle profile when the assignments are created to be able to select active signals. If a vehicle profile is updated, an assignment can be upgraded to match the new vehicle profile by doing a copy. This will automatically upgrade it and if there is a diagnostic description connected it will be possible to use active signals.
Select “Active signal” in signal Source. Then it is possible to select ECU in ECU name. After that available signals will show up and select/deselect works like for the other signal sources.
When creating a task with an assignment that has active signals selected, a button “ECU SW mappings” will show up. If there is a red exclamation mark, a specific software version has to be selected for one or more ECUs. If a recorder signal does not exist in the selected software version it will be removed. Note that the software version has to contain all active signals that exist in the trigger conditions otherwise it will not be possible to create the task.
Using a portal assignment for a signal reader task
In order to use a portal assignment. Select the WCUs in the Vehicle tab that you want to create the new signal reader assignment for and click new task. Navigate to the Signal reader tab and click the Browse saved assignments button and select the assignment you want to use and click Ok. This assignment will now be used to create the .haf file required by the WCUs to perform the signal reader task. If selecting "Legacy WICE internal signal names" certain wice internal signals names will be translated.
Legacy WICE internal signal names:
From | To |
---|---|
WICE.Longitude | WICE_Generic_Internal.Longitude_0020 |
WICE.Latitude | WICE_Generic_Internal.Latitude_0020 |
WICE.CSQ | WICE_Generic_Internal.CSQ_0020 |
WICE.WCU_Voltage | WICE_Generic_Internal.WCU_Voltage_0103 |
WICE.WCU_Temp | WICE_Generic_Internal.WCU_Temp_0104 |
WICE.Time_Since_Epoch | WICE_Generic_Internal.Time_Since_Epoch_0090 |
WICE.Start_Signal | WICE_Generic_Internal.Start_Signal_0100 |
Select different communication interface or transport protocol
Under the "Modules" tab, the different signal sources are visible. In the "I/O" column, the selected communication interface and transport protocol are shown. By selecting a row and then clicking on the button “Edit Interface” this can be changed. Currently this is only possible for modules with type “A2L” or "Diagnostics." When changing this, a validation of the settings with what is red from the corresponding A2L file is done. If the validation is successful, a green icon will appear. If the icon is a red cross the A2L file does not contain the necessary information for the setting.
When selecting between CAN and Ethernet/DoIP diagnostics, a window pops up where you can select the interface between "Default Channel", "CAN" or "DoIP". Selecting "Default Channel" means that the default channel in the signal reader module settings on the wcu is going to be used. Interface "CAN" a specific CAN interface can be selected to be used for the diagnostic requests. If selecting "DoIP", the diagnostics will be performed over Ethernet using the Diagnostics-over-IP (DoIP) protocol. In this case, you can also select whether to use the IP address broadcasted by the vehicle in a "Vehicle Announcement" message, or you can specify the IP address explicitly (in which case the Vehicle Announcement will be ignored). The DoIP port number to use (default 13400) can also be specified.
A2L modules support the following interfaces, CPP-CAN, XCP-CAN, XCP-TCP, XCP-UDP and UDS (2C/2A).
Record frames with filter
Frame recorder can be used on FlexRay and CAN-bus. In a signal recorder the frame recorder with or without filter can be activated.
To activate/deactivate the frame recorder for a module either click on the active icon or select a specific row and click Toggle.
To edit the filter either double click on row or click on edit filter.
User defined signals
In this tab are user defined signals handled.
- Add and remove signals by clicking the respective button.
- Signals names are set on creation and can not be changed after that.
- Calculation formula is the formula that will be calculated for the signal's value. For example writing “module.signal_name + 10” will increase “signal_name” by 10.
- Update on signals is determining when the formula shall be calculated. Each time that signals get present the new user defined signal will be calculated.
This type of signals can then be used in triggers and recorder by finding the name that will be “UD.<Name>”.
Import/Export assignment
Signal reader assignment can be exported and then be imported in another portal. Versions can mismatch with one version and still work. If it differs more, use it carefully. When importing an assignment and vehicle profile needs to be selected. This profile should be similar to that one the original assignment was based on. If some signals or signals source do not exist in the new profile that was used in assignment a warning message will be shown with information about what is missing. If missing signals were used in a trigger expression the state will be set as invalid. Today there is no way to export and import a vehicle profile. So these have to be done manually.
DAQ/Event-list
If the assignment contains signals source that are compatible with DAQ list or Event channels a tab with name “DAQ/Event” will be visible. After signals have been added to the recorder it can be added to the DAQ list.
Add new DAQ-List
To add a new DAQ list click on green plus icon on specific Measurement setup and ECU name. The new window shows all the DAQ-list that was predefined in the a2l-file. NOTE! What information that will be shown depends on what transport protocol that is selected in the module settings. If there is no information the table will be empty. Choose either one from the list or select “New blank” to define DAQ-list yourself.
Manage DAQ-List
On “Edit DAQ” following settings can be made:
- Name
- DAQ number: Must be unique
- Periodicity: Will not affect the real periodicity is only for information.
- Max bytes/Max Frame: Depending on measurement is over can or ethernet.
- Prescaler
Manage Event channel
Manage event channels is similar to DAQ-list. In DAQ list you add signals but in event channels you add DAQ-list. With “Edit event” following settings can be made:
- Name
- Channel number: Must be unique.
- Periodicity: Will not affect the real periodicity is only for information.
- Max DAQs: Note that 255 meaning infinity.
- Max Size of DAQs: Max byte each DAQ list can contain.
- Priority