Difference between revisions of "Template:FMM Bluetooth settings"
From Wiki Knowledge Base | Teltonika GPS
| (9 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
| + | ==Disclaimer== | ||
| + | |||
| + | [[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. | ||
| + | |||
| + | If you are using Bluetooth we strongly recommend '''using AES encryption''' for enhanced security. | ||
| + | |||
==General functionality== | ==General functionality== | ||
| − | [[Image: | + | [[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| | + | General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to {{{model|FMM1YX}}}.<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. | + | |
| − | * <span style=color:#F6A83E>Enable (hidden)</span> – Bluetooth functionality will be enabled, external devices will be able to connect to {{{model| | + | *<span style="color:#F6A83E">Disabled</span> – Bluetooth functionality will be disabled. |
| − | * <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| | + | *<span style="color:#F6A83E">Enable (hidden)</span> – Bluetooth functionality will be enabled, external devices will be able to connect to {{{model|FMM1YX}}}, but no devices will be able to detect it. |
| − | 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| | + | *<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|FMM1YX}}}.<br /> |
| − | * <span style=color:#F6A83E>Local Name</span> parameter lets user declare a visible name of {{{model| | + | |
| − | * <span style=color:#F6A83E>Local PIN</span> parameter lets user configure Bluetooth PIN of {{{model| | + | 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|FMM1YX}}} device. There are two different parameters: |
| + | |||
| + | *<span style="color:#F6A83E">Local Name</span> parameter lets user declare a visible name of {{{model|FMM1YX}}} to external devices.<br /> | ||
| + | *<span style="color:#F6A83E">Local PIN</span> parameter lets user configure Bluetooth PIN of {{{model|FMM1YX}}} device.<br /> | ||
| − | The {{{model| | + | The {{{model|FMM1YX}}} 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> |
<code>Device name + %imeiX</code><br><br> | <code>Device name + %imeiX</code><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 | + | 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> | <strong>Example:</strong><br> | ||
| − | If the configured Local Name parameter is " | + | If the configured Local Name parameter is "FMB_120_%imei7" and the IMEI of the device is 352093089520901, the name will be displayed as <strong>FMB_120_9520901</strong> (whether "_LE" is added at the end depends on whether the 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> | 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> | <strong>Example:</strong><br> | ||
| − | If the configured Local Name parameter is " | + | 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" | {| class="wikitable" style="border-style: solid; border-width: 0px" | ||
| − | |+ | + | |+ |
|- | |- | ||
| − | | style="text-align: left; background: #F6F6FB;" | + | | style="text-align: left; background: #F6F6FB;" |[[Image:Bw_nb.png|50px]] |
| − | | style="text-align: left; background: #F6F6FB;" | + | | style="text-align: left; background: #F6F6FB;" |The Composed Bluetooth name is supported from 03.25.05 firmware version. |
|} | |} | ||
| − | {{{model| | + | {{{model|FMM1YX}}} Bluetooth has several different ''Security Modes'': |
| − | * <span style=color:#F6A83E>PIN only</span> – only Local PIN will be reacquired to complete connection to {{{model| | + | |
| − | * <span style=color:#F6A83E>PIN + MAC list</span> – PIN and Authorized Devices MAC List will be checked against to allow connection to {{{model| | + | *<span style="color:#F6A83E">PIN only</span> – only Local PIN will be reacquired to complete connection to {{{model|FMM1YX}}}. |
| − | * <span style=color:#F6A83E>MAC list only</span> – only ''Authorized Devices MAC List'' will be checked when trying to connect to {{{model| | + | *<span style="color:#F6A83E">PIN + MAC list</span> – PIN and Authorized Devices MAC List will be checked against to allow connection to {{{model|FMM1YX}}}. If the external device MAC ID is in the list and correct ''Local PIN'' is entered then connection will be established, otherwise {{{model|FMM1YX}}} will reject connection. |
| − | * <span style=color:#F6A83E>None</span> – neither ''Local PIN'' nor ''Authorized Device MAC List'' will be checked. | + | *<span style="color:#F6A83E">MAC list only</span> – only ''Authorized Devices MAC List'' will be checked when trying to connect to {{{model|FMM1YX}}}. If external device MAC ID is in the list then connection will be established, otherwise {{{model|FMM1YX}}} 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== | ==Auto Connect to External Device== | ||
| − | [[Image: | + | [[Image:FMU_C_M_Auto_Connect_to_External_Device_v2.gif|{{{auto_connect|size}}}|right]] |
| − | Auto connection functionality configures {{{model| | + | Auto connection functionality configures {{{model|FMM1YX}}} as master device, which allows connecting {{{model|FMM1YX}}} to an external device. {{{model|FMM1YX}}} currently supports these modes: |
| − | * <span style=color:#F6A83E>None</span> – disables auto connection functionality. | + | |
| − | + | *<span style="color:#F6A83E">None</span> – disables auto connection functionality. | |
| − | * <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| | + | *<span style="color:#F6A83E">[[How to connect OBD II Bluetooth Dongle to FMB device|OBDII]]</span> – {{{model|FMM1YX}}} starts searching for an external OBD II Dongle. If {{{model|FMM1YX}}} finds a device which matches user defined ''External MAC'' or ''External Name'' then {{{model|FMM1YX}}} will try to pair with that external device. If the external device asks for PIN then {{{model|FMM1YX}}} will send user defined ''External PIN''. After successfully pairing {{{model|FMM1YX}}} will connect to paired device. |
| + | |||
| + | *<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|FMM1YX}}} 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|FMM1YX}}} 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|FMM1YX}}} 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;" | + | | style="text-align: left; background: #F6F6FB;" |[[Image:Bw_nb.png|50px]] |
| − | | style="text-align: left; background: #F6F6FB;" | + | | style="text-align: left; background: #F6F6FB;" |{{{model|FMM1YX}}} supports ONE connection at a time.<br />{{{model|FMM1YX}}} 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 | + | ''External Name'' parameter works as a substring, which allows users to enter a part of the full external device name. For example, if the external device name is "OBDDongle" and the user enters "OBD" in ''External Name'' parameter window, then {{{model|FMM1YX}}} will be allowed to connect to an external device named "OBDDongle". |
| + | |||
| + | ===Bluetooth solutions=== | ||
| − | + | *[[How to connect OBD II Bluetooth Dongle to FMB device|How to connect OBD II Bluetooth Dongle to {{{model|FMM1YX}}} device]] | |
| − | + | *[[Logging the FMB1YX device using your mobile phone|Logging the {{{model|FMM1YX}}} device using your mobile phone]] | |
| − | *[[How to connect OBD II | ||
| − | *[[Logging the FMB1YX device using your mobile phone|Logging the {{{model| | ||
Latest revision as of 07:04, 14 November 2023
Disclaimer
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
General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to FMM1YX.
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 FMM1YX, 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 FMM1YX.
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 FMM1YX device. There are two different parameters:
- Local Name parameter lets user declare a visible name of FMM1YX to external devices.
- Local PIN parameter lets user configure Bluetooth PIN of FMM1YX device.
The FMM1YX 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, the name will be displayed as FMB_120_9520901 (whether "_LE" is added at the end depends on whether the 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.
|
The Composed Bluetooth name is supported from 03.25.05 firmware version. |
FMM1YX Bluetooth has several different Security Modes:
- PIN only – only Local PIN will be reacquired to complete connection to FMM1YX.
- PIN + MAC list – PIN and Authorized Devices MAC List will be checked against to allow connection to FMM1YX. If the external device MAC ID is in the list and correct Local PIN is entered then connection will be established, otherwise FMM1YX will reject connection.
- MAC list only – only Authorized Devices MAC List will be checked when trying to connect to FMM1YX. If external device MAC ID is in the list then connection will be established, otherwise FMM1YX will reject connection.
- None – neither Local PIN nor Authorized Device MAC List will be checked.
Auto Connect to External Device
Auto connection functionality configures FMM1YX as master device, which allows connecting FMM1YX to an external device. FMM1YX currently supports these modes:
- None – disables auto connection functionality.
- OBDII – FMM1YX starts searching for an external OBD II Dongle. If FMM1YX finds a device which matches user defined External MAC or External Name then FMM1YX will try to pair with that external device. If the external device asks for PIN then FMM1YX will send user defined External PIN. After successfully pairing FMM1YX 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 – FMM1YX 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. FMM1YX 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 FMM1YX 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.
|
|
FMM1YX supports ONE connection at a time. FMM1YX 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 users to enter a part of the full external device name. For example, if the external device name is "OBDDongle" and the user enters "OBD" in External Name parameter window, then FMM1YX will be allowed to connect to an external device named "OBDDongle".
