Difference between revisions of "TAT100 Bluetooth® settings"

From Wiki Knowledge Base | Teltonika GPS
m (Protected "TAT100 Bluetooth settings" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
(Replaced content with "{{ Template:TATXYZ Bluetooth® settings |model=TAT100 }} Category:TAT100 Configuration")
Tag: Replaced
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=Sensors=
+
{{
 
+
Template:TATXYZ Bluetooth® settings
TAT100 has a BLE connectionless devices reading feature that can be configured in the '''Bluetooth''' tab. When '''Sensors''' mode is selected a table with configurable parameters will appear. Currently to the TAT100 device up to '''4 sensors''' can be connected.
+
|model=TAT100
 
+
}}
[[Image:TAT100_BLE_Sensor_configuration_v3.png|250px|{{{general|size}}}|right]]
 
<br>'''BLE Feature:'''<br>
 
<br><code>None</code> – Bluetooth functionality will be disabled. <br>
 
<code>Sensors</code> – Enables Bluetooth functionality for sensors. <br>
 
 
 
'''Update frequency''' – how often BLE scanning will run. <br>
 
'''Scan duration''' – how long scanning will be processed.
 
[[Image:TAT100_BLE_Sensor_configuration.png|1000px|center|class=tlt-border]]
 
 
 
Supported BLE sensors are listed below:<br>
 
 
 
*'''Blue Puck/Coin T''' (Temperature)
 
*'''Blue Puck/Coin MAG''' (Magnet detection)
 
*'''Blue Puck/Coin MOV''' (Movement detection)
 
*'''Blue Puck RHT''' (Temperature and Humidity)
 
*'''EYE Sensor / BTSMP1''' (Temperature, Humidity, Movement, Magnet and sensor's battery voltage)
 
 
 
<br>These sensors have been fully tested by Teltonika and are confirmed to work properly.<br>
 
<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:''' How to configure the device to read data is described <b>[[How to read data from BLE Sensors|HERE]]<b>.
 
|}
 
 
 
=Backup Tracker=
 
 
 
==Introduction to Backup Tracker functionality==
 
 
 
TAT100 supports a feature which allows to work as backup tracker. <br>
 
 
 
1. Even if Backup tracker is in alarm mode, device will continue to track its position as configured. <br>
 
2. If FMBXXX device ([[FMB_Compability_table_for_backup_tracker_feature|Compatibility table]]) is turned off, Alarm event from the TAT100 will be received and AVL 236 in the data packet will be sent.<br>
 
 
 
==Topology scheme==
 
 
 
[[File:422705 VEHICLE BACKUP SECURITY SOLUTION TOPOLOGY 02 (1).png|center|900px]]
 
 
 
==Backup feature logic==
 
 
 
[[File:TAT100_Backup_feature.png]]
 
{| class="wikitable" style="background: #0054A6; color: black; border: 2px #0054A6; border-bottom: 1px solid #0054A6;border-top: 1px solid #0054A6;border-left: 1px solid #0054A6;border-right: 1px solid #0054A6;""
 
|+
 
| style="width: auto; text-align: left; border: 1px solid #0054A6; border-bottom: 1px solid #0054A6; background: #0054A6; color: white;" |<b>NOTE:</b>
 
| style="width: auto; text-align: left; border: 1px solid #0054A6; border-bottom: 1px solid #0054A6; background: white;" | '''If TAT100 does not pick up advertised data packets from main tracker, TAT100 enters alarm state, generates and starts sending records with AVL ID 236 (Value 0).'''
 
|}
 
 
 
[[File:Backup schema 2.jpg]
 
 
 
{| class="wikitable"
 
|- style="font-weight:bold;"
 
! Parameter Name
 
! Description
 
! ID
 
! Value
 
|-
 
| BLE Feature
 
| Select which BLE feature is enabled.<br />For Backup Tracker "Backup Tracker" <br />feature has to be selected
 
| 189
 
| 0 - None<br />1 - Backup Tracker <br />2 -Sensors
 
|-
 
| Central Device IMEI
 
| IMEI of central device that TAT100 is connected
 
| 190
 
| Valid IMEI number
 
|-
 
| Update Frequency
 
| Time in seconds for scanning intervals
 
| 1100
 
| Min 5 sec.<br />Max 65535 sec.<br />Default 120 sec.
 
|-
 
| Scan Duration
 
| Time in seconds for how long BLE scan will be running
 
| 1113
 
| Up to 60 seconds (Not configurable)
 
|}
 
 
 
==FIRMWARE (MODEM AND BLUENRG) INSTALLATION==
 
<p align="left">Download Firmware and Configurator from [[TAT100_Stable_firmware | '''STABLE FIRMWARE''']] or [[TAT100_Short-term_firmware |'''SHORT-TERM FIRMWARE''']] pages.</p>
 
<p align="left"><b> After device connection to Configurator:</b><br>
 
1) Select Update firmware;<br>
 
2) Select to flash Firmware(*.e.XIM) file;<br>
 
3) Click on file;<br>
 
4) And select Open.<br><br>
 
Wait until the device will upload the firmware.<br>
 
 
 
[[Image:TAT100Firmware.png|center|border|class=tlt-border]]<br>
 
 
 
<p align="left"><b>When parameters successfully loaded:</b><br>
 
1) Select Update firmware;<br>
 
2) Select to flash BlueNRG firmware(*.bin);<br>
 
3) Click on file;<br>
 
4) And select Open.<br><br>
 
 
 
[[Image:TAT100NRG.png|center|border|class=tlt-border]]
 
 
 
==Instructions==
 
'''To ENABLE backup feature on TAT100 device:'''
 
 
 
# <code>Bluetooth</code> → select <code>Backup Tracker</code><br>
 
# Enter main device (FMBxxx/TFT100/TST100/GH5200/TMT250) IMEI<br>
 
# Set <b>Update frequency</b> to <b>3600</b> (s) – <i>We do not recommend to set values below <b>1800</b> sec. in this field, as it will shorten the battery life.</i><br>
 
# Configure your <b>APN</b> and Server settings in <b>GPRS</b> section.<br>
 
 
 
 
 
[[File:TAT100_Bluetooth_Backup_v2.png|center|400px]]
 
 
 
 
 
'''To ENABLE backup feature on FMBXXX/TFT100/TST100/GH5200/TMT250 devices:'''
 
 
 
#<code>Bluetooth</code> → <code>BT Radio</code> set to <code>Enable(visible)</code><br><br>[[File:BT ONN.jpg|center|500px]]<br>
 
#ENABLE backup feature on:
 
##<b>TFT100 | TST100 | GH5200 | TMT250</b> devices<br><code>Bluetooth 4.0</code> → <code>Backup Tracker</code> set to <code>Enabled</code><br><br>[[File:TAT100_bluetooth_backup_enable.png|center|700px]]<br>
 
##<b>FMBXXX</b> devices<br>Instructions on how to configure the FMBXXX device can be found [https://wiki.teltonika-gps.com/view/FMC130_Bluetooth_4.0_settings#Backup_Tracker here].
 
 
 
==DEVICE RECOGNITION CHECK USING TERMINAL==
 
* '''Debug mode:'''
 
Device is able to transmit its current state when connected to PC using USB cable. It is used to detect
 
errors and provide information to possible solutions when operating as unexpected.
 
 
 
# After launching terminal choose baud rate 115200 and hardware control – none.
 
# Select COM port which is assigned to “Virtual COM Port”.
 
# Click on ‘Start Log’ button and save a new file.
 
# Then click ‘Connect’ to start receiving messages from device.
 
 
 
[[File:Terminal_debug_TAT100.png|center|600px|border|class=tlt-border]]
 
Required Terminal application for log capturing can be downloaded here: [http://avl1.teltonika.lt/Downloads/Software/Terminal.zip Terminal] </br>
 
 
 
'''TAT100 terminal instructions:'''<br>
 
 
 
1. Connect TAT100 to the computer and open it with Terminal as shown in example above. <br>
 
2. When TAT100 recognizes the main tracker, a terminal will print a line as shown in example below:<br>
 
<code>[2021.10.26 06:28:40] – [ASSET.UART] << Device MAC: 785ae3d1f9de IMEI 141fa7497ac1 Command 0 Sequence 24 Packet Cnt 5 </code><br>
 
3. When TAT100 cannot see the main tracker Terminal will print a line as shown in example below:<br>
 
<code>[2021.10.26 10:50:03] – [ASSET.UART] << [2021.10.26 10:50:03] – [APP.TBT] ERROR! Amount of valid packets does not detect during this period! Triggering alarm </code><br>
 
 
 
 
[[Category:TAT100 Configuration]]
 
[[Category:TAT100 Configuration]]

Latest revision as of 10:20, 3 April 2024

Main Page > Autonomous Trackers > TAT100 > TAT100 Configuration > TAT100 Bluetooth® settings

BLE Feature Sensors

Allows to configure universal or EYE sensors for data reading or BLE beacons for use with Recovery mode.

size


BLE Feature:

None – Bluetooth functionality will be disabled.
Sensors – Enables Bluetooth functionality for universal sensors, EYE Sensors and beacons.
Backup Tracker - Enables Backup Tracker

Update frequency - Sets BLE update frequency if Backup Tracker or BLE beacon is configured. Scan for universal sensors or EYE Sensors is only performed with periodic or scheduled records. To increase BLE scan frequency when using universal sensors or EYE Sensors, Operand in IO elements needs to be configured.

AAS scenario - When enabled TAT device will only perform BLE scan while it is in "On Move" tracking scenario. While device is stationary BLE scan does not initiate.

Sensor

When Sensors mode is selected a table with configurable parameters will appear:

TAT sensors window.png


  • The table has 9 types of parameters:
    1. Type – EIR data type. This parameter will indicate which type to look for and work with.
    2. Data Offset – start index of data we are interested in.
    3. Data Size – size of the data we are interested in. Limited to 2 bytes of data.
    4. Action – two actions are possible: Match and Save. Match means that we want to perform a validation of certain data. Save means that we want to get certain data and later save it to an AVL record.
    5. IO – tells which IO element's data will be saved to. Used only with Save action.
    6. Match – hex string to be matched with BLE sensor data. Used only with Match action.
    7. Endianness – endianness of data: little endian (ex. 0x1122) or big endian (ex. 0x2211). Used only with Save action.
    8. Multiplier – value to be used to multiply output data. Used only with Save action.
    9. Offset – value to be added to output data. Used only with Save action.


MAC - MAC address of the universal sensor.

Lost universal sensor.png

Lost Sensor Alarm - When enabled TAT device will generate a record to notify that sensor has been lost. Required to be enabled for Recovery mode trigger "Lost BLE sensor" to work.
When universal sensor is lost TAT will send a record with event number that is the first configured IO element. In shown example if sensor is lost device will generate a record with event ID 29 (BLE Battery #1:29). If it was configured for second sensor, record will have event ID 20 (BLE Battery #2:20). Depending on the type of IO element this AVL ID will have one of two values:
-4162 - if configured data is integer
BEEF - if configured data is sent as HEX number.


EYE Sensor

TAT EYE Sensor window2.png

When EYE Sensors mode is selected MAC address of the sensor will need to be entered.
MAC - MAC address of the EYE Sensor.

Lost Sensor Alarm - When enabled TAT device will generate a record to notify that EYE Sensor has been lost. Required to be enabled for Recovery mode trigger "Lost BLE sensor" to work.
AVL ID 463, value BEEF - Lost BLE1 EYE Sensor.
AVL ID 467, value BEEF - Lost BLE2 EYE Sensor.
AVL ID 471, value BEEF - Lost BLE3 EYE Sensor.
AVL ID 475, value BEEF - Lost BLE4 EYE Sensor.

Note icon.png Please note:

If Lost Sensor Alarm is disabled and sensor is not found during a scan IO element will contain value:

  • 32767 - temperature IO
  • 65535 - humidity IO


When EYE Sensor is configured, TAT device will automatically map data to below IO elements -

Sensor Data IO Element AVL ID
EYE Sensor 1 Temperature BLE Temp #1 25
EYE Sensor 1 Battery BLE Battery #1 29
EYE Sensor 1 Humidity BLE Humidity #1 86
EYE Sensor 1 Flags BLE1 Custom #1 331
EYE Sensor 1 Movement Counter BLE1 Custom #2 463
EYE Sensor 1 Angle (pitch) BLE1 Custom #3 464
EYE Sensor 1 Angle (roll) BLE1 Custom #4 465
EYE Sensor 2 Temperature BLE Temp #2 26
EYE Sensor 2 Battery BLE Battery #2 20
EYE Sensor 2 Humidity BLE Humidity #2 104
EYE Sensor 2 Flags BLE2 Custom #1 332
EYE Sensor 2 Movement Counter BLE2 Custom #2 467
EYE Sensor 2 Angle (pitch) BLE2 Custom #3 468
EYE Sensor 2 Angle (roll) BLE2 Custom #4 469
EYE Sensor 3 Temperature BLE Temp #3 27
EYE Sensor 3 Battery BLE Battery #3 22
EYE Sensor 3 Humidity BLE Humidity #3 106
EYE Sensor 3 Flags BLE3 Custom #1 333
EYE Sensor 3 Movement Counter BLE3 Custom #2 471
EYE Sensor 3 Angle (pitch) BLE3 Custom #3 472
EYE Sensor 3 Angle (roll) BLE3 Custom #4 473
EYE Sensor 4 Temperature BLE Temp #4 28
EYE Sensor 4 Battery BLE Battery #4 23
EYE Sensor 4 Humidity BLE Humidity #4 108
EYE Sensor 4 Flags BLE4 Custom #1 334
EYE Sensor 4 Movement Counter BLE4 Custom #2 475
EYE Sensor 4 Angle (pitch) BLE4 Custom #3 476
EYE Sensor 4 Angle (roll) BLE4 Custom #4 477



Eddystone

TAT Eddystone window.png

When Eddysone mode is selected Namesspace and Instance IDs will be configurable.
Configuring both parameters is not mandatory. If one of the parameters is is left empty TAT will find beacons matching other provided parameter. It is also possible to configure only part of a parameter (for example only 10 Namespace ID symbols instead of 20). During BLE scan device needs to find at least one beacon (even if 4 different connections are configured. Scanning for BLE beacons is initiated every Update Frequency. Scan will take up to 60 seconds and will end early if at least one beacon is found.

If no beacons are found during a BLE scan, device will wake up, acquire location based on configuration and send a record to configured server. This record will have event AVL ID 20014 with a value of 3.
This functionality can also trigger Recovery mode. Device will send lost beacon event and then go into Recovery mode.


iBeacon

TAT iBeacon window.png

When iBeacon mode is selected UUID, Major ID and Minor IDs will be configurable.
Configuring all parameters is not mandatory. If one of the parameters is is left empty TAT will find beacons matching other provided parameter. It is also possible to configure only part of a parameter (for example only 20 UUID symbols instead of 32). During BLE scan device needs to find at least one beacon (even if 4 different connections are configured. Scanning for BLE beacons is initiated every Update Frequency. Scan will take up to 60 seconds and will end early if at least one beacon is found.

If no beacons are found during a BLE scan, device will wake up, acquire location based on configuration and send a record to configured server. This record will have event AVL ID 20014 with a value of 3.
This functionality can also trigger Recovery mode. Device will send lost beacon event and then go into Recovery mode.





BLE Feature Backup Tracker

Introduction to Backup Tracker functionality

TAT devices support a feature which allows them to work as a Backup Tracker.

1. If main tracker (Compatibility table) is turned off, Alarm event from the TAT100 will be received and AVL 236 in the data packet will be sent.
2. Even if Backup tracker is in alarm mode, TAT device will continue to track its position as configured.

Topology scheme

422705 VEHICLE BACKUP SECURITY SOLUTION TOPOLOGY 02 (1).png

Backup feature logic

TAT Backup Logic.png

NOTE: If TAT does not pick up advertised data packets from main tracker, TAT100 generates and sends a record with AVL ID 236 (Value 1). After sending this record, device will wait for the next Update Frequency and will keep generating records with event ID 236 until main tracker is found again. No record is generated if main tracker can be located during a BLE scan.
Parameter Name Description Parameter ID Parameter Value
BLE Feature Select which BLE feature is enabled.
Backup tracker or Sensors can be selected (not both)
189 0 - None
1 - Backup Tracker
2 - Sensors
IMEI of Central Device IMEI of main tracker that TAT is scanning for 190 Valid IMEI number
Update Frequency Time in seconds for scanning intervals 1100 Min 30 sec.
Max 65535 sec.
Default 120 sec.


Instructions

To ENABLE backup feature on TAT device:

  1. Bluetooth → select Backup Tracker
  2. Enter main device (FMBxxx/TFT100/TST100/GH5200/TMT250) IMEI
  3. Set Update frequency(We recommend to set update frequency to >3600 sec. Frequent BLE scanning will reduce battery life.)
TAT Backup Tracker.png

To ENABLE backup feature on main tracker:

  1. BluetoothBT Radio set to Enable (visible)

    450x

  2. ENABLE backup feature on:
    1. TFT100 | TST100 | GH5200 | TMT250 devices
      Bluetooth 4.0Backup Tracker set to Enabled

      Main tracker BackT enable mob.png

    2. FMBXXX devices
      BLE connection control needs to be set to Prohibit for Backup Tracker feature to become visible.

      Main tracker BackT enable fmb.png