View source for TAT140 Tracking settings

__TOC__

==Tracking Scenarios==

{| class="main-table" style="background: #E7F1FE; color: black;"
{| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]] 
|| '''Please note:'''<br> 
* Device has up to 3 min. hardcoded time to get fixed position while it i's awake from a Sleep Mode. <br>
* If GNSS signal is poor - device will need more time to get fixed position. Battery usage is higher while device is looking for GNSS positions than when it stays in Sleep Mode. <br>
* If less than 3 satellites are visible in the first 60 seconds, satellite search is terminated early. 
|}


<b>Periodic:</b>
{| style="width: 100%;"

|[[File:TAT140TRACKINGPNG.png|border|class=tlt-border|right]]
{| class="main-table" style="background: #E7F1FE; color: black;"
{| style="width: 700px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]] 
|| '''Please note:'''<br> 
It means that device will <b>wake up from Sleep Mode</b> periodically and send data of asset location information after fix is obtained. Data could be sent according to I/O parameters in I/O section.
|}

<br>
<b>Record timestamp shift:</b> When disabled, the timestamp in records will not be modified and the timestamp will be in UNIX time (UTC +00), although functionality won’t be affected. <b>Time Zone:</b> Set tracking scenario time zone. Time zone can be set in range of -12h to +14h.<br>
<b>On Stop detection time (s)</b> configurable amount of time until device switches to On Stop periodic tracking. Device needs to be stationary for configured amount of time to change state. Movement interrupts will reset this timer.<br>
<b>On Move detection time (s)</b> configurable amount of time until device switches to On Move periodic tracking. Instant movement will not change tracking scenario to On Move. Device needs to be interrupted <b>at least once every 5 seconds</b> during the configured time to change tracking scenario to On Move.<br>
<br>
<b>Periodic Tracking Options:</b><br><br>
<b>On Stop scenario</b><br>
<b>On Stop periodic tracking</b> - enable or disable periodic data sending when device is On Stop. Device will generate and send normal record with event ID 0 and movement AVL ID 240 with a value of 0.<br>
<b>On Stop event record</b> - enable or disable record sending when device switches tracking scenario from On Move to On Stop. To trigger this event <b>On Stop detection time</b> (see Record timestamp shift) timer needs to reach set value. Once event is triggered GNSS module will wake up and obtain GNSS fix. Record will have AVL event 240 with a value of 4 that means "Movement event - On Stop".<br>
<b>On Stop</b> time period between records when device is working in On Stop scenario.<br>
<br>
<b>On Move scenario</b><br>
<b>On Move periodic tracking</b> enable or disable periodic data sending when device is On Move. Device will generate and send normal record with event ID 0 and movement AVL ID 240 with a value of 1.<br>
<b>On Move event record</b> enable or disable record sending when device switches tracking scenario from On Stop to On Move. To trigger this event <b>On Move detection time</b> (see Record timestamp shift) timer needs to reach set value. Once event is triggered device will wake up and will trigger one of two records:<br>
 1 - if last record did not have a GNSS fix, GNSS module will be turned on and fix obtained.<br>
 2 - if last record had a valid GNSS fix, GNSS module will not be turned on and record will contain last good coordinates.<br>
Record will have AVL event 240 with a value of 5 that means "Movement event - On Move" in both cases.<br>
<b>On Moving (s)</b> time period between records when device is working in On Move scenario.<br>





<b>Detailed example of default Periodic settings:</b> <br><br>
1. Device wakes up after 28800 seconds if no movement is detected for 20 seconds, see step 2. If movement is detected during this period, see step 5<br>
2. Device is looking for GPS Fix (can take up to 3 min., depends on the environment)<br>
3. Device saves record to memory and tries to send it via GPRS (can take up to 2 min., depends on the environment)<br>
4. Device goes to sleep for 28800 s.<br>
5. If movement is detected for 20 seconds device switches to On Move scenario.<br>
 5.1 If <b>On Move event record</b> is <b>Disabled</b> device does not generate a new record and starts On Move scenario timer.<br>
 5.2 If <b>On Move event record</b> is <b>Enabled</b> and valid fix <b>is present</b>, device sends last known good position.<br>
 5.3 If <b>On Move event record</b> is <b>Enabled</b> and valid fix is <b>not present</b>, device will wake up, obtain and send new position (GPS fix - up to 3 minutes, record saved, sent via GPRS - up to 2 minutes)<br>
6. Device wakes up after 28800 seconds if device was not stationary for 600 seconds, see step 7. If device was stationary for 600 seconds, see step 10<br>
7. Device is looking for GPS Fix (can take up to 3 min., depends on the environment)<br>
8. Device saves record to memory and tries to send it via GPRS (can take up to 2 min., depends on the environment)<br>
9. Device goes to sleep for 28800 seconds.<br> 
10. If device was stationary for 600 seconds during On Move scenario device switches to On Stop scenario.<br>
 10.1 If <b>On Stop event record</b> is <b>Disabled</b> device does not generate a new record and starts On Stop scenario timer.<br>
 10.2 If <b>On Stop event record</b> is <b>Enabled</b> device will wake up, obtain and send new position (GPS fix - up to 3 minutes, record saved, sent via GPRS - up to 2 minutes)<br>
11. Device goes to sleep for 28800 seconds, see step 1.<br>

|}
{| class="main-table" style="background: #E7F1FE; color: black;"
{| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]] 
|| '''Please note:'''<br> If On Move tracking period is configured to be greater than On Stop, when devices detects movement, On Move countdown will start.
|}


<b>Scheduler:</b>
{| style="width: 100%;"
[[File:Selecting days.gif|border|class=tlt-border|right]]
This mode is used to set up the actual schedule of data sending. Every day of the week data could be sent up to 6 times.<br><br>
<b>The main rules of making Schedule:</b>

*Time from 1st to 6th record must be set in ascending order.
*Intervals between different times must be at least 6 minutes.
*Days of the week must be selected by clicking on it.<br>
{| class="main-table" style="background: #E7F1FE; color: black;"
{| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #0054A6; border-bottom: 1px solid #0054A6; border-left: 1px solid #0054A6;border-top: 1px solid #0054A6;border-right: 1px solid #0054A6;background: #E7F1FE; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Note_icon.png|30 px|link=]] 
|| '''Please note:'''<br> The record will not be generated at configured specific time, but will be generated up to a few minutes later because of time needed to boot modem and to get position.
|}


|}

==Recovery mode==
{| style="width: 100%;"

<br>'''Recovery mode''' is a special functionality that stops all ongoing tracking modes, Bluetooth® scans, scenarios and sends records periodically with a configured '''Recovery period'''. However, it does not change options like Location and GNSS sources or Static navigation option. This mode is turned on by a configured number of events and can be turned on/off manually with a GPRS or SMS command. Once turned off, device will come back to a normal scenario that was configured before.<br>

<br>'''Recovery mode can be triggered by:'''<br>

* '''Lost BLE sensor''' - for this trigger to work, Lost Sensor Alarm has to be enabled. When the sensor is not found, Recovery mode will turn on and a lost sensor alarm record will be sent.  <br>
* '''Lost BLE beacon''' - when TAT does not detect any beacons, it will start delayed Recovery mode - TAT will wake up to send a Lost BLE Beacon alarm record (AVL ID 20014) and then start Recovery mode timer to send Recovery alarm records (AVL ID 20012).<br>
* '''Backup tracker''' - when TAT does not detect the central device, it will start delayed Recovery mode - TAT will wake up to send a Backup tracker alarm record (AVL ID 236) and then start Recovery mode timer to send Recovery alarm records (AVL ID 20012) periodically.<br>
* '''SMS/GPRS command''' - <code>&nbsp;  recovery:1</code> command can be sent to turn '''on''' Recovery mode. If Recovery mode is already activated, sending 1 won’t have any effect.<br>
&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;<code>&nbsp;  recovery:0</code> command can be sent to turn '''off''' Recovery mode.<br>
* '''Tamper''' - currently, Recovery Mode cannot be triggered with tamper detection. This feature is still under development.

<br>&nbsp; &nbsp; &nbsp;&nbsp;'''Note : ''' Recovery mode will not turn off automatically. It can only be turned off by restarting the device using the switch or sending SMS/GPRS command which was earlier mentioned.<br>

[[File:Recovery mode.png|border|class=tlt-border|right]]
<br>'''Recovery mode configuration settings:'''
* <code>None</code> - no events will trigger Recovery Mode and it can only be controlled with commands manually.<br>
* <code>Period</code> - by default, Recovery mode period is 180 seconds and can be configured to a minimum of 30 seconds. When the period is less than 180 seconds, modem will be always kept on and fix will not be caught repeatedly. This means that the modem will always try to update the coordinate if possible.<br>
* <code>Turn off</code> - if recovery mode is activated it can be turned off in Teltonika configurator by clicking on a button. <br>
<br>

<table id="important" style="
  border-collapse: collapse;
  width: 100%;">
  <tr>
    <th style=" border: 1px solid #ddd; padding: 8px; padding-top: 12px; padding-bottom: 12px; text-align: left; background-color: #0054A6; color: white; ">Important!</th>
  <tr>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">The device will turn on/off the Recovery mode depending upon when the command was received:
<br> 1. If Recovery mode was turned on '''during sleep''', Recovery mode will turn on when modem wakes up and the record will be sent with AVL ID 20012.
<br> 2. If Recovery mode was turned on '''before record sending''', Recovery mode will turn on immediately and the record will be sent with AVL ID 20012.
<br> 3. If Recovery mode was turned on '''after record sending''', Recovery mode will turn on immediately and the next record will be sent with AVL ID 20012.
<br> 4. If Recovery mode was turned off '''during sleep''', Recovery mode will be turned off and last record with AVL ID 20012 will be send. After that, device goes back to normal periodic record sending.
<br> 5. If Recovery mode was turned off '''before record sending''', a record will be sent with AVL ID 20012, Recovery mode will be turned off and on the next wakeup a normal periodic record will be sent.
<br> 6. If Recovery mode was turned off '''after record sending''', Recovery mode will be turned off and on the next wakeup a normal periodic record will be sent. If the Recovery period was less than 180 seconds then modem will be shut down (it will not remain turned on as mentioned).
 </td> 
 </tr>
</table>

<br><u>'''SMS event'''</u>

There is a new configurable IO element for Recovery mode status notifications via SMS. It can be found at the bottom of IO table:
[[File:Recovery-sms.PNG|center]]
It has three operands that can be configured to get an SMS about the Recovery mode status. Here is a table that descibes the configurations and the desired result:
<table id="Operand" style="
  border-collapse: collapse;
  width: 100%;">
  <tr>
    <th style=" border: 1px solid #ddd; padding: 8px; padding-top: 12px; padding-bottom: 12px; text-align: left; background-color: #0054A6; color: white; ">Operand</th>
    <th style=" border: 1px solid #ddd; padding: 8px; padding-top: 12px; padding-bottom: 12px; text-align: left; background-color: #0054A6; color: white; ">Low/High level</th>
    <th style=" border: 1px solid #ddd; padding: 8px; padding-top: 12px; padding-bottom: 12px; text-align: left; background-color: #0054A6; color: white; ">Result</th>
  </tr>
  <tr>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">On Exit</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">1/1</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">SMS notification will be send only when Recovery mode is turned off</td>
  </tr>
  <tr>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">On Entrance</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">1/1</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">SMS notification will be send only when Recovery mode is turned on</td>
  </tr>
   <tr>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">On Change</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">ANY/ANY</td>
    <td style=" border: 1px solid #ddd; padding: 8px; background-color: #f1f2f5;">SMS notification will be send every time when Recovery mode is turned on/off</td>
  </tr>
</table>
<br>'''Note''', that in order for notifications to work, Priority has to be either _Low_ or _High_ and a telephone number has to be specified.

'''Received SMS will contain:'''
#Date and Time
#Last known coordinates (longitude and latitude)
#Recovery mode Val:<(0 if turned off, 1 if turned on)>

===Precautions===

{| style="width: 800px;height: 60px; text-align: left; border: 1 px solid #FFCC33; border-bottom: 1px solid #FFCC33; border-left: 1px solid #FFCC33;border-top: 1px solid #FFCC33;border-right: 1px solid #FFCC33;background: #FEF6E7; color: black; text-align: left; padding: 10px;"
| style="width: 40px;height: 20px;padding: 10px;" | [[File:Warning.png|30px|link=]]
||<b>CAUTION! Device usage with USB cable.</b> <br> In order to prevent device battery from running out of power, make sure USB cable is not connected, while testing the device.<br>Continuous use of device, while connected to the USB cable will result in faster battery drain.
|}

[[Category:TAT140 Configuration]]