Notification Type
Depending on the conditions of triggering, notifications in Wialon are divided into types which you can select when creating the notification.
The measurement system applied to the settings of each notification is the same as the measurement system of the resource to which the notification belongs.
Below are all the possible notification types and the parameters available for them.
Speed
A notification of this type allows monitoring the vehicle speed.
For this purpose, configure the following options:
Option | Description |
---|
Control type | Available options: - Fixed speed limit. The notification is triggered if the speed value is above or below the specified range (the Min and Max fields);
- Road speed limits. The notification is triggered if the speed limits from maps are violated. For this control type, you can specify the number of kilometers per hour by which the limits from maps can be exceeded (the Tolerance on speeding field).
|
Trigger if there is no assigned driver | If this option is enabled, the notification is triggered if the conditions specified for the control type are met, and no driver is assigned to the unit. |
Sensor value | If this option is enabled, there is an additional condition for triggering the notification: a specific sensor value. The option is configured similarly to the notification type of the same name. |
Geofence
Below are the steps to configure a notification of the Geofence type.
- Select when the notification should be triggered:
- when the unit enters the geofence (Inside geofence);
- when the unit leaves the geofence (Outside geofence).
- Select the resource whose geofences should be displayed in the list (select All available to view the geofences of all available resources).
- In the left list, select the geofences or groups of geofences (displayed in square brackets) for which the notification should be triggered. You can use the dynamic filter above the list to search.
- Using the icon , move the items from the left list to the right one.
- In the Advanced options section, if necessary, specify the additional conditions under which the notification should be triggered. It can be the range of speed values (the Speed option), and/or the range or the difference of the selected sensor values (the Sensor value option).
- Select the logical operator on the basis of which the notification should be triggered if several geofences are selected. The OR and AND operators are available.
Logical operators for a unit inside the geofence
Logical operator | Description |
---|
OR | The notification is triggered when the unit enters any of the selected geofences. |
AND | The notification is triggered when the unit is in all the selected geofences at the same time. |
Logical operators for a unit outside the geofence
Logical operator | Description |
---|
OR | The notification is triggered when the unit leaves any of the selected geofences if it previously has been in all of them at the same time. |
AND | The notification is triggered when the unit leaves all the selected geofences.
|
Alarm (SOS)
A notification of this type is triggered when the system receives an alarm message from the unit. For this purpose, the device should support the function of sending such messages or a sensor of the Alarm type should be configured in the unit properties.
A notification of this type is triggered if a digital input of the device is activated or deactivated. To configure the notification, specify the input number on the Activation or Deactivation tab, respectively.
If the message doesn't have the I/O parameter, the io_n parameter is analyzed.
Parameter in a Message
Using this type of notification, you can control sensor parameters in messages. It allows controlling parameters sent by the device and doesn’t include the control of virtual parameters (sats, speed, lat, and so on).
To configure a notification of this type, follow these steps:
In the drop-down list, select the parameter you want to control.
- Select one of the available control types:
- Value range. Allows specifying the minimum and maximum values of the parameter and select the activation type. For this type, follow steps 3 and 4.
- Text mask. Allows controlling text parameters. For this type, specify the text mask in the Mask field using special characters (* and ?).
- Parameter availability. Allows controlling the availability of the selected parameter in messages.
- Parameter lack. Allows controlling the lack of the selected parameter in messages. For the notification to be activated when the parameter appears or disappears from messages, select the Only when state changed option in the Generate notification parameter.
- Specify the minimum and maximum values of the parameter. If you want the notification to be activated when the value is not equal to 0, specify 0 in both fields and select the Out of range activation type.
- Select the activation type:
- In range. The notification is triggered when receiving values which fall in the specified range, including the values specified as minimum and maximum ones.
- Out of range. The notification is triggered when receiving values which don’t fall in the specified range.
Sensor Value
For a notification of this type, two control methods are available:
- Value range. Allows specifying a range of sensor values to control whether the received values fall in it or not.
- Value change. Allows specifying one value to control whether the received values exceed it or not.
For the Value range method, follow these steps:
- In the drop-down list, select the sensor type and/or in the Sensor name field, specify the name mask using special characters (* and ?).
- In the Similar sensors drop-down list, select one of the available options:
- Sum up values. The values of all sensors of the selected type and/or sensors with the same name mask are summed up. Thus, the sum of all values is taken into account before the notification is activated.
- Calculate separately. The values of all sensors of the selected type and/or sensors with the same specified name mask are controlled separately.
- Specify the minimum and maximum values of the sensor.
- Select the activation type:
- In range. The notification is activated when receiving values which fall in the specified range, including the values specified as minimum and maximum ones.
- Out of range. The notification is activated when receiving values which don’t fall in the specified range.
For the Value change method, open the same-name tab on the right and follow steps 1 and 2 from the instruction above. In the Delta field, specify a difference when exceeding which the notification should be triggered. The sensor values can be increased or decreased because the specified delta is compared with the module (for example, |12 − 10| = 2 and |10 − 12| = 2).
Connection Loss
To configure a notification of this type, follow the steps below:
- Select when the notification should be triggered: when the connection is lost or restored. You can select both options.
Select in what way the connection loss should be detected:
Control type | Description |
---|
No coordinates | If this option is selected, the connection loss refers to the absence of coordinates in the unit messages or the absence of the messages themselves. It may happen that messages with sensor data are sent but they don't contain data on the unit location (for example, if the GPS antenna is closed). |
No data | If this option is selected, the connection loss refers to the absense of any messages from the unit. |
- In the Time interval field, specify how long the connection loss should last in order for the notification to be triggered. The maximum allowed value is 999,999,999 minutes.
- If necessary, specify if the unit should be inside or outside a certain geofence as an additional condition for triggering the notification. To configure the Geofences option, follow steps 1–4 from the guide on configuring the notification of the same name.
Off Time
A notification of this type is used to monitor vehicle off time.
In the Max allowed off time field, you should specify for how long a vehicle can be parked; and in the Speed, no more than field, you should indicate what speed shouldn't be exceeded during off time.
To avoid situations where the notification is triggered because of the device inaccuracy, it is advisable to specify a speed value of more than 0 km/h, for example, 1–5 km/h.
If the Sensor value option is activated, the notification is triggered only if all the specified conditions are met: off time duration, speed, and the sensor value. For example, you can receive notifications when the unit is parked with the engine or attachments running. This option is configured in the same way as the notification type of the same name.
Also, whether the unit is inside or outside a certain geofence can be an additional condition for triggering the notification. For this purpose, enable the Geofence option and configure the settings described in steps 1–4 in the same-name notification type.
SMS
A notification of this type informs the receiver of getting an SMS message. An asterisc (*) is specified in the SMS text field by default, which means that the notification works for any SMS message. You can specify a mask of a message text so that the notification is triggered only if an SMS message contains the specified text. This may be useful, for example, if the device sends an SMS message with a certain content in case of malfunction.
Interposition of Units
Using notifications of this type, you can monitor whether the units are approaching or moving away from one another.
To configure a notification, follow the steps below.
- Select when you want to receive the notification: when the unit is moving away from another unit or approching it.
- Move the units you want to monitor to the right part of the window. To find the required unit, use the dynamic filter above the list.
In the Radius field, specify the distance between the units upon the reduction or increase in which the notification should be triggered.
- If necessary, set additional conditions for the notification: unit speed and sensor value. The latter option is configured in the same way as the notification type of the same name.
- In the Logic operator section, select how the specified conditions should be applied in case several units are selected. If the OR option is enabled, the notification is triggered when the unit approaches or moves away from any of the selected units. If the AND option is enabled, the notification is triggered when the unit approaches or moves away from all the selected units simultaneously.
Address
This notification is triggered if the unit is within a certain place or outside it. For configuration, follow the steps below.
- Select when the notification should be triggered: when the unit is at the specified address (Inside) or in any other place (Outside).
- Start typing the address in the Address field (city, street, house number, etc.) and select the suitable option from the list.
- Specify the radius of this point in the Radius field.
- If necessary, specify an additional condition: speed and/or sensor value.
Excess of Messages
Using notifications of this type, you can control the number of messages received from the unit during a certain time interval. These can be regular messages with data (coordinates, sensor values, etc.) or SMS messages.
To configure a notification, follow the steps below.
- Select the type of messages: data messages or SMS messages.
- In the Reset counter each field, specify the time interval for which you want to set a limit on messages.
- In the Limit of messsages field, specify the number of messages after exceeding which the notification should be triggered.
In the example from the image above, the notification is triggered if 3 or more SMS messages are received from the unit within 24 hours.
Fuel Filling
A notification of this type allows you to monitor fuel fillings.
In the Sensor masks option, you can specify one or several masks of the sensors that should be used for detecting fuel fillings and their volume.
If the Ignore recalculated data option is enabled, the notification is received only once after a filling is detected.
If the Geofence option is enabled, it is an additional trigger condition whether the unit is inside or outside a certain geofence during the filling. To configure the option, follow steps 1–4 from the guide to the same-name notification type.
Fuel Theft
A notification of this type allows you to monitor fuel thefts.
In the Sensor masks option, you can specify one or several masks of the sensors that should be used for detecting fuel thefts and their volume.
If the Ignore recalculated data option is enabled, the notification is received only once after a theft is detected.
If the Geofence option is enabled, it is an additional trigger condition whether the unit is inside or outside a certain geofence during the theft. To configure the option, follow steps 1–4 from the guide to the same-name notification type.
Route Progress
Notifications of this type are used to monitor the unit movement along the route. You can receive notifications related to the following route changes:
- Ride status (started, finished and aborted);
- Activity at check points (arriving, departing and skipping a check point);
- Schedule control (delay, outrunning, and return to the schedule).
Additionally, you can specify the name mask of the route, schedule and/or ride.
Driver
Notifications of this type allow you to monitor when drivers are assigned to the units or separated from them.
The Driver code field is available only for notifications about assignments. Here you can specify the driver code or its mask to receive notifications when this driver is assigned to a unit. If an asterisk (*) is specified in this field, the notification is applied to all the drivers.
A notification about separation is triggered if any driver is separated from a unit.
Trailer
Notifications of this type allow you to monitor when trailers are assigned to the unit or separated from it. You can configure them in the same way as notifications of the Driver type.
Passenger Activity
Notifications of this type allow you to monitor passengers are assigned to the unit (get on) and separated from it (get off).
If you want to be notified of a particular passenger getting on or off the vehicle, specify his or her code in the Passenger code field. You can enter several codes or code masks separated by commas without spaces in this field. If an asterisk (*) is specified in this field, the notification is applied to all the passengers.
Passenger Alarm
A notification of this type is triggered if any passenger of the seleted resource hasn't got off the vehicle (that is, hasn't been separated from the unit) within the specified timeout. The timeout is counted from the moment the passenger is assigned to the unit.
Maintenance
Notifications of this type are used for the services created on the Service intervals tab of the unit properties.
To configure a maintenance notification, follow these steps:
- Select when you want to receive notifications: before or after the service term (the Service term approach and Service term expiry buttons, respectively).
- In the Service intervals field, specify the name of the service for which you want to configure the notification. To specify several names, use the name mask. If the symbol * is specified in the field, the notification is applied to all created intervals.
- To be notified of the service term approach, specify how many kilometres, hours, and/or days should be left before the beginning of the service term so that the notification is triggered. To be notified of the service term expiry, specify how many kilometres, hours, and/or days should pass after the expiration of the service so that the notification is triggered.
The maintenance notification is triggered only once when at least one of the conditions specified in step 3 is fulfilled. After performing maintenance work, register it using the event registrar or in the unit properties so that the notification term is counted again.
Notifications of this type are not triggered if:
- a unit with an already expired service interval is selected when creating a notification;
- the unit for which the notification is created doesn't have any positional messages.