Difference between revisions of "Vehicles"

Latest revision as of 08:13, 23 May 2024

This view is used to handle the various vehicles that are assigned to you. A figure of this view is presented below in the Figure "Vehicles Tab". At the top, the red section, is a search area where you type in the criteria to be used for fetching the vehicles you are interested in. As you enter your criteria a row count is presented in the upper right area to show how many potential matches there are. The entries are also fetched as you type but only as many rows as fit your current view are fetched. As you scroll down more results will be fetched.

Vehicles Tab

The number of possible columns to show is quite large. You can elect which columns you wish to see by right clicking on the column header and select "Columns..". A small window will pop-up, in which you can select which columns should be visible in the table. These are the available columns:

Active alarms	Presents a numeric summary of alarms. It displays the amount of errors and warnings.
Connected	Shows how many minutes have passed since the WCU made a connection to the WICE portal.
Distance	Shows the distance the car has been driven the last week. (SoH task specific)
Last DRO	Says when the DRO log file was last transferred to the portal.
Last log	Shows when the last log file was transferred to the portal.
Mileage	The column shows the mileage of the car.
Plate number	The plate number of the car where the WCU is mounted.
Platform type	Search WCU by platform type.
Project Id	Shows the project identification number.
Proto number	Shows the proto number.
Resource group	The resource group (if any) the WCU is part of.
Series	Shows the series attribute.
TSU	Shows the TSU identifier.
Upload	This column says how much data has been transferred from the WCU to the portal the last week.
Upload date	Contains which date the last upload was done
Upload size	Says what the size, in kilobytes, of the last data upload was.
Uptime	Shows how many hours the WCU been running the last week.
VIN	Shows the Vehicle Identification Number of the car where the WCU is mounted.
Voltage	The column shows the latest known battery voltage as reported by the CEM.
WCU ID	The MAC ID of the WCU. For example: AA-01-AA-01-AA-01.
WCU Description	A textual comment attached to the WCU.
WCU Firmware	Shows which firmware the WCU uses.
WCU voltage	Shows the voltage as measured by the WCU.
WCU Version	Shows which version the current WCU software has.
WCU storage usage	Shows the amount of storage available to store data on the WCU.
WCU name	Shows the name of the WCU

Now, as there are so many columns present you have the option of selecting which ones you would like to see by right-clicking on the table header. If you would like your selection to be remembered between sessions, use the binocular icon with an add sign in bottom right corner in the Figure "Vehicles Tab". To save the currently entered search expression, similarly use the magnifying glass icon with an add sign. To read more about the view and search functionality, click here.

There is a concept called “resource groups” you should be aware of in this panel. A resource group is simply a way to refer to a group of resources (WCU, Car) collectively. An example is when creating tasks you can select a resource group instead of the individual WCU:s to start a new task. Also, when showing the positions on a map, you select a resource group and press “Show position”, all WCU:s in that resource group will show. To see which resources are in a resource group you press the triangle to the left of the row and the row opens up to show the individual members. To show the members in the view you can rightclick the entry and select the option “find members” from the menu.

When selecting a row in the table the selected row changes to a blue shade. You can modify the description of the WCU by clicking in the “Edit Description” button and entering a new description. You can search among the vehicles log files by clicking the “Get log files” button.

Right click context menu

If you select one or more rows in the table, you can right click on the selected rows. This will display a context menu with several options, some of which are described here.

Go to Tasks Panel
This allows you to instantly jump to the tasks panel, which will automatically perform a search based on either the WCU or the car which the selected row represents.

Go to Search Panel
This allows you to instantly jump to the search panel. The search panel will automatically perform a search based on either the WCU or the car.

Go to Timeline
This allows you to jump to the Timeline-view, which will adjust itself to the WCU you have selected.

Go to alarms
Selecting this will take you to the alarms panel, where a search is conducted for all selected WCUs. This allows you to quickly see all alarms for a specific set of WCU resources. This works well together with the Active Alarms column (which you can read about further up this page), which tells you if a WCU has any active alarms. If a WCU has any active alarms, then using "go to alarms" will allow you to review those alarms in detail.

Remove WCU(s) from Resource Group
If WCUs which are included in a resource group are selected, the menu option "Remove WCU(s) from Resource Group" will appear. They do not have to be in the same resource group as each other. If a resource which do not fulfill this requirement is selected in addition, this option will not be visible.

Show WCU history

Example of a Show WCU history

Selecting this shows a window with the history of the selected WCU. In the window it can be seen when a change has been made, if there is a change in the description, if the WCU is active or not, the WCU ID, labels on the WCU, WCU Name and which user made the change. If the WCU has a modem id it will also be shown in the window. For the Show WCU history option to be available only a single WCU can be selected.

Trigger upload now

Momentarily stop the WCU, offload it and upload any data as soon as possible. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.39

Trigger reboot now

Reboots the trigger and WCU. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.39

Trigger collect and upload

This action will cause the task to momentarily stop and upload any data as soon as possible. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.45.

Trigger VIN readout

Trigger VIN readout, this action will cause the task to momentarily stop .This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.65.

New task

To create a new task for all selected WCUs, click the button New Task. To learn more about creating each specific task see Creating a Task.

Show the Vehicle Position

To see the last reported position of a vehicle, click the “Show Position” button which opens up a map view of where the vehicle was last known to be. You can view several vehicles simultaneously by ctrl- or shift-clicking the vehicles you are interested in.

If you want to know more about the "Show position"-tool you can read more about it here.

View Diagnostic Trouble Codes

Viewing Diagnostic Trouble Codes

If an SoH task has been enabled to do Diagnostic Trouble Code (DTC) read-outs, you can view the trouble codes by selecting the vehicle you are interested in and push the button “View DTCs”. In Figure "Viewing Diagnostic Trouble Codes" you can see an example presentation of DTCs. There are five columns in the table. The leftmost is the name of the ECU issuing the DTC, next is the date and time when the trouble code was read-out, the actual DTC with clear text description, and thereafter the VIN and WCU id of the vehicle. If you click in the column for the actual trouble code, a dialog opens with that particular trouble codes. You can extend the size of the dialog in order to examine the trouble codes in more detail. You can also search the trouble codes as you can see at the top of Figure "Viewing Diagnostic Trouble Codes".

View ECU software

ECU Software Versions

It is possible to see the ECU software number for each ECU in a vehicle. Press the button “ECU SW” after you have selected one vehicle. The following view will be shown. As you can see in Figure "ECU Software Versions", each ECU's software number is shown along with when it was read. You can download the list as a tab-separated text file if you press “Download”.

Get WCU Up-time

WCU Up-time Dialog

This function is used to get a compilation of the up-time of a set of vehicles during a particular time span. Select the WCUs you are interested in and the click the “Get WCU uptime” button. This brings up the dialog to the right.

Choose the dates you are interested by choosing a start and end date. Next you have the option of downloading a CSV file, or excel file. The up-time in that file is listed as hours up-time per day per WCU. The other option is to compile the up-time in a chart shown on screen. The up-time is averaged over the WCUs selected for each day. WCUs having no up-time at all are excluded from the compilation.

From version 2.42 there is a new feature to display the WCUs uptime based on the data sent from statusd. More info in WCU Uptime.

Export SoH Data

SoH Data Export Panel

You can export data from SoH tasks to your local computer by using the function “Export SoH data”. Select the cars you are interested in as you can export for more than one car in one export. You select the dates you are interested in getting the data from. Check each item you are interested in. Currently you can select mileage, WCU voltage, ECU software versions, battery voltage, storage usage and diagnostic trouble codes. The file can be exported in CSV format (suitable for Excel and other spreadsheet applications) and in XML format.

Resource Groups

WCUs and cars can collectively be referred to as "resources". As such they can be grouped together and be handled collectively in order to ease the administration of a set of similar individuals. A resource group can consist of both cars and WCUs but usually only one type of resource is in a resource group.

You identify a resource group by a gray arrow like icon to the left in the table row. If you click the icon the entry opens up and makes room for showing which resources are part of the resource group.

From version 2.42 the showing of the resource group's resources has been improved. More info can be found in Resource group's resources.

When a new task is created any resource groups assigned to you will show up in addition to individual WCUs. There is, however, no indication as to the particular entry is a resource group or not. If you select a resource group, the new task will be downloaded to all the WCUs that are part of the resource group. As a regular user you can not create and remove resource groups, only an administrator of the portal can do this.

From version 2.42 of the portal it is easier to search out members of resource groups using the "Resource group" column. When searching in this column one will get results that either matches the name of a resource group WCU or WCUs that are part of a resource group that matches the search criteria. In other words, if we search for "ABCD" we will get the resource group "ABCD" together with all WCUs that are part of the "ABCD" group.

This column can also be used to list all WCUs that are not part of any resource group. To perform this search, put "^$" in the "Resource group" column.

Alternatively, you can find the resource group that a WCU belongs to, by right-clicking the WCU and select "Search resource group".

Modules

If you have the right permission you will be able to view a WCU:s modules, and configure them. A module is a specific functionality of the WCU, such as a measurement tool. The available modules are:

@@ Line 20: / Line 20: @@
 |-
 | style="font-weight: bold;" | <span id="Distance">Distance</span>
-| Shows the distance the car has been driven the last week. (SoH assignment specific)
+| Shows the distance the car has been driven the last week. (SoH task specific)
 |-
 | style="font-weight: bold;" | <span id="Last_DRO">Last DRO</span>
@@ Line 61: / Line 61: @@
 | Says what the size, in kilobytes, of the last data upload was.
 |-
-| style="font-weight: bold;" | <span id="Up-time">Up-time</span>
+| style="font-weight: bold;" | <span id="Up-time">Uptime</span>
 | Shows how many hours the WCU been running the last week.
 |-
@@ Line 94: / Line 94: @@
 Now, as there are so many columns present you have the option of selecting which ones you would like to see by right-clicking on the table header. If you would like your selection to be remembered between sessions, use the binocular icon with an add sign in bottom right corner in the Figure "Vehicles Tab". To save the currently entered search expression, similarly use the magnifying glass icon with an add sign. To read more about the view and search functionality, click [[Save View and Search Expressions|here]].
-There is a concept called “resource groups” you should be aware of in this panel. A resource group is simply a way to refer to a group of resources (WCU, Car) collectively. An example is when creating assignments you can select a resource group instead of the individual WCU:s to start a new assignment. Also, when showing the positions on a map, you select a resource group and press “Show position”, all WCU:s in that resource group will show. To see which resources are in a resource group you press the triangle to the left of the row and the row
+There is a concept called “resource groups” you should be aware of in this panel. A resource group is simply a way to refer to a group of resources (WCU, Car) collectively. An example is when creating tasks you can select a resource group instead of the individual WCU:s to start a new task. Also, when showing the positions on a map, you select a resource group and press “Show position”, all WCU:s in that resource group will show. To see which resources are in a resource group you press the triangle to the left of the row and the row
 opens up to show the individual members. To show the members in the view you can rightclick the entry and select the option “find members” from the menu.
@@ Line 119: / Line 119: @@
 '''Show WCU history'''
+[[File:WikiwcuHistory.png|alt=|thumb|Example of a Show WCU history]]
+Selecting this shows a window with the history of the selected WCU. In the window it can be seen when a change has been made, if there is a change in the description, if the WCU is active or not, the WCU ID, labels on the WCU, WCU Name and which user made the change. If the WCU has a modem id it will also be shown in the window. For the Show WCU history option to be available only a single WCU can be selected.
-Selecting this will create a window of the selected WCU history. In the window the user can see when the change have been made, if there is a change in the description, if the WCU is active or not, the WCU ID , WCU Name and which user made the change. If multiple WCU is selected this function will be disable. So for this to option to work only one WCU can be selected at the time.
+'''Trigger upload now'''
+Momentarily stop the WCU, offload it and upload any data as soon as possible. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.39
+'''Trigger reboot now'''
+Reboots the trigger and WCU. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.39
+'''Trigger collect and upload'''
+This action will cause the task to momentarily stop and upload any data as soon as possible. This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.45.
+'''Trigger VIN readout'''
+Trigger VIN readout, this action will cause the task to momentarily stop .This trigger button is only visible if the WCU state is in-operation and the WCU version is later then 2.65.
 ==New task==
@@ Line 133: / Line 149: @@
 [[File:Illustration28.png|thumb|300px|Viewing Diagnostic Trouble Codes]]
-If an SoH assignment has been enabled to do Diagnostic Trouble Code (DTC) read-outs, you can view the trouble codes by selecting the vehicle you are interested in and push the button “View DTCs”. In Figure "Viewing Diagnostic Trouble Codes" you can see an example presentation of DTCs. There are five columns in the table. The leftmost is the name of the ECU issuing the DTC, next is the date and time when the trouble code was read-out, the actual DTC with clear text description, and thereafter the VIN and WCU id of the vehicle.
+If an SoH task has been enabled to do Diagnostic Trouble Code (DTC) read-outs, you can view the trouble codes by selecting the vehicle you are interested in and push the button “View DTCs”. In Figure "Viewing Diagnostic Trouble Codes" you can see an example presentation of DTCs. There are five columns in the table. The leftmost is the name of the ECU issuing the DTC, next is the date and time when the trouble code was read-out, the actual DTC with clear text description, and thereafter the VIN and WCU id of the vehicle.
 If you click in the column for the actual trouble code, a dialog opens with that particular trouble codes. You can extend the size of the dialog in order to examine the trouble codes in more detail.
 You can also search the trouble codes as you can see at the top of Figure "Viewing Diagnostic Trouble Codes".
@@ Line 155: / Line 171: @@
 ==Export SoH Data==
 [[File:Soh data export.png|frame|SoH Data Export Panel]]
-You can export data from SoH assignments to your local computer by using the function
+You can export data from SoH tasks to your local computer by using the function
 “Export SoH data”. Select the cars you are interested in as you can export for more than
 one car in one export.
-You select the dates you are interested in getting the data from. Check each item you are interested in. Currently you can select mileage, WCU voltage, ECU software versions, battery voltage and storage usage.
+You select the dates you are interested in getting the data from. Check each item you are interested in. Currently you can select mileage, WCU voltage, ECU software versions, battery voltage, storage usage and diagnostic trouble codes.
 The file can be exported in CSV format (suitable for Excel and other spreadsheet applications) and in XML format.
@@ Line 173: / Line 189: @@
 When a new task is created any resource groups assigned to you will show up in addition to individual WCUs. There is, however, no indication as to the particular entry is a
-resource group or not. If you select a resource group, the new assignment will be downloaded to all the WCUs that are part of the resource group.
+resource group or not. If you select a resource group, the new task will be downloaded to all the WCUs that are part of the resource group.
 As a regular user you can not create and remove resource groups, only an administrator
 of the portal can do this.
@@ Line 194: / Line 210: @@
 * [[The Portal Administrator View#Configure the DoIP Module|DoIP]]
 * [[The Portal Administrator View#Configure the ETAS Module|ETAS]]
+* [[The Portal Administrator View#Configure the File fetcher module|File Fetcher]]
 * [[The Portal Administrator View#Configure the GPS Module|GPS]]
 * [[The Portal Administrator View#Configure the IDC Module|IDC]]
+* [[The Portal Administrator View#Configure the IPEmotion RT Module|IPEmotion RT]]
+* [[The Portal Administrator View#Configure the LPD Module|LPD]]
 * [[The Portal Administrator View#Configure the MCD-Hub Module|MCD-Hub]]
 * [[The Portal Administrator View#Configure the M-log Module|M-log]]