Line 1: |
Line 1: |
| __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. |
| | | |
− | {{{model|FMB1YX}}} offers Bluetooth 4.0 (Bluetooth Low Energy, also referred as BLE) functionality. | + | If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security. |
| + | |
| + | ==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]] | | [[Image:Blue-tooth 4.0v2 settings.PNG|300px|none]] |
Line 13: |
Line 18: |
| *'''''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'' | + | *'''''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=== | | ===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. | + | 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. | | AES128 key field settings showed below. |
| | | |
Line 64: |
Line 69: |
| | | |
| '''More information about Advanced Beacon Capturing Configuration can be found [[Advanced Beacon Capturing Configuration|HERE]] | | '''More information about Advanced Beacon Capturing Configuration can be found [[Advanced Beacon Capturing Configuration|HERE]] |
− |
| |
− |
| |
− | ==Parsing Advanced Beacon data from record (AVL ID 548)==
| |
− | <br>
| |
− | {| class="nd-othertables_2" style="width:100%;"
| |
− | |+
| |
− | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Beacon data
| |
− | |-
| |
− | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |Unparsed Beacon data
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |01<span style="background:#87CEEB">360001b10110f34b6f6aa38255aa9ef619154e2d0055021f0201060303aafe1716aafe0002f34b6f6aa38255a<br>a9ef619154e2d00550000</span><span style="background:#4ab92f">360001ab0110e987706aa38255aa94321b154e2d0055021f0201060303aafe1716aafe0<br>002e987706aa38255aa94321b154e2d00550000</span><span style="background:#e6e144">360001a801101e74706aa38255faabcd000000000000021f0201060303aafe1716<br>aafe00021e74706aa38255faabcd0000000000000000</span><span style="background:#fa623d">360001a201100c8c6f6ba38255aab7361a164e2d0055021f0201060303aafe171<br>6aafe00020c8c6f6ba38255aab7361a164e2d00550000</span>
| |
− | |-
| |
− | |}
| |
− | <br>
| |
− | ===Beacon Parameters===
| |
− |
| |
− | The below table represents possible Beacon Parameters.
| |
− | {| class="nd-othertables_2" style="width:25%;"
| |
− | |+
| |
− | ! colspan="2" style="width:10%; border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parameters
| |
− | |-
| |
− | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |00
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI
| |
− | |-
| |
− | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |01
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID
| |
− | |-
| |
− | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |02
| |
− | | style="vertical-align: middle; text-align: center;" |Additional beacon data
| |
− | |}
| |
− | {| class="nd-othertables_2" style="width:100%;"
| |
− | |+
| |
− | ! colspan="3" style="border-bottom: 2px solid #0054A6; vertical-align: middle; text-align: center;" |Parsed Beacon data
| |
− | |-
| |
− | ! colspan="2" rowspan="1" style="width:60%; vertical-align: middle; text-align: center;" |Parsed Beacon data part
| |
− | ! rowspan="1" style="width:40%; vertical-align: middle; text-align: center;" |HEX Code Part
| |
− | |-
| |
− | | rowspan="50" style="vertical-align: middle; text-align: center;" |
| |
− | | style="vertical-align: middle; text-align: center;" |(Constant)
| |
− | | style="vertical-align: middle; text-align: center;" |01
| |
− | |-
| |
− |
| |
− | | style="vertical-align: middle; text-align: center;" |1st Beacon data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">36
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">00
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI value
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">B1
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">10
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">F34B6F6AA38255AA9EF619154E2D0055
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">02
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">1F
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#87CEEB">0201060303AAFE1716AAFE0002F34B6F6AA38255AA9EF619154E2D00550000
| |
− | |-
| |
− |
| |
− | | style="vertical-align: middle; text-align: center;" |2nd Beacon data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">36
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">00
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI value
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">AB
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">10
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">E987706AA38255AA94321B154E2D0055
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">02
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">1F
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#4ab92f">0201060303AAFE1716AAFE0002E987706AA38255AA94321B154E2D00550000
| |
− | |-
| |
− |
| |
− | | style="vertical-align: middle; text-align: center;" |3rd Beacon data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">36
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">00
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI value
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">A8
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">10
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">1E74706AA38255FAABCD000000000000
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">02
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">1F
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#e6e144">0201060303AAFE1716AAFE00021E74706AA38255FAABCD0000000000000000
| |
− | |-
| |
− |
| |
− | | style="vertical-align: middle; text-align: center;" |4th Beacon data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">36
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI (Parameter 00)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">00
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |RSSI value
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">A2
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID (Parameter 01)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">01
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">10
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Beacon ID
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">0C8C6F6BA38255AAB7361A164E2D0055
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data (Parameter 02)
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">02
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data length
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">1F
| |
− | |-
| |
− | | style="vertical-align: middle; text-align: center;" |Additional data
| |
− | | style="vertical-align: middle; text-align: center;" |<span style="background:#fa623d">0201060303AAFE1716AAFE00020C8C6F6BA38255AAB7361A164E2D00550000
| |
− | |-
| |
− | |}
| |
| | | |
| ==IO elements choices== | | ==IO elements choices== |
Line 318: |
Line 157: |
| 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]] |
| | | |
Line 353: |
Line 192: |
| | | |
| ==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: |
| | | |
− | ==FMB Family Bluetooth 4.0 support==
| + | 1) BLE Connection control must be prohibited: |
| + | <br> |
| + | [[Image:BLE_Connection_Control.png]] |
| + | <br> |
| + | 2) Enable Backup Tracker: |
| <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. | + | [[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 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%;"> |
Line 434: |
Line 294: |
| <tr><td>FMC800</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>FMM800</td><td>All versions</tr></tr> |
− | <tr><td>FMB965</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> | | </table> |