5,089
edits
Changes
Template:FMB Blue-tooth 4.0 settings (view source)
Revision as of 09:51, 28 December 2023
, 09:51, 28 December 2023no edit summary
__TOC__
__TOC__
==Disclaimer==
==Bluetooth 4.0 settings==
[[File:Alert.png|left|link=]] <br> If you are not using Bluetooth®, '''please consider turning it off''' or '''change Bluetooth® PIN''' to remove potential risks.
If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security.
[[Image:Common_settings.PNG|300px|none]]
==Bluetooth® 4.0 settings==
{{{model|FMB1YX}}} offers Bluetooth® 4.0 (Bluetooth® Low Energy, also referred as BLE) functionality.
[[Image:Blue-tooth 4.0v2 settings.PNG|300px|none]]
Configurable parameters:
Configurable parameters:
*'''''Update frequency''''' – changes sensor's temperature/humidity/battery voltage data update frequency. <br /> Minimum value: 120 s, maximum value: 65535 s, default value: 120.
*'''''Non Stop Scan''''' - Enabled Non Stop Scan feature, the device will try to scan for the sensors all the time if any of them are configured.
*'''''TZ-BT04/05/05B Update frequency''''' – changes sensor's temperature/humidity/battery voltage data update frequency. <br /> Minimum value: 30 s, maximum value: 65535 s, default value: 30.
*'''''BLE Scan Duration''''' - Sensors data reading time.
*'''''BLE Scan Duration''''' - Sensors data reading time.
*'''''Scan retries until error''''' - Configured scan retries, to show the Error Value '3000' - sensor disconnected.
*'''''Scan retries until error''''' - Configured scan retries, to show the Error Value '3000' - sensor disconnected.
*'''''Working mode''''' – Bluetooth® connection mode''. '''Disabled''':'' Bluetooth® 4.0 connection will not be used. '''''TZ-BT04/05/05B sensor''':'' this Bluetooth® connection will be used to communicate with TZ-BT04/05/05B sensor. '''''Advanced''' -'' It allows to gather data from BLE device‘s broadcast packets regardless of what data packing protocol is used''.''
*'''''Working mode''''' – Bluetooth connection mode''. '''Disabled''':'' Bluetooth 4.0 connection will not be used. '''''TZ-BT04/05/05B sensor''':'' this Bluetooth connection will be used to communicate with TZ-BT04/05/05B sensor. '''''Advanced''' -'' It allows to gather data from BLE device‘s broadcast packets regardless of what data packing protocol is used''.''
*'''''Local Name''''' – Bluetooth® local name user for pairing. If it is empty, name will be automatically generated: FMBxxx_<last 7 IMEI digits>. Maximum name length = 16 characters''
===BLE Serial Encryption===
Since FW version ''' 03.27.07.Rev.00''' there has been an implementation of BLE transferred data encryption with '''AES128 cipher'''. In '''Bluetooth® 4.0 tab''' under '''Settings''' there is a field for a '''AES128 key'''. Which if left empty, the BLE outgoing data will not be ciphered and incoming data will not be decoded.
AES128 key field settings showed below.
[[Image:AES Serial Encrytpion.png|left]]<br><br><br><br>
If a key is present the outgoing data will be ciphered by the configured key and incoming data will be deciphered. The '''AES128 key''' must be in '''HEX format with a length of 16 bytes'''. As an example 11223344556677889900AABBCCDDEEFF is used.
[[Image:AES Serial Encrytpion set.png|left]]<br><br><br>
==Configuration modes==
==Configuration modes==
Non Stop Scan Enabled.
Non Stop Scan Enabled.
[[Image:Common_settings_2.PNG|250px|none]]
[[Image:Non Stop.png|300px|none]]
In Configurator when Non Stop sensor scans is active update frequency & scan retries until error will be hidden. Although BLE scan duration will still be active because it is important for btgetlist SMS command.
In Configurator when Non Stop sensor scans is active update frequency & scan retries until error will be hidden. Although BLE scan duration will still be active because it is important for btgetlist SMS command.
*#Multiplier – value to be used to multiply output data. '''Used only with Save action.'''
*#Multiplier – value to be used to multiply output data. '''Used only with Save action.'''
*#Offset – value to be added to output data. '''Used only with Save action.''' <br />
*#Offset – value to be added to output data. '''Used only with Save action.''' <br />
'''More information about Advanced Beacon Capturing Configuration can be found [[Advanced Beacon Capturing Configuration|HERE]]
==IO elements choices==
==IO elements choices==
While following the steps showed in the images below, you can find the supported sensors in our Configurator.
While following the steps showed in the images below, you can find the supported sensors in our Configurator.
In the Configurator, find the Bluetooth 4.0 Settings menu, select the advanced sensors mode which was mentioned before. The following window should appear.
In the Configurator, find the Bluetooth® 4.0 Settings menu, select the advanced sensors mode which was mentioned before. The following window should appear.
[[Image:Preset1.png|1200px|none]]
[[Image:Preset1.png|1200px|none]]
The supported sensors are listed below:
The supported sensors are listed below:
*[https://wiki.teltonika-gps.com/view/EYE_SENSOR_/_BTSMP1 EYE Sensor]
*BLE TPMS -Tire Pressure Monitoring System.
*BLE TPMS -Tire Pressure Monitoring System.
*Efento Humidity BLE sensors (version 2.2 and 4 presets)
*Efento Humidity BLE sensors (version 2.2 and 4 presets)
*TZ-BT04 Temperature and Humidity Sensors
*TZ-BT04 Temperature and Humidity Sensors
*TZ-BT05 Temperature and Humidity Sensors
*TZ-BT05 Temperature and Humidity Sensors
[https://wiki.teltonika-gps.com/view/How_to_add_a_BLE_preset_to_the_configurator Save your own settings as a preset/delete the preset]
==Visual demonstration==
==Visual demonstration==
Here is a visual demonstration of Bluetooth 4.0 sensors in a cold storage truck.
Here is a visual demonstration of Bluetooth® 4.0 sensors in a cold storage truck.
<br/><br/><youtube>n0yJvoCBZLI</youtube><br/>
<br/><br/><youtube>n0yJvoCBZLI</youtube><br/>
{{{Backup Tracker|
==Backup Tracker==
FMB devices from '''03.28.06.Rev.02''' firmware version have an ability to set up TAT100 device as a backup tracker.
When the feature is enabled - FMB device starts to advertise encrypted BLE packets.
In this solution - FMB device is a main tracker and TAT100 is set up as a backup tracker - TAT100 periodically checks if FMB advertised packets are available. If no FMB packets are read - an alarm is sent from TAT100 side and tracker switches it's mode to become the main tracker.
To enable Backup tracker:
1) BLE Connection control must be prohibited:
<br>
[[Image:BLE_Connection_Control.png]]
<br>
2) Enable Backup Tracker:
<br>
[[Image:Backup_Tracker_enabled.png]]
'''Note:''' when Backup Tracker is enabled - '''BLE sensor and Beacon settings become disabled'''. Additionally - '''Ultra Deep Sleep mode is also disabled''' (in this mode BLE packets would not be advertised)
TAT100 device recognizes the BLE packets by FMB devices IMEI, therefore after FMB configuration is done - additional TAT100 device configuration is required to support the full solution.
You can learn more about the backup tracker and TAT100 configuration in our [https://wiki.teltonika-gps.com/view/TAT100_Bluetooth®_settings#Backup_Tracker wiki site]
}}}
==FMB+FMB Backup Tracker==
==FMB Family Bluetooth 4.0 support==
FMB+FMB Backup Tracking functionality lets you pair two FM devices together where primary device will report periodical and eventual data and secondary device will be responsible only for reporting once primary device is lost. With '''03.27.13.Rev.452''' firmware version Devices are able to set Main and Backup trackers through configurator.
<br>
To enable FMB+FMB Backup Tracking:
{| width = "100%"
|-
| style="width:22%; vertical-align: middle; text-align: center;" | '''<big>System tab</big>'''
| style="width:78%; vertical-align: middle; text-align: center;" |
|}
[[File:Backup Tracker Ultra Sleep.gif]]
<br>
Backup Tracking both modes (Main and Backup) does not allow '''Ultra Sleep''' mode to be used so it has to be disabled in order for functionality to work effectively. Other sleep modes don't have an effect on the Bluetooth® functionality. If Ultra Sleep mode is selected - Backup Tracking options will be hidden and if Backup Tracking (Main or Backup modes) are selected then Ultra Sleep mode button will be hidden.
{| width = "100%"
|-
| style="width:37%; vertical-align: middle; text-align: center;" | '''<big>Bluetooth® 4.0 tab</big>'''
| style="width:63%; vertical-align: middle; text-align: center;" |
|
|-
|}
[[File:Backup Tracker Main Tracker.PNG|220px]] [[File:Backup Tracker.PNG|250px]]
<br>
<br>
Devices that are listed in table below shows which device model has Bluetooth 4.0 hardware installed. If your device is manufactured before the day shown in the list it means that this model does not have Bluetooth functionality or it has an older version installed. The date shown in the table depends on when hardware production has started, but not when first lot was sold.
'''Main Tracker''' - Once Main Tracker is selected device will work as usual but additionally it will start broadcasting BLE packets with encrypted manufacturer data, which contains device's IMEI number. Broadcasting range depends from set BT Power Level<br>
'''Backup Tracker''' - When Backup Tracker is selected device will start scanning for Main tracker's broadcasted BLE packet at the configured Update frequency (s)<br>
<code>IMEI</code> – Set IMEI that Backup device will look for while scanning. <br>
<code>Update frequency</code> – Frequency at which FMB should scan for the main tracker. <br>
<code>Delay timeout</code> – Delay after which alarm should be sent to the server. <br>
<br>
'''Note:''' Once Main tracker or Backup tracker is selected Non Stop Scan and All BLE connectionless functionalities such as sensors will be '''Disabled'''. More information about full solution such as sent packets, received and parsed data and flowchart can be found in our [https://wiki.teltonika-gps.com/view/FMB%2BFMB_Backup_Tracker <u>'''wiki site'''</u>].
==FMB Family Bluetooth® 4.0 support==
Devices that are listed in table below shows which device model has Bluetooth® 4.0 hardware installed. If your device is manufactured before the day shown in the list it means that this model does not have Bluetooth® functionality or it has an older version installed. The date shown in the table depends on when hardware production has started, but not when first lot was sold.
<br>
<br>
<table class="nd-othertables" style="width: 40%;">
<table class="nd-othertables" style="width: 40%;">
<th style="width: 20%; text-align:center; vertical-align:middle; color: black">BT 4.0 manufacture starting date</th>
<th style="width: 20%; text-align:center; vertical-align:middle; color: black">BT 4.0 manufacture starting date</th>
</tr><tr><td>FM3001</td><td>2018.01</td></tr><tr>
</tr><tr><td>FM3001</td><td>2018.01</td></tr><tr>
<td style="vertical-align:middle">FMB010 </td>
<tr>
<td>2018.04</td>
<td style="vertical-align:middle">FMB001</td>
<td style="vertical-align:middle">2018.04</td>
</tr>
</tr>
<tr>
<tr>
<td style="vertical-align:middle">FMB001</td>
<td style="vertical-align:middle">FMB010</td>
<td style="vertical-align:middle">2018.04</td>
<td style="vertical-align:middle">2018.04</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB020</td>
<td style="vertical-align:middle">All versions</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB002</td>
<td style="vertical-align:middle">All versions</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB003</td>
<td style="vertical-align:middle">All versions</td>
</tr>
</tr>
<tr>
<tr>
<td style="vertical-align:middle">2019.07</td>
<td style="vertical-align:middle">2019.07</td>
</tr>
</tr>
<tr>
<td style="vertical-align:middle">FMB110</td>
<td>2018.01</td>
</tr>
<tr>
<tr>
<td style="vertical-align:middle">FMB125</td>
<td style="vertical-align:middle">FMB125</td>
<td>2017.11</td>
<td>2017.11</td>
</td></tr><tr><td>FMB140</td><td>All versions
</td></tr><tr><td>FMU125</td><td>FW is on release, All versions</td></tr><tr><td>FMU126</td><td>FW is on release, All versions</td></tr><tr><td>FMU130</td><td>FW is on release, All versions</td><tr><td>FMM125</td><td>FW is on release, All versions</td></tr><tr><td>FMM130</td><td>FW is on release, All versions</td></tr><tr><td>FMM0YX</td><td>FW is on release, All versions</td></tr><tr><td>FMB202</td><td>All versions</td></tr><tr><td>FMB204</td><td>All versions</td></tr><tr><td>FMB208</td><td>All versions</td></td></tr><tr><td>FMC640</td><td>All versions</td></tr><tr></tr></table>
<tr><td>FMB130</td><td>All versions</td></tr>
<tr><td>FMB140</td><td>All versions</td></tr>
<tr><td>FMU125</td><td>FW is on release, All versions</td></tr>
<tr><td>FMU126</td><td>FW is on release, All versions</td></tr>
<tr><td>FMU130</td><td>FW is on release, All versions</td></tr>
<tr><td>FMM125</td><td>FW is on release, All versions</td></tr>
<tr><td>FMM130</td><td>FW is on release, All versions</td></tr>
<tr><td>FMM0YX</td><td>FW is on release, All versions</td></tr>
<tr><td>FMC130</td><td>FW is on release, All versions</td></tr>
<tr><td>FMB202</td><td>All versions</td></tr>
<tr><td>FMB204</td><td>All versions</td></tr>
<tr><td>FMB208</td><td>All versions</td></tr>
<tr><td>FMC640</td><td>All versions</td></tr>
<tr><td>FMT100</td><td>All versions</tr></tr>
<tr><td>FMP100</td><td>All versions</tr></tr>
<tr><td>FMC800</td><td>All versions</tr></tr>
<tr><td>FMM800</td><td>All versions</tr></tr>
<tr><td>FMC880</td><td>All versions</tr></tr>
<tr><td>FMM880</td><td>All versions</tr></tr>
</table>
