Difference between revisions of "Template:FMB Blue-tooth settings"

From Wiki Knowledge Base | Teltonika GPS
 
(86 intermediate revisions by 17 users not shown)
Line 1: Line 1:
==General functionality==
+
__TOC__
  
[[Image:Fmb120_bt_general.png|300px|right]]
+
==Disclaimer==
General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to FMB120.<br/>Parameter ''BT Radio'' allows enabling or disabling Bluetooth. There are three different scenarios:
 
# <span style=color:#F6A83E>Disabled</span> – Bluetooth functionality will be disabled.
 
# <span style=color:#F6A83E>Enable (hidden)</span> – Bluetooth functionality will be enabled, external devices will be able to connect to FMB120, but no devices will be able to detect it.
 
# <span style=color:#F6A83E>Enable (visible)</span> – Bluetooth functionality will be enabled and any external device will be able to detect and connect to FMB120.<br/>''Local Name'' parameter lets user to declare visible name of FMB120 to external devices.<br/>''Local PIN'' parameter lets user to configure Bluetooth PIN of FMB120 device.<br/>
 
FMB120 Bluetooth has several different ''Security Modes':
 
* <span style=color:#F6A83E>PIN only</span> – only Local PIN will be reacquired to complete connection to FMB120.
 
* <span style=color:#F6A83E>PIN + MAC list</span> – PIN and Authorized Devices MAC List will be checked against to allow connection to FMB120. If the external device MAC ID is in the list and correct ''Local PIN'' is entered then connection will be established, otherwise FMB120 will reject connection.
 
* <span style=color:#F6A83E>MAC list only</span> – only ''Authorized Devices MAC List'' will be checked when trying to connect to FMB120. If external device MAC ID is in the list then connection will be established, otherwise FMB120 will reject connection.
 
* <span style=color:#F6A83E>None</span> – neither ''Local PIN'' nor ''Authorized Device MAC List'' will be checked.
 
  
Auto connection functionality configures FMB120 as master device, which allows connecting FMB120 to an external device. FMB120 currently supports these modes:
+
[[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.
* <span style=color:#F6A83E>None</span> – disables auto connection functionality.
 
* <span style=color:#F6A83E>Hands Free</span> or <span style=color:#F6A83E>OBDII</span> – FMB120 starts searching for an external hands free headset. If FMB120 finds a device which matches user defined ''External MAC'' or ''External Name'' then FMB120 will try to pair with that external device. If the external device asks for PIN then FMB120 will send user defined ''External PIN''. After successfully pairing FMB120 will connect to paired device.
 
* <span style=color:#F6A83E>Data Link</span> – BT Data link mode is enabled by Configurator ''Data Link'' parameter: when ''Data Link'' is configured and FMB has a link with the server, paired device can send messages via Bluetooth SPP profile directly to the server. Messages will be encoded by codec12.
 
  
{| class="wikitable" style="border-style: solid; border-width: 0px"
+
If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security.
|+
+
==General functionality==
|-
 
| style="text-align: left; background: #F6F6FB;"        | [[Image:Bw_nb.png|50px]]
 
| style="text-align: left; background: #F6F6FB;"        | FMB120 supports ONE connection at a time.<br/>FMB001 can see up to 10 available devices. If there are more than 10 devices, the list may change with each new scan.
 
|}
 
  
''External Name'' parameter works as a substring, which allows user to enter a part of the full external device name. For example, if external device name is "HandsFreeHeadset" and user enters "HandsFree" in External Name parameter window, then FMB120 will be allowed to connect to an external device named "HandsFreeHeadset".
+
[[Image:FMB_Blue-tooth_settings.gif|{{{general|size}}}|right]]
 +
General functionality configures Bluetooth® to work in slave mode. This mode allows any external device to connect to {{{model|FMB1YX}}}.<br />Parameter ''BT Radio'' allows enabling or disabling Bluetooth®. There are three different settings:
  
==How to connect Bluetooth Hands Free adapter to FMB device==
+
*<span style="color:#F6A83E">Disabled</span> – Bluetooth® functionality will be disabled.
 +
*<span style="color:#F6A83E">Enable (hidden)</span> – Bluetooth® functionality will be enabled, external devices will be able to connect to {{{model|FMB1YX}}}, but no devices will be able to detect it.
 +
*<span style="color:#F6A83E">Enable (visible)</span> – Bluetooth® functionality will be enabled and any external device will be able to detect and connect to {{{model|FMB1YX}}}.<br />
  
[[Image:Fmb120_bt_settings.png|thumb|300px|right|Bluetooth settings]]
+
It is possible to configure the Local name of the device, as well as the Local PIN, which will be used when trying to pair with the {{{model|FMB1YX}}} device. There are two different parameters:
[[Image:Fmb120_inc_call_action_settings.png|thumb|300px|right|Incoming Call Action settings under SMS\Call Settings]]
 
===Bluetooth settings configuration===
 
  
These are instructions on how to easily create a connection between a Bluetooth Hands Free device and an FMB device. First the FMB device Bluetooth settings need to be configured. These are the required steps:
+
*<span style="color:#F6A83E">Local Name</span> parameter lets user declare a visible name of {{{model|FMB1YX}}} to external devices.<br />
 +
*<span style="color:#F6A83E">Local PIN</span> parameter lets user configure Bluetooth® PIN of {{{model|FMB1YX}}} device.<br />
  
* Press <span style=color:#F6A83E>Bluetooth</span> settings (position 1).
+
The {{{model|FMB1YX}}} supports composed Bluetooth® Local names, which allows the user to have a predefined number of IMEI digits at the end of the device name. The format of the composed Bluetooth® name looks like this:<br><br>
* Turn on BT Radio by pressing <span style=color:#F6A83E>Enable (visible)</span> (position 2). ''Local name'' (position 3) will be "FMB120_last 7 imei digits" by default, which can be changed.
+
<code>Device name + %imeiX</code><br><br>
* Set Security Mode (position 4) to <span style=color:#F6A83E>PIN only</span> or <span style=color:#F6A83E>None</span>. <span style=color:#F6A83E>PIN + MAC list</span> or <span style=color:#F6A83E>MAC list only</span> security modes could also be selected, but in that case external device MAC address is required to be entered to ''Authorized Devices MAC List'' (position 7).
+
X - how many digits will be taken from IMEI to show in Local name, digits will be taken from the end of IMEI. Minimum value of X is 1 and the Maximum value is 15.<br><br>
* Set connection mode to <span style=color:#F6A83E>Hands Free</span> (position 5).
 
* Set ''External Name'' (position 6) as your Hands Free device name for proper identification. In the given example Hands Free headset name is "DMH10" but at least 2 characters are required to recognize it and connect to it. For better and quicker adapter identification on the network you could enter a full device name. You could check your Hands Free adapter Bluetooth name by scanning nearby Bluetooth devices using mobile phone or computer with Bluetooth adapter.
 
* Go to <span style=color:#F6A83E>SMS/Call Settings</span> in main menu and set ''Incoming Call Action'' to <span style=color:#F6A83E>Do Nothing</span> as shown on next figure.
 
* After all these steps press <span style=color:#F6A83E>Save to device</span> to save configuration.
 
* Now FMB device can be disconnected from the configurator.
 
<br/><br/><br/><br/><br/><br/><br/>
 
  
===Connecting Bluetooth Hands Free adapter===
+
<strong>Example:</strong><br>
----
+
If the configured Local Name parameter is "FMB_120_%imei7" and the IMEI of the device is 352093089520901, name will be displayed as <strong>FMB_120_9520901</strong> (whether "_LE" is added at the end depends on whether device supports BLE or not. The full name of the device, which supports BLE would be <strong>FMB_120_9520901_LE</strong>).<br>
Turn on Hands Free device and then turn on its Bluetooth connection for pairing following your model instructions. Hands Free adapter should make a specific sound in the speakers or its LED identification should inform about a successful connection. To check if the adapter is successfully connected, dial the FMB device phone number and the Hands Free device should start ringing. If you later restart FMB device it will automatically reconnect to this adapter.
+
If the Local Name is written incorrectly, the Bluetooth® name of the device will be broadcasted as it is. An example can be seen below.<br><br>
<br/><br/><br/><br/>
 
  
==Logging the FMB120 device using your mobile phone==
+
<strong>Example:</strong><br>
 +
If the configured Local Name parameter is "FMB_120_%ime7" devices name will be broadcasted as <strong>FMB_120_%ime7</strong> or if wrong X will be configured, for example "FMB_120_%imei20" devices name will broadcasted as <strong>FMB_120_%imei20</strong>.
  
Bluetooth starts automatically when the FMB device is on. Take your mobile phone, go to Settings->Bluetooth and turn it on. Scan for nearby devices, find the device in list, distinguish the device by last IMEI digits on device module. Press pair, wait until device will ask to enter pairing password, type: ''"5555"'' (as in the example on the figure). Paired device will show up in the paired device list. Download  a terminal for Bluetooth e.g. BlueTerm from Play Store/App store. Run app, click Find->Connect to your paired device. Now we need to send a command to FMB120 from Bluetooth terminal, type: ''".log:1"''<br/>Device will respond with ''"Debug enabled"'' and FMB120 log will show up. Do not forget to save the log file to mobile phone.
+
{| class="wikitable" style="border-style: solid; border-width: 0px"
 
+
|+
==Device debug over Android smartphone==
+
|-
 
+
| style="text-align: left; background: #F6F6FB;" |[[Image:Bw_nb.png|50px]]
[[Image:Fmb120_bt_general_vis.png|300px|right]]
+
| style="text-align: left; background: #F6F6FB;" |The Composed Bluetooth® name is supported from 03.25.05 firmware version.
 +
|}
  
In order to pair FMB device with Android smartphone, make sure that BT radio is enabled (visible) in device configuration. It can be checked via SMS command too:<br/>''"getparam 800"''<br/>The answer has to be ''"2"'', which means ''Enabled and visible''.
 
<br/><br/><br/><br/><br/><br/><br/><br/><br/>
 
  
[[Image:Android_bt.png|300px|right]]
+
{{{model|FMB1YX}}} Bluetooth® has several different ''Security Modes'':
  
* Scan for visible BT devices using your Android smartphone and connect to your FMB device.<br/>Default FMB BT name: ''"MB1YX_last_7_imei_digits"''.<br/>Default PIN code: ''"5555"''.
+
*<span style="color:#F6A83E">PIN only</span> – only Local PIN will be reacquired to complete connection to {{{model|FMB1YX}}}.
 +
*<span style="color:#F6A83E">PIN + MAC list</span> – PIN and Authorized Devices MAC List will be checked against to allow connection to {{{model|FMB1YX}}}. If the external device MAC ID is in the list and correct ''Local PIN'' is entered then connection will be established, otherwise {{{model|FMB1YX}}} will reject connection.
 +
*<span style="color:#F6A83E">MAC list only</span> – only ''Authorized Devices MAC List'' will be checked when trying to connect to {{{model|FMB1YX}}}. If external device MAC ID is in the list then connection will be established, otherwise {{{model|FMB1YX}}} will reject connection.
 +
*<span style="color:#F6A83E">None</span> – neither ''Local PIN'' nor ''Authorized Device MAC List'' will be checked.
  
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
+
==Auto Connect to External Device==
  
* Download "Bluetooth Terminal" application. Following link can be used: https://play.google.com/store/apps/details?id=com.hatflabs.btt
+
[[Image:Auto_Connect_to_External_Device.gif|{{{auto_connect|size}}}|right]]
 +
Auto connection functionality configures {{{model|FMB1YX}}} as master device, which allows connecting {{{model|FMB1YX}}} to an external device. {{{model|FMB1YX}}} currently supports these modes:
  
[[Image:Android_bt_serial.png|300px|right]]
+
*<span style="color:#F6A83E">None</span> – disables auto connection functionality.
 +
*<span style="color:#F6A83E">[[How to connect Bluetooth® Hands Free adapter to FMB device|Hands Free]]</span> or <span style="color:#F6A83E">[[How to connect OBD II Bluetooth® Dongle to FMB device|OBDII]]</span> – {{{model|FMB1YX}}} starts searching for an external hands free headset or OBD II Dongle. If {{{model|FMB1YX}}} finds a device which matches user defined ''External MAC'' or ''External Name'' then FMB1YX will try to pair with that external device. If the external device asks for PIN then {{{model|FMB1YX}}} will send user defined ''External PIN''. After successfully pairing {{{model|FMB1YX}}} will connect to paired device.
  
* Run "Bluetooth Terminal", in menu press "Connect" and select paired FMB device. To start log check "CR" and enter the command in terminal: ''".log:1"''.
+
*<span style="color:#F6A83E">Data Link</span> – BT Data link mode is enabled by Configurator ''Data Link'' parameter: when <span style="color:#F6A83E">Data Link</span> is configured and {{{model_2|FMB}}} has a link with the server, paired device can send messages via Bluetooth® SPP profile directly to the server. Messages will be encoded by [[Codec#Codec 12|Codec12]].
 
+
*<span style="color:#F6A83E">Inateck Scanner</span> – {{{model|FMB1YX}}} automatically connects to Inateck BT Barcode Scanner BCST-70 and will be ready to receive data (coded in barcode). ''Scanner must be configured for using “ENTER” as suffix.'' {{{model|FMB1YX}}} supports online and inventory mode. A new record will be generated on every data portion received from scanner via SPP. Data will be stored with AVL ID 264, variable data length, max length is 32 bytes. '''''Note:''''' ''Added from FW version 03.16.00.Rev.00+''
* Wait ~10 minutes and press "Save" button in menu. You will find saved log file in device folder (My Files/Bluetooth Terminal), select log files and press "Share via Email" and send them to Teltonika support.
+
*<span style="color:#F6A83E">User ID</span>  - This mode makes {{{model|FMB1YX}}} connect automatically to a device and stores its BT MAC address in I/O element ''User ID'' (I/O ID: 50520). This is used for driver authentication. If there‘s no connection, the I/O element value is set to 0.
 
 
<br/><br/>
 
 
 
<gallery widths=100px perrow=3 caption="Saving and sharing the log">
 
Image:Android_bt_log1.png
 
Image:Android_bt_log2.png
 
Image:Android_bt_log3.png
 
</gallery>
 
 
 
<br/><br/><br/><br/><br/>
 
  
 
{| class="wikitable" style="border-style: solid; border-width: 0px"
 
{| class="wikitable" style="border-style: solid; border-width: 0px"
|+  
+
|+
 
|-
 
|-
| style="text-align: left; background: #F6F6FB;"         | [[Image:Bw_nb.png|50px]]
+
| style="text-align: left; background: #F6F6FB;" |[[Image:Bw_nb.png|50px]]
| style="text-align: left; background: #F6F6FB;"         | Unfortunately it is not possible to perform debug the same way on iPhone, because there is no native SPP Bluetooth profile support on iPhone.
+
| style="text-align: left; background: #F6F6FB;" |{{{model|FMB1YX}}} supports ONE connection at a time.<br />{{{model|FMB1YX}}} can see up to 10 available devices. If there are more than 10 devices, the list may change with each new scan.
 
|}
 
|}
  
==How to connect OBD II Bluetooth Dongle to FMB device==
+
''External Name'' parameter works as a substring, which allows user to enter a part of the full external device name. For example, if external device name is "HandsFreeHeadset" and user enters "HandsFree" in ''External Name'' parameter window, then {{{model|FMB1YX}}} will be allowed to connect to an external device named "HandsFreeHeadset".
===Bluetooth settings configuration===
 
 
 
[[Image:Fmb120_bt_odbii_settings.png|300px|right]]
 
These are instructions on how to easily prepare Bluetooth Dongle connection to the FMB device. First we need to configure FMB device Bluetooth settings. These are the required steps:
 
* Go to <span style=color:#F6A83E>Bluetooth</span> section similarly to as shown in the figure to the right (position 1).
 
* Turn on BT Radio by pressing <span style=color:#F6A83E>Enable (visible)</span> (position 2). "Local name" (position 3) will automatically be "FMB120_last 7 imei digits", you can leave it or type your own name.
 
* Set ''Security Mode'' (position 4) to <span style=color:#F6A83E>PIN only</span> or <span style=color:#F6A83E>None</span> (you could select <span style=color:#F6A83E>PIN + MAC list</span> or <span style=color:#F6A83E>MAC list only</span> security mode but in this case you need to type external device MAC address in <span style=color:#F6A83E>Authorized Devices MAC List</span> (position 7).
 
* Set connection mode to <span style=color:#F6A83E>OBDII</span> (position 5).
 
* Set <span style=color:#F6A83E>External Name</span> as your Bluetooth OBD II device name for proper device identification and connection to it. In this example OBD II device name is "DONGLE" but at least 2 characters are needed to recognize it and connect to it. For better and faster adapter identification in network you could enter a full device name. You could check your OBD II adapter Bluetooth name by scanning nearby Bluetooth devices using mobile phone or computer with Bluetooth adapter.
 
* Go to <span style=color:#F6A83E>OBD II (Bluetooth)</span> in main menu and select priority and others parameters visible in the following figure.
 
 
 
[[Image:Fmb120_odbii_settings.png|800px|center]]
 
 
 
* After all these steps press <span style=color:#F6A83E>Save to device</span> to save configuration (position 8 in the top right hand figure).
 
* Now you can disconnect FMB device from the configurator.
 
 
 
===Connecting to Bluetooth OBD II dongle===
 
----
 
After this configuration you can connect your OBD II dongle to FMB device. Turn on ignition, then turn on its Bluetooth connection. For pairing follow your dongle instructions. OBDII device notification about paired Bluetooth connection depends on the specific model. If you later restart FMB device it will automatically reconnect to this dongle.
 
  
===Supported Bluetooth OBD II dongles===
+
===Bluetooth® solutions===
----
 
FMB module works with Bluetooth OBD II dongles which are based on ELM327 or STN1110 chips.<br/>Comparison of these chips is presented in the image below:
 
  
[[Image:Elm317_stn1110_comp.png|400px|center]]
+
*[[How to connect Bluetooth® Hands Free adapter to FMB device|How to connect Bluetooth® Hands Free adapter to {{{model|FMB1YX}}} device]]
 +
*[[How to connect OBD II Bluetooth® Dongle to FMB device|How to connect OBD II Bluetooth® Dongle to {{{model|FMB1YX}}} device]]
 +
*[[Logging the FMB1YX device using your mobile phone|Logging the {{{model|FMB1YX}}} device using your mobile phone]]

Latest revision as of 09:42, 27 December 2023

Disclaimer

Alert.png


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.

General functionality

size

General functionality configures Bluetooth® to work in slave mode. This mode allows any external device to connect to FMB1YX.
Parameter BT Radio allows enabling or disabling Bluetooth®. There are three different settings:

  • Disabled – Bluetooth® functionality will be disabled.
  • Enable (hidden) – Bluetooth® functionality will be enabled, external devices will be able to connect to FMB1YX, but no devices will be able to detect it.
  • Enable (visible) – Bluetooth® functionality will be enabled and any external device will be able to detect and connect to FMB1YX.

It is possible to configure the Local name of the device, as well as the Local PIN, which will be used when trying to pair with the FMB1YX device. There are two different parameters:

  • Local Name parameter lets user declare a visible name of FMB1YX to external devices.
  • Local PIN parameter lets user configure Bluetooth® PIN of FMB1YX device.

The FMB1YX supports composed Bluetooth® Local names, which allows the user to have a predefined number of IMEI digits at the end of the device name. The format of the composed Bluetooth® name looks like this:

Device name + %imeiX

X - how many digits will be taken from IMEI to show in Local name, digits will be taken from the end of IMEI. Minimum value of X is 1 and the Maximum value is 15.

Example:
If the configured Local Name parameter is "FMB_120_%imei7" and the IMEI of the device is 352093089520901, name will be displayed as FMB_120_9520901 (whether "_LE" is added at the end depends on whether device supports BLE or not. The full name of the device, which supports BLE would be FMB_120_9520901_LE).
If the Local Name is written incorrectly, the Bluetooth® name of the device will be broadcasted as it is. An example can be seen below.

Example:
If the configured Local Name parameter is "FMB_120_%ime7" devices name will be broadcasted as FMB_120_%ime7 or if wrong X will be configured, for example "FMB_120_%imei20" devices name will broadcasted as FMB_120_%imei20.

Bw nb.png The Composed Bluetooth® name is supported from 03.25.05 firmware version.


FMB1YX Bluetooth® has several different Security Modes:

  • PIN only – only Local PIN will be reacquired to complete connection to FMB1YX.
  • PIN + MAC list – PIN and Authorized Devices MAC List will be checked against to allow connection to FMB1YX. If the external device MAC ID is in the list and correct Local PIN is entered then connection will be established, otherwise FMB1YX will reject connection.
  • MAC list only – only Authorized Devices MAC List will be checked when trying to connect to FMB1YX. If external device MAC ID is in the list then connection will be established, otherwise FMB1YX will reject connection.
  • None – neither Local PIN nor Authorized Device MAC List will be checked.

Auto Connect to External Device

size

Auto connection functionality configures FMB1YX as master device, which allows connecting FMB1YX to an external device. FMB1YX currently supports these modes:

  • None – disables auto connection functionality.
  • Hands Free or OBDII – FMB1YX starts searching for an external hands free headset or OBD II Dongle. If FMB1YX finds a device which matches user defined External MAC or External Name then FMB1YX will try to pair with that external device. If the external device asks for PIN then FMB1YX will send user defined External PIN. After successfully pairing FMB1YX will connect to paired device.
  • Data Link – BT Data link mode is enabled by Configurator Data Link parameter: when Data Link is configured and FMB has a link with the server, paired device can send messages via Bluetooth® SPP profile directly to the server. Messages will be encoded by Codec12.
  • Inateck Scanner – FMB1YX automatically connects to Inateck BT Barcode Scanner BCST-70 and will be ready to receive data (coded in barcode). Scanner must be configured for using “ENTER” as suffix. FMB1YX supports online and inventory mode. A new record will be generated on every data portion received from scanner via SPP. Data will be stored with AVL ID 264, variable data length, max length is 32 bytes. Note: Added from FW version 03.16.00.Rev.00+
  • User ID  - This mode makes FMB1YX connect automatically to a device and stores its BT MAC address in I/O element User ID (I/O ID: 50520). This is used for driver authentication. If there‘s no connection, the I/O element value is set to 0.
Bw nb.png FMB1YX supports ONE connection at a time.
FMB1YX can see up to 10 available devices. If there are more than 10 devices, the list may change with each new scan.

External Name parameter works as a substring, which allows user to enter a part of the full external device name. For example, if external device name is "HandsFreeHeadset" and user enters "HandsFree" in External Name parameter window, then FMB1YX will be allowed to connect to an external device named "HandsFreeHeadset".

Bluetooth® solutions