Wireless Manager

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

Language Note: Input fields accept ENGLISH ONLY.

EMDK For Xamarin - 8.0

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 or secure environments.

Main Functionality

  • Enable/Disable user access to device radio state (turn on/off):
    • Bluetooth
    • Near Field Communication (NFC)
    • Global Positioning System (GPS)
    • Wireless Wide Area Network (WWAN/cellular data)
  • Control the state (turn on/off):
    • Bluetooth radio
    • Bluetooth scanning
    • Wi-Fi scanning
    • Location service (devices running Android 8.x Oreo or later)
  • Select internal or external Bluetooth/Wi-Fi antenna
  • Select GPS Location Mode to control battery usage:
    • High accuracy
    • Battery savings
    • Device only
  • Automatically turn off Airplane Mode after a set period of time

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 Status 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

Controls whether the device user can control the Bluetooth radio state (turn on/off) on most devices. This parameter does NOT turn the Bluetooth radio on or off; it controls the ability of the device user to do so.

Jelly Bean, KitKat Notes

  • Enable (option 1): On devices running KitKat with Bluetooth turned on, puts the Bluetooth radio in an active state. With Jelly Bean, turns on the Bluetooth radio, enabling its usage on the device and changes to its state.
  • Disable (option 2): On KitKat with Bluetooth turned on, puts the Bluetooth radio in an inactive state. With Jelly Bean, turns off the Bluetooth radio, preventing its usage on the device and changes to its state.

Parm Name: Bluetooth

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

OSX: 4.2+

MX: 4.2+

1 Enable Enables the device user to control the Bluetooth radio state (turn on/off).

OSX: 4.2+

MX: 4.2+

2 Disable Prevents the device user from controlling the Bluetooth radio state (turn on/off).

OSX: 4.2+

MX: 4.2+

Bluetooth 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: Supported only on devices running Android 4.4 KitKat or later.

Parm Name: BluetoothState

Option Name Description Note Status 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+

Bluetooth Scanning On/Off

Controls the ability of the device to scan using connected Bluetooth peripherals.

Parm Name: BTScanningState

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parameter from the XML) causes no change to this device setting; any previously selected setting is retained.

MX: 10.4+

1 Turn On Turns On the ability to scan using Bluetooth devices.

MX: 10.4+

2 Turn Off Turns Off the ability to scan using Bluetooth devices.

MX: 10.4+

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 parameter 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.

Note: Supported only on devices running Android 7.x (Nougat) or earlier.

Parm Name: GPSLocationMode

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is 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 Status 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+

Location Service On/Off

Controls use of the Location service on devices running Android 8.x Oreo and later.

Note: Supported only on devices running Android 8.x Oreo and later.

Parm Name: LocationState

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parameter from the XML) causes no change to this device setting; any previously selected setting is retained.

MX: 10.4+

Android API: 26+

1 Turn On Turns On the Location service on the device.

MX: 10.4+

Android API: 26+

2 Turn Off Turns Off the Location service on the device.

MX: 10.4+

Android API: 26+

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 Status 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: 29+

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

MX: 4.3+

Android API: 29+

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

MX: 4.3+

Android API: 29+

Wi-Fi Scanning On/Off

Controls the ability of the device to scan using connected Wi-Fi peripherals.

Parm Name: WiFiScanningState

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parameter from the XML) causes no change to this device setting; any previously selected setting is retained.

MX: 10.4+

1 Turn On Turns On the ability to scan using Wi-Fi devices.

MX: 10.4+

2 Turn Off Turns Off the ability to scan using Wi-Fi devices.

MX: 10.4+

Airplane Mode Timer

Used to enter a length of time (in minutes) after which Airplane Mode will be automatically turned off on the device. Minimum is two (2) minutes; maximum is 1440 minutes (24 hours).

Parm input rules:

  • Accepts an integer from 2–1440

Shown if: Airplane Mode Shut-off is set to "Enable Airplane Mode automatic shut-off"

Parm Name: AirplaneModeTimer

Requires:

  • MX: 11.5+
  • Android API: 30+

Airplane Mode Auto Shut-off

Used to select whether to automatically turn off Airplane Mode after a length of time as configured in the Airplane Mode Timer parameter. The auto shut-off parameter is intended to restore wireless access to a device if Airplane Mode (which turns off all wireless radios) was inadvertently left on by the device user.

Parm Name: AirplaneShutOff

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parameter from the XML) causes no change to this device setting; any previously selected setting is retained.

MX: 11.5+

Android API: 30+

1 Disable Airplane Mode automatic shut-off Allows device to remain in Airplane Mode indefinitely.

MX: 11.5+

Android API: 30+

2 Enable Airplane Mode automatic shut-off Turns off Airplane Mode on the device after a predetermined time.

MX: 11.5+

Android API: 30+

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 Status 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>