Wireless Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

EMDK For Xamarin - 2.7

Overview

The Wireless Manager (WirelessMgr) controls usage of all radios on the device, which varies by device and can include Bluetooth, GPS, NFC and WWAN radios. Through control of device radios, the WirelessMgr permits administrators to prevent device users from accessing any of a given radio's functions or those of the devices or networks they connect with, providing a measure of security that is impenetrable by the device user.

The WirelessMgr also can control the GPS Location Mode to help preserve battery life, and on some devices the state (active/inactive) of the Bluetooth radio.

It's important to distinguish between the terms "State" and "Usage." The State of a radio refers to whether that radio is turned on (and available for communication), or off (inactive). Usage determines whether that radio is enabled on the device. A radio's State can be controlled by the device user or administrator only if its Usage is Turned On (enabled).

Android devices often come with a variety of wireless communication interfaces. These include bidirectional interfaces such as Bluetooth, Wireless Wide Area Network (WWAN/cellular data), Near Field Communications (NFC) and the unidirectional (receive-only) Global Positioning System (GPS). Wireless radios that can transmit may significantly effect battery life if turned on unnecessarily. Some radios also might need to be turned off in certain situations, such as during air travel or when in hazardous environments.

Main Functionality

  • Enable/Disable user access to device radios:
    • Bluetooth
    • Near Field Communication (NFC)
    • Global Positioning System (GPS)
    • Wireless Wide Area Network (WWAN/cellular data)
  • Control State of the Bluetooth radio
  • Select internal or external Bluetooth/Wi-Fi antenna
  • Select GPS Location Mode to control battery usage:
    • High accuracy
    • Battery savings
    • Device only

Antenna Selection

Used to select between built-in and external antennas for Bluetooth and Wi-Fi (WLAN) communications on the device. This feature applies only to the Zebra VC80x and similarly equipped vehicle-mounted computers.

Parm Name: AntennaSelection

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to settings; any previously selected setting will be retained.

MX: 7.1+

1 Use Internal Antenna Sets the device to use its built-in Bluetooth/Wi-Fi antenna.

MX: 7.1+

2 Use External Antenna Sets the device to use an (optional) external Bluetooth/Wi-Fi antenna.

MX: 7.1+

Bluetooth Enable/Disable

For KitKat devices on which the Bluetooth radio is Turned On, controls whether the Bluetooth functionality on the device is active.

On Jelly Bean devices, this is the On/Off switch for the Bluetooth radio, which controls whether Bluetooth can be used on the device. If Enabled, the Jelly Bean device user can pair and connect with other Bluetooth devices make changes to the Bluetooth State (active/inactive).

Parm Name: Bluetooth

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the state of the Bluetooth radio; any previously selected setting will be retained.

OSX: 4.2+

MX: 4.2+

1 Enable On KitKat devices, puts the Bluetooth radio (if Turned On) in an active state. On Jelly Bean devices, Turns On the Bluetooth radio, enabling its usage on the device and changes to its state.

OSX: 4.2+

MX: 4.2+

2 Disable On KitKat devices, puts the Bluetooth radio (if Turned On) in an inactive state. On Jelly Bean devices, Turns Off the Bluetooth radio, preventing its usage on the device and changes to its state.

OSX: 4.2+

MX: 4.2+

Bluetooth Turn On/Off

The On/Off switch for the Bluetooth radio, which controls whether the State of the radio (active/inactive) can be changed by the device user. Turning On the Bluetooth radio allows the device to pair with other Bluetooth devices and connect with devices previously paired.

Note: This parm is available only on devices running KitKat and higher.

Parm Name: BluetoothState

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the Bluetooth radio state; any previously selected setting will be retained.

MX: 4.3+

Android API: 5+

1 Turn On Turns On the Bluetooth radio, enabling usage and changes to its state.

MX: 4.3+

Android API: 5+

2 Turn Off Turns Off the Bluetooth radio, preventing all usage.

MX: 4.3+

Android API: 5+

GPS Location Mode

Permits selection of the GPS Location Mode for determining the device location, allowing for scanrios in which location accuracy can be sacrified in favor of longer battery life. This parm uses Android's three location modes:

  • High Accuracy mode suppliments information from the built-in GPS receiver with Wi-Fi and cellular data to calculate the location with the highest degree of precision. This option draws the most energy.

  • Battery saving mode uses only Wi-Fi and cellular data to determine location, but doesn't work with Google Maps and similar apps. This option draws the least energy.

  • Device only mode uses only GPS data, but is subject to signal loss in some settings.

Parm Name: GPSLocationMode

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the GPS Location Mode; any previously selected setting will be retained.

MX: 6.1+

Android API: 1+

1 High Accuracy Uses GPS, Wi-Fi and cellular network information to determine device location with the highest degree of accuracy.

MX: 6.1+

Android API: 1+

2 Battery Saving Determines device location using only Wi-Fi and cellular information, preserving battery life.

MX: 6.1+

Android API: 1+

3 Device Only Determines location using only the GPS radio, which is subject to signal loss in some settings.

MX: 6.1+

Android API: 1+

GPS Radio On/Off

The On/Off switch for the Global Positioning System (GPS) radio, which allows the device to receive information from GPS satellites to determine the position of the device and controls whether the device user can change the State of the radio (active/inactive).

Parm Name: GPSState

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the GPS radio usage status; any previously selected setting will be retained.

MX: 4.3+

Android API: 1+

1 Turn On Turns On the GPS radio, enabling usage and changes to its state.

MX: 4.3+

Android API: 1+

2 Turn Off Turns Off the GPS radio, preventing all usage.

MX: 4.3+

Android API: 1+

NFC Radio On/Off

The On/Off switch for the Near Field Communications (NFC) radio, which allows the device to communicate with NFC tags by reading from or writing to them when they are in near proximity to the device, and controls whether the device user can change State of the radio (active/inactive).

Parm Name: NFCState

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the NFC radio usage status; any previously selected setting will be retained.

MX: 4.3+

Android API: 10+

1 Turn On Turns On the NFC radio, enabling usage and changes to its state.

MX: 4.3+

Android API: 10+

2 Turn Off Turns Off the NFC radio, preventing all usage.

MX: 4.3+

Android API: 10+

WWAN Radio On/Off

The On/Off switch for Wireless Wide Area Network (WWAN) cellular radio, which allows the device to establish a cellular data connection to enable cellular voice connections, if supported. Also controls whether the device user can change the State of the radio (active/inactive).

Parm Name: WWANState

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the WWAN radio usage setting; any previously selected setting will be retained.

OSX: 4.3+

MX: 4.3+

1 Turn On Turns On the WWAN radio, enabling usage and changes to its state.

OSX: 4.3+

MX: 4.3+

2 Turn Off Turns Off the WWAN radio, preventing all usage.

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>

Select the external antenna for Bluetooth and Wi-Fi


<wap-provisioningdoc>
    <characteristic type="WirelessMgr">
        <parm name="AntennaSelection" value="2" />
    </characteristic>
</wap-provisioningdoc>