Difference between revisions of "FMB+FMB Backup Tracker"

From Wiki Knowledge Base | Teltonika GPS
m (Text replacement - "Bluetooth" to "Bluetooth®")
(Created page with "Backup Tracker information here")
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Introduction to Backup Tracker functionality==
+
Backup Tracker information here
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:
 
* Able to catch 15 valid Main tracker packets, the scan will stop and the device will wait for next cycle to start.
 
* 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]]
 
 
 
'''<big>Parameter list</big>'''
 
{| class="wikitable"
 
|+
 
! 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
 
|-
 
|}
 
 
 
===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==
 
<br>
 
<code>000000000000004A8E010000016B412CEE0001000000000000000000000000000000 '''0481''' 0005000100010100010011001D00010010015E2C880002000B00000000</code><br><code>3544C87A000E000000001DD7E06A00000100002994</code> <br>
 
{| class="nd-othertables_2" style="width:100%;"
 
|+
 
! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |AVL Data Packet
 
|-
 
! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |AVL Data Packet Part
 
! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part
 
|-
 
| rowspan="4" style="vertical-align: middle; text-align: center;" |
 
| style="vertical-align: middle; text-align: center;" |Zero Bytes
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Data Field Length
 
| style="vertical-align: middle; text-align: center;" |00 00 00 4A
 
|-
 
| style="vertical-align: middle; text-align: center;" |Codec ID
 
| style="vertical-align: middle; text-align: center;" |8E
 
|-
 
| style="vertical-align: middle; text-align: center;" |Number of Data 1 (Records)
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
| rowspan="25" style="vertical-align: middle; text-align: center;" |AVL Data
 
| style="vertical-align: middle; text-align: center;" |Timestamp
 
| style="vertical-align: middle; text-align: center;" |00 00 01 6B 41 2C EE 00 (GMT: Monday, June 10, 2019 11:36:32 AM)
 
|-
 
| style="vertical-align: middle; text-align: center;" |Priority
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
| style="vertical-align: middle; text-align: center;" |Longitude
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Latitude
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Altitude
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Angle
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Satellites
 
| style="vertical-align: middle; text-align: center;" |00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Speed
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| style="vertical-align: middle; text-align: center;" |Event IO ID
 
| style="vertical-align: middle; text-align: center;" |'''04 81 (AVL: 1153 - Backup Tracker Alarm)'''
 
|-
 
| style="vertical-align: middle; text-align: center;" |N of Total ID
 
| style="vertical-align: middle; text-align: center;" |00 05
 
|-
 
| style="vertical-align: middle; text-align: center;" |N1 of One Byte IO
 
| style="vertical-align: middle; text-align: center;" |00 01
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |00 01 (AVL ID: 1, Name: DIN1)
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
| style="vertical-align: middle; text-align: center;" |N2 of Two Bytes IO
 
| style="vertical-align: middle; text-align: center;" |00 01
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |00 11 (AVL ID: 17, Name: Axis X)
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |00 1D
 
|-
 
| style="vertical-align: middle; text-align: center;" |N4 of Four Bytes IO
 
| style="vertical-align: middle; text-align: center;" |00 01
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |00 10 (AVL ID: 16, Name: Total Odometer)
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |01 5E 2C 88
 
|-
 
| style="vertical-align: middle; text-align: center;" |N8 of Eight Bytes IO
 
| style="vertical-align: middle; text-align: center;" |00 02
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO ID
 
| style="vertical-align: middle; text-align: center;" |00 0B (AVL ID: 11, Name: ICCID1)
 
|-
 
| style="vertical-align: middle; text-align: center;" |1’st IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00 35 44 C8 7A
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO ID
 
| style="vertical-align: middle; text-align: center;" |00 0E (AVL ID: 14, Name: ICCID2)
 
|-
 
| style="vertical-align: middle; text-align: center;" |2’nd IO Value
 
| style="vertical-align: middle; text-align: center;" |00 00 00 00 1D D7 E0 6A
 
|-
 
| style="vertical-align: middle; text-align: center;" |NX of X Byte IO
 
| style="vertical-align: middle; text-align: center;" |00 00
 
|-
 
| rowspan="2" style="vertical-align: middle; text-align: center;" |
 
| style="vertical-align: middle; text-align: center;" |Number of Data 2 (Number of Total Records)
 
| style="vertical-align: middle; text-align: center;" |01
 
|-
 
| style="vertical-align: middle; text-align: center;" |CRC-16
 
| style="vertical-align: middle; text-align: center;" |00 00 29 94
 
|-
 
|}
 

Revision as of 13:19, 1 June 2023

Backup Tracker information here