6,023
edits
Changes
Created page with "__TOC__ <br> {{{model|X}}} offers Bluetooth 4.0 (Bluetooth Low Energy, also referred as BLE) functionality. ==Common settings== {| style="width: 100%" |Image:Bluetooth 4.0..."
__TOC__
<br>
{{{model|X}}} offers Bluetooth 4.0 (Bluetooth Low Energy, also referred as BLE) functionality.
==Common settings==
{| style="width: 100%"
|[[Image:Bluetooth 4.0 common settings.png|right]]
* <b>Non Stop Scan</b> - Enabled Non Stop Scan feature, the device will try to scan for the sensors all the time if any of them are configured.
* <b>BLE Scan Start Period</b> - This parameter determines when the next BLE scan will start for Beacons and TZ sensors.
*<b>BLE Scan Duration</b> - Sensors data reading time.
*<b>Scan retries until error</b> - Configured scan retries, to show the Error Value '3000' - sensor disconnected.
*<b>BT power level</b> - The BT power level can be selected. Approximate range in meters:<br><code>1</code> - <0.5<br><code>2</code> - 0.5<br><code>3</code> - 11<br><code>4</code> - 13<br><code>5</code> - 15<br><code>6</code> - 27<br><code>7</code> - 50<br>
*<b>BLE broadcasting service ID</b> - When any ID is provided, the broadcasting is enabled.
*<b>BLE connection control</b> - if <code>Enabled</code>, the BLE connections are allowed.
*<b>Backup Tracker</b> - enabled or disabled Backup tracker scenario.
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|+
|-
| style="width: auto; text-align: left; background: #F6F6FB;" | '''NOTE!'''
| style="width: auto; text-align: left; background: #F6F6FB;" | Backup Tracker feature only available on the FW 55.01.00 Rev 0 or newer.
|}
|}
===Configuration modes===
{| style="width: 100%"
[[Image:Bluetooth 4.0 common settings non stop scan.png|right]]
* If the Non Stop Scan is <b>Enabled</b>, the Non Stop sensor scans until any error will be hidden. Although BLE scan duration will still be active because it is important for btgetlist SMS command.
|}
{| style="width: 100%"
|[[Image:Bluetooth 4.0 common settings.png|right]]
* If Non Stop Scan <b>Disabled</b>, Scan period is selected manually.<br><br>
The Scan time period will be selected from two sources:
*<b>BLE Scan Duration</b> - the time when sensors are scanned,
*<b>Update frequency</b> - The time when the sensor information is packed as the AVL Data record.
For example, if <i>Update frequency</i> - 120 seconds and <i>BLE Scan Duration</i> - 60 Seconds, the 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.
|}
{{{BLE_Encryption|==BLE Serial Encryption==
<br>
[[Image:Aes encryption.png|right]]
If BLE Encryption Key is set, then device will communicate over BLE SPP (Serial Port Profile) with AES cipher mechanism. All incoming and outgoing data will be crypted with AES128 algorithm with entered key. Connected to the other side device must have similar encryption method and algorithm BLE Encryption Key is a 16 byte hex coded string, like 00112233445566778899AABBCCDDEEFF
Keep BLE Encryption Key blank to non crypted communications.
[[Image:BLE terminal ciphered.png|300px|right]]
This [https://wiki.teltonika-mobility.com/wikibase/images/b/b8/Simple_BLE_Terminal.zip Simple BLE Terminal] is for AES128 functionality testing as it has an Encryption Key option.
Set correct key in app settings.
<br>
<table style="border-collapse:collapse;border-spacing:0" class="tg">
<tr>
<td style="background-color:#0054A6;border-color:#0054A6;border-style:solid;border-width:1px;color:#ffffff;font-family:Arial, sans-serif;font-size:14px;font-weight:bold;overflow:hidden;padding:10px 5px;text-align:left;vertical-align:top;word-break:normal">NOTE!
</td>
<td style="background-color:#ffffff;border-color:#0054A6;border-style:solid;border-width:1px;color:#333333;font-family:Arial, sans-serif;font-size:14px;overflow:hidden;padding:10px 5px;text-align:left;vertical-align:top;word-break:normal">AES128 feature only available on the 55.01.06.Rev.00 FW or newer.</td>
</tr>
</table><br>
Detailed instructions on how to test <b>AES128 BLE Encryption Functionality</b> can be found in the following [https://wiki.teltonika-mobility.com/view/AES128_BLE_Encryption_testing link].
}}}
==BLE connectionless functionalities==
{| style="width: 100%"
|[[Image:BLE connectionless functionalities.png|right]]
Currently to the {{{model|X}}} device <b>up to 4 sensors can be connected</b>.
|}
When Advanced mode is selected a table with configurable parameters will appear.
[[Image:BLE connectionless functionalities advanced.png]]
*<b>Type</b> – 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.
*<b>Data Offset</b> – start index of data we are interested in.
*<b>Data Size</b> – size of the data we are interested in.
*<b>Action</b> – 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.
*<b>IO</b> – tells which IO element's data will be saved to.
*<b>Match</b> – hex string to be matched with BLE sensor data. Used only with Match action.
*<b>Endianness</b> – endianness of data: little endian (ex. 0x1122) or big endian (ex. 0x2211). Used only with Save action.
*<b>Multiplier</b> – value to be used to multiply output data. Used only with Save action.
*<b>Offset</b> – value to be added to output data. Used only with Save action.
How to correctly configure the <b>Bluetooth LE solutions</b>, can be found here:
*[[How to read data from TZ-BT04/05/05B sensor with TMT250 device | How to read data from TZ-BT04/05/05B sensor with Teltonika device]]
*[[How to read data from BLE Sensors]]
<br>
{{{model|X}}} offers Bluetooth 4.0 (Bluetooth Low Energy, also referred as BLE) functionality.
==Common settings==
{| style="width: 100%"
|[[Image:Bluetooth 4.0 common settings.png|right]]
* <b>Non Stop Scan</b> - Enabled Non Stop Scan feature, the device will try to scan for the sensors all the time if any of them are configured.
* <b>BLE Scan Start Period</b> - This parameter determines when the next BLE scan will start for Beacons and TZ sensors.
*<b>BLE Scan Duration</b> - Sensors data reading time.
*<b>Scan retries until error</b> - Configured scan retries, to show the Error Value '3000' - sensor disconnected.
*<b>BT power level</b> - The BT power level can be selected. Approximate range in meters:<br><code>1</code> - <0.5<br><code>2</code> - 0.5<br><code>3</code> - 11<br><code>4</code> - 13<br><code>5</code> - 15<br><code>6</code> - 27<br><code>7</code> - 50<br>
*<b>BLE broadcasting service ID</b> - When any ID is provided, the broadcasting is enabled.
*<b>BLE connection control</b> - if <code>Enabled</code>, the BLE connections are allowed.
*<b>Backup Tracker</b> - enabled or disabled Backup tracker scenario.
{| class="wikitable" style="border-style: solid; border-width: 0px;"
|+
|-
| style="width: auto; text-align: left; background: #F6F6FB;" | '''NOTE!'''
| style="width: auto; text-align: left; background: #F6F6FB;" | Backup Tracker feature only available on the FW 55.01.00 Rev 0 or newer.
|}
|}
===Configuration modes===
{| style="width: 100%"
[[Image:Bluetooth 4.0 common settings non stop scan.png|right]]
* If the Non Stop Scan is <b>Enabled</b>, the Non Stop sensor scans until any error will be hidden. Although BLE scan duration will still be active because it is important for btgetlist SMS command.
|}
{| style="width: 100%"
|[[Image:Bluetooth 4.0 common settings.png|right]]
* If Non Stop Scan <b>Disabled</b>, Scan period is selected manually.<br><br>
The Scan time period will be selected from two sources:
*<b>BLE Scan Duration</b> - the time when sensors are scanned,
*<b>Update frequency</b> - The time when the sensor information is packed as the AVL Data record.
For example, if <i>Update frequency</i> - 120 seconds and <i>BLE Scan Duration</i> - 60 Seconds, the 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.
|}
{{{BLE_Encryption|==BLE Serial Encryption==
<br>
[[Image:Aes encryption.png|right]]
If BLE Encryption Key is set, then device will communicate over BLE SPP (Serial Port Profile) with AES cipher mechanism. All incoming and outgoing data will be crypted with AES128 algorithm with entered key. Connected to the other side device must have similar encryption method and algorithm BLE Encryption Key is a 16 byte hex coded string, like 00112233445566778899AABBCCDDEEFF
Keep BLE Encryption Key blank to non crypted communications.
[[Image:BLE terminal ciphered.png|300px|right]]
This [https://wiki.teltonika-mobility.com/wikibase/images/b/b8/Simple_BLE_Terminal.zip Simple BLE Terminal] is for AES128 functionality testing as it has an Encryption Key option.
Set correct key in app settings.
<br>
<table style="border-collapse:collapse;border-spacing:0" class="tg">
<tr>
<td style="background-color:#0054A6;border-color:#0054A6;border-style:solid;border-width:1px;color:#ffffff;font-family:Arial, sans-serif;font-size:14px;font-weight:bold;overflow:hidden;padding:10px 5px;text-align:left;vertical-align:top;word-break:normal">NOTE!
</td>
<td style="background-color:#ffffff;border-color:#0054A6;border-style:solid;border-width:1px;color:#333333;font-family:Arial, sans-serif;font-size:14px;overflow:hidden;padding:10px 5px;text-align:left;vertical-align:top;word-break:normal">AES128 feature only available on the 55.01.06.Rev.00 FW or newer.</td>
</tr>
</table><br>
Detailed instructions on how to test <b>AES128 BLE Encryption Functionality</b> can be found in the following [https://wiki.teltonika-mobility.com/view/AES128_BLE_Encryption_testing link].
}}}
==BLE connectionless functionalities==
{| style="width: 100%"
|[[Image:BLE connectionless functionalities.png|right]]
Currently to the {{{model|X}}} device <b>up to 4 sensors can be connected</b>.
|}
When Advanced mode is selected a table with configurable parameters will appear.
[[Image:BLE connectionless functionalities advanced.png]]
*<b>Type</b> – 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.
*<b>Data Offset</b> – start index of data we are interested in.
*<b>Data Size</b> – size of the data we are interested in.
*<b>Action</b> – 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.
*<b>IO</b> – tells which IO element's data will be saved to.
*<b>Match</b> – hex string to be matched with BLE sensor data. Used only with Match action.
*<b>Endianness</b> – endianness of data: little endian (ex. 0x1122) or big endian (ex. 0x2211). Used only with Save action.
*<b>Multiplier</b> – value to be used to multiply output data. Used only with Save action.
*<b>Offset</b> – value to be added to output data. Used only with Save action.
How to correctly configure the <b>Bluetooth LE solutions</b>, can be found here:
*[[How to read data from TZ-BT04/05/05B sensor with TMT250 device | How to read data from TZ-BT04/05/05B sensor with Teltonika device]]
*[[How to read data from BLE Sensors]]
