New features in v2.41
This page aims to list all new features that is implemented i version 2.41 of the WiCE Portal.
New task
To create a new task, first select task type in the window presented in Figure "New Task Window". Learn more about how to go about creating a new task here. When a task is chosen, you can select target WCUs for the task by clicking the "Add resources"-button, presented in Figure "Add Resources to Task". As the illustration shows, the area where WCU's where added and removed to the task is a table very similar to the that in the Vehicles tab. This table shows the currently added WCUs that the chosen task will be added to. Clicking "Add resources" the window shown in Figure "Select Resources Window" will open up.
The select resources window contains two tables. The upper table has filter editors where one enters search criteria and performs a search by pressing enter or clicks the "Search" button. The lower table shows the selected resources (WCUs) and is connected to the table shown in Figure "Add Resources to Task".
Add/remove resources
To add content to the table of selected resources you can select the a WCU and then either click on the "arrow down" button located between the two tables or drag and drop the selected WCUs. It is also possible to add a single WCU by double clicking it. To remove content from the table of selected resources you can select the WCUs you want to remove and then click the "X" button next to the "arrow down" button. You can also remove a single WCU by clicking the red "Remove record" icon in the end of each line in the table.
When you are happy with the selected resources, click "Done" and the content will be added to the table shown in Figure "Add Resources to Task". If you click cancel, the content will not be added and you will have to add the WCUs again by reopen the Select resources window.
Incompatible resources
If you add a WCU and return to the New task window you can end up with having one or more lines, in the selected WCUs table, with red background. This means that the WCU does not have the current tool installed. An example of this can be seen in Figure "Incompatible Resources".
Add resources from the Search- and Vehicles tab
Instead of adding WCUs by the method shown above, it is also possible to select one or more records in the Search/Vehicles table in the corresponding tabs and then click "New Task". Any selected WCU will then by added to the table of selected WCUs. An example can be seen in Figure "Add WCUs from Vehicles Tab".
When selecting WCUs in the Search/Vehicles tab it is possible to select all visible WCUs by pressing Ctrl+A. To select even non visible WCUs (when your search criteria matches more results than the standard fetch of 50 results) you press Ctrl+A two times in a row. Note! Internet Explorer has some problems to correctly report keys down when two keys are pressed and when the result table in Vehicles has the focus. To come around this (and use the double CTRL+A feature) click outside the table and then press CTRL+A twice.
A illustration showing what it looks like when CTRL+A is pressed twice and even non-fetched WCUs are selected can be seen in Figure "Select All by CTRL+A".
View the validation reasons for each WCU within a resource group when creating a task
Starting with version 2.91.0, users can now view the validation status of each WCU within a resource group when creating a task. To access this feature, simply click the 'Show Resources' button or double-click the row (Figure "Add Resources to Task"). This will open a new validation window displaying the status of each individual WCU (Figure "Validation Resource Window"). If any WCU's status is not 'Ok,' users can hover over the WCU to see a detailed description of the issue. In the bottom left corner, you'll also find statistics indicating how many WCUs have the statuses of 'OK,' 'Warning,' and 'Error. In the bottom right corner, you'll find a copy button. When pressed, this button opens a new window displaying the table in text format, making it easier for users to copy any data.
I/O configurations
For WCUs with software version >= 2.41 the "Edit Configuration" window has a new tab named "IO". In this tab, it is possible to edit the settings of the CAN and Ethernet channels of a WCU. It is also possible to apply a pre defined template which is created and managed by an admin. The "Edit Configuration" window is reached by going to the Vehicles tab, select a WCU and press the button "Edit Configuration".
Edit CAN channels
The number of available CAN channels depends on the platform type of the WCU which is configured. The group of CAN channels consists of four columns named Channel, Speed, Name and Comment. Each column is described separately below.
Channel
This column is a checkbox and if you enable CAN X, this means that X is available for mappings when creating a new task and uploading this task to his WCU. Read more about Mappings. In the same way, disabling CAN X means that X is not available for mappings. If a CAN channel for some reason is not connected to the WCU, then it could be good choice to disabling it here.
Speed (kB)
The speed column shows the baud rate of each CAN channel. This value was previously added to the WCU configuration when the WCU was connected to a CAR but from now it has to be set manually in this tab.
FD Speed (kB)
If the platform is HMX and the WCU version is 2.91.0 or later, a column will appear for the CAN channel.
Name
In this column it is possible to set a nickname for the channel. This name is used when a Signalreader task or assignment is automapped (see Mappings) so choose your names carefully. The default value is CAN 1,2..6.
Comment
The last column is used to add some comments to each channel. This is typically some describing text, e.g. the reason why a channel is disabled.
Add WMU(s)
If your Portal has WMU's enabled the "Add WMU" button will show in the CAN section. You can then add/remove WMU's and configure their CAN channels in the same way as the WCU's CAN channels are configured. For each WMU that is added, a corresponding tab is added under the Power Management tab for configuring the WMU's power behaviour.
Add CAN channels
If your Portal has Vehicle Communication Forwarder enabled, the "Add CAN channels" button will show in the CAN section. If both WMUs and Vehicle Communication Forwarder are enabled in your Portal, only "Add CAN channels" will show up. After having added a Vehicle Communication Forwarder with at least one CAN channel, pressing the button again will add more CAN channels to the Vehicle Communication Forwarder. When removing CAN channels, it is possible to either remove the entire Vehicle Communication Forwarder, or individual CAN channels from it.
Edit Ethernet Channels
Like for CAN channels, the number of available Ethernet channels depends on the platform type of the WCU which is configured. The group of Ethernet channels contains eight columns and the individual meaning is as follows.
Channel
This column indicates which interface or interfaces that exists.
Addressing mode
In this column the Addressing mode is configured. The choices are "DHCP client", "AutoIP" and "Static".
IP address
Here you set the static IP address if you have selected "Static" as the Addressing mode.
Netmask
Here you set the netmask if you have selected "Static" as the Addressing mode.
Default route
Here you set the default route if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. The default route is the route that takes effect when no other route is available for an IP destination address.
Name Server (DNS)
Here you set the Name Server if you have selected "Static" as the Addressing mode. This field only shows if the WCU software version is 2.85.0 or later. Here you set the name of the DNS protocol.
Name
In this column you can set a nickname for this channel. This setting has no effect on the WCU side.
Comment
In the last column you can set a comment for this channel. Like for the name, this setting has no effect on the WCU side.
The Miscellaneous Section
This section is available for WCUs with version 2.49 or later.
Set digital out 3 on boot
Digital out 3 is one of the output pins in the dsub contact on WCUs of model MX4. This setting activates that pin on start-up of the WCU. The purpose of this is to trigger an external measurement equipment (e.g. M-Log or Arcos).
Diagnostic tester priority
For WCUs of version later than or equal to 2.60 it is possible to choose to configure the diagnostic tester priority. If enabled, a value between 1-12 can be selected. The described options are depicted in Figure "Miscellaneous".
Allow ethernet activation on WCU
For WCUs of version 2.90.4 or later it is possible to choose whether or not to allow the WCU to use ethernet activation. Not allowing this might disturb some of the WCUs features.
Set 5V out on boot
Option to set one of the output pins on the WCU to supply electricity at 5V to external equipment when the WCU is starting up. The option is visible for WCUs of model MX4 (except submodel V61) and with version 2.76.0 or later.
Activate buzzer on detected digital input change
Option to enable that the WCU makes a buzzing sound when a trigger-button (or other digital input) is activated on the WCU. It is possible on all MX4 models. The option is visible for WCUs with version 2.76.0 or later.
Diagnostic firewall disable and PIN
Option to disable diagnostic firewall. Requires PIN. Visible for WCUs with version 2.89.0 or later.
Diagnostic tester detection
Option to detect any diagnostic testers that they may not be interrupted, typically during OTA. Available for WCUs with version 2.96.0 or later.
Manage templates
Admins can save configs as templates (see Manage templates (for admins)) and normal users can use these templates to fill all columns with the data stored in the template. Clicking "Apply" will apply the selected template. You can always change settings or add more info, the template could be anything you need or just act as a starting point.
If WMUs are enabled in the portal, a template will save the CANs from each WMU and when a template is selected the WMU CANs are applied 1:1 to each existing WMU in the configuration. If there are no WMUs in the configuration the template's WMU CANs will not be applied, only the WCU's CANs.
Manage templates (for admins)
If you are an admin you have an extra button "Save current config as template" in the Manage configuration templates window. Clicking it to save the current configuration as a template will prompt you for a name. If the name already exists (case insensitive) a confirmation dialog will popup before overwriting.
Additionally, as admin you will be able to remove existing templates, which is done by clicking the red "Remove record" icon to the right of the template name. A confirmation dialog will popup to prevent deletion by mistake.
Show Vehicle Profile
The button "Show vehicle profile" can be used to show, and hide, a panel showing the CAN and ethernet information for the connected car, see Figure "Vehicle Profile". This option is disabled if no car is connected.
Check PINs
Requires version 2.89.0 or later. Pressing Check PINs for a WCU will lookup existing PINs for HIA, HIB, and Diagnostic firewall disable. If available the PINs will be applied to their corresponding fields. If not all PINs are available there will be a pop-up specifying which PINs are unavailable and for which reason: either missing entirely or there exists a PIN for the ECU but for the wrong service area.
For resource groups Check PINs will not apply any found PINs, instead if there are any resources with missing PINs it will specify, like for individual WCUs, which PINs are missing and for which WCUs.
To apply PINs for resource groups see apply uploaded PINs below.
Apply uploaded PINs
Option for resource groups to apply uploaded PINs for HIA, HIB, and Diagnostic firewall disable. Resets back to unchecked after saving the configuration. Visible for WCUs with version 2.89.0 or later.
PINs must first have been be uploaded via either the Upload Vehicle PINs button in the vehicles tab (for multiple vehicles), or by right-clicking a WCU and selecting Upload Vehicle PINs (for a single vehicle). As of 2.94.0 the PINs may also be fetched from PIE via Administration->Resource groups, read more about fetching PINs from PIE here.
Overview
The Mappings for this task window is used to configure the connections between logical communication channels (from a signal reader assignment) and the physical buses used in the system. It displays both CAN and LIN channels and allows you to assign them to specific physical buses (WCU/WMU or VCF).
Left Side – Logical Channels
On the left side of each group, you can see the logical configuration:
- Channel: The CAN or LIN bus identifier (e.g., CAN1, LIN1).
- Speed: The communication speed of the bus (e.g., 500 kbit/s for CAN, 9600 bit/s for LIN).
- Name: The assigned name of the channel.
- #Signals: Number of signals currently mapped to that bus.
- WCU: The drop-down menu where you assign the physical bus.
This area represents the buses defined in the signal reader assignment. These are the logical buses that need to be linked to physical buses.
Right Side – Physical Bus Selection
On the right side, under the WCU column, you select the physical bus.
- The physical bus can belong to a WCU, WMU or a VCF channel.
- Selecting the correct WCU ensures that signals are properly routed to the physical communication hardware.
- The syntax for a physical bus is: BUSIO:Speed:Name (for example: CAN1:500:CAN1).
Automatic Mapping
The system performs auto-mapping automatically when the window is opened or refreshed.
Auto-mapping works as follows:
- Name Matching: The tool first tries to match logical and physical buses based on their names.
- Bus Number Matching: If names don’t match, it attempts to match based on bus numbers.
- Speed Requirement: The mapping only succeeds if the bus speeds are identical.
If a match cannot be made, or if an error occurs, a red triangle appears next to the affected bus.
Error and Warning Indicators
A red triangle will appear in the following cases:
- The bus speed does not match between logical and physical buses.
- The selected physical bus has already been assigned elsewhere. Each physical bus can only be used once in the mapping.
A yellow triangle will appear in the following cases:
- No physical bus is selected
Grouping Option
In the top-right corner, there is an option to choose whether WCUs should be grouped.
When grouping is enabled, the system will automatically match WCUs that have:
- The same number of channels,
- The same I/O numbering, and
- The same communication speed.
When groups are created, an eye icon 👁️ and a number appear next to the group name.
- Clicking the eye icon or the number displays a list of all WCUs included in that group.
- The number indicates how many WCUs are currently part of the group.
This grouping feature helps simplify configuration when working with multiple identical WCUs.
Buttons
At the bottom of the window:
- Save: Confirms and saves all mappings.
- Restore: Resets everything to the auto-mapped state. (Auto-mapping is always performed first when the window opens.)
- Close: Exits the window without saving changes.
Search Tab
The 'Search' tab makes it possible to search for and download result files and log files without first searching for a specific task. The tab is split into three portlets where each portlet can be expanded or minimized to make more space for the other windows.
The portlets are Search, Results and Selected downloads where each one has its own section on this page.
Search
The search portlet is where constraints are added to the search query.
Filename:
Filename can be full filename like "ABC_123.dat" or some regular expression that matches a part of a filename.
Measurement date:
By default to is set to today's date and the time when the page last was refreshed and from is set to (to - 7 days).
WCUs:
This widget allows the user to filter WCUs on various search criteria. The default search criteria is 'WCU ID matches expression .*' which means that we will search on every WCU the current logged in user has access to. If the current user is an admin, we will search for all WCUs in the system. If the current user is a restricted user with access to only 10 WCUs, we will search for only those 10 WCUs.
The currently available WCU attributes to filter on is: WCU ID, Software version, Description and WCU Name
Operators:
Each search criteria has at least two operators; 'matches expression' and 'equals'.
Matches expression:
'Matches expression' means that the inserted value will be treated as a regular expression.
Equals:
'Equals means that the chosen attribute has to exactly match the inserted value.
Is one of:
For the attributes 'WCU ID' and 'WCU Name' there is an additional operator 'is one of'. When choosing this operator, the value text field is replaced by a combined search and drop down list which is populated be either all WCU IDs or WCU Names the currently logged in user has access to. One can use this operator to conveniently filter out a few WCUs where it's a non trivial task to write a regular expression that only matches the wanted wcus.
Advanced filter:
The WCUs widget allows the user build advanced nestled filters which is illustrated in the Figure "Advanced Filter".
In this example we filter "all wcus that matches expression '8' " AND "software version equals '2.43.0' " AND "description matches expression 'T20' or 'T30' ".
Cars:
This widget is very similar to the WCUs widget. Default search criteria is "Plate number matches expression .*" which basically means that we don't put any constraints on cars.
The currently available Car attributes to filter on is: Description, Plate number, Project, Proto number, Series, TSU and VIN.
Labels:
The labels section allows the user to search for result files from tasks matching the selected labels. Labels on tasks means labels that was associated with the resource (WCU or car) when the task was created. Any labels added to the resource after the task was created can not be used here. In other words, no result files for label X will be found if label X was not associated with the resource before an task was started.
File types:
The file types widget decides which file types we want to include in the search result. A file type is included in the result if the file type button in the window is toggled.
The file types 'MDF', 'TEXT' and 'VECTOR' has sub types. When toggling a button with sub types, this will enable/disable all sub types for that file type. If one only want to include a subset of the sub types, one can expand the file type and only choose the wanted sub type. If only a subset of the file sub types are selected, the file type button will be in the disabled state. If all file sub types for a file type is enabled, the file type will change to enabled state. An example can be seen in "Enable file types".
Aggregate results by:
This widget allows the user how the search results will be aggregated. Available choices are 'Day', 'Week'. 'Month' or 'Year', where 'Day' is the default option.
Results
If the search query yielded any results these results are presented as a chart in the Results portlet, an example of which can be seen in the "Search Tab" illustration above.
The X-axis depends on the chosen "Aggregate results by" in the Search portlet and the Y-axis shows the number of result files for each aggregation. The result files types that were found in the query are displayed in the legend below the chart. In the example we can see that we searched for 8 result file types but result contains 5 of them. If one clicks on any result bar in the chart a new window, "Add to download" will popup which can be seen in Figure "Add to Download". This window shows the date for the aggregation, which can be a day, a week, a month or a year, the file type (MDF in this case), the total number of files and the total size of all the files in the aggregation. The window also has a grid that shows if the aggregation consists of subsets of file sub types. In this example we only have the sub type "MDF_WITHOUT_MODULE_NAMES". When clicking the button "Add to download", this aggregation will be added to the "Selected downloads" portlet.
It is also possible to click the label of the X-axis to add all the file types for this date to "Selected downloads". In the same way it's doable to click the legend to add all found results of a particular file type to the "Selected downloads".
Selected downloads
Selected downloads shows the all aggregations added from the Results chart. An example can be seen in Figure "Selected Downloads". The columns shows basically the same information as the "Add to download" window displays before the aggregations are added for download.
Clicking "Download" starts the compilation and the user is notified when the compilation is ready for download. The compilation can take quite some time if the total file size is > 100 mb.
Save, apply and reset search criteria
In the same way as for the 'Tasks' tab and the 'Vehicles' tab, search criteria can be saved as templates. To save the current search criteria as a template, use the middle of the three buttons to the right of the Search and Cancel buttons in the Search portlets. An example of this dialogue can be seen in Figure "Save Current Search Criteria".
The leftmost button applies previously saved criteria and the rightmost buttons resets the search criteria to default.