Alarm

2026-02-10T09:25:38Z

Henrik.Moller:

<includeonly>=== The Alarm Tab===</includeonly>
Alarms assists in keeping track of the health and status of individual WCUs. Alarms are created for individual WCUs if certain conditions are met. Typically these conditions are indicators that suggest that a resource has encountered a problem, or has entered a state that could potentially be problematic or harmful. When an alarm is registered it shows up in the WICE portal under the Administration/Alarms tab. Using the Alarm panel a user can get an overview of any WCUs that requires attention in the form of a list. To further inspect the resource for which the alarm occurred it is possible to base a search in the vehicle- or task tab using a right click option. By default, the alarms from the last 24 hours are kept in the list. The list is updated automatically with new alarms once every 10 minutes. A figure of the alarm panel is on the right. An alarm consists of five components: a '''resource identifier''', a '''time''', a '''message''', a '''severity''' and a '''category'''.
[[File:The alarm panel.png|thumb|A set of alarms in the alarm tab.]]A '''resource identifier''' can basically take any form, it is a string that identifies the source of the alarm. In the case to the right there are three distinct WCU resources with id ''wcu::04-1B-94-00-20-8C'', ''wcu::00-09-D8-02-B7-4A'' and ''wcu::04-1B-94-00-20-76''. The currently existing identifiers in the alarm-tab are ''wcu::'' and ''rg::'', the last of which can be used to search out all alarms for the WCUs currently included in the named resource group.

'''Time''' is simply at what time the alarm was triggered.

A '''message''' is a textual description of what happened. In this case it was because certificates are about to expire. The message looks as follows: 'Certificate expires on 20181019-184056 +02:00'.

'''Severity''' is a way to communicate the urgency of the alarm. Severity is currently divided into two types, ''Error'' and ''Warning''. Error implies that something unexpected has happened which requires attention. Warning implies that a resource has entered a state that could potentially (but not necessarily) be harmful.

'''Category''' is a way to categorize an alarm. This is particularly useful for searching.

The '''remark''' column tells what has happened with the alarm. If it is empty, the alarm has simply been raised. If there are letter present the are either an <big>A</big>, which means acknowledged, or a <big>G</big> which means that the alarm situation has been resolved either as a consequence of the acknowledgement or automatically. An example of where it has automatically been resolved is the case where the SD card in the WCU has reached, let us say, an 85% usage degree and later when data is uploaded the usage degree drops below 80%. By hovering over the remark column you will be presented with the date and user of when an alarm was acknowledged and with a date if it was automatically closed.

At the top is a set of controls to filter alarms based on other criteria than the text in the columns. Here it is possible to restrict the search to a specified time interval by checking the boxes "'''From'''" and "''''To'''". It is also possible to only select one of the two thus searching for all alarms from a certain date or after a date. However, if the "'''To'''"-option is selected this means that the automatic update of alarms is temporarily switched off, which is notified with a warning icon. In addition, you can choose to include closed alarm by checking the box "'''Include closed alarms'''" and/or including acknowledged alarms by checking "'''Include acknowledged alarms'''". It is only when either or both of these check boxes are checked that the remark column is populated.

== Functions ==
There are a few functions in this panel. You can '''update''' an alarm list, '''reload''' the alarm list, '''set''' new alarm interval, '''acknowledge''' an alarm and '''search''' among the alarms in the table.

=== Update alarm list ===
A said earlier, the list is automatically updated every 10 minutes. But if you feel like not waiting, simply press the 'Update alarms' button. This will fetch new alarms from the server.

=== Reload alarm list ===
By pressing 'Reload alarms' button you will clear the current set of alarms and fetch a new set from the last 24 hours. Usually this is not needed but it is here for your convenience. The button needs to be pressed if you use and change the fetch interval.

=== '''Set Alarm Interval''' ===
[[File:AlarmIntervalSetting.png|thumb|Alarm Interval Setting]]
Clicking '''Set Alarm Interval''' opens a new window titled '''Alarm Interval Setting''' in the bottom-left corner. In this window, users can select the desired interval and confirm it by clicking the green button. Clicking the red button resets the alarm interval to the default setting.

When the interval is changed, the '''From''' search range is automatically adjusted to match the selected interval in hours.

=== Acknowledge alarm ===
[[File:Alarm acknowledge.png|thumb|200px|Comment dialog]]
When alarm is 'taken care of' you can acknowledge this by pressing the button 'Acknowledge alarm'. When doing so a dialog pops up providing to opportunity of adding a comment, presented in Figure 'Comment dialog'. If there is no need to comment, simply leave the field empty and save. The alarm is thereafter marked as 'acknowledged' with the remark A and if a comment is added it is also 'commented' with the remark C. To view the existing comments for an acknowledged alarm, or to add new comments, mark it in the table and press the button 'Show comment'. This will result in a panel appearing to the right of the table as can be seen in Figure 'Comment history panel'.

[[File:Alarm comment panel.png|thumb|left|600px|Comment history panel]]
 

The existing comments for the alarm is presented in a list in reversed chronological order along with date and user. To add a new comment press the 'Add new'-button at the bottom of the panel. The panel can be hidden again by either pressing the 'Hide'-button at the bottom of the panel or the 'Hide comment' button at the bottom of the alarm table.

=== Search alarm ===
The alarms are presented in pages with 50 hits in each which are stepped through by the use of the arrow buttons at the bottom of the panel. To narrow down the search result, specify dates using the "'''From'''" and "'''To'''" options above the table and/o by entering search expressions for the resource, message, severity and category columns. When entering a value in one of these columns, it is interpreted as a regular expression and a search is performed. However, to search for alarms for WCUs included in a specified resource group, using the resource identifier ''rg::,'' the full name of the resource group needs to be entered. When the automatic update is run, or if the "'''Update alarms'''"-button is pressed, the new alarms which fit into the currently selected page, with search expression and ordering taken into consideration, is incorporated into the page content. If there exist new alarms which do not fit into the currently selected page an information icon appears on the "'''Update alarms'''"-button. It will disappear either when you choose to press the button, switch page or when the next automatic update is run and there are no new alarms outside the page.

=== Alarm fetch interval ===
At the top is a set of controls to filter alarms based on other criteria than the text in the columns. First out we have the checkbox "'''Use fetch interval'''". Checking this box enables the two items "'''Time unit'''" and "'''Time interval'''". This makes it possible to fetch alarms from more than 24 hours back. Its default setting is conveniently 24 hours. The '''time unit''' says how the number should be interpreted, e.g. changing the '''time unit''' to Days while leaving the '''time interval''' at 24 will mean to fetch alarms from 24 days back. Available '''time units''' are '''hours''', '''days''' and '''months'''. Also, you choose to include closed alarm by checking the box "'''Include closed alarms'''" and/or including acknowledged alarms by checking "'''Include acknowledged alarms'''". It is only when either or both of these check boxes are checked that the remark column is populated.

=== Block alarms ===
Sometimes it might not be relevant to show all existing alarms in the portal. For instance, when an alarm is being handled but is not yet ready to be acknowledged. In such cases it is possible to block a set of alarms which fulfill certain requirements using the red alarm block icon in the right bottom corner of the table, see Figure "Block alarm for WCU". To block alarms for one specific WCU, select it in the grid before pressing this button. The appearing window lists all existing alarm blocks. To create a new blockage, press "Block alarms" and enter the conditions in the appearing dialog, an example of which is presented in Figure "New alarm block".

[[File:Block alarm.png|thumb|400px|Block alarm for WCU]]
[[File:New alarm block.png|thumb|left|150px|New alarm block]]
 

Alarms can be blocked for a specific WCU, selected in the grid, or for all WCUs. If the logged in user is an administrator, the blockage can be put in place for all users or for the current user. If this is not the case, the user options are hidden and alarms can then only be blocked for that user. Additionally, it is possible to select one or several severeties and/or categories to block. If no severity and/or category is selected the alarms of all severities/categories will be blocked. End with naming the alarm block and save it. It will now appear in the list as presented in Fiugre "Block alarm list" and from here it is possible to edit or delete it. Edit the block by either double-clicking the list tile or by pressing the pen icon. To delete it simply press the green alarm button.

[[File:Block alarms list.png|thumb|left|150px|Block alarm list]]
 

== Available alarms ==
Presented below is the set of alarms currently available.

=== Certificate expires ===
This alarm is identified with '''wcu::info::cert::expire''<nowiki/>'. Currently, alarms start to appear from 30 days of certificate expiry date. The alarm is triggered at most once per 24 hours.

=== Certificate not present ===
This alarm is identified with '''wcu::info::cert::not_present''<nowiki/>'. It means there is no certificate at all on the WCU. The alarm is automatically closed when the WCU reports that there is a certificate installed on the WCU. It is triggered at most once per 24 hours.

=== Certificate password missing ===
The alarm is identified with '''wcu::info::cert::password::missing''<nowiki/>'. There is a certificate on the WCU and the private key is encrypted but there is no password supplied to decrypt it with. As soon as correct a password is supplied this alarm will be automatically closed.

=== Certificate unlock failed ===
The alarm is identified with '''wcu::info::cert::unlock::failed''<nowiki/>'. The most common problem to this alarm is that the wrong password has been supplied to decrypt the private key. As soon as correct a password is supplied this alarm will be automatically closed.

=== Sdcard usage ===
The alarm is identified with '''wcu::info::sdcard::use_percent''<nowiki/>'. An alarm is raised, currently, when the usage percentage of the SD card on the WCU is 80% or more. Alarms for this are triggered at most once every 24 hours. If the usage percentage is 95% or more, an alarm can be triggered up to once every 10 minutes. Once the usage percentage drops below 80% alarms are automatically closed.

=== Sdcard missing ===
The alarm is identified with ''<nowiki/>'wcu::info::sdcard::missing'''. This means that the WCU has not been able to detect an SD-card when booting up and this is rather serious and should be investigated.

=== Switch in INT position ===
The alarm is identified with '''wcu::info::start_switch::int''<nowiki/>'. An alarm is raised when the WCU reports that the switch is in the int position. It is automatically closed when the WCU reports that the switch is in position ext.

=== Unexpected powerloss ===
The alarm is identified with ''<nowiki/>'wcu::info::shutdown::reason::powerloss'''. The reason could be that the cable powering the WCU has come loose or that it is not secured firmly enough.

=== Date and time on WCU is incorrect ===
The alarm is identified with ''<nowiki/>'wcu::info::time::wrong'''. This alarm is largely due to a bad clock battery in the WCU, replace it.

File:AlarmIntervalSetting.png

2026-02-10T09:25:20Z

Henrik.Moller:

AlarmIntervalSetting

2025-11-05T07:23:42Z

Henrik.Moller:

New features in v2.96

2025-11-05T07:05:20Z

Henrik.Moller:

New features in v2.96

2025-11-05T07:00:44Z

Henrik.Moller:

This page gives a brief introduction to new features or changes introduced in version 2.96 of the WICE portal.

== DLT Daemon mode and DLT UDS in parallel ==
The portal now supports creating DLT tasks with daemon mode and UDS service 38 enabled at the same time. This requires WCU software version 2.96.0 or later for the selected WCUs. See [[Creating a Task#Diagnostic Log and Trace (DLT)|Creating a Task#Diagnostic Log and Trace (DLT).]]

== DLT Daemon address via vehicle announcement ==
For WCUs configured for software version 2.96.0 it is possible to get the daemon address via vehicle announcement instead of specifying a daemon address when the task is created. See [[Creating a Task#Diagnostic Log and Trace (DLT)|Creating a Task#Diagnostic Log and Trace (DLT).]]

== Set, View, and Apply Default WCU Configurations ==
Starting from version 2.96, users can now set, view, and apply default WCU configurations. Admin permissions are required to access these new functions. Read more about it [[Default WCU Configuration|here]].

== Introduced functionality to shelve a WCU from the Vehicles panel. ==

Default WCU Configuration

2025-11-04T09:52:01Z

Henrik.Moller:

Starting with version 2.96.0, users with administrator permissions can '''set''', '''view''', and '''apply''' a default WCU configuration to any WCU. A default configuration includes both the WCU settings and the module configurations.

== Set Default WCU Configuration ==
[[File:SetandApplyDefaultConfig.png|thumb|Set/Apply default WCU configuration button]]
To access the '''Set''' function, an administrator must open the '''Edit Configuration''' in the '''Vehicle''' panel. In this view, a new button labeled '''Set as Default Configuration''' is available. When clicked, it creates a new default configuration based on that WCU’s platform and version.

The version used for the default configuration is determined by the '''Preferred WCU Software''' column in the '''WCU''' tab within the Edit Configuration. If this column is set to '''NO_CHANGE''', the system will instead use the value from the '''WCU Software Version''' column in the same tab.

== Apply Default WCU Configuration ==
[[File:Defaultconfigurationspanel.png|thumb|Apply Default Configurations Panel]]
To access the '''Apply''' function, an administrator must open '''Edit Configuration''' in the '''Vehicle''' panel. When clicked, a new panel called '''Default Configurations''' will open (see image ''“Default Configurations Panel”'' for reference).

This panel displays all default configuration versions available for the WCU’s platform type. To apply a default configuration, simply click the '''Apply Default Configuration''' button, and the selected configuration will be applied.

There is also a shortcut to apply a default configuration to a WCU. By right-clicking on a WCU, a new option called '''Apply Default Configuration''' will be shown. Selecting this option will take the user directly to the '''Default Configurations''' panel.

The '''Apply Default Configuration''' function also supports applying a configuration to multiple WCUs simultaneously.

== View Default WCU Configuration ==
[[File:ViewDefaultConfigurations.png|thumb|View Default Configurations Panel]]
In the '''Vehicle''' panel, administrator users will now see a new button labeled '''View Default Configurations'''. Clicking it opens the '''Default Configurations''' panel, providing an overview of all existing default configurations.

In this panel, users can view the WCU configuration by clicking the '''“View WCU Configuration”''' button, and the module configuration by clicking the '''“View Modules Configuration”''' button. Configurations viewed from this panel cannot be edited. Users can also remove a default configuration directly from this panel.