Jump to content

Template:FMX Ver4 Accelerometer Based Features: Difference between revisions

From Teltonika Telematics Wiki
m Protected "Template:FMX Ver4 Accelerometer Based Features" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))
No edit summary
Line 1: Line 1:
Teltonika Telematics
== Unplug Detection ==
Unplug Detection is a feature that notifies when the device is disconnected from its external power source, and again when reconnected. This feature is available for devices that have an internal battery.
 
Unplug detection is useful in all industries and applications where uninterrupted tracking and notifications about unplugging are essential, e.g. to detect tampering with the device or disconnection attempts by a person.
 
The Unplug Detection feature monitors the voltage level of the external power source, e.g. of a car battery to which the tracker is connected. If the voltage level drops below a device-specific value for longer than Unplug Delay, an event is generated and notifications can be sent (SMS, calls). The Speed Threshold parameter helps prevent unwanted unplug events in vehicles with smart alternators.
 
=== Prerequisites and Important Settings ===
* This feature is available for devices that have an internal battery.
* All accelerometer-related features depend on proper device mounting, see “Mounting recommendations” [link].
* To send SMS messages and/or make calls, at least one number must be predefined in the “GSM Predefined Numbers” list (“SMS / Call Settings” menu).
 
=== Basic Operation ===
 
If Unplug detection scenario is enabled, conditions to determine unplug state are checked every second. Initially external power is checked to set device to appropriate unplug state. If external power is less than 5.25 volts, unplugged state is set, on the other hand, if external power is higher than or equal 5.25 volts, plugged state is set. 
 
It is required 1 to 3 seconds to determine the power loss of a device. Consequently, if a device is not being moved any more after few seconds after removing it from the power source, no event will be generated. This can happen, if a device is quickly throwed on the ground after ripping it off.
 
==== Simple mode ====
 
* Unplug detection constantly monitors external power source voltage.
* Unplug scenario changes states from plugged to unplugged, when external power is less than 5.25 volts and  Unplug delay counter reaches its limit.
* Active Unplug event is recorded and SMS notifications are sent.
* Unplug scenario changes states from unplugged to plugged, when external power is higher than or equal 5.25 volts. It resets Unplug delay counter. Plugged event is generated again and  SMS notifications are sent accordingly.
 
==== Advanced mode ====
 
* Unplug detection constantly monitors external power source voltage and accelerometer source for movement changes.
* Unplug scenario changes states from plugged state to unplugged, when unplugged state detected by accelerometer flag is set to true.
* If Speed Threshold is not exceeded,  then unplugged event detected by accelerometer, flag is set to true when external power is less than 5.25 volts and measured accelerometer threshold exceeds 0.31 mg.
Once accelerometer threshold exceeds 0.31 mg it is not going to be measured again until external power will be higher or equal to 5.25 volts.
* Active Unplug event is recorded and SMS notifications are sent.
* Unplug scenario changes states from unplugged state to plugged, when external power is higher than or equal 5.25 volts. Plugged event is recorded and SMS notifications are sent.
 
==== Unplug Status After Reset ====
 
When Unplug Detection Mode is configured as Advanced, Unplug status is saved to flash memory every time when Unplug status is changed. On the first run after soft/hard reset Unplug status is retrieved from flash memory. After configuration change, if previous Unplug Detection Mode was Simple and current alarm sensor ripped off Unplug Detection Mode is Advanced – Unplug status persists from previous mode. This does not work the other way around when configuration changes from Advanced to Simple.
 
==== Unplug Detection with Low Power Mode ====
 
When Unplug Detection is being used together with Low Power Mode (LPM), depending on configured Sleep mode it will or will not send Unplug Detection record, make a call, or send SMS message.
 
In Deep Sleep mode record and SMS will be created but they will not be sent, because entering LPM device immediately enters sleeping mode without checking any of the conditions. Since modem is disabled in Deep Sleep, record and SMS will be sent when device will wake up according to LPM conditions. Call will not be made.
 
In Online Deep Sleep mode record and SMS will be created and sent as well as call will be made since modem is not being turned off. Link will be closed immediately after sending is completed.
 
 
=== Parameters ===
Where applicable, the table also shows AVL ID values that are directly related to a certain parameter (in parentheses). Always double-check the AVL IDs in the page of your device.
 
<table class="nd-othertables_2" style="width:100%; border-collapse: collapse;">
<tr>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER NAME</th>
<th style="width:1%; vertical-align: middle; text-align: center;">PARAMETER ID (RELATED AVL ID)</th>
<th style="width:5%; vertical-align: middle; text-align: center;">DESCRIPTION</th>
<th style="width:6%; vertical-align: middle; text-align: center;">VALUES</th>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Scenario Settings</td>
<td style="vertical-align: middle; text-align: center;">11500 <br> (252)</td>
<td style="vertical-align: middle; text-align: center;">Sets the scenario priority level.</td>
<td style="vertical-align: middle; text-align: left;">
'''0 = Disable''' Disable scenario.<br>
'''1 = Low priority''' Device makes an additional record with indication of event cause. <br>
'''2 = High priority''' Device makes an additional record with high priority flag and immediately sends an event packet to the server by GPRS. <br>
'''3 = Panic priority''' Triggers the same actions as high priority, but if GPRS fails, the device sends an AVL packet via SMS (if enabled in SMS settings).
</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Eventual Records</td>
<td style="vertical-align: middle; text-align: center;">11501</td>
<td style="vertical-align: middle; text-align: center;">Toggle appending scenario status to eventual records.</td>
<td style="vertical-align: middle; text-align: left;">'''0 = Disable''' When enabled, scenario status will be appended only to eventual records.<br>
'''1 = Enable''' When disabled, scenario status will be appended in each AVL record.
</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Detection Mode</td>
<td style="vertical-align: middle; text-align: center;">11502</td>
<td style="vertical-align: middle; text-align: center;">Toggle between simple and advanced unplug detection modes.</td>
<td style="vertical-align: middle; text-align: left;">'''0 = Simple''' Detects unplugging according to change in external voltage. Event created when external voltage drops below minimum operating voltage of this device.<br>
'''1 = Advanced''' Detects unplugging according to changes in external voltage and accelerometer data. Event created when the accelerometer detects movement and external voltage drops below minimum operating voltage of this device.
</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Speed Threshold (km/h)</td>
<td style="vertical-align: middle; text-align: center;">11510</td>
<td style="vertical-align: middle; text-align: center;">Sets the speed over which unplug events are ignored.</td>
<td style="vertical-align: middle; text-align: left;">Minimum value '''= 0'''.<br>
Maximum value '''= 5000'''.
* Condition is disabled, if value is set to '''0'''.</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Unplug Delay (s)</td>
<td style="vertical-align: middle; text-align: center;">11511</td>
<td style="vertical-align: middle; text-align: center;">Sets the value by which to delay an Unplug event. Record is generated only if the unplug event is detected and persists for the delay period. If the unplug state keeps changing during the delay period, the unplug event is ignored.
</td>
<td style="vertical-align: middle; text-align: left;">Minimum value '''= 0'''.<br>
Minimum value '''= 3600'''.
* Condition is disabled, if value is set to '''0'''.<br>
</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Make Call to</td>
<td style="vertical-align: middle; text-align: center;">11503</td>
<td style="vertical-align: middle; text-align: center;">Select the GSM number for the device to make a call upon event.</td>
<td style="vertical-align: middle; text-align: left;">Number selected from “GSM Predefined Numbers” list in menu “SMS / Call Settings”.</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">Send SMS to</td>
<td style="vertical-align: middle; text-align: center;">7036</td>
<td style="vertical-align: middle; text-align: center;">Sets the GSM number of SMS event recipient.</td>
<td style="vertical-align: middle; text-align: left;">Number selected from “GSM Predefined Numbers” list in menu “SMS / Call Settings".</td>
</tr>
<tr>
<td style="vertical-align: middle; text-align: center;">SMS Text</td>
<td style="vertical-align: middle; text-align: center;">8036</td>
<td style="vertical-align: middle; text-align: center;">Sets the SMS text that will be sent to SMS recipient when the event is triggered.</td>
<td style="vertical-align: middle; text-align: left;">Maximum text length '''= 160 symbols'''.</td>
</tr>
</table>
 
=== Limitations, Edge Cases ===
Unplug event may not be generated in Advanced detection mode when GNSS signal quality is poor:
* When the GNSS signal quality is poor, speed values may be incorrectly reported, e.g. non-zero values when the vehicle is actually stationary.
* If, during a real unplug event, this incorrect speed value is higher than the configured Speed Threshold, the unplug event will not be registered.
* In such cases, we recommend setting a higher Speed Threshold value.

Revision as of 11:17, 27 August 2025

Unplug Detection

Unplug Detection is a feature that notifies when the device is disconnected from its external power source, and again when reconnected. This feature is available for devices that have an internal battery.

Unplug detection is useful in all industries and applications where uninterrupted tracking and notifications about unplugging are essential, e.g. to detect tampering with the device or disconnection attempts by a person.

The Unplug Detection feature monitors the voltage level of the external power source, e.g. of a car battery to which the tracker is connected. If the voltage level drops below a device-specific value for longer than Unplug Delay, an event is generated and notifications can be sent (SMS, calls). The Speed Threshold parameter helps prevent unwanted unplug events in vehicles with smart alternators.

Prerequisites and Important Settings

  • This feature is available for devices that have an internal battery.
  • All accelerometer-related features depend on proper device mounting, see “Mounting recommendations” [link].
  • To send SMS messages and/or make calls, at least one number must be predefined in the “GSM Predefined Numbers” list (“SMS / Call Settings” menu).

Basic Operation

If Unplug detection scenario is enabled, conditions to determine unplug state are checked every second. Initially external power is checked to set device to appropriate unplug state. If external power is less than 5.25 volts, unplugged state is set, on the other hand, if external power is higher than or equal 5.25 volts, plugged state is set.

It is required 1 to 3 seconds to determine the power loss of a device. Consequently, if a device is not being moved any more after few seconds after removing it from the power source, no event will be generated. This can happen, if a device is quickly throwed on the ground after ripping it off.

Simple mode

  • Unplug detection constantly monitors external power source voltage.
  • Unplug scenario changes states from plugged to unplugged, when external power is less than 5.25 volts and Unplug delay counter reaches its limit.
  • Active Unplug event is recorded and SMS notifications are sent.
  • Unplug scenario changes states from unplugged to plugged, when external power is higher than or equal 5.25 volts. It resets Unplug delay counter. Plugged event is generated again and SMS notifications are sent accordingly.

Advanced mode

  • Unplug detection constantly monitors external power source voltage and accelerometer source for movement changes.
  • Unplug scenario changes states from plugged state to unplugged, when unplugged state detected by accelerometer flag is set to true.
  • If Speed Threshold is not exceeded, then unplugged event detected by accelerometer, flag is set to true when external power is less than 5.25 volts and measured accelerometer threshold exceeds 0.31 mg.

Once accelerometer threshold exceeds 0.31 mg it is not going to be measured again until external power will be higher or equal to 5.25 volts.

  • Active Unplug event is recorded and SMS notifications are sent.
  • Unplug scenario changes states from unplugged state to plugged, when external power is higher than or equal 5.25 volts. Plugged event is recorded and SMS notifications are sent.

Unplug Status After Reset

When Unplug Detection Mode is configured as Advanced, Unplug status is saved to flash memory every time when Unplug status is changed. On the first run after soft/hard reset Unplug status is retrieved from flash memory. After configuration change, if previous Unplug Detection Mode was Simple and current alarm sensor ripped off Unplug Detection Mode is Advanced – Unplug status persists from previous mode. This does not work the other way around when configuration changes from Advanced to Simple.

Unplug Detection with Low Power Mode

When Unplug Detection is being used together with Low Power Mode (LPM), depending on configured Sleep mode it will or will not send Unplug Detection record, make a call, or send SMS message.

In Deep Sleep mode record and SMS will be created but they will not be sent, because entering LPM device immediately enters sleeping mode without checking any of the conditions. Since modem is disabled in Deep Sleep, record and SMS will be sent when device will wake up according to LPM conditions. Call will not be made.

In Online Deep Sleep mode record and SMS will be created and sent as well as call will be made since modem is not being turned off. Link will be closed immediately after sending is completed.


Parameters

Where applicable, the table also shows AVL ID values that are directly related to a certain parameter (in parentheses). Always double-check the AVL IDs in the page of your device.

PARAMETER NAME PARAMETER ID (RELATED AVL ID) DESCRIPTION VALUES
Scenario Settings 11500
(252)
Sets the scenario priority level.

0 = Disable Disable scenario.
1 = Low priority Device makes an additional record with indication of event cause.
2 = High priority Device makes an additional record with high priority flag and immediately sends an event packet to the server by GPRS.
3 = Panic priority Triggers the same actions as high priority, but if GPRS fails, the device sends an AVL packet via SMS (if enabled in SMS settings).

Eventual Records 11501 Toggle appending scenario status to eventual records. 0 = Disable When enabled, scenario status will be appended only to eventual records.

1 = Enable When disabled, scenario status will be appended in each AVL record.

Detection Mode 11502 Toggle between simple and advanced unplug detection modes. 0 = Simple Detects unplugging according to change in external voltage. Event created when external voltage drops below minimum operating voltage of this device.

1 = Advanced Detects unplugging according to changes in external voltage and accelerometer data. Event created when the accelerometer detects movement and external voltage drops below minimum operating voltage of this device.

Speed Threshold (km/h) 11510 Sets the speed over which unplug events are ignored. Minimum value = 0.

Maximum value = 5000.

  • Condition is disabled, if value is set to 0.
Unplug Delay (s) 11511 Sets the value by which to delay an Unplug event. Record is generated only if the unplug event is detected and persists for the delay period. If the unplug state keeps changing during the delay period, the unplug event is ignored. Minimum value = 0.

Minimum value = 3600.

  • Condition is disabled, if value is set to 0.
Make Call to 11503 Select the GSM number for the device to make a call upon event. Number selected from “GSM Predefined Numbers” list in menu “SMS / Call Settings”.
Send SMS to 7036 Sets the GSM number of SMS event recipient. Number selected from “GSM Predefined Numbers” list in menu “SMS / Call Settings".
SMS Text 8036 Sets the SMS text that will be sent to SMS recipient when the event is triggered. Maximum text length = 160 symbols.

Limitations, Edge Cases

Unplug event may not be generated in Advanced detection mode when GNSS signal quality is poor:

  • When the GNSS signal quality is poor, speed values may be incorrectly reported, e.g. non-zero values when the vehicle is actually stationary.
  • If, during a real unplug event, this incorrect speed value is higher than the configured Speed Threshold, the unplug event will not be registered.
  • In such cases, we recommend setting a higher Speed Threshold value.