In the Alarm rules module, an administrator can configure rules for an alarm. The alarms are triggered when specified events occur based on the alarm rules configured. This helps assess driver behavior and monitor the vehicle status.
Based on the alarm rules configuration, a dispatcher can add an alarm to a specific site to monitor the activities of drivers. The dispatcher receives a notification when an alarm in a geozone is triggered.
Add Alarm Rule #
You can add alarm rules on the SCALAR platform and assign assets. Alarms are triggered based on the alarm rules configured for different events, such as fuel drop, harsh braking, and driving without a tacho card.
This functionality is subject to user permissions. Only an administrator can access the Admin module.
- In the Admin module > click Alarm rules . The Alarm rules page is displayed.
- Click Add alarm rule. The Add an alarm rule by using one of the templates below dialog containing the following tabs is displayed: Alarm rules and Automations.
For more information, see Configuring fixed alarm rules and Configuring organization-specific alarm rules.
Configuring fixed alarm rules #
Alarm rules are standardized templates provided to the customer organizations by default where the user can specify the alarm level, enter the threshold value to trigger an alarm, and assign assets.
- From the Add an alarm rule by using one of the templates below dialog > go to the Alarm rules tab.
- From the templates provided, select the option corresponding to the required event. The Add alarm rule page is displayed.
NOTE:In this example, the event selected is ‘Engine’, which is auto-filled.
- In the General section, in the Alarm name box, enter a name for the alarm rule.
- In the Value section, specify the value for the alarm rule to be triggered (the alarm is triggered when it breaches—exceeds or falls beyond the threshold limit). For more information, see Specify Values for Sending Alarms.
NOTE:The Value field is not applicable for the following events: Driving without ISO cable, Driving without tacho card, and RSS (Roll Stability Support) activation.
- To indicate the alarm severity, in the Alarm level section, select the required tab: Information, Warning, or Critical.
- In the Assign assets section, select the required tab: None, All, By name, or By Property, and then click Save. The alarm rule is saved. For more information on how to assign assets and teams for alarm rule application, see Assign Assets to an Alarm by name and Assign Assets to an Alarm by Property.
Specify Values for Sending Alarms #
Template for event | Action |
Driving without ISO cable | The value field is not applicable for this event. |
Driving without tacho card | The value field is not applicable for this event. |
Engine | Select the On or Off checkbox to specify whether an alarm is to be triggered when the engine is turned on or off. Set the time to trigger the alarm, for example, ‘00h:05m:00s’. |
Fuel drop | Enter the percentage decrease in fuel of an asset that when reached, triggers an alarm, for example, 20%. |
Fuel increase | Enter the percentage increase in fuel of an asset that when reached, triggers an alarm, for example, 20%. |
Harsh acceleration | Enter the value to specify the acceleration rate that when reached, triggers an alarm, for example, 4.5 m/s². |
Harsh braking | Enter the value to specify the deceleration rate that when reached, triggers an alarm, for example, 3 m/s². |
Idling | Enter the value to specify when idling time exceeds the threshold limit to trigger an alarm, for example, 00h:05m. NOTE: Idling refers to a scenario where a driver leaves the engine running when the vehicle is not in motion. |
Ignition | Select the On or Off checkbox to specify whether an alarm is to be triggered when the ignition is turned on or off Set the time to trigger an alarm, for example, 00h:05m:00s. |
Maximum RPM (Revolutions per minute) | Enter the value to specify when the RPM exceeds the threshold limit to trigger an alarm, for example, 1700 RPM. |
Maximum speed | Enter the value to specify when the maximum speed in km per hour exceeds the threshold limit to trigger an alarm, for example, 90 km/h. |
RSS (Roll Stability Support) activation | The value field is not applicable for this event. |
Assign Assets to an Alarm by name #
- On the Add alarm rule page, in the Assign assets section, click the By name tab. The section that shows the number of assets assigned is displayed.
- Click Max.100 assets. The Add assets page is displayed.
- From the <number> assets available pane, click Add next to the assets to be assigned. The assets added are listed on the right pane and assigned to the alarm.
- Click Done. The selected assets are added and you are redirected to the Add alarm rule page.
To unassign an asset, from the right pane, click Remove next to the asset name. To unassign all the assets, click Remove all.
Assign Assets to an Alarm by Property #
- On the Add alarm rule page, in the Assign assets section, click the By property tab. The section to assign alarm rules on the basis of assets and teams is displayed.
- Next to the Asset type list, from the Select asset types list, select the asset type.
NOTE:
Click the Asset type list to assign an alarm rule to a team. You can assign more than one asset type.
- Click Add another property to assign assets by teams. The Teams list is displayed.
- Next to the Teams list, from the Select teams list, select the teams.
NOTE:You can assign more than one team.
- Click Save. The selected assets and teams are assigned.
Configuring organization-specific alarm rules #
- From the Add an alarm rule by using one of the templates below dialog > go to the Automations tab. The templates available for configuring organization-specific alarm rules are displayed as cards.
- Select the card corresponding to the required event: in this example, the DC Overspeed with Axle dialog is selected. The Automation setup page is displayed.
- In the General section, in the Automation name box, enter a name for the automation rule.
- In the Definition details section, specify the inputs, variables, and output.
TIP:Read the definition description provided while setting the input values for the variables.
Inputs
- In the Inputs section, click next to Axle load to expand the section.
- Click Axle load threshold to go to the Variables section.
- Click next to Speed to expand the section.
- Click Speed threshold to go to the Variables section.
Variables
- Click to expand the section, and then set the value for the axle load threshold. The alarm is triggered when it breaches—exceeds or falls beyond the threshold limit
- Click to expand the section, and then set the value for the speed threshold. The alarm is triggered when it breaches—exceeds or falls beyond the threshold limit
Outputs
Click to expand the output section and enter the following alarm details.
- Alarm title
- Alarm level
- Alarm icon
5. In the Assign assets section, assign assets for which this automation rule will be applied. For more information, see Assign Assets to an Alarm by name and Assign Assets to an Alarm by Property.
6. Click Activate. The alarm rule based on the automation workflow defined is activated.
Edit Alarm Rule #
- To edit an alarm rule record, on the Alarm rules page, select the required alarm rule from the list. The alarm rule information page is displayed.
- Modify information in the required sections:
For fixed alarms: General, Value, Alarm level, and Assign assets. For more information, see Add Alarm Rule.
For alarms configured by using automation rules: Inputs, Variables, Outputs, and Assign assets. - Click Save. The modified information is saved.
View Alarm Rules List #
In the Admin module > click Alarm rules . The Alarm rules window is displayed.
Click Sort in the column headers to sort records in ascending or descending order.
Available fields
Column name | Description |
Alarm name | Name of the alarm rule |
Event | Specifies the event in which the alarm will be triggered, for example, harsh braking, fuel drop, and driving without tacho card |
Category | Alarm type, such as Alarm rule and Automation. |
Alarm level | Alarm severity level: Information, Warning, or Critical that denotes the following: Information: Activity of an asset, such as entering or leaving a siteWarning: Driving behavior of the driver, such as harsh acceleration and harsh breakCritical: Safety-related information about the driver or asset. |
Status | Active or Inactive. |
Filter Alarm Rules #
You can filter alarm rules to narrow search results based on the alarm level, category, and status on the Alarm rules page by using the Filters option.
- To open the filter pane, on the Alarm rules page > click Filters . The Filter pane is displayed.
- In the Alarm level, Category, and Status sections, select the required options. The alarm rule records that fulfil the criteria are listed.
- To clear the applied filters, in the Filters pane, click the Reset all link.
- The numeric value displayed on the Filters button is a counter that indicates the number of filter criteria selected. For example, in this example, two filter criteria are applied .
Search an Alarm Rule #
You can search an alarm rule on the Alarm rulespage by using the Search feature.
In the Search box, enter the alarm rule name. The records matching the search criteria are listed.
Enter at least three characters to start a search operation.
Remove an Alarm Rule #
You can remove an alarm rule if it is no longer required.
- In the Admin module > click Alarm rules . The Alarm rules page is displayed.
- Click the required alarm rule record. The alarm rule information page is displayed.
- Click the Remove link. The Remove alarm rule dialog is displayed.
- Click Remove. The alarm rule is permanently removed from the SCALAR platform.