Difference between revisions of "Creating a Task"

From WICE Wiki v2.89
Jump to navigation Jump to search
Line 62: Line 62:
==== Files containing references to sequence files ====  
==== Files containing references to sequence files ====  
[[File:SequenceFileForSignalreader.png|thumb|right|Illustartion 4.2: Sequence files references found in the .haf file]]  
[[File:SequenceFileForSignalreader.png|thumb|right|Illustartion 4.2: Sequence files references found in the .haf file]]  
When the measurement file contains sequence files the user must help by selecting the local which sequence files that are needed in order to run the assignment. The portal scans the .haf file for such entries and presents this to the user, see to the right. Click the button for each sequence file reference to upload each sequence file needed. Some queries in the sequence file are of functional type, i.e. posed to all ECUs, and in such cases you have the option of doing it using snapshots or extended data. An example of this can found in illustration 4.2.  
If the measurement file contains references to sequence files, you are also required to select these in order to run the assignment. The portal scans the .haf file for such entries and presents this to you, see illustration 4.2. Click the button for each sequence file reference to upload each sequence file needed. Some queries in the sequence file are of functional type, i.e. posed to all ECUs, and in such cases you can select the option of using ''Snapshots'' or ''Extended data''. An example of this can found in illustration 4.2.  
[[File:SequenceFilesForSignalreaderWithFunctionalQuery.png|thumb|right|Illustration 4.3: Sequence file with functional query]]  
[[File:SequenceFilesForSignalreaderWithFunctionalQuery.png|thumb|right|Illustration 4.3: Sequence file with functional query]]  


Here, the .haf file contained two references to sequence files. As no sequence files have yet been uploaded, the selection for reading snapshot or extended data is grayed out. In illustration 4.3 we have selected one such sequence file containing functional queries. We have here checked that we would like to read extended data as well. One could also check both options.   
Here, the .haf file contained two references to sequence files. As no sequence files have yet been uploaded, the selection for reading snapshot or extended data is grayed out. In illustration 4.3 we have selected one such sequence file containing functional queries. Here we have checked that we would like to read ''Extended data''. It is also possible to select both ''Snapshots'' and ''Extended data''.   
<br>
<br>



Revision as of 10:48, 28 June 2018

You create a new task by pressing the "New Task" button on the bottom of the "Tasks" tab. This will open a window where you choose the type of assignment you want to create. Here we will go through how to create tasks of each of the nine different kinds of assignments available (MCD-Hub, Canrecorder, IDC, SoH, Signal Reader, SWDL, ETAS, SoftHub and blue piraT). Note that step 3-6 on MCD-Hub is identical on all assignments so it will not be described to avoid this being repetitive.

illustration 1: MCD-Hub

MCD-Hub

MCD-Hub assignments are used to collect data using the MCD-Hub flight recorder. This assignment tab has seven parts (as shown in illustration 1) with one function each that is used as follows:

1. Selecting which MCD-Hub assignment file to use. Press "Bläddra"/"Browse" to bring up the file selection where you select the .hub file to use. The assignment file is typically created using the MCD Tool software.

2. Choose which formats the MCD-Hub result files should be converted to when result files are uploaded to the portal from a WCU.

3. Write a descriptive text for the assignment (optional).

4. Assign owner and the period of validity to the assignment. This is filled automatically and is optionally changed.

5. The "Add schedule" option is under construction, do not use except for special cases.

6. Start searching and selecting target WCUs by pressing add resources at the bottom left of the screen. There you will get a pop up with two boxes, the upper one for searching cars and the bottom one for selected cars. In the top one you can search for WCUs using ten different parameters by writing a value and pressing search or ENTER. To select a WCU you drag it from the top to the bottom box so that it appears in the bottom one.

After you press OK there will be a pop-up telling you "Transfer ok!" if everything went well, otherwise there will be a pop-up dialog showing you an error message.

CAN-recorder

Illustration 2: Canrecorder

Canrecorder is a measurement module that allows CAN frames to be captured and logged. This assignment has four options described in illustration 2 and below:

1. In the grid, select which bus (or buses) to record from. By clicking the check box in the top left corner, you can select all buses at once.

2. Specify which CAN frames you want to record by entering their CAN IDs in the CAN frame ID column in the grid, on the same row as the bus you have selected, or by entering the IDs in the text box labeled “Set filters on selected CAN buses”. If you use the latter option, the filters will be set on all of the buses you have selected. To enter a filter on a specific bus use the method of entering the filter on the same row as the selected bus, on the grid. This can only be done if the CAN frame passthrough filter is turned on. Turning off the CAN frame passthrough filter option will disable the CAN frame ID column in the grid. Press the “Clear All” button to remove all the entered filters from all buses.

3. Turning on or off a CAN frame pass-through filter. If you choose to have the filter on you must specify which CAN bus or CAN buses you wish to record.

4. Select how long time to record before and after the trigger.

IDC

The Internal Diagnostic Client (IDC) is a measurement module that allows a sequence of diagnostic requests to be sent and responses recorded. The sequence of diagnostic requests are uploaded to the portal as a text file (usually ending with ".seq").

SoH

Illustration 3: SoH tab

A State of Health (SoH) assignment collects specific status information from vechiles. You select which information you want the assignment to collect by filling in one or more of the six boxes shown in illustration 3. In order for SoH data to be correctly interpreted, relevant description files (SDDB/GDS) for the vehicles executing the SoH assignment must have been defined. To add a SDDB/GDS file to a vehicle, see The Edit Car Dialog.The six different options are:

  • Mileage
  • Voltage
  • Read ECU software numbers
  • Read ECU DTC:s
  • Read OBD-II PIDs
  • App Diagnotstic Db Part Num

Signal Reader

Illustration 4.1: Signal reader assignment.

Signal Reader is a measurement module that allows monitoring and logging of CAN and FlexRay signals, as well as diagnostics data. Signal Reader performs more or less the same kind of measurements as the MCD-Hub but it has other functions as well. Those other functions are described below and shown in illustration 4.1:

1. You either select an assignment file of .haf format, or choose an assignment blueprint created in the blueprint creator. Your current choice will be displayed in the "Chosen file" field.

2. When you have selected a file and WCU unit(s), the buses defined in the file and on the WCU will be mapped. If they can be automatically mapped a green check will be displayed, otherwise a red cross will be displayed. Clicking the mapping button will open the mapper. In the pop-up window you will have to map the different buses to each other manually and then save. Once this is done correctly, the red cross will become a green check, indicating that the mappings are ready to be automatically applied upon submit. Read more about this in I/O configurations and Mappings.

3. With a Signal Reader assignment you can follow WCU signals live by selecting "Monitor signals". When selected it will come up two boxes under the task description. In the left one you search for signals and drag them over to the right one where the monitored signals are. You can later se the monitored signals through the vehicles tab. It is also possible to copy the signals text in the bottom right corner of the right box. Next to the copy text button you can also paste signals as text where the pasted signal names will be matched against the list of unselected signals

4. You can choose if you want the signals to have their data source names as a prefix (e.g. ECM.EngineSpeed instead of EngineSpeed).


Signal Reader can also act as a signal broker for other software components. Read more about this in WICE Signal Broker API.

Files containing references to sequence files

Illustartion 4.2: Sequence files references found in the .haf file

If the measurement file contains references to sequence files, you are also required to select these in order to run the assignment. The portal scans the .haf file for such entries and presents this to you, see illustration 4.2. Click the button for each sequence file reference to upload each sequence file needed. Some queries in the sequence file are of functional type, i.e. posed to all ECUs, and in such cases you can select the option of using Snapshots or Extended data. An example of this can found in illustration 4.2.

Illustration 4.3: Sequence file with functional query

Here, the .haf file contained two references to sequence files. As no sequence files have yet been uploaded, the selection for reading snapshot or extended data is grayed out. In illustration 4.3 we have selected one such sequence file containing functional queries. Here we have checked that we would like to read Extended data. It is also possible to select both Snapshots and Extended data.

SWDL

A Software Download (SWDL) task updates the ECU software in one or more ECUs in one or more vehicles. A number of Versatile Binary Format (VBF) files containing the ECU software need to be supplied, along with PIN codes to allow security access to re-program the ECUs.

ETAS

Through an ETAS task, an ETAS ES720 Drive Recorder system can be configured, and measurement data offloaded and accessed through the WICE Portal.

When creating an ETAS task, the assignment description file you select must be a .exp file.

SoftHub

The SoftHub is a more recent version of the MCD-Hub measurement system, and a SoftHub task is created much in the same way an MCD-Hub task is.

When creating a SoftHub task, it is identical to a MCD-Hub task except that the file you select must be a .shub file.

Blue piraT

The blue PiraT is a measurement system from Telemotive AG that can be configured with measurement set-ups, and data accessed through the WICE Portal. Note that to use the blue PiraT module, the WCUs to be used need to be preconfigured with a special software package (i.e. an "extra bundle"). Contact Alkit Communications in order to set this up.

Video

A video task makes it possible to record and monitor live video from one or two cameras attached to a WCU. You can trigger recording of video using either a trigger button or a recorder start event from Signal Reader. You can alson let the video recording start as soon as the WCUs has started. If monitoring of video from a WCU is enabled, a live video stream will be transmitted which can be viewed using a RTP-based video tool, for instance Alkit Confero.

Read more about the video support in WICE here.