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

From Wiki Knowledge Base | Teltonika GPS
m
(115 intermediate revisions by 17 users not shown)
Line 1: Line 1:
−
__TOC__
+
==General functionality==
  
−
==Disclaimer==
+
[[Image:Fmb120_bt_general.png|300px|right]]
 +
General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to FMB120.<br/>Parameter BT Radio allows user to select if he wants to enable or disable Bluetooth. There are three different scenarios:
 +
# Disabled – Bluetooth functionality will be disabled.
 +
# Enable (hidden) – Bluetooth functionality will be enabled, but none of external devices will be able to detect FMB120 but will be able to connect.
 +
# Enable (visible) – Bluetooth functionality will be enabled and any external device will be able to detect and connect to FMB120.
 +
# Local Name parameter lets user to declare visible name of FMB120 to external devices.
 +
# Local PIN parameter lets user to configure Bluetooth PIN of FMB120 device.
  
−
[[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.
+
FMB1YX Bluetooth has several different security modes:
 +
* PIN only – while external device trying to connect to FMB120 only Local PIN will be reacquired to complete connection.
 +
* PIN + MAC list – while external device trying to connect to FMB120 Local PIN and Authorized Devices MAC List will be checked. If external device MAC ID is in the list and correct Local PIN is entered then connection will be established, else FMB120 will reject connection.
 +
* MAC list only – while external device trying to connect to FMB120 only Authorized Devices MAC List will be checked. If external device MAC ID is in the list then connection will be established, else FMB120 will reject connection.
 +
* None – while external device trying to connect to FMB1YX neither Local PIN or Authorized Device MAC list will be checked.
 +
Auto Connection to External Device functionality
 +
Auto connection functionality configures FMB120 as master device, this allows FMB120 connect to external device. FMB1YX currently supports these modes:
 +
* None – disables auto connection functionality.
 +
* Hands Free – FMB120 starts to search external hands free headset. If FMB120 finds device which matches user defined Externar MAC or External Name then FMB120 will try to pair with that external device. If external device asks for PIN then FMB120 will send user defined External PIN. After successfull pairing FMB120 will connect to paired device.
 +
* OBDII – FMB120 starts to search external OBDII Bluetooth dongle. If FMB120 finds device which matches user defined Externar MAC or External Name then FMB120 will try to pair with that external device. If external device asks for PIN then FMB120 will send user defined External PIN. After successful pairing FMB120 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 server, paired device could send messages via Bluetooth SPP profile directly to server. Messages will be encoded by codec12.
  
−
If you are using Bluetooth® we strongly recommend '''using AES encryption''' for enhanced security.
+
{| class="wikitable" style="border-style: solid; border-width: 0px"
−
==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 then 10, with each scanning the list may change.
 +
|}
 +
 
 +
External Name parameter works as substring, this allows user to enter 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 external device named "HandsFreeHeadset".
 +
 
 +
==How to connect Bluetooth Hands Free adapter to FMB device==
 +
 
 +
===Bluetooth settings configuration===
 +
 
 +
[[Image:Fmb120_bt_settings.png|thumb|300px|right|Bluetooth settings]]
 +
[[Image:Fmb120_inc_call_action_settings.png|thumb|300px|right|Incoming Call Action settings under SMS\Call Settings]]
 +
 
 +
These are instructions how to easily prepare Bluetooth Hands Free device connection to FMB device. First we need to configure FMB device Bluetooth settings for proper connection to this hands-free unit. These are required steps:
 +
 
 +
* Press „Bluetooth“ settings (position 1).
 +
* Turn on BT Radio by pressing „Enable (visible)“ (position 2). “Local name” (position 3) automatically will be “FMB120_last 7 imei digits”, you can leave it or type your own name.
 +
* Set Security Mode (position 4) to “PIN only” or “None” (you could select “PIN + MAC list” or “MAC list only” security mode but in this case you need to type external device MAC address in “Authorized Devices MAC List” (position 7).
 +
* Set connection mode to “Hands Free” (position 5).
 +
* Set „External Name“ (position 6) as your Hands Free device name for proper device identification and connection to it. In this example Hands Free headset name is „DMH10“ 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 Hands Free adapter Bluetooth name by scanning nearby Bluetooth devices using mobile phone or computer with Bluetooth adapter.
 +
* Go to “SMS \ Call Settings” in left menu and set “Incoming Call Action” to “Do Nothing” visible on next figure.
 +
* After all these steps press „Save to device“ to save configuration.
 +
* Now you can disconnect FMB device from a configurator.
 +
 
 +
===Connecting Bluetooth Hands Free adapter===
 +
Hands Free device then turn on its Bluetooth connection for pairing following your model instructions1. Hands Free adapter should make a special sound in ear from speaker or its led identification should change to inform about successful connection. To check if adapter is successfully connected, call to FMB device, Hands Free device should start ringing. If you later restart FMB device it will automatically connect to this adapter.
 +
<br/><br/><br/><br/>
  
−
[[Image:FMB_Blue-tooth_settings.gif|{{{general|size}}}|right]]
+
==Device’s log using your mobile phone==
−
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:
 
  
−
*<span style="color:#F6A83E">Disabled</span> – Bluetooth® functionality will be disabled.
+
When FMB device starts, automatically Bluetooth is ON too. Take your mobile phone, go to settings>Bluetooth and turn it on. Scan for near by devices, find you device in list, distinguish device by last IMEI numbers on device module. Press pair, wait until device will ask to enter pairing password, type: 5555. Paired device will show up in paired device list. Now download from play store/app store terminal for Bluetooth. E.g BlueTerm. Run app, click find>connect to your paired device. Now we need to send command to FMB120 from Bluetooth terminal, type: ''.log:1''<br/>Device will respond Debug enabled and FMB1YX log will how up. Do not forget to start save log file to mobile phone.
−
*<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 />
 
  
−
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:
+
==Device debug over Android smartphone==
  
−
*<span style="color:#F6A83E">Local Name</span> parameter lets user declare a visible name of {{{model|FMB1YX}}} to external devices.<br />
+
[[Image:Fmb120_bt_general_vis.png|300px|right]]
−
*<span style="color:#F6A83E">Local PIN</span> parameter lets user configure Bluetooth® PIN of {{{model|FMB1YX}}} device.<br />
 
  
−
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>
+
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”.
−
<code>Device name + %imeiX</code><br><br>
+
<br/><br/><br/><br/><br/><br/><br/><br/><br/>
−
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>
 
  
−
<strong>Example:</strong><br>
+
[[Image:Android_bt.png|300px|right]]
−
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>
 
−
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>
 
  
−
<strong>Example:</strong><br>
+
* 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.
−
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>.
 
  
−
{| class="wikitable" style="border-style: solid; border-width: 0px"
+
<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/>
−
|+
 
−
|-
 
−
| style="text-align: left; background: #F6F6FB;" |[[Image:Bw_nb.png|50px]]
 
−
| style="text-align: left; background: #F6F6FB;" |The Composed Bluetooth® name is supported from 03.25.05 firmware version.
 
−
|}
 
  
 +
* Download “Bluetooth Terminal” application. You can use the following link: https://play.google.com/store/apps/details?id=com.hatflabs.btt
  
−
{{{model|FMB1YX}}} Bluetooth® has several different ''Security Modes'':
+
[[Image:Android_bt_serial.png|300px|right]]
  
−
*<span style="color:#F6A83E">PIN only</span> – only Local PIN will be reacquired to complete connection to {{{model|FMB1YX}}}.
+
* Run Bluetooth Terminal. In menu press “Connect” button and select paired FMB device. To start log check CR and enter the command in terminal: ''.log:1''.
−
*<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.
 
  
−
==Auto Connect to External Device==
+
* 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 button Share via Email and send them to the Teltonika support.
  
−
[[Image:Auto_Connect_to_External_Device.gif|{{{auto_connect|size}}}|right]]
+
<br/><br/>
−
Auto connection functionality configures {{{model|FMB1YX}}} as master device, which allows connecting {{{model|FMB1YX}}} to an external device. {{{model|FMB1YX}}} currently supports these modes:
 
  
−
*<span style="color:#F6A83E">None</span> – disables auto connection functionality.
+
<gallery widths=100px perrow=3 caption="Saving and sharing the log">
−
*<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.
+
Image:Android_bt_log1.png
 +
Image:Android_bt_log2.png
 +
Image:Android_bt_log3.png
 +
</gallery>
  
−
*<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]].
+
<br/><br/><br/><br/><br/>
−
*<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+''
 
−
*<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.
 
  
 
{| 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;" |{{{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.
+
| style="text-align: left; background: #F6F6FB;"         | Unfortunately it is not possible to do the same on iPhone, because there is no native SPP Bluetooth profile support in iPhone.
 
|}
 
|}
  
−
''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".
+
==How to connect OBD II Bluetooth Dongle to FMB device==
−
 
 
−
===Bluetooth® solutions===
 
−
 
 
−
*[[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]]
 

Revision as of 13:20, 11 April 2018

General functionality

Fmb120 bt general.png

General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to FMB120.
Parameter BT Radio allows user to select if he wants to enable or disable Bluetooth. There are three different scenarios:

  1. Disabled – Bluetooth functionality will be disabled.
  2. Enable (hidden) – Bluetooth functionality will be enabled, but none of external devices will be able to detect FMB120 but will be able to connect.
  3. Enable (visible) – Bluetooth functionality will be enabled and any external device will be able to detect and connect to FMB120.
  4. Local Name parameter lets user to declare visible name of FMB120 to external devices.
  5. Local PIN parameter lets user to configure Bluetooth PIN of FMB120 device.

FMB1YX Bluetooth has several different security modes:

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

Auto Connection to External Device functionality Auto connection functionality configures FMB120 as master device, this allows FMB120 connect to external device. FMB1YX currently supports these modes:

  • None – disables auto connection functionality.
  • Hands Free – FMB120 starts to search external hands free headset. If FMB120 finds device which matches user defined Externar MAC or External Name then FMB120 will try to pair with that external device. If external device asks for PIN then FMB120 will send user defined External PIN. After successfull pairing FMB120 will connect to paired device.
  • OBDII – FMB120 starts to search external OBDII Bluetooth dongle. If FMB120 finds device which matches user defined Externar MAC or External Name then FMB120 will try to pair with that external device. If external device asks for PIN then FMB120 will send user defined External PIN. After successful pairing FMB120 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 server, paired device could send messages via Bluetooth SPP profile directly to server. Messages will be encoded by codec12.
Bw nb.png FMB120 supports ONE connection at a time.
FMB001 can see up to 10 available devices. If there are more then 10, with each scanning the list may change.

External Name parameter works as substring, this allows user to enter 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 external device named "HandsFreeHeadset".

How to connect Bluetooth Hands Free adapter to FMB device

Bluetooth settings configuration

Bluetooth settings
Incoming Call Action settings under SMS\Call Settings

These are instructions how to easily prepare Bluetooth Hands Free device connection to FMB device. First we need to configure FMB device Bluetooth settings for proper connection to this hands-free unit. These are required steps:

  • Press „Bluetooth“ settings (position 1).
  • Turn on BT Radio by pressing „Enable (visible)“ (position 2). “Local name” (position 3) automatically will be “FMB120_last 7 imei digits”, you can leave it or type your own name.
  • Set Security Mode (position 4) to “PIN only” or “None” (you could select “PIN + MAC list” or “MAC list only” security mode but in this case you need to type external device MAC address in “Authorized Devices MAC List” (position 7).
  • Set connection mode to “Hands Free” (position 5).
  • Set „External Name“ (position 6) as your Hands Free device name for proper device identification and connection to it. In this example Hands Free headset name is „DMH10“ 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 Hands Free adapter Bluetooth name by scanning nearby Bluetooth devices using mobile phone or computer with Bluetooth adapter.
  • Go to “SMS \ Call Settings” in left menu and set “Incoming Call Action” to “Do Nothing” visible on next figure.
  • After all these steps press „Save to device“ to save configuration.
  • Now you can disconnect FMB device from a configurator.

Connecting Bluetooth Hands Free adapter

Hands Free device then turn on its Bluetooth connection for pairing following your model instructions1. Hands Free adapter should make a special sound in ear from speaker or its led identification should change to inform about successful connection. To check if adapter is successfully connected, call to FMB device, Hands Free device should start ringing. If you later restart FMB device it will automatically connect to this adapter.



Device’s log using your mobile phone

When FMB device starts, automatically Bluetooth is ON too. Take your mobile phone, go to settings>Bluetooth and turn it on. Scan for near by devices, find you device in list, distinguish device by last IMEI numbers on device module. Press pair, wait until device will ask to enter pairing password, type: 5555. Paired device will show up in paired device list. Now download from play store/app store terminal for Bluetooth. E.g BlueTerm. Run app, click find>connect to your paired device. Now we need to send command to FMB120 from Bluetooth terminal, type: .log:1
Device will respond Debug enabled and FMB1YX log will how up. Do not forget to start save log file to mobile phone.

Device debug over Android smartphone

Fmb120 bt general vis.png

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:
getparam 800
The answer has to be 2, which means “Enabled and visible”.








Android bt.png
  • Scan for visible BT devices using your Android smartphone and connect to your FMB device.
    Default FMB BT name: MB1YX_last_7_imei_digits.
    Default PIN code: 5555.


























Android bt serial.png
  • Run Bluetooth Terminal. In menu press “Connect” button and select paired FMB device. To start log check CR and enter the command in terminal: .log:1.
  • 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 button Share via Email and send them to the Teltonika support.



  • Saving and sharing the log
  • Android bt log1.png
  • Android bt log2.png
  • Android bt log3.png






Bw nb.png Unfortunately it is not possible to do the same on iPhone, because there is no native SPP Bluetooth profile support in iPhone.

How to connect OBD II Bluetooth Dongle to FMB device

Retrieved from "https://wiki.teltonika-gps.com/index.php?title=Template:FMB_Blue-tooth_settings&oldid=7153"