Bluetooth Manager

EMDK For Xamarin - 2.5

Overview

BluetoothMgr controls whether a device can pair with other Bluetooth devices such as headsets and printers that come into range, and whether the device can be "discoverable," which would enable other Bluetooth devices to initiate pairing requests with it.

Bluetooth is a short-range wireless technology operating in the 2.4 GHz ISM band that was originally intended as a replacement for serial communications cables. It has since been adopted as a standard for hands-free headsets, stereo audio, networking to PCs and connections for barcode scanners, medical equipment and other devices formerly using RS-232.

Main Functionality

  • Enable/Disable Bluetooth Pairing
  • Enable/Disable Bluetooth Discoverability

Pairing Enable/Disable

Controls whether the device will be permitted to pair with newly discovered Bluetooth devices that come into range. The settings of this parameter do not effect existing device pairings.

Parm Name: AllowPairing

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to the device's ability to pair with discovered Bluetooth devices; any previously selected setting will be retained.

MX: 5.1+

Android API Level: 22+

1 Enable Enables the device to pair with newly discovered Bluetooth devices.

MX: 5.1+

Android API Level: 22+

2 Disable Disables pairing with newly discovered Bluetooth devices.

MX: 5.1+

Android API Level: 22+

Discoverability Enable/Disable

Controls whether the device can be put into "discoverable" mode by the device user. When in this mode, the device can be discovered by other Bluetooth devices, which could then attempt to pair with it. This parameter has no effect on the device's own ability to discover other devices, to initiate pairing requests with them, or to reconnect with devices it had paired with previously.

Parm Name: AllowDiscoverability

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to the device's ability to be discoverable by other Bluetooth devices; any previously selected setting will be retained.

MX: 6.1+

Android API Level: 22+

1 Enable Enables the user to set the device as "discoverable" by other Bluetooth devices.

MX: 6.1+

Android API Level: 22+

2 Disable Prevents the user from setting the device as discoverable by other Bluetooth devices.

MX: 6.1+

Android API Level: 22+

Examples

Allow New Pairing

Input


<wap-provisioningdoc>
    <characteristic type="BluetoothMgr" version="5.0">
        <parm name="AllowPairing" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BluetoothMgr" version="5.0">
        <parm name="AllowPairing" value="1"/>
    </characteristic>
</wap-provisioningdoc>

If the operation was successful, the Result XML (output) will be identical to the input XML.

Disallow New Pairing

Input


<wap-provisioningdoc>
    <characteristic type="BluetoothMgr" version="5.0">
        <parm name="AllowPairing" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BluetoothMgr" version="5.0">
        <parm name="AllowPairing" value="2"/>
    </characteristic>
</wap-provisioningdoc>

If the operation was successful, the Result XML (output) will be identical to the input XML.