Changes

Created page with "__TOC__ ==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..."
__TOC__

==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:

*'''''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.
*'''''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''.''
*'''''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==
Non Stop Scan Enabled.
[[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.


Non Stop Scan Disabled, Scan period is selected manually.
[[Image:Scan.png|300px|none]]

From the picture above, the Scan time period will be selected from two sources, '''''BLE Scan Duration'' -''' the time when sensors are scanned and the '''''Update frequency''''' - The time when the sensor information is packed as the AVL Data record.

For example:

'''''Update frequency''' - 120 seconds.''

'''''BLE Scan Duration''''' ''- 60 Seconds''

Device will start the first scan after 120 seconds and will scan nearby BLE devices for 60 seconds to update configured sensor data. The sensor data will be updated every 120 seconds. Update Frequency is counted even while a scan is performed.

Update frequency period passes. 120 seconds -> 0 seconds, a 60 second scan is initiated. Update Frequency countdown is restarted (countdown from configured value to 0) while the scan (according to the BLE Scan duration parameter) is performed.

==Advanced Mode==
<br>When Advanced mode is selected a table with configurable parameters will appear:[[Image:BLE advanced window.png|1000px|none]]<br />

*The table has 9 types of parameters:
*#Type – EIR data type. This parameter will indicate which type to look for and work with. Note: We have also added type with value 0xFE which will indicate to work with a whole data packet and not just a single data type.
*#Data Offset – start index of data we are interested in.
*#Data Size – size of the data we are interested in.
*#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.
*#IO – tells which IO element's data will be saved to. Possible choices for IO elements will be described later in the chapter. '''Used only with Save action.'''
*#Match – hex string to be matched with BLE sensor data. '''Used only with Match action.'''
*#Endianness – endianness of data: little endian (ex. 0x1122) or big endian (ex. 0x2211). '''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 />

'''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==
{| class="wikitable"
|Name
|Connection #1 AVL ID
|Connection #2 AVL ID
|Connection #3 AVL ID
|Connection #4 AVL ID
|-
|None
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|<nowiki>-</nowiki>
|-
|Temperature
|25
|26
|27
|28
|-
|Battery
|29
|20
|22
|23
|-
|Humidity
|86
|104
|106
|108
|-
|Custom1
|331
|332
|333
|334
|-
|Fuel
|270
|273
|276
|279
|-
|Luminosity
|335
|336
|337
|338
|-
|Fuel Frequency
|306
|307
|308
|309
|-
|Custom2
|463
|467
|471
|475
|-
|Custom3
|464
|468
|472
|476
|-
|Custom4
|465
|469
|473
|477
|-
|Custom5
|466
|470
|474
|478
|}
==Supported Sensors List==


This list shows the supported BLE sensors and where their Presets can be found in the configurator to use those sensors with FMB devices. The prests and sensors have been fully tested by Teltonika and are confirmed to work properly.

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.
[[Image:Preset1.png|1200px|none]]


At the top right corner, you should see the following '''Buttons''', press on the first one from the left.
[[Image:Preset2.png|200px|none]]

After the named '''Button''' was pressed the list with all supported sensors and the configuration presets should appear.
[[Image:Preset3.png|150px|none]]


Select your sensor and click load. The correct configuration and recommended settings will appear in the configuration.
[[Image:Preset4.png|1200px|none]]

The supported sensors are listed below:
*[https://wiki.teltonika-gps.com/view/EYE_SENSOR_/_BTSMP1 EYE Sensor]
*BLE TPMS -Tire Pressure Monitoring System.
*Efento Humidity BLE sensors (version 2.2 and 4 presets)
*ELA ANG (Angle)
*ELA MOV AG (Movement and Angle)
*ELA PUCK ID (ID)
*ELA RHT (Temperature and Humidity)
*ELA T (Temperature)
*ELA MOV MAG (Movement Magnetic)
*Escort Fuel BLE sensors
*Escort luminosity BLE sensors
*Escort Temperature BLE sensors
*S1 BLE Motion, Humidity and Temperature Sensors
*Technoton Wireless fuel level sensors
*TZ-BT04 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==
Here is a visual demonstration of Bluetooth 4.0 sensors in a cold storage truck.
<br/><br/><youtube>n0yJvoCBZLI</youtube><br/>

==FMB Family Bluetooth 4.0 support==
<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.
<br>
<table class="nd-othertables" style="width: 40%;">
<tr>
<th style="width: 20%; text-align:center; vertical-align:middle; color: black">Device Model</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>
<td style="vertical-align:middle">FMB001</td>
<td style="vertical-align:middle">2018.04</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB010</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>
<td style="vertical-align:middle">FMB900</td>
<td style="vertical-align:middle">2018.08</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB920</td>
<td>2018.07</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB964</td>
<td style="vertical-align:middle">2019.07</td>
</tr>

<tr>
<td style="vertical-align:middle">FMB110</td>
<td>2018.01</td>
</tr>

<tr>
<td style="vertical-align:middle">FMB120</td>
<td>2018.01</td>
</tr>

<tr>
<td style="vertical-align:middle">FMB122</td>
<td>2017.11</td>
</tr>
<tr>
<td style="vertical-align:middle">FMB125</td>
<td>2017.11</td>


<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>FMB965</td><td>All versions</tr></tr>
</table>