Wireless Manager

EMDK For Xamarin - 2.1

Overview

The WirelessMgr turns wireless radios On or Off, including Bluetooth, GPRS, NFC, etc.

Android devices often support a variety of wireless communication interfaces. These include bidirectional interfaces such Wireless Wide Area Network (WWAN/cellular data), Bluetooth, and Near Field Communications (NFC). They also include unidirectional (receive only) interfaces such as that of the Global Positioning System (GPS). Wireless radios that can transmit may significantly affect battery life if turned on unnecessarily, and also may need to be turned off in certain situations (e.g. when on an airplane or in "incendiary" environments).

The WirelessMgr can prevent the state of various wireless radios from being changed, thus providing a sort of "lock" that is untouchable by the device user.

Main Functionality

  • Turn selected wireless radios On or Off
    • Bluetooth
    • Near Field Communication (NFC)
    • Global Positioning System (GPS)
    • Wireless Wide Area Network (WWAN/cellular data)
  • Enable or Disable changing the state (on/off) of various wireless radios
    • Bluetooth

Enable/Disable Bluetooth

This parm will allow you to control whether the state (On/Off) of the Bluetooth radio can be changed.

Note: On JellyBean devices, this parm allows you to change the state of the Bluetooth radio by Turning it On or Off.

Parm Name: Bluetooth

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to be made as to whether the state of the Bluetooth radio can be changed.

OSX: 4.2+

MX: 4.2+

1 Enable This value will allow changes to be made to the state of the Bluetooth radio. On JellyBean devices, this will cause the Bluetooth radio to be Turned On.

OSX: 4.2+

MX: 4.2+

2 Disable This value will prevent changes from being made to the state of the Bluetooth radio. On JellyBean devices, this will cause the Bluetooth radio to be Turned Off.

OSX: 4.2+

MX: 4.2+

Turn On/Off Bluetooth

This parm allows you to change the state of the Bluetooth radio by Turning it On or Off. Turning the Bluetooth radio On would allow the device to connect to other to other Bluetooth devices that have previously been paired or would allow the setup of a new pairing.

Note: This parm is only available from KitKat onwards. It is not supported on JellyBean devices.

Parm Name: BluetoothState

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 state (On/Off) of the Bluetooth radio.

MX: 4.3+

Android API Level: 5+

1 Turn On This value will cause the Bluetooth radio to be Turned On.

MX: 4.3+

Android API Level: 5+

2 Turn Off This value will cause the Bluetooth radio to be Turned Off.

MX: 4.3+

Android API Level: 5+

Turn On/Off NFC

This parm allows you to change the state of the Near Field Communications (NFC) radio by Turning it On or Off. Turning the NFC radio On would allow the device to communicate with NFC tags by reading or writing them when they are in near proximity to the device.

Parm Name: NFCState

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to be made to the state (On/Off) of the NFC radio.

MX: 4.3+

Android API Level: 10+

1 Turn On This value will cause the NFC radio to be Turned On.

MX: 4.3+

Android API Level: 10+

2 Turn Off This value will cause the NFC radio to be Turned Off.

MX: 4.3+

Android API Level: 10+

Turn On/Off GPS

This parm allows you to change the state of the Global Positioning System (GPS) radio by Turning it On or Off. Turning the GPS radio On would allow the device to receive information from GPS satellites and thereby determine the position of the device.

Parm Name: GPSState

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to be made to the state (On/Off) of the GPS radio.

MX: 4.3+

Android API Level: 1+

1 Turn On This value will cause the GPS radio to be Turned On.

MX: 4.3+

Android API Level: 1+

2 Turn Off This value will cause the GPS radio to be Turned Off.

MX: 4.3+

Android API Level: 1+

Turn On/Off WWAN

This parm allows you to change the state of the Wireless Wide Area Network (WWAN) cellular radio by Turning it On or Off. Turning the WWAN radio On would allow the device to establish a cellular data connection and would also enable cellular voice connections, if supported.

Parm Name: WWANState

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to be made to the state (On/Off) of the WWAN radio.

OSX: 4.3+

MX: 4.3+

1 Turn On This value will cause the WWAN radio to be Turned On.

OSX: 4.3+

MX: 4.3+

2 Turn Off This value will cause the WWAN radio to be Turned Off.

OSX: 4.3+

MX: 4.3+

Examples

Enable Changes to be made to Bluetooth State

Note: In JellyBean devices, this XML will change the state of the Bluetooth radio by Turning it On.


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="Bluetooth" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Disable Changes from being made to Bluetooth State

Note: In JellyBean devices, this XML will change the state of the Bluetooth radio by Turning it Off.


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="Bluetooth" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Turn On All Radios (For JellyBean Devices)


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="Bluetooth" value="1"/>
        <parm name="NFCState" value="1"/>
        <parm name="GPSState" value="1"/>
        <parm name="WWANState" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Turn Off All Radios (For JellyBean Devices)


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="Bluetooth" value="2"/>
        <parm name="NFCState" value="2"/>
        <parm name="GPSState" value="2"/>
        <parm name="WWANState" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Turn On All Radios (For KitKat Devices)


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="BluetoothState" value="1"/>
        <parm name="NFCState" value="1"/>
        <parm name="GPSState" value="1"/>
        <parm name="WWANState" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Turn Off All Radios (For KitKat Devices)


<wap-provisioningdoc>
    <characteristic type="WirelessMgr" version="4.3" >
        <parm name="BluetoothState" value="2"/>
        <parm name="NFCState" value="2"/>
        <parm name="GPSState" value="2"/>
        <parm name="WWANState" value="2"/>
    </characteristic>
</wap-provisioningdoc>