0
edits
Changes
Template:Bluetooth settings (view source)
Revision as of 13:59, 24 March 2023
, 13:59, 24 March 2023Created page with "==General functionality== {| style="width: 100%" |right General functionality configures Bluetooth to work in slave mode. This mode allows any extern..."
==General functionality==
{| style="width: 100%"
|[[Image:FMB BT NAME.png|right]]
General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to {{{model|X}}}.
*<b>BT Radio</b> - allows enabling or disabling Bluetooth. There are three different settings:
**<code>Disabled</code> – Bluetooth functionality will be disabled.
**<code>Enable (hidden)</code> – Bluetooth functionality will be enabled, external devices will be able to connect to {{{model|X}}}, but no devices will be able to detect it.
**<code>Enable (visible)</code> – Bluetooth functionality will be enabled and any external device will be able to detect and connect to {{{model|X}}}.<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|X}}} device. There are two different parameters:
*<b>Local Name</b> - parameter lets user declare a visible name of {{{model|X}}} to external devices.<br />
*<b>Local PIN</b> - parameter lets user configure Bluetooth PIN of {{{model|X}}} device.<br />
The {{{model|X}}} 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: <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 Maximum value is 15.<br><br>
<strong>Example:</strong><br>
If the configured Local Name parameter is "{{{model|X}}}_%imei7" and the IMEI of the device is 352093089520901, name will be displayed as <strong>{{{model|X}}}_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>{{{model|X}}}_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>
If the configured Local Name parameter is "{{{model|X}}}_%ime7" devices name will be broadcasted as <strong>{{{model|X}}}_%ime7</strong> or if wrong X will be configured, for example "{{{model|X}}}_%imei20" devices name will broadcasted as <strong>{{{model|X}}}_%imei20</strong>.
*<b>Security Modes</b> - Connection mode:
**<code>PIN only</code> – only Local PIN will be reacquired to complete connection to {{{model|X}}}.
**<code>PIN + MAC list</code> – PIN and Authorized Devices MAC List will be checked against to allow connection to {{{model|X}}}. If the external device MAC ID is in the list and correct ''Local PIN'' is entered then connection will be established, otherwise {{{model|X}}} will reject connection.
**<code>MAC list only</code> – only ''Authorized Devices MAC List'' will be checked when trying to connect to {{{model|X}}}. If external device MAC ID is in the list then connection will be established, otherwise {{{model|X}}} will reject connection.
**<code>None</code> – neither ''Local PIN'' nor ''Authorized Device MAC List'' will be checked.
|}
==Auto Connect to External Device==
{| style="width: 100%"
|[[Image:{{{Auto_Connect_pic|Auto_Connect_To_External_Device.png}}}|right]]
Auto connection functionality configures {{{model|X}}} as master device, which allows connecting {{{model|X}}} to an external device. {{{model|X}}} currently supports these modes:
*<code>None</code> – disables auto connection functionality.
{{{txt_hide_tst-tft|
*<code>[[How to connect Bluetooth Hands Free adapter to FMB device|Hands Free]]</code> – {{{model|X}}} starts searching for an external hands free headset. If {{{model|X}}} finds a device which matches user defined ''External MAC'' or ''External Name'' then {{{model|X}}} will try to pair with that external device. If the external device asks for PIN then {{{model|X}}} will send user defined ''External PIN''. After successfully pairing {{{model|X}}} will connect to paired device.
}}}
*<code>Data Link</code> – BT Data link mode is enabled by Configurator ''Data Link'' parameter: when <span style="color:#F6A83E">Data Link</span> is configured and {{{model|FMB1YX}}} has a link with the server, paired device can send messages via Bluetooth SPP profile directly to the server. Messages will be encoded by [[Teltonika_data_sending/receiving_protocols#Codec_12|Codec12]].
{| 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;" |{{{model|X}}} supports ONE connection at a time.<br />{{{model|X}}} 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 {{{model|X}}} will be allowed to connect to an external device named "HandsFreeHeadset".
===Bluetooth solutions===
*[[How to debug {{{model|X}}} device over Android smartphone|Logging the TFT100 device using your mobile phone]]
{| style="width: 100%"
|[[Image:FMB BT NAME.png|right]]
General functionality configures Bluetooth to work in slave mode. This mode allows any external device to connect to {{{model|X}}}.
*<b>BT Radio</b> - allows enabling or disabling Bluetooth. There are three different settings:
**<code>Disabled</code> – Bluetooth functionality will be disabled.
**<code>Enable (hidden)</code> – Bluetooth functionality will be enabled, external devices will be able to connect to {{{model|X}}}, but no devices will be able to detect it.
**<code>Enable (visible)</code> – Bluetooth functionality will be enabled and any external device will be able to detect and connect to {{{model|X}}}.<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|X}}} device. There are two different parameters:
*<b>Local Name</b> - parameter lets user declare a visible name of {{{model|X}}} to external devices.<br />
*<b>Local PIN</b> - parameter lets user configure Bluetooth PIN of {{{model|X}}} device.<br />
The {{{model|X}}} 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: <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 Maximum value is 15.<br><br>
<strong>Example:</strong><br>
If the configured Local Name parameter is "{{{model|X}}}_%imei7" and the IMEI of the device is 352093089520901, name will be displayed as <strong>{{{model|X}}}_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>{{{model|X}}}_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>
If the configured Local Name parameter is "{{{model|X}}}_%ime7" devices name will be broadcasted as <strong>{{{model|X}}}_%ime7</strong> or if wrong X will be configured, for example "{{{model|X}}}_%imei20" devices name will broadcasted as <strong>{{{model|X}}}_%imei20</strong>.
*<b>Security Modes</b> - Connection mode:
**<code>PIN only</code> – only Local PIN will be reacquired to complete connection to {{{model|X}}}.
**<code>PIN + MAC list</code> – PIN and Authorized Devices MAC List will be checked against to allow connection to {{{model|X}}}. If the external device MAC ID is in the list and correct ''Local PIN'' is entered then connection will be established, otherwise {{{model|X}}} will reject connection.
**<code>MAC list only</code> – only ''Authorized Devices MAC List'' will be checked when trying to connect to {{{model|X}}}. If external device MAC ID is in the list then connection will be established, otherwise {{{model|X}}} will reject connection.
**<code>None</code> – neither ''Local PIN'' nor ''Authorized Device MAC List'' will be checked.
|}
==Auto Connect to External Device==
{| style="width: 100%"
|[[Image:{{{Auto_Connect_pic|Auto_Connect_To_External_Device.png}}}|right]]
Auto connection functionality configures {{{model|X}}} as master device, which allows connecting {{{model|X}}} to an external device. {{{model|X}}} currently supports these modes:
*<code>None</code> – disables auto connection functionality.
{{{txt_hide_tst-tft|
*<code>[[How to connect Bluetooth Hands Free adapter to FMB device|Hands Free]]</code> – {{{model|X}}} starts searching for an external hands free headset. If {{{model|X}}} finds a device which matches user defined ''External MAC'' or ''External Name'' then {{{model|X}}} will try to pair with that external device. If the external device asks for PIN then {{{model|X}}} will send user defined ''External PIN''. After successfully pairing {{{model|X}}} will connect to paired device.
}}}
*<code>Data Link</code> – BT Data link mode is enabled by Configurator ''Data Link'' parameter: when <span style="color:#F6A83E">Data Link</span> is configured and {{{model|FMB1YX}}} has a link with the server, paired device can send messages via Bluetooth SPP profile directly to the server. Messages will be encoded by [[Teltonika_data_sending/receiving_protocols#Codec_12|Codec12]].
{| 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;" |{{{model|X}}} supports ONE connection at a time.<br />{{{model|X}}} 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 {{{model|X}}} will be allowed to connect to an external device named "HandsFreeHeadset".
===Bluetooth solutions===
*[[How to debug {{{model|X}}} device over Android smartphone|Logging the TFT100 device using your mobile phone]]
