Changes

5,481 bytes added ,  15:07, 6 December 2023
m
Text replacement - "Bluetooth" to "Bluetooth®"
Line 1: Line 1:  
==Introduction to Backup Tracker functionality==
 
==Introduction to Backup Tracker functionality==
   
FMB+FMB Backup Tracker is a new feature which allows to transform device's work-mode to work as a backup tracker.<br>
 
FMB+FMB Backup Tracker is a new feature which allows to transform device's work-mode to work as a backup tracker.<br>
 
Each backup tracker's scan cycle lasts up to 60 seconds. If during those 60 seconds the Backup tracker is:
 
Each backup tracker's scan cycle lasts up to 60 seconds. If during those 60 seconds the Backup tracker is:
Line 6: Line 5:  
* Unable to catch at least 15 valid Main tracker packets, an alarm record will be generated with AVL ID 1153. After '''delay timeout (s)''' is reached, device will send that generated record to the server and enable other record generation/sending (Periodic and Eventual record).
 
* Unable to catch at least 15 valid Main tracker packets, an alarm record will be generated with AVL ID 1153. After '''delay timeout (s)''' is reached, device will send that generated record to the server and enable other record generation/sending (Periodic and Eventual record).
    +
==Backup functionality logic==
 +
[[File:Flowchart BackupTracker.jpg|600px]]
 +
 +
Each time the device is starts up or gets reconfigured, it checks if either main or backup tracker modes are enabled on the current configuration.<br>
 +
Both modes have some common initialization procedures:
 +
* Check if '''Sleep Mode''' (ID: 102) is configured to '''Ultra Sleep''' (4). If it is, set '''Sleep Mode''' to '''Disabled''' (0). This means that both tracker modes overwrite configured '''Ultra Sleep''' mode and it‘s impossible to use Ultra Sleep mode with this functionality enabled;
 +
* '''Non stop scanning''' (ID: 1115) is set '''Disable''' (0);
 +
* '''BLE connection control''' (ID: 1112) is set to '''Prohibit''' (0);
 +
* All '''BLE connectionless functionalities''' are set to '''Disabled''' (0).
 +
Then, both modes have some unique initialization procedures (specific to the tracker mode):
 +
Main tracker mode:
 +
* '''Beacon Detection''' (ID: 134) is set to '''Disabled''' (0);
 +
* BLE packet sending gets initialized and works according to flowchart.
 +
Backup tracker mode:
 +
* '''Beacon Detection''' (ID: 134) is set to '''All''' (1);
 +
* All record generation is disabled. This means that if the device is not detecting the main tracker and starts generating records, it can be reconfigured or hard reset, and it will only start generating records again after the next failed scan (aka after next alarm record).
 +
* Record sending is queued up to stop. Device waits for any currently queued up record sending to finish, so there might be a delay for this full record sending stop to occur.
 +
<br>
 +
[[File:Backup feature logic.png|1000px]]<br>
 +
<br>
 +
'''<big>Packet format</big>'''<br>
 +
[[File:Packet format.jpg]]
   −
==Limitations==
+
'''<big>Parameter list</big>'''
Since the feature relies on Bluetooth functionality, all of the existing Bluetooth limitations are applied.
+
{| class="wikitable"
One of such limitations is the fact that FMB devices only store up to 100 BLE devices per scan. This means, that if there are more than 100 BLE devices in the surrounding environment, backup tracker being able to catch main tracker packets in time gets reduced.
+
|+
 +
! rowspan="2" style="width: 150px; background: #003475; color: white;" |'''Parameter ID'''
 +
! rowspan="2" style="width: 150px; background: #003475; color: white;" |'''Name'''
 +
! rowspan="2" style="width: 100px; background: #003475; color: white;" |'''Data Type'''
 +
! colspan="3" style="width: 150px; background: #003475; color: white;" |'''Value range'''
 +
! rowspan="2" style="width: 250px; background: #003475; color: white;" |'''Description'''
 +
|-
 +
! style="width: 75px; background: #003475; color: white;" |Min
 +
! style="width: 75px; background: #003475; color: white;" |Max
 +
! style="width: 75px; background: #003475; color: white;" |Default
 +
|-
 +
!style="text-align: center; vertical-align: center;" |70200
 +
|style="text-align: center; vertical-align: center;" |FMB Tracker mode
 +
|style="text-align: center; vertical-align: center;" |Uint8
 +
|style="text-align: center; vertical-align: center;" |0
 +
|style="text-align: center; vertical-align: center;" |2
 +
|style="text-align: center; vertical-align: center;" |0
 +
|style="text-align: center;" |0 - Disabled; <br> 1 - Main; <br> 2 - Backup.
 +
|-
 +
!style="text-align: center; vertical-align: center;" |70201
 +
|style="text-align: center; vertical-align: center;" |FMB Tracker mode
 +
|style="text-align: center; vertical-align: center;" |String
 +
|style="text-align: center; vertical-align: center;" |-
 +
|style="text-align: center; vertical-align: center;" |15
 +
|style="text-align: center; vertical-align: center;" |-
 +
|style="text-align: center;" |IMEI of the tracker which is configured as a main tracker
 +
|-
 +
!style="text-align: center; vertical-align: center;" |70202
 +
|style="text-align: center; vertical-align: center;" |Update frequency
 +
|style="text-align: center; vertical-align: center;" |Uint16
 +
|style="text-align: center; vertical-align: center;" |60
 +
|style="text-align: center; vertical-align: center;" |65535
 +
|style="text-align: center; vertical-align: center;" |120
 +
|style="text-align: center;" |Frequency, at which backup tracker should start scanning for Main Tracker BLE packets.
 +
|-
 +
!style="text-align: center; vertical-align: center;" |70203
 +
|style="text-align: center; vertical-align: center;" |Delay timeout
 +
|style="text-align: center; vertical-align: center;" |Uint16
 +
|style="text-align: center; vertical-align: center;" |0
 +
|style="text-align: center; vertical-align: center;" |65535
 +
|style="text-align: center; vertical-align: center;" |0
 +
|style="text-align: center;" |Delay, after which backup tracker starts sending records after an alarm occurs
 +
|-
 +
|}
   −
==Parameter ID's==
+
===Firmware compatibility===
 +
To start working with FMB + FMB functionality '''03.27.13.Rev.452''' firmware or newer will be required to be used. You can check what devices are compatible with using this firmware on [https://wiki.teltonika-gps.com/view/Compability_table_for_FMB_%2B_FMB_backup_tracking '''Compability table for FMB + FMB backup tracking'''] page.
    +
===Limitations===
 +
Since the feature relies on Bluetooth® functionality, all of the existing Bluetooth® limitations are applied.
 +
One of such limitations is the fact that FMB devices only store up to 100 BLE devices per scan. This means, that if there are more than 100 BLE devices in the surrounding environment, backup tracker being able to catch main tracker packets in time gets reduced.
    +
==Setup instructions==
 +
'''To ENABLE backup feature on FMBxxx device:'''<br><br>
 +
'''Both devices:'''
 +
* Make sure <code>Ultra Sleep</code> mode → <code>Disabled</code>
 +
[[File:Backup Tracker Ultra Sleep.gif]]
 +
* <code>Bluetooth®</code> → <code>BT Radio</code> set to <code>Enable(visible)</code>
 +
[[File:BT ONN.jpg]]<br><br>
    +
'''Main device:'''
 +
* <code>Bluetooth® 4.0</code> → select <code>Main Tracker</code><br>
 +
[[File:MainTracker.PNG]]<br>
 +
<br>
 +
'''Backup device:'''
 +
* <code>Bluetooth® 4.0</code> → select <code>Backup Tracker</code><br>
 +
* Enter main device IMEI (15 digits)<br>
 +
* Set <b>Update frequency</b> to how frequent you want backup tracker to scan.
 +
* Set <b>Delay timeout</b> to delay sending alarm record. Leave it default (0) if you want to immediately receive alarm record.<br>
 +
[[File:BackupTracker.PNG]]
 +
* Configure your <b>APN</b> and Server settings in <b>GPRS</b> section.<br>
 
==Parsed data==
 
==Parsed data==
 
<br>
 
<br>

Navigation menu