To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.
Input fields accept ENGLISH ONLY.
Queries from MX are not supported on Zebra devices running Android 11 or later. See alternative method.
The "SmartDocs" bar can customize this page to show only the features present on a particular Zebra device.
OSX, MX and Android version information for a device can be found in the Android Settings panel or by querying the device through ADB, EMDK or the MX CSP. More info.
Wi-Fi Manager (Wi-Fi) administers the wireless LAN settings and network profiles for a device, including the settings required for connecting to networks.
For Zebra Professional-series devices, the following Wi-Fi parameters and/or options might require purchase of a Mobility DNA Enterprise License:
Used to enter the operating system of the target device.
Parm Name: TargetOS
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Android | Specifies Android as the operating system of the target device. |
MX: 4.2+ |
This is the On-Off switch for the Wi-Fi radio. Note: Wi-Fi must be enabled to change most of the Wi-Fi settings described in this document. Attempting to change such settings while the Wi-Fi radio is disabled will return an error in the Result XML. Zebra recommends beginning any profile created to change Wi-Fi settings with a command to Enable the Wi-Fi radio.
CAUTION: Some Wi-Fi parameters vary from conventions used by other CSPs:
Parm Name: WiFiAction
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 Wi-Fi settings; any previously selected setting is retained. |
MX: 4.2+ |
||
1 | Enable | Turns the Wi-Fi radio On. |
MX: 4.2+ |
||
2 | Disable | Turns the Wi-Fi radio Off. |
MX: 4.2+ |
Used to select the state of the Wi-Fi radio when the device enters sleep mode. When Wi-Fi remains enabled during sleep, existing Wi-Fi connections are maintained as during normal operations. While preferrable for some situations, this mode can significantly reduce battery life.
Android devices by default enter sleep mode after being idle for a specified period of time. While in this mode, apps run in a lower-power state.
Note: This parameter cannot be configured in devices running Android 8.x and higher; Oreo locks the Wi-Fi radio into the "AlwaysOn" setting.
Parm Name: WifiSleepPolicy
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
4 | Do not change | This (null) value (or the absence of this parm from the XML) causes no change to the current sleep policy on the device; any previously selected setting is retained. |
MX: 4.2+ |
||
0 | AlwaysOn | Causes the Wi-Fi radio to remain enabled when the device goes to sleep, providing running apps with uninterrupted access to Wi-Fi (NOTE- This is the permanent state of devices running Android 8.x Oreo). |
MX: 4.2+ |
||
1 | PluggedIn | Causes the Wi-Fi radio to remain enabled only when the device is plugged in and not running on battery power regardless of sleep state, providing running apps with uninterrupted access to Wi-Fi. |
MX: 4.2+ |
||
2 | NeverOn | Causes the Wi-Fi radio to be disabled when the device enters sleep mode, dropping any existing Wi-Fi connection. |
MX: 4.2+ |
Controls whether to display user notifications when unknown, open networks such as those offered by public Wi-Fi come into range of the device. If enabled, the user is presented with the opportunity to connect with such networks. This might be desireable for personal or dual-use devices, but could introduce vulnerabilities when connecting to non-secure or otherwise unknown networks. Zebra recommends disabling Network Notification on devices intended for use only on corporate Wi-Fi networks.
Parm Name: NetworkNotification
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current network notification setting; any previously selected setting is retained. |
MX: 4.2+ |
||
1 | true | Enables user notifications to be displayed when unknown, open networks come into range. |
MX: 4.2+ |
||
0 | false | Disables user notifications when unknown, open networks come into range. |
MX: 4.2+ |
This is the On/Off switch for Wi-Fi Wake-up, which enables Wi-Fi to automatically connect when a previously connected network is detected. This feature can be used to help conserve battery power by enabling Wi-Fi only when known networks are in range.
Wi-Fi Wakeup requires the Android Location service and Wi-Fi scanning feature to be enabled on the device.
Parm Name: WifiWakeup
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 9.1+ |
||
1 | Enable | Enables Wi-Fi to wake automatically when a previously connected network is detected. |
MX: 9.1+ |
||
0 | Disable | Prevents Wi-Fi from waking up automatically. |
MX: 9.1+ |
Control the country-selection preference for network usage and Wi-Fi regulatory setting by the device. Check the box to select the country manually from the drop-down menu; leave the box unchecked to allow the network router or Wi-Fi access point to select the country using the 802.11d protocol.
Parm Name: UseRegulatory
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
checked | UseRegulatory | Permits manual country selection. |
MX: 4.2+ |
||
unchecked | Country | Allows the country to be determined by the router. |
MX: 4.2+ |
Used to select country-specific Wi-Fi regulatory settings. Choosing "AUTO" enables selection through 802.11d, which configures the device to listen for a country-specific beacon. Using the AUTO setting, the device will not transmit unless it can successfully detect the country and use a frequency that is consistent with the country's Wi-Fi infrastructure. This setting is the least likely to violate country-specific regulations. Countries that do not support the 802.11d infrastructure must be selected manually.
Shown if: The "Configure Country (Auto/Manual)" box is unchecked
Parm Name: Country
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
AUTO | AUTO (Use 802.11d) |
MX: 4.2+ |
|||
DZ | Algeria |
MX: 4.2+ |
|||
AI | Anguilla |
MX: 4.2+ |
|||
AR | Argentina |
MX: 4.2+ |
|||
AU | Australia |
MX: 4.2+ |
|||
AT | Austria |
MX: 4.2+ |
|||
AZ | Azerbaijan |
MX: 11.5+ Android API: 30+ |
|||
BS | Bahamas |
MX: 4.2+ |
|||
BH | Bahrain |
MX: 4.2+ |
|||
BD | Bangladesh |
MX: 11.5+ Android API: 30+ |
|||
BB | Barbados |
MX: 4.2+ |
|||
BY | Belarus |
MX: 4.2+ |
|||
BE | Belgium |
MX: 4.2+ |
|||
BM | Bermuda |
MX: 4.2+ |
|||
BO | Bolivia |
MX: 4.2+ |
|||
BQ | Bonaire |
MX: 4.2+ |
|||
BA | Bosnia and Herzegovina |
MX: 4.2+ |
|||
BR | Brazil |
MX: 4.2+ |
|||
BG | Bulgaria |
MX: 4.2+ |
|||
CA | Canada |
MX: 4.2+ |
|||
KY | Cayman Islands |
MX: 4.2+ |
|||
CL | Chile |
MX: 4.2+ |
|||
CN | China |
MX: 4.2+ |
|||
CX | Christmas Island |
MX: 4.2+ |
|||
CO | Colombia |
MX: 4.2+ |
|||
CR | Costa Rica |
MX: 4.2+ |
|||
HR | Croatia |
MX: 4.2+ |
|||
CW | Curacao |
MX: 4.2+ |
|||
CY | Cyprus |
MX: 4.2+ |
|||
CZ | Czech Republic |
MX: 4.2+ |
|||
DK | Denmark |
MX: 4.2+ |
|||
DO | Dominican Republic |
MX: 4.2+ |
|||
EC | Ecuador |
MX: 4.2+ |
|||
EG | Egypt |
MX: 4.2+ |
|||
SV | El Salvador |
MX: 4.2+ |
|||
EE | Estonia |
MX: 4.2+ |
|||
FK | Falkland Islands(Malvinas) |
MX: 4.2+ |
|||
FI | Finland |
MX: 4.2+ |
|||
FR | France |
MX: 4.2+ |
|||
GF | French Guiana |
MX: 4.2+ |
|||
DE | Germany |
MX: 4.2+ |
|||
GH | Ghana |
MX: 11.5+ Android API: 30+ |
|||
GI | Gibraltar |
MX: 11.5+ Android API: 30+ |
|||
GR | Greece |
MX: 4.2+ |
|||
GP | Guadelope |
MX: 4.2+ |
|||
GU | Guam |
MX: 4.2+ |
|||
GT | Guatemala |
MX: 4.2+ |
|||
GG | Guernsey |
MX: 11.5+ Android API: 30+ |
|||
GY | Guyana |
MX: 4.2+ |
|||
HT | Haiti |
MX: 4.2+ |
|||
HN | Honduras |
MX: 4.2+ |
|||
HK | Hong Kong |
MX: 4.2+ |
|||
HU | Hungary |
MX: 4.2+ |
|||
IS | Iceland |
MX: 4.2+ |
|||
IN | India |
MX: 4.2+ |
|||
ID | Indonesia |
MX: 4.2+ |
|||
IE | Ireland |
MX: 4.2+ |
|||
IL | Israel |
MX: 4.2+ |
|||
IT | Italy |
MX: 4.2+ |
|||
JM | Jamaica |
MX: 4.2+ |
|||
JP | Japan |
MX: 4.2+ |
|||
JO | Jordan |
MX: 4.2+ |
|||
KZ | Kazakhstan |
MX: 4.2+ |
|||
KE | Kenya |
MX: 4.2+ |
|||
KR | Korea Republic |
MX: 4.2+ |
|||
XK | Kosovo |
MX: 11.5+ Android API: 30+ |
|||
KW | Kuwait |
MX: 4.2+ |
|||
KG | Kyrgyzstan |
MX: 11.5+ Android API: 30+ |
|||
LV | Latvia |
MX: 4.2+ |
|||
LB | Lebanon |
MX: 4.2+ |
|||
LI | Liechtenstein |
MX: 4.2+ |
|||
LT | Lithuania |
MX: 4.2+ |
|||
LU | Luxembourg |
MX: 4.2+ |
|||
MK | Macedonia, Former Yugoslav Republic |
MX: 4.2+ |
|||
MY | Malaysia |
MX: 4.2+ |
|||
MT | Malta |
MX: 4.2+ |
|||
MQ | Martinique |
MX: 4.2+ |
|||
MX | Mexico |
MX: 4.2+ |
|||
MD | Moldova |
MX: 11.5+ Android API: 30+ |
|||
ME | Montenegro |
MX: 4.2+ |
|||
MA | Morocco |
MX: 4.2+ |
|||
AN | Netherlands, Antilles |
MX: 4.2+ |
|||
NL | Netherlands |
MX: 4.2+ |
|||
NZ | New Zealand |
MX: 4.2+ |
|||
NI | Nicaragua |
MX: 4.2+ |
|||
NG | Nigeria |
MX: 4.2+ |
|||
NU | Niue |
MX: 4.2+ |
|||
NF | Norfolk Islands |
MX: 4.2+ |
|||
MP | Northern Marina Islands |
MX: 4.2+ |
|||
NO | Norway |
MX: 4.2+ |
|||
OM | Oman |
MX: 4.2+ |
|||
PK | Pakistan |
MX: 4.2+ |
|||
PA | Panama |
MX: 4.2+ |
|||
PY | Paraguay |
MX: 4.2+ |
|||
PE | Peru |
MX: 4.2+ |
|||
PH | Philippines |
MX: 4.2+ |
|||
PL | Poland |
MX: 4.2+ |
|||
PT | Portugal |
MX: 4.2+ |
|||
PR | Puerto Rico |
MX: 4.2+ |
|||
QA | Qatar |
MX: 4.2+ |
|||
RO | Romania |
MX: 4.2+ |
|||
RU | Russian Federation |
MX: 4.2+ |
|||
SX | St. Maarten |
MX: 4.2+ |
|||
SA | Saudi Arabia |
MX: 4.2+ |
|||
SN | Senegal |
MX: 11.5+ Android API: 30+ |
|||
RS | Serbia |
MX: 4.2+ |
|||
SG | Singapore |
MX: 4.2+ |
|||
SK | Slovakia |
MX: 4.2+ |
|||
SI | Slovenia |
MX: 4.2+ |
|||
ZA | South Africa |
MX: 4.2+ |
|||
ES | Spain |
MX: 4.2+ |
|||
LK | Sri Lanka |
MX: 4.2+ |
|||
SE | Sweden |
MX: 4.2+ |
|||
CH | Switzerland |
MX: 4.2+ |
|||
TW | Taiwan, Province of China |
MX: 4.2+ |
|||
TH | Thailand |
MX: 4.2+ |
|||
TT | Trinidad and Tobago |
MX: 4.2+ |
|||
TN | Tunisia |
MX: 4.2+ |
|||
TR | Turkey |
MX: 4.2+ |
|||
UG | Uganda |
MX: 11.5+ Android API: 30+ |
|||
UA | Ukraine |
MX: 4.2+ |
|||
AE | United Arab Emirates |
MX: 4.2+ |
|||
GB | United Kingdom |
MX: 4.2+ |
|||
US | U.S.A. |
MX: 4.2+ |
|||
UY | Uruguay |
MX: 4.2+ |
|||
VE | Venezuela |
MX: 4.2+ |
|||
VN | Vietnam |
MX: 4.2+ |
|||
VG | Virgin Islands(British) |
MX: 4.2+ |
|||
VI | Virgin Islands(US) |
MX: 4.2+ |
Used to select which RF band(s) the device uses for 802.11 communications. This parameter is usually set automatically through negotiation with the Wi-Fi infrastructure. However, it might sometimes be desirable to limit Wi-Fi communications to certain bands, leaving other bands free for other purposes.
Zebra Professional-series devices require purchase of a Mobility DNA Enterprise License for some features. For details, hover mouse at icon.
Parm Name: BandSelection
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Unchanged | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 4.2+ |
||
1 | 2.4GHz | Enables only the 2.4GHz band for Wi-Fi communications. |
MX: 4.2+ |
||
2 | 5.0GHZ | Enables only the 5.0GHz band for Wi-Fi communications. |
MX: 4.2+ |
||
3 | Auto | Allows any band to operate on the device and for connection(s) to be selected automatically. |
MX: 4.2+ |
||
4 | 6.0GHz | Enables only the 6.0GHz band to operate on the device. |
MX: 11.4+ Android API: 30+ |
||
5 | 2.4GHz and 5.0GHz | Enables 2.4GHz and 5.0GHz bands to operate on the device. |
MX: 11.4+ Android API: 30+ |
||
6 | 5.0GHz and 6.0GHz | Enables 5.0GHz and 6.0GHz bands to operate on the device. |
MX: 11.4+ Android API: 30+ |
||
7 | 2.4GHz and 6.0GHz | Enables 2.4GHz and 6.0GHz bands to operate on the device. |
MX: 11.5+ Android API: 30+ |
Used to designate channels in the 2.4GHz band for use by the device. While channels used in this band are generally determined automatically through negotiation with the Wi-Fi infrastructure, channels or sets of channels also may be specified manually to avoid interference with other devices or to dedicate certain channels to specific purposes. Warning: Not all channels are available in all countries. See the List of WLAN Channels for more information.
Parm value input rules:
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The selected RF Band is "2.4GHz" or "2.4GHz and 5.0GHz" or "2.4GHz and 6.0GHz" or "Auto"
Parm Name: 2.4GHzChannels
Requires:
- MX: 4.2+
Used to designate channels in the 5GHz band for use by the device. While channels used in this band are generally determined automatically through negotiation with the Wi-Fi infrastructure, channels or sets of channels also can be specified manually to avoid interference with other devices or to dedicate certain channels for specific purposes. Warning: Not all channels are available in all countries. See the List of WLAN Channels for more information.
Parm value input rules:
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The selected RF Band is "5.0GHz" or "2.4GHz and 5.0GHz" or "5.0GHz and 6.0GHz" or "Auto"
Parm Name: 5.0GHzChannels
Requires:
- MX: 4.2+
Used to designate channels in the 6.0GHz band for use by the device. While channels used in this band are generally determined automatically through negotiation with the Wi-Fi infrastructure, channels or sets of channels also can be specified manually to avoid interference with other devices or to dedicate certain channels for specific purposes. Warning: Not all channels are available in all countries. See the List of WLAN Channels for more information.
Parm value input rules:
HELP Enter channels(s) to use, separate by commas and/or as high/low pair(s) separated by dash. Only valid channels will be applied based on Regulatory and Platform"
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The selected RF Band is "2.4GHz" or "2.4GHz and 5.0GHz" or "2.4GHz and 6.0GHz" or "Auto"
Parm Name: 6.0GHzChannels
Requires:
- MX: 11.4+
Controls whether Diagnostic Options is used on the device. Generally used only at the direction of Zebra support staff; impacts device performance and behavior. Used to collect additional information for troubleshooting. When checked, Fusion Advanced Logging can also be enabled.
Parm Name: UseDiagnosticOptions
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | (checked) | Allows device diagnostics options to be selected. |
MX: 4.4+ |
||
0 | (unchecked) | Prevents diagnostics options from being displayed for selection. |
MX: 4.4+ |
Controls whether Fusion Advanced Logging is used on the device.
This option is generally used only at the direction of Zebra support staff.
Shown if: The "Use Diagnostic Options" box is checked
Parm Name: FusionAdvancedLogging
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | (checked) | Enables logging on the device. |
MX: 4.4+ |
||
0 | (unchecked) | Disables logging on the device. |
MX: 4.4+ |
Controls Wi-Fi Advanced Options, which should be used only under the guidance of Zebra Support. Do not use these features unless told to do so by qualified personnel; altering advanced options can result in undesirable device behavior.
WARNING:
Wi-Fi Advanced Options should be used only under the guidance of Zebra Technical Support. Do not use these features unless told to do so by qualified personnel; altering advanced settings can result in undesirable behavior.
Zebra recommends using Advanced Options only on devices with MX 8.3 or higher. Use with prior MX versions can result in unpredictable behavior.
Parm Name: UseAdvancedOptions
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | (checked) | Enables the use of Wi-Fi Advanced Options on the device. |
MX: 4.2+ |
||
0 | (unchecked) | Disables the use of Wi-Fi Advanced Options on the device. |
MX: 4.2+ |
This is the On/Off switch for Secure Advanced Logging Mode, which encrypts Wi-Fi Advanced logs and imposes a user-specified password for log access (see Secure Logging Password parameter, below). Logging might effect device performance.
Parm Name: SecureFusionAdvancedLoggingMode
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 13.1+ |
||
1 | Enable | Enables secure logging of Wi-Fi events. |
MX: 13.1+ |
||
0 | Disable | Disables secure logging of Wi-Fi events. |
MX: 13.1+ |
Used to enter a Password for access to encrypted Wi-Fi event logs when Secure Logging is used. Case sensitive.
Parm value input rules:
Shown if: The "Use Advanced Options" box is checked and "Secure Fusion Advanced Logging Mode" is set to Enable
Parm Name: EncryptionPassword
Requires:
- MX: 13.1+
Used to enable/disable AutoTimeConfig feature, a Zebra-specific feature that updates the device timestamp based on Zebra IE in the 802.11 beacon. Not supported on TC70 QC GA1/GA2 running Android KitKat.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: AutoTimeConfig
Requires:
- MX: 4.2+
This is the On/Off switch for AutoTimeConfig feature, a Zebra-specific feature that updates the device timestamp based on Zebra IE in the 802.11 beacon.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: AutoTimeConfiguration
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables AutoTimeConfig feature. |
MX: 8.2+ |
||
0 | Disable | Disables AutoTimeConfig feature. |
MX: 8.2+ |
Used to enable/disable Hyper Fast Secure Roam (HFSR), Zebra's fast roam algorithm.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Supported only on MC18, MC32, MC40, MC67 and MC92 devices.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: HFSR
Requires:
- MX: 4.2+
This is the On/Off switch for Hyper Fast Secure Roam (HFSR), Zebra's fast roam algorithm.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Supported only on MC18, MC32, MC40, MC67 and MC92 devices.
Parm Name: HFSR_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables HFSR on the device. |
MX: 8.2+ |
||
0 | Disable | Disables HFSR on the device. |
MX: 8.2+ |
Used to enable/disable Cisco Centralized Key Management (CCKM), a form of fast roaming and a subset of the Cisco Compatible Extensions (CCX) spec.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: CCKM
Requires:
- MX: 4.2+
This is the On/Off switch for configuring Cisco Centralized Key Management (CCKM), a form of fast roaming and a subset of the Cisco Compatible Extensions (CCX) spec.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: CCKM_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables configuration of CCKM. |
MX: 8.2+ |
||
0 | Disable | Disables configuration of CCKM. |
MX: 8.2+ |
Controls the Fast Transition roam algorithm (802.11r), which improves on IEEE 802.11r Over-the-DS fast roaming. When used in conjunction with Zebra wireless LAN infrastructure, the device will achieve more reliable and consistent fast roaming. Enabled by default.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Not supported on TC70 QC GA1 devices running Android KitKat.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: FT
Requires:
- MX: 4.2+
This is the On/Off switch for the Fast Transition roam algorithm (802.11r), which improves on IEEE 802.11r Over-the-DS fast roaming.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Not supported on TC70 QC GA1 devices running Android KitKat.
Parm Name: FT_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables FT on the device. |
MX: 8.2+ |
||
0 | Disable | Disables FT on the device. |
MX: 8.2+ |
Used to enables/disable the Fast Transition Resource Request (802.11r). Not supported on TC70 QC GA1/GA2, TC75 GA or TC55 GA devices running Android KitKat.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Not supported on TC70 QC GA1/GA2, TC75 GA or TC55 GA devices running Android KitKat.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: FTRIC
Requires:
- MX: 4.2+
This is the On/Off switch for Fast Transition Resource Request (802.11r).
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: FTRIC_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables FTRIC on the device. |
MX: 8.2+ |
||
0 | Disable | Disables FTRIC on the device. |
MX: 8.2+ |
Used to enable/disable Opportunistic Key Caching (OKC), which can be used along with Pairwise Master Keys (PMKs) to help reduce authentication time when roaming to multiple access points. See PMKID.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: OKC
Requires:
- MX: 4.2+
This is the On/Off switch for Opportunistic Key Caching (OKC), which can be used to help reduce authentication time.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: OKC_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables OKC the device. |
MX: 8.2+ |
||
0 | Disable | Disables OKC the device. |
MX: 8.2+ |
Used to enable/disable Pairwise Master Key ID (PMKID) caching. A PMK is defined in the 802.11i specification as a key resulting from successful authentication between a wireless device and an access point.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: PMKID
Requires:
- MX: 4.2+
This is the On/Off switch for Pairwise Master Key ID (PMKID) caching.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: PMKID_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables PMKID on the device. |
MX: 8.2+ |
||
0 | Disable | Disables PMKID on the device. |
MX: 8.2+ |
Used to enable/disable 802.1x Pre-Authentication.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DISCONTINUED
Shown if: The "Use Advanced Options" box is checked.
Parm Name: PreAuth
Requires:
- MX: 4.2+
This is the On/Off switch for pre-authentication on the device, which can be used to help enable faster roaming.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: DISCONTINUED
Parm Name: PreAuth_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables pre-authentication on the device. |
MX: 8.2+ |
||
0 | Disable | Disables pre-authentication on the device. |
MX: 8.2+ |
Used to configure the Power Save Mode from the settings table below. The default "Fast Power Save" value must be used for the "Power Save" parameter; the "Do not change" value will result in failure.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: PowerSave
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change |
MX: 4.2+ |
|||
1 | Always Active |
MX: 4.2+ |
|||
2 | Fast Power Save (DEPRECATED) |
MX: 4.2+ |
|||
3 | Max Power Save (DEPRECATED) |
MX: 4.2+ |
|||
4 | WMM-PS |
MX: 4.4+ |
|||
5 | Null Data Power Save |
MX: 4.4+ |
|||
6 | PS-POLL |
MX: 4.4+ |
|||
7 | TWT for Wi-Fi6 |
MX: 11.1+ Android API: 30+ |
|||
99 | Unsupported |
MX: 6.2+ |
Used to select the Power Save Mode for the WLAN radio.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DEPRECATED; this feature will be removed from a future release.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: WLANPowerSave
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | WMM-PS |
MX: 4.3+ |
|||
1 | Null Data Power Save |
MX: 4.3+ |
|||
2 | PS-POLL |
MX: 4.3+ |
|||
3 | Do not change |
MX: 4.3+ |
|||
99 | Unsupported |
MX: 6.2+ |
Used to start or stop advanced Wi-Fi logging.
Wi-Fi Diagnostic Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DISCONTINUED. This feature is not available in devices running MX 8.3 or later.
Shown if: The "Use Diagnostic Options" box is checked.
Parm Name: AdvancedLogging
Requires:
- MX: 4.2+
This is the On/Off switch for logging WLAN module events, which is sometimes helpful for troubleshooting. Logs from all Wi-Fi modules are stored in the /fusionlogs
folder on the device. Caution: Logging might cause performance delays.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: DISCONTINUED. This feature is not available in devices running MX 8.3 or later.
Parm Name: AdvancedLogging_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables logging of Wi-Fi events. |
MX: 8.2+ |
||
0 | Disable | Disables logging of Wi-Fi events. |
MX: 8.2+ |
Used to enable/disable Federal Information Processing Standards (FIPS), a cryptographic data security specification developed by the U.S. government for protecting data in motion across a wireless LAN. Zebra complies with FIPS 140-2, level 1.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Supported only on MPA3-platform devices. FIPS 140-2 cryptography can be enabled on select hardware configurations ONLY through a custom SKU request.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: FIPS
Requires:
- MX: 4.2+
Used to enable/disable Federal Information Processing Standards (FIPS), a cryptographic data security specification developed by the U.S. government for protecting data in motion across a wireless LAN. Zebra complies with FIPS 140-2, level 1.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Supported only on MPA3-platform devices. FIPS 140-2 cryptography can be enabled on select hardware configurations ONLY through a custom SKU request.
Parm Name: FIPS_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables FIPS on the device. |
MX: 8.2+ |
||
0 | Disable | Disables FIPS on the device. |
MX: 8.2+ |
Used to enable/disable read-only mode for Wi-Fi settings according to the values in the table below. Not supported on TC70 QC GA1/GA2 running Android KitKat.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: EnableRestrictedSettingsUI
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do not change |
MX: 4.2+ |
|||
1 | Disable Restricted WLAN Settings UI |
MX: 4.2+ |
|||
2 | Enable Restricted WLAN Settings UI |
MX: 4.2+ |
Used to enable/disable Radio Resource Management, which measures transmit power, data rates and other wireless characteristics in an effort to optimize communication efficiency. Not supported on TC70 QC GA1/GA2 running Android KitKat, or MPA3 RevB-based devices running Android Jelly Bean.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: 802.11K
Requires:
- MX: 4.3+
This is the On/Off switch for Radio Resource Management, a feature of the 802.11k specification that analyzes access point traffic and estimates the optimal connection for maximizing wireless communication throughput. When disabled (option 0), the device generally connects to the AP with the strongest signal. When enabled using "802.11k Lite" (option 1), the Wi-Fi client can request Neighbor Reports, from which compatible APs return information about nearby APs that offer optimal connections for client attachment while roaming.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: 802.11K_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable 802.11k Lite | Enables only the Neighbor Report feature of the 802.11k wireless protocol. |
MX: 10.2+ |
||
3 | Enable 802.11k Full | Enables all 802.11k Radio Resource Measurement, which help a device discover an access point with with optimal traffic distribution. |
MX: 10.2+ |
||
0 | Disable | Disables 802.11k Radio Resource Measurement on the device. |
MX: 8.2+ |
Used to enter the Management Frame Protection mode from the values in the table below. Not supported on TC70 QC GA1/GA2, TC75 GA, or TC55 GA devices running Android KitKat, or MPA3 RevB-based devices running Android Jelly Bean.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Early releases of Zebra Professional-series devices running Android 10 required purchase of a Mobility DNA Enterprise license to use this feature. The Oct. 2020 (or later) system update removes this requirement.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: 802.11w
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | No MFP | Applies no Management Frame Protection. |
MX: 4.3+ |
||
1 | Capable | Allows MFP-capable and non-capable clients to join the network. |
MX: 4.3+ |
||
2 | Mandatory | Allows only MFP-capable clients to join the network. |
MX: 4.3+ |
||
3 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 4.3+ |
||
99 | Unsupported |
MX: 6.2+ |
Used to enter the preferred Wi-Fi band when the device attempts to connect with a Wi-Fi access point. Not supported on MPA3 RevB-based devices running Android Jelly Bean.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: BandPreference
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | No Preference |
MX: 4.3+ |
|||
1 | 2.4GHz |
MX: 4.3+ |
|||
2 | 6.0GHz if available (else, 5.0GHz) |
MX: 4.3+ |
|||
3 | Prefer 5.0GHz over 6.0GHz |
MX: 4.3+ |
|||
4 | Do not change |
MX: 11.5+ Android API: 30+ |
|||
99 | Unsupported |
MX: 6.2+ |
Used to enable/disable Fast Transition over the Distribution System (FTOverTheDS). Enabled by default. Also known as 802.11r Over-the-DS, this fast roam standard reduces the number frames exchanged when the device roams from one AP to another if the infrastructure supports it.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Supported only on ET50, ET55, MC33, TC51, TC56, TC70x, TC75x, TC53, TC58, TC73, TC78 VC80X and WT6000 devices.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: FTOverTheDS
Requires:
- MX: 4.3+
This is the On/Off switch for Fast Transition over the Distribution System (FTOverTheDS).
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Supported only on ET50, ET55, MC33, TC51, TC56, TC70x, TC75x, TC53, TC58, TC73, TC78 VC80X and WT6000 devices.
Parm Name: FTOverTheDS_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables FT over the DS. |
MX: 8.2+ |
||
0 | Disable | Disables FT over the DS. |
MX: 8.2+ |
Used to enable/disable the AggregatedFT feature.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DISCONTINUED
Shown if: The "Use Advanced Options" box is checked.
Parm Name: AggregatedFT
Requires:
- MX: 4.3+
This is the On/Off switch for Fast Transition roam algorithm (802.11r), which improves on IEEE 802.11r Over-the-DS fast roaming.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: DISCONTINUED
Parm Name: AggregatedFT_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables Aggregated FT. |
MX: 8.2+ |
||
0 | Disable | Disables Aggregated FT. |
MX: 8.2+ |
Used to enable/disable ScanAssist. This feature improves roaming on Zebra devices by allowing the device to monitor neighboring access points to retrieve roam-related information from the Zebra wireless LAN infrastructure without doing scans. Enabled by default.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DISCONTINUED
Shown if: The "Use Advanced Options" box is checked.
Parm Name: ScanAssist
Requires:
- MX: 4.3+
This is the On/Off switch for ScanAssist, which improves roaming on Zebra devices by allowing the device to monitor neighboring access points for roam-related information from the Zebra wireless LAN infrastructure without the need to perform additional scans.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: DISCONTINUED
Parm Name: ScanAssist_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables ScanAssist on the device. |
MX: 8.2+ |
||
0 | Disable | Disables ScanAssist on the device. |
MX: 8.2+ |
Used to enable/disable Coverage Hole Detection, which reports gaps in signal coverage to the Zebra wireless LAN infrastructure. Enabled by default. Network administrators can detect and mitigate coverage gaps present in the network for greater reliability.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: DISCONTINUED
Shown if: The "Use Advanced Options" box is checked.
Parm Name: CHD
Requires:
- MX: 4.3+
This is the On/Off switch for Coverage Hole Detection, which reports gaps in signal coverage to the Zebra wireless LAN infrastructure.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: DISCONTINUED
Parm Name: CHD_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables CHD on the device. |
MX: 8.2+ |
||
0 | Disable | Disables CHD on the device. |
MX: 8.2+ |
Used to enable subnet roaming. Not supported on TC70 QC GA1/GA2, TC75 GA, or TC55 GA devices running Android KitKat, or MPA3 RevB-based devices running Android Jelly Bean.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing. Not supported on TC70 QC GA1/GA2, TC75 GA, or TC55 GA devices running Android KitKat, or MPA3 RevB-based devices running Android Jelly Bean.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: SubNetRoam
Requires:
- MX: 4.4+
This is the On/Off switch for of subnet roam, which allows the device to roam between subnets attached to different wireless controllers.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Not supported on TC70 QC GA1/GA2, TC75 GA, or TC55 GA devices running Android KitKat, or MPA3 RevB-based devices running Android Jelly Bean.
Parm Name: SubNetRoam_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables Subnet Roam on the device. |
MX: 8.2+ |
||
0 | Disable | Disables Subnet Roam on the device. |
MX: 8.2+ |
Used to enable/disable WAN Country, which obtains country information from the WAN Interface (GSM/CDMA base station) and applies regulatory rules based on the Country Code received. Not supported on TC70 QC GA1/GA2 running Android KitKat, or MPA3 RevB- or RevC-based devices running Android Jelly Bean.
Wi-Fi Advanced Options should be used only at the direction of Zebra Support or other qualified personnel. Altering this setting can result in undesirable behavior.
Note: Supported on WAN-enabled devices only. Not supported on TC70 QC GA1/GA2 running Android KitKat, or MPA3 RevB- or RevC-based devices running Android Jelly Bean.
Shown if: The "Use Advanced Options" box is checked.
Parm Name: WANCountry
Requires:
- MX: 4.3+
This is the On/Off switch for the WAN country on the device, which obtains country information from the WAN Interface (GSM/CDMA base station) and applies regulatory rules based on the Country Code received. Not supported on TC70 QC GA1/GA2 running Android KitKat, or MPA3 RevB- or RevC-based devices running Android Jelly Bean.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: Supported on WAN-enabled devices only. Not supported on TC70 QC GA1/GA2 running Android KitKat, or MPA3 RevB- or RevC-based devices running Android Jelly Bean.
Parm Name: WANCountry_Config
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables the WAN country on the device. |
MX: 8.2+ |
||
0 | Disable | Disables the WAN country on the device. |
MX: 8.2+ |
Controls whether Wi-Fi Passwords stored on the device (which are always encrypted) can be read by system apps as clear text. Enable this parameter to prevent system apps from reading stored Passwords as clear text.
Note: Enabling this feature prevents the Google Mobile Service (GMS) backup service from successfully restoring Wi-Fi settings to a device, and might effect the operation of other device-backup systems.
The Password combines with an Identity to form an authentication credential for gaining access to a network. Authentication is required only when "Enterprise" is the selected Security Mode. All authentication types require a Password except EAP-TLS, which uses a client certificate.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: PasswordProtectEncryption
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Password Protect Encryption setting; any previously selected setting is retained. |
MX: 6.1+ |
||
1 | Enable | Prevents Passwords stored on the device from being read by apps as clear text. |
MX: 6.1+ |
||
0 | Disable | Allows Passwords stored on the device to be read by apps as clear text. |
MX: 6.1+ |
This is the On/Off switch for the detection of a Captive Portal, which requires user interaction to activate an internet connection. Captive portals are often used on public-access networks such as those at airports, hotels and coffee shops.
Select "Enable" (option 1) to allow device users to authenticate through a portal, if detected.
Parm Name: CaptivePortalDetection
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 7.0+ |
||
1 | Enable | Enables the detection of a captive portal. |
MX: 7.0+ |
||
0 | Disable | Disables the detection of a captive portal. |
MX: 7.0+ |
This is the On/Off switch for 802.11ac wireless protocol on the device, which operates on the 5GHz band and provides faster transfer rates than 802.11n and other earlier protocols. Requires network infrastructure that explicitly supports the 802.11ac protocol.
Note: Enabling 802.11ac also enables the 802.11n protocol on the device. Disabling this protocol is not supported on SDM660-platform devices.
Parm Name: 802.11ac
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 7.0+ |
||
1 | Enable | Enables 802.11ac and 802.11n wireless protocols on the device. |
MX: 7.0+ |
||
0 | Disable | Disables 802.11ac wireless protocol on the device. |
MX: 7.0+ |
This is the On/Off switch for 802.11n wireless protocol on the device, which operates on the 2.4GHz and 5GHz bands and provides faster transfer rates than 802.11ag.
Note: Disabling 802.11ac also disables the 802.11n protocol on the device. Disabling this protocol is not supported on SDM660-platform devices.
Parm Name: 802.11n
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 7.0+ |
||
1 | Enable | Enables 802.11n wireless protocol on the device. |
MX: 7.0+ |
||
0 | Disable | Disables 802.11n and 802.11ac wireless protocols on the device. |
MX: 7.0+ |
This is the On/Off switch for 802.11v wireless protocol on the device, which permits connected devices to obtain network load and other information from nearby access points to help make roaming decisions.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: 802.11v
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 7.1+ |
||
1 | Enable | Enables 802.11v wireless protocol on the device. |
MX: 7.1+ |
||
0 | Disable | Disables 802.11v wireless protocol on the device. |
MX: 7.1+ |
This is the On/Off switch for MAC randomization, which replaces the MAC address hard-coded in the device's wireless hardware with randomly generated values. Enabled by default. Use of this feature can sometimes prevent address-based device locationing.
It might be necessary to disable this feature while troubleshooting issues related to Wi-Fi connection and/or roaming.
Note: Supported on ET40, ET45, WS50, TC53, TC58, TC73, TC78 and SDM660-platform devices only.
Parm Name: MACRandomization
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.1+ |
||
1 | Enable | Enables MAC randomization on the device (default). |
MX: 8.1+ |
||
0 | Disable | Disables MAC randomization on the device, forcing the physical MAC address to be used. |
MX: 8.1+ |
This is the On/Off switch for Call Admission Control, which can help prevent voice-traffic congestion and improve call quality. Enabled by default. When used on a network on which Call Admission Control is mandated, the Wi-Fi stack negotiates to reserve bandwidth using Traffic Specification (TSPEC), the IEEE 802.11e standard for Quality of Service-capable networks.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: CallAdmissionControl
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.1+ |
||
1 | Enable | Enables Call Admission Control on the device (default). |
MX: 8.1+ |
||
0 | Disable | Disables Call Admission Control on the device. |
MX: 8.1+ |
This is the On/Off switch for use of the Aggregated MAC Protocol Data Unit (AMPDU), which can improve performance and optimize data transmission by grouping multiple MPDU blocks together.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Parm Name: EnableAmpdu
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.4+ |
||
1 | Enable | Enables use of AMPDU on the device. |
MX: 8.4+ |
||
0 | Disable | Disables use of AMPDU on the device. |
MX: 8.4+ |
This is the On/Off switch for Gratuitous ARP, which issues an address resolution protocol (ARP) announcement for updating the ARP tables of other hosts on the network. A recipient can use the ARP response frame received from a device to update its ARP cache or to add a new entry in the ARP table.
When this parameter is Enabled (option 1), a Zebra device transmits a Gratuitous ARP packet after every successful roam to a new access point. This can save the typical ARP request/response packets that the new AP might have to exchange with the device since the ARP table might already be updated.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: Gratuitous_ARP
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.4+ |
||
1 | Enable | Enables Gratuitous ARP on the device. |
MX: 8.4+ |
||
0 | Disable | Disables Gratuitous ARP on the device. |
MX: 8.4+ |
This is the On/Off switch for 2g Channel Bonding, which controls whether use of the 40MHz-wide channel in the 2.4GHz band is allowed. This can be useful for configuring devices to operate properly on networks that do not support this capability and to improve device performance on networks that do.
Attempts to use this parameter on a device that doesn't support it returns a value of "0" or "99" (depending on the MX version) in the relevant section of the Result XML file. See a list of Zebra devices by platform.
Note: Supported on SDM660-based devices (except TC52AX and MC33AX) running any Android version, and on 5430 and 6490 devices with Android 13 or earlier ONLY. This parameter is NOT supported on 4490- or 6375-platform devices. See device-platform link, above.
Parm Name: ChannelBondingMode2g
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 8.2+ |
||
1 | Enable | Enables 2g Channel Bonding. |
MX: 8.2+ |
||
0 | Disable | Disables 2g Channel Bonding. |
MX: 8.2+ |
Used while roaming to select a Received Signal Strength Indicator (RSSI) increase delta as the basis for choosing the stronger AP connection after threshold is met. Adjustments to this setting can help improve the Wi-Fi user experience while roaming. Default value is 5dBm.
Note: This parameter is supported only on 4490, 5430 and 6490 platform devices.
Parm Name: RoamRssiDelta
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do nothing | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.5+ Android API: 30+ |
||
1 | 1 | Sets the Roam RSSI Delta value to 1dBm. |
MX: 11.5+ Android API: 30+ |
||
2 | 2 | Sets the Roam RSSI Delta value to 2dBm. |
MX: 11.5+ Android API: 30+ |
||
3 | 3 | Sets the Roam RSSI Delta value to 3dBm. |
MX: 11.5+ Android API: 30+ |
||
4 | 4 | Sets the Roam RSSI Delta value to 4dBm. |
MX: 11.5+ Android API: 30+ |
||
5 | 5 | Sets the Roam RSSI Delta value to 5dBm. |
MX: 11.5+ Android API: 30+ |
||
6 | 6 | Sets the Roam RSSI Delta value to 6dBm. |
MX: 11.5+ Android API: 30+ |
||
7 | 7 | Sets the Roam RSSI Delta value to 7dBm. |
MX: 11.5+ Android API: 30+ |
||
8 | 8 | Sets the Roam RSSI Delta value to 8dBm. |
MX: 11.5+ Android API: 30+ |
||
9 | 9 | Sets the Roam RSSI Delta value to 9dBm. |
MX: 11.5+ Android API: 30+ |
||
10 | 10 | Sets the Roam RSSI Delta value to 10dBm. |
MX: 11.5+ Android API: 30+ |
||
98 | Default | Sets the Roam RSSI Delta value to its default (5dBm) setting. |
MX: 11.5+ Android API: 30+ |
Used while roaming to select a Received Signal Strength Indicator (RSSI) Threshold value, below which (as determined by the RSSI Delta Value parameter) the device will seek a stronger access point (AP) connection. Adjustments to this setting can help improve the Wi-Fi user experience while roaming. Default value is -65dBm.
Note: This parameter is supported only on 4490, 5430 and 6490 platform devices.
Parm Name: RoamRssithreshold
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: 11.5+ Android API: 30+ |
||
1 | -55 | Sets the threshold value to -55dBm. |
MX: 11.5+ Android API: 30+ |
||
2 | -56 | Sets the threshold value to -56dBm. |
MX: 11.5+ Android API: 30+ |
||
3 | -57 | Sets the threshold value to -57dBm. |
MX: 11.5+ Android API: 30+ |
||
4 | -58 | Sets the threshold value to -58dBm. |
MX: 11.5+ Android API: 30+ |
||
5 | -59 | Sets the threshold value to -59dBm. |
MX: 11.5+ Android API: 30+ |
||
6 | -60 | Sets the threshold value to -60dBm. |
MX: 11.5+ Android API: 30+ |
||
7 | -61 | Sets the threshold value to -61dBm. |
MX: 11.5+ Android API: 30+ |
||
8 | -62 | Sets the threshold value to -62dBm. |
MX: 11.5+ Android API: 30+ |
||
9 | -63 | Sets the threshold value to -63dBm. |
MX: 11.5+ Android API: 30+ |
||
10 | -64 | Sets the threshold value to -64dBm. |
MX: 11.5+ Android API: 30+ |
||
11 | -65 | Sets the threshold value to -65dBm. |
MX: 11.5+ Android API: 30+ |
||
12 | -66 | Sets the threshold value to -66dBm. |
MX: 11.5+ Android API: 30+ |
||
13 | -67 | Sets the threshold value to -67dBm. |
MX: 11.5+ Android API: 30+ |
||
14 | -68 | Sets the threshold value to -68dBm. |
MX: 11.5+ Android API: 30+ |
||
15 | -69 | Sets the threshold value to -69dBm. |
MX: 11.5+ Android API: 30+ |
||
16 | -70 | Sets the threshold value to -70dBm. |
MX: 11.5+ Android API: 30+ |
||
17 | -71 | Sets the threshold value to -71dBm. |
MX: 11.5+ Android API: 30+ |
||
18 | -72 | Sets the threshold value to -72dBm. |
MX: 11.5+ Android API: 30+ |
||
19 | -73 | Sets the threshold value to -73dBm. |
MX: 11.5+ Android API: 30+ |
||
20 | -74 | Sets the threshold value to -74dBm. |
MX: 11.5+ Android API: 30+ |
||
21 | -75 | Sets the threshold value to -75dBm. |
MX: 11.5+ Android API: 30+ |
||
98 | 98 | Sets the threshold value to its default (-65dBm) setting. |
MX: 11.5+ Android API: 30+ |
Used to manage the Wi-Fi network profiles on the device, each of which contains the settings necessary to connect to an individual Wi-Fi network. Any number of profiles can be defined and stored on the device using the parameters relevant to "Add" below. Profiles can be used to control the networks to which a device is allowed to connect or to force connections to a particular network.
Parm Name: NetworkAction
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Do nothing | This value (or the absence of this parm from the XML) performs no Network Action. |
MX: 4.2+ |
||
1 | Add | Adds a new network profile with the settings specified in the relevant network profile parameters. |
MX: 4.2+ |
||
2 | Remove | Removes an existing network profile based on the SSID specified. |
MX: 4.2+ |
||
3 | Connect | Initiates a connection to an existing network based on the SSID specified. |
MX: 4.2+ |
||
4 | Disconnect | Disconnects from a network based on the SSID specified. |
MX: 4.2+ |
||
5 | Enable | Enables a network profile based on the SSID specified. |
MX: 4.2+ |
||
6 | Disable | Disables a network profile based on the SSID specified. |
MX: 4.2+ |
||
7 | DisableAll | Disables all network profiles on the device. |
MX: 4.2+ |
||
8 | RemoveAll | Deletes all network profiles from the device. |
MX: 4.2+ |
Used to enter the SSID name of the network on which to perform a Network Action. The SSID is the primary mechanism used to identify a Wi-Fi network and the Wi-Fi network profile to be acted upon.
Parm value input rules:
Shown if: The Network Action is NOT "Do Nothing" or "Disable All Existing Networks" or "Remove All Existing Networks"
Parm Name: SSID
Requires:
- MX: 4.2+
Used to set device security on networks that employ 802.1x Extensible Authentication Protocol (EAP) security. This protocol uses authentication to establish the entitlement of a device to join the network and then distribute necessary keys once this entitlement has been verified. Security information pertaining to the EAP type and authentication credentials to be used will need to be supplied to configure these networks.
Open network security is not generally advisable since no security credentials are needed to connect. If an open network is to be used, security can be added through VPNs, data encryption or other means.
Basic security generally implements a Pre-Shared Key (PSK) or Wired Equivalent Privacy (WEP) key known to the device and the Wi-Fi infrastructure to encrypt data. These networks are more secure than open networks, but can be compromised if the keys are not handled securely and/or changed periodically. Security information pertaining to the required key must be supplied to configure these networks.
Shown if: The Network Action is "Add"
Parm Name: SecurityMode
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Open | Sets the device to use no security. |
MX: 4.2+ |
||
1 | Personal | Sets the device to use basic security. |
MX: 4.2+ |
||
2 | Enterprise | Sets the device to use advanced security. |
MX: 4.2+ |
Used to select the Wi-Fi security mode in use on the selected WLAN. When the selected Security Mode is "Personal" or "Enterprise," the WPA Mode must be specified to determine the key type to use. WPA performs encryption using the Temporal Key Integrity Protocol, and a TKIP-compatible key must be specified. WPA2 supports encryption using TKIP (and is therefore backward-compatibile with WPA) and the more secure Advanced Encryption Standard (AES) algorithm. For key selection for this mode, enter either TKIP, AES or auto-select.
Shown if: The Network Action is "Add" and the Security Mode is "Personal" or "Enterprise"
Parm Name: WPAMode
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | WPA | Enables Wi-Fi Protected Access (WPA) encryption mode on the device. |
MX: 4.2+ |
||
2 | WPA2 | Enables Wi-Fi Protected Access version 2 (WPA2) standard on the device. |
MX: 4.2+ |
||
3 | WPA/WPA2 | Enables Wi-Fi Protected Access (WPA) standard on the device. |
MX: 4.2+ |
||
4 | WEP | Enables Wired Equivalency Privacy (WEP) standard on the device. |
MX: 4.2+ |
Used to select the Wi-Fi security mode in use on the selected WLAN. When the selected Security Mode is "Personal" or "Enterprise," the WPA Mode must be specified to determine the key type to use. WPA performs encryption using the Temporal Key Integrity Protocol. A TKIP-compatible key must be specified. WPA2 supports encryption using TKIP (and is therefore backward-compatibile with WPA) and the more secure Advanced Encryption Standard (AES) algorithm. For key selection for this mode, enter either TKIP, AES or auto-select.
Shown if: The Network Action is "Add" and the Security Mode is "Personal" or "Enterprise"
Parm Name: WPAModePersonal
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | WPA | Enables Wi-Fi Protected Access (WPA) encryption mode on the device. |
MX: 10.2+ |
||
2 | WPA2 | Enables Wi-Fi Protected Access version 2 (WPA2) standard on the device. |
MX: 10.2+ |
||
3 | WPA/WPA2 | Enables Wi-Fi Protected Access (WPA) standard on the device. |
MX: 10.2+ |
||
4 | WEP | Enables Wired Equivalency Privacy (WEP) standard on the device. |
MX: 10.2+ |
||
5 | WPA3 (SAE) | Enables Wi-Fi Protected Access version 3 (WPA3) standard with support for Simultaneous Authentication fo Equals operations. |
MX: 10.2+ |
Used to enter the Wi-Fi Protected Access (WPA) encryption type to enforce on the network for Wi-Fi log-ins. The values that can be selected for Encryption Type will vary based on the selections made for Security Mode and WPA Mode. A selection must always be made for Encryption Type whenever Security Mode is not "Open" (no encryption).
Shown if: The Network Action is "Add" and the Security Mode is "Personal" or "Enterprise" and the WPA Mode is WPA
Parm Name: EncryptionWPA
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Default | This value (or the absence of this parm from the XML) cause no change to the encryption type that is currently selected on the device; any previously selected setting is retained. |
MX: 4.2+ |
||
1 | TKIP | Selects use of the Temporal Key Integrity Protocol (TKIP) standard with a per-packet key length of 128 bits. |
MX: 4.2+ |
Used to enter the Wi-Fi Protected Access II (WPA2) encryption type to enforce on the network for Wi-Fi log-ins.
Shown if: The Network Action is "Add" and the Security Mode is "Personal" or "Enterprise" and the WPA Mode is WPA2 or WPA/WPA2
Parm Name: EncryptionWPA2
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Default | This value (or the absence of this parm from the XML) causes no change to the encryption type that is currently selected on the device; any previously selecting setting is retained. |
MX: 4.2+ |
||
1 | AES-CCMP | Selects use of the Advanced Encryption Standard - Counter mode Cipher block chaining Message authentication code Protocol (AES-CCMP) standard, wherein the AES block cipher is used with a per-packet key length of 128 bits. |
MX: 4.2+ |
||
2 | TKIP | Selects use of the Temporal Key Integrity Protocol (TKIP) standard with a per-packet key length of 128 bits. |
MX: 4.2+ |
||
3 | AES-CCMP/TKIP | Selects the use of either the AES-CCMP standard or the TKIP encryption standard and the proper encryption type to use can be automatically determined by negotiation with the Wi-Fi infrastructure. |
MX: 4.2+ |
Used to enter the Wired Equialent Privacy (WEP) encryption type to enforce on the network for Wi-Fi log-ins.
Shown if: The Network Action is "Add" and the Security Mode is "Personal" or "Enterprise" and the WPA Mode is WEP
Parm Name: EncryptionWEP
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | WEP-40 | Selects use of the Wireless Equivalency Privacy (WEP) standard with a key size of 40 bits. |
MX: 4.2+ |
||
2 | WEP-104 | Selects use of the Wireless Equivalency Privacy (WEP) standard with a key size of 104 bits. |
MX: 4.2+ |
Used to enter the type of encryption key to be used by the network. A key is specified only when the Security Mode is "Personal" since the "Open" Security Mode does not use encryption and the "Enterprise" Security Mode distributes keys automatically after Authentication.
An encryption key can be specified using either of these methods:
The selected method usually depends on the configuration of the Wi-Fi network because the key must be shared between the Wi-Fi infrastructure and the client. Therefore, they must use a common method to enter the key.
Shown if: The Network Action is "Add" and the Security Mode is "Personal"
Parm Name: KeyType
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
HexKey | Hex Key | The key used by the network to perform encryption is specified. |
MX: 4.2+ |
||
Passphrase | Passphrase | A passphrase derived from the specified key and used by the network to perform encryption. |
MX: 4.2+ |
Enables encryption of the Key. The Key (or the Passphrase used to generate a Key) is generally considered sensitive information since having the Key for a network grants access to that network. Since the Key or Passphrase must be embedded within the XML, it is often desirable to encrypt the Key or Passphrase so it cannot be extracted and exploited if the XML is intercepted. The specified WPA Mode and the Key Type determine what type of Key or Passphrase must used. The value selected for the ProtectKey parameter deterimes whether the Key or Passphrase is specified as clear or encrypted text.
Shown if: The Network Action is "Add" and the Security Mode is "Personal"
Parm Name: ProtectKey
Requires:
- MX: 4.2+
Controls whether the Key is encrypted. When the Key Type is Passphrase, then the specified Passphrase is used to generate the Key. The required Passphrase will vary depending on the WPA Mode specified (WEP or WPA Passphrase).
Note: Currently, the parm value encryption process is not documented and the key that is needed to encrypt is not published. Therefore, an MDM cannot currently use encrypted Keys or Passphrases since there is no way to store an encrypted, server-supplied password in XML file.
If WEP is selected and Protect Key is false:
If WEP is selected and Protect Key is true:
If WEP is not selected and Protect Key is false:
If WEP is not selected and Protect Key is true:
Parm Name: PassphraseWEPClear, PassphraseWEPEncrypted, PassphraseWPAClear, PassphraseWPAEncrypted
Requires:
- MX: 4.2+
Used to select the Wi-Fi security mode in use on the selected WLAN. When the selected Security Mode is "Personal" or "Enterprise," the WPA Mode must be selected to determine the key type to use. WPA performs encryption using the Temporal Key Integrity Protocol. A TKIP-compatible key must be specified. WPA2 supports encryption using TKIP (and is therefore backward-compatibile with WPA) and the more secure Advanced Encryption Standard (AES) algorithm. For key selection for this mode, enter either TKIP, AES or auto-select.
Shown if: The Network Action is "Add" and the Security Mode is "Enrerprise" or "Enterprise"
Parm Name: WPAModeEnterprise
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | WPA | Enables Wi-Fi Protected Access (WPA) encryption mode on the device. |
MX: 10.2+ |
||
2 | WPA2 | Enables Wi-Fi Protected Access version 2 (WPA2) standard on the device. |
MX: 10.2+ |
||
3 | WPA/WPA2 | Enables Wi-Fi Protected Access (WPA) standard on the device. |
MX: 10.2+ |
||
4 | WEP | Enables Wired Equivalency Privacy (WEP) standard on the device. |
MX: 10.2+ |
||
5 | WPA3 | Enables Wi-Fi Protected Access version 3 (WPA3) standard on the device. |
MX: 10.2+ |
||
6 | WPA3 192-bit | Enables 192-bit Wi-Fi Protected Access version 3 (WPA3) standard on the device. |
MX: 10.2+ |
Used to enter the Identity, which can be a user name, email address, ID number or other unique identifier. The Identity combines with a Password to form an authentication credential for gaining access to a network. Authentication is required only when "Enterprise" is the selected Security Mode. Once a credential is accepted by the Authentication Server, the Identity is replaced by an encryption key and has no further significance.
Entering an empty (length of zero) value (or the absence of this parm from the XML) will fail to set an Identity.
Shown if: The Network Action is "Add" and the Authentication is "PEAP-NONE"
Parm Name: Identity
Requires:
- MX: 4.2+
Used to enter an Anonymous Identity for systems that support separate authentication outside of a secure tunnel.
When using an EAP type that has a secure tunnel over which authentication credentials can be delivered, it is sometimes necessary to enter an Identity outside the protections of the tunnel. In these cases, an Anonymous Identity can be sent so as not to disclose the actual Identity, password or other verifying credentials. A separate Anonymous Identity can be used only if the Authentication Server is set up to support it.
If no Anonymous Identity is specified, then the actual Identity is sent outside the tunnel, if required. This may still be secure since the password and/or other verifying credentials are always sent inside the tunnel (in modes that use a tunnel for secure credential delivery). Using the actual Identity outside the tunnel would therefore risk disclosure of only part of the information needed to authenticate.
Parm value input rules:
Note: Entering an empty (length of zero) value (or the absence of this parm from the XML) will fail to set an Anonymous Identity.
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" and the Authentication is NOT "EAP-TLS" or "LEAP"
Parm Name: AnonymousIdentity
Requires:
- MX: 4.2+
Controls whether passwords are stored as encrypted or clear text while in transit to the device. Passwords specified in Profile Manager are embedded within an XML file and sent to the device for consumption as part of a configuration. Encrypting a Password might be desirable as a security measure to prevent extraction and exploitation in case the XML is intercepted while in transit.
A Password combines with an Identity to form an authentication credential for gaining access to a network. Authentication is required only when "Enterprise" is the selected Security Mode. All authentication types require a Password except EAP-TLS, which uses a client certificate.
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" and the Authentication is NOT "EAP-TLS"
Parm Name: ProtectPassword
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | (unchecked) | Passwords are stored in clear text on the device unless specifically encrypted using the Password Protect Encryption parameter. |
MX: 4.2+ |
||
1 | (checked) | Encrypted and clear-text Passwords are stored in a protected area on the device that is NOT accessible by users or unauthorized applications. |
MX: 4.2+ |
Used to enter a Password to be used to connect to a network. This parameter name will change according to the value of ProtectPassword:
If ProtectPassword is false:
If Protect Password is true:
Parm value input rules:
NOTE: The encryption process for this parameter value is currently undocumented, and the key required to encrypt is unpublished. Since there is currently no way to store an encrypted, server-supplied password within an XML file, mobile device management (MDM) systems cannot use an encrypted password.
Parm Name: PasswordClear, PasswordEncrypted
Requires:
- MX: 4.2+
Optional parameter used to enter the name of a certificate alias to be used to verify a server.
Parm value input rules:
NOTES:
Applicability of this Enterprise Authentication option might depend on the version of Android running in the device. See Authentication parameter for verify applicability.
When Security Mode is "Enterprise," the device must authenticate to an Authentication Server using the defined Authentication type. This involves sending potentially sensitive authentication credentials to the Authentication Server. Zebra recommends against this unless the authenticity of the Authentication Server can be verified, for example to ensure that it is not attempting to carry out a "man in the middle" attack.
The device contacts and challenges the Authentication Server to assert and prove its Identity through the use of a server certificate. The device must be able to establish the validity of that certificate and must trust the chain of authority of the issuer of that certificate. This would all occur whether or not a Server Certificate Name is specified.
By default, a certificate asserted by an Authentication Server is trusted if it can be verified to have been issued by any trusted certificate authority. If a Server Certificate Name is supplied, the certificate asserted by an Authentication Server is trusted only if it is verified to have been issued by that specific trusted certificate authority. This increases the security by preventing the use of certificates issued by authorities that are not trusted to issue certificates to authentication servers.
Entering an empty (length of zero) value (or the absence of this parm from the XML) will fail to set the Optional Server Certificate.
In the special case involving a server using a self-signed certificate, the server’s own certificate is also the Root CA Cert that stands behind the server’s certificate.
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" and the Authentication is "EAP-TLS" or "PEAP-MSCHAPV2" or "EAP-TTLS-MSCHAP" or "EAP-FAST-MSCHAPV2" or "EAP-TTLS-PAP" or "PEAP-GTC" or "EAP-FAST-MSCHAPV2" or "EAP-FAST-GTC" or "PEAP-NONE"
Parm Name: OptionalServerCertificate
Requires:
- MX: 4.2+
Optional parameter that allows the name of a client certificate alias to be used to join a network. When Authenticating with EAP types other than EAP-TLS (which would not require a client certificate), a client is still allowed. In this case, the client certificate is used to authenticate the device to the authentication server as part of the establishment of the secure tunnel over which further authentication credentials is delivered. The client certificate does not need to be unique, even if the authentication credentials are. The use of a client certificate can introduce an additional level of protection by requiring a device to have a valid client certificate as well as valid authentication credentials. The client certificate serves as a first-pass filter.
Parm value input rules:
NOTES:
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" the Authentication is "PEAP-MSCHAPV2" or "EAP-TTLS-MSCHAP" or "EAP-TTLS-MSCHAPV2" or "EAP-TTLS-PAP" or "PEAP-GTC" or "EAP-FAST-MSCHAPV2" or "EAP-FAST-GTC" or "PEAP-NONE"
Parm Name: OptionalClientCertificate
Requires:
- MX: 4.2+
Controls whether the device user is permitted to suppress validation of the server certificate when configuring a network using the in-device Settings panel.
Parm Name: MandateServerCertificate
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the setting; any previously selected setting is retained. |
MX: 11.6+ |
||
1 | Enable | Prevents the device user from suppressing validation of the server certificate. |
MX: 11.6+ |
||
0 | Disable | Allows the device user to suppress validation of the server certificate. |
MX: 11.6+ |
Used to enter the name of a mandatory certificate alias to be used to verify a server.
Parm value input rules:
NOTES:
Applicability of this Enterprise Authentication option might depend on the version of Android running in the device. See Authentication parameter for verify applicability.
When Security Mode is "Enterprise," the device must authenticate to an Authentication Server using the defined Authentication type. This involves sending potentially sensitive authentication credentials to the Authentication Server. Zebra recommends against this unless the authenticity of the Authentication Server can be verified, for example to ensure that it is not attempting to carry out a "man in the middle" attack.
The device contacts and challenges the Authentication Server to assert and prove its Identity through the use of a server certificate. The device must be able to establish the validity of that certificate and must trust the chain of authority of the issuer of that certificate. This would all occur whether or not a Server Certificate Name is specified.
By default, a certificate asserted by an Authentication Server is trusted if it can be verified to have been issued by any trusted certificate authority. If a Server Certificate Name is supplied, the certificate asserted by an Authentication Server is trusted only if it is verified to have been issued by that specific trusted certificate authority. This increases the security by preventing the use of certificates issued by authorities that are not trusted to issue certificates to authentication servers.
Entering an empty (length of zero) value (or the absence of this parm from the XML) will fail to set the Mandatory Server Certificate.
In the special case involving a server using a self-signed certificate, the server’s own certificate is also the Root CA Cert that stands behind the server’s certificate.
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" and the Authentication is "EAP-TLS" or "PEAP-MSCHAPV2" or "EAP-TTLS-MSCHAP" or "EAP-FAST-MSCHAPV2" or "EAP-TTLS-PAP" or "PEAP-GTC" or "EAP-FAST-MSCHAPV2" or "EAP-FAST-GTC" or "PEAP-NONE"
Parm Name: MandatoryServerCertificate
Requires:
- MX: 4.2+
Used to enter the name of the certificate alias to be used to join the network (Mandatory). When Authenticating using EAP-TLS, a client certificate is used instead of a Password. When the Authentication type is EAP-TLS, a client certificate must be specified and a Password will not be accepted.
Parm value input rules:
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise" and the Authentication is "EAP-TLS"
Parm Name: MandatoryClientCertificate
Requires:
- MX: 4.2+
Used to select a security certificate Action for the domain server specified in the Server Cert Domain Name parameter.
Parm Name: ServerCertificateAction
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do Not Validate | This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained. |
MX: 11.6+ |
||
1 | Use System Certificates | Uses existing system security certificates. |
MX: 11.6+ |
||
0 | User Installed Certificates | Uses security certificates installed by the user. |
MX: 11.6+ |
Used to enter the domain name of the domain server on which to perform the selected certificate Action.
Parm value input rules:
Shown if: WPA Mode Enterprise is NOT "WPA3 192-bit" and Server Certificate Action is NOT "Do Not Validate"
Parm Name: DomainName
Requires:
- MX: 11.6+
Controls whether the device obtains its IP settings automatically using DHCP or manually by an administrator. When disabled (value=0), an individual IP address must be specified for the device as well as those for the default gateway, subnet mask and at least one DNS server using the relevant parameters below.
Shown if: The Network Action is "Add"
Parm Name: UseDHCP
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | (checked) | Sets the device to obtain IP settings from a DHCP server. |
MX: 4.4+ |
||
0 | (unchecked) | Allows IP address settings to be configured manually. |
MX: 4.4+ |
Used to enter a static IP address for the device. Must be an address that is unique to the network on which the device will operate.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpAddress
Requires:
- MX: 4.2+
Used to enter the IP address of the default gateway for the device, through which packets to and from outside networks are routed. This parameter is required only if the device must have access to (or from) networks beyond its local subnet.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpGateway1
Requires:
- MX: 4.2+
Used to enter the IP address of an optional second default gateway for the device, through which packets to and from outside networks are routed. This parameter is required only if the device must have access to (or from) networks through a second network adapter.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpGateway2
Requires:
- MX: 4.2+
Used to enter a subnet mask for the device, which defines the network subdivision on which the device will operate.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpMask
Requires:
- MX: 4.2+
Used to enter the primary domain name server for the device. This parameter is required only if DNS name resolution is required for the device.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpDns1
Requires:
- MX: 4.2+
Used to enter a secondary domain name server for the device. This parameter is required only if an alternate DNS is required for the device.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use DHCP" box is unchecked
Parm Name: IpDns2
Requires:
- MX: 4.2+
Controls use of a proxy, an intermediary service that routes HTTP traffic between clients on a device and another network (typically the internet or an intranet). When used, proxy settings can be configured manually or can be contained in a PAC file for automatic configuration. When there is a proxy between the Wi-Fi network and some outer network, HTTP-based applications might need to negotiate with the proxy to access the services of the outer network.
In MX 5.0 and later, the data type for this parameter changed from a boolean (1=true; 0=false) to a value selected from the UseProxy list below.
Parm Name: UseProxy
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | None | Since MX 5.0, the use of a code over a boolean value was implemented. This value was unaffected. |
MX: 5.0+ |
||
1 | Manual | Since MX 5.0, the use of a code over a boolean was implemented. This value indicates a Manual Proxy. |
MX: 5.0+ |
||
3 | Proxy Auto-Config | Automatically use a proxy. This value was introduced in MX 5.0. |
MX: 5.0+ |
Provide the Host Name or IP Address of the computer on which the proxy is running. Host Name can be used only if the network provides suitable name resolution. Otherwise, an IP Address would need to be provided.
Since different Wi-Fi networks may have different proxies connecting them to different outer networks, proxy information, if needed, must be configured for each network.
Parm value input rules:
Shown if: The Network Action is "Add" and "Use Proxy" is set to manual.
Parm Name: ProxyHostName
Requires:
- MX: 4.2+
Provide the Host Name or IP Address of the location of where the proxy PAC file is located. This can be used only if the network provides suitable name resolution. Otherwise, an IP Address would need to be provided.
Since different Wi-Fi networks may have different proxies connecting them to different outer networks, proxy information, if needed, must be configured for each network.
Parm value input rules:
Note: On devices running Android 13, this feature will be implemented in a later OS update.
Shown if: The Network Action is "Add" and "Use Proxy" is set to Proxy Auto-Config.
Parm Name: ProxyPAC
Requires:
- MX: 5.0+
Used to enter the Port number for reaching a Proxy Server to access the Internet.
Shown if: The Network Action is "Add" and "Use Proxy" is set to manual.
Parm Name: ProxyPort
Requires:
- MX: 4.2+
Used to enter the host name(s) and/or IP address(es) for direct access by a device, bypassing the Proxy server specified in the Proxy Host Name parameter. Multiple names and/or IP addresses can be specified in any combination, separated by commas. Generally used for entering internal servers and/or as a means to prevent traffic overload on the specified Proxy server. Traffic bound for any host not specifically excluded using this parameter is routed through the specified Proxy server.
Zebra recommends testing bypass-proxy settings on a working device before general deployment.
Input rules:
Shown if: The Network Action is "Add" and "Use Proxy" is set to manual.
Parm Name: BypassProxy
Requires:
- MX: 4.2+
Used to select whether communications on the device should go through a Global Proxy, an intermediary service that routes HTTP traffic between clients on a device and another network (typically the internet or an intranet).
Parm Name: GlobalProxyState
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | 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: 11.4+ |
||
1 | On | Forces HTTP communications on the device to go through a Global Proxy. |
MX: 11.4+ |
||
0 | Off | Allows non-proxy HTTP device communications. |
MX: 11.4+ |
Used to enter the Host Name or IP Address of the computer on which the Global Proxy is running. Host Name can be used only if the network provides suitable name resolution. Otherwise, an IP Address must be provided.
Since different Wi-Fi networks might have different proxies connecting them to different outer networks, proxy information, if needed, must be configured for each network.
Parm value input rules:
Shown if: The Global Proxy State is "On"
Parm Name: GlobalProxyHostName
Requires:
- MX: 11.4+
Used to enter the Port number for reaching a Proxy Server to access the Internet.
Parm value input rules:
Shown if: The Global Proxy State is "On"
Parm Name: GlobalProxyPort
Requires:
- MX: 11.4+
Used to enter the host name(s) and/or IP address(es) for direct access by a device, bypassing the Global Proxy server specified in the Global Proxy Host Name parameter. Multiple names and/or IP addresses can be specified in any combination, separated by commas. Generally used for entering internal servers and/or as a means to prevent traffic overload on the specified Proxy server. Traffic bound for any host not specifically excluded using this parameter is routed through the specified Global Proxy server.
Zebra recommends testing bypass-proxy settings on a working device before general deployment.
Parm value input rules:
Shown if: The Global Proxy State is "On"
Parm Name: GlobalProxyBypass
Requires:
- MX: 11.4+
Used to enter the Authentication Mode used by the network. When a Security Mode of "Enterprise" is selected, an Authentication Mode must be specified to determine how authentication is performed as part of the 802.1x EAP type used by the network.
Shown if: The Network Action is "Add" and the Security Mode is "Enterprise"
Parm Name: Authentication
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | EAP-TLS | This indicates that the network requires authentication using the 802.1x Extensible Authentication Protocol - Transport Layer Security (EAP-TLS) standard (RFC 5216). EAP-TLS requires a device identity to be specified and requires that a client certificate be specified to prove the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
2 | PEAP-MSCHAPV2 | This indicates that the network requires authentication using the Microsoft Challenge Authentication Protocol Version 2 (MSCHAPV2) within a secure TLS tunnel established using the Protected Extensible Authentication Protocol, (PEAP) defined by Cisco Systems, Microsoft, and RSA Security. PEAP-MSCHAPV2 requires a device identity to be specified and requires that a password be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
4 | LEAP | This indicates that the network requires authentication using the Lightweight Extensible Authentication Protocol (LEAP) defined by Cisco. LEAP uses a modified version of MSCHAP without a secure tunnel and hence can be easily compromised. LEAP requires a device identity to be specified and requires that a password be specified to prove the authenticity of that device identity. Unlike standard EAP modes, LEAP does not support an optional certificate to help verify the identity of the authentication server. |
MX: 4.2+ |
||
6 | EAP-TTLS-MSCHAP | This indicates that the network requires authentication using the Microsoft Challenge Authentication Protocol (MSCHAP) within a secure TLS tunnel established using the 802.1x Extensible Authentication Protocol - Tunneled Transport Layer Security (EAP-TTLS) standard (RFC 5281). EAP-TTLS-MSCHAP requires a device identity to be specified and requires that a password be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
7 | EAP-TTLS-MSCHAPV2 | This indicates that the network requires authentication using the Microsoft Challenge Authentication Protocol Version 2 (MSCHAPV2) within a secure TLS tunnel established using the 802.1x Extensible Authentication Protocol - Tunneled Transport Layer Security (EAP-TTLS) standard (RFC 5281). EAP-TTLS-MSCHAPV2 requires a device identity to be specified and requires that a password be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
8 | EAP-TTLS-PAP | This indicates that the network requires authentication using the Password Authentication Protocol (PAP) within a secure TLS tunnel established using the 802.1x Extensible Authentication Protocol - Tunneled Transport Layer Security (EAP-TTLS) standard (RFC 5281). EAP-TTLS-PAP requires a device identity to be specified and requires that a password be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
10 | PEAP-GTC | This indicates that the network requires authentication using a token generated using a Generic Token Card (GTC) within a secure TLS tunnel established using the Protected Extensible Authentication Protocol, (PEAP) defined by Cisco Systems, Microsoft, and RSA Security. PEAP-GTC requires a device identity to be specified and requires that a token value (typically obtained from a physical token device) be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
11 | EAP-FAST-MSCHAPV2 | This indicates that the network requires authentication using the Microsoft Challenge Authentication Protocol Version 2 (MSCHAPV2) within an anonymous TLS tunnel established using the 802.1x Extensible Authentication Protocol - Flexible Authentication via Secure Tunneling (EAP-FAST) standard (RFC 5422). |
MX: 4.2+ |
||
13 | EAP-FAST-GTC | This indicates that the network requires authentication using a token generated using a Generic Token Card (GTC) within an anonymous TLS tunnel established using the 802.1x Extensible Authentication Protocol - Flexible Authentication via Secure Tunneling (EAP-FAST) standard (RFC 5422). EAP-FAST-GTC requires a device identity to be specified and requires that a token value (typically obtained from a physical token device) be specified to prove the authenticity of that device identity. An optional client certificate may also be specified to verify the authenticity of the device identity. In all EAP modes, an optional certificate may be specified to help verify the identity of the authentication server. |
MX: 4.2+ |
||
14 | PEAP-NONE | Not supported. |
MX: 5.0+ |
||
15 | EAP-PWD | This indicates that the network requires authentication using the 802.1x Extensible Authentication Protocol, which uses a shared password for authentication. |
MX: 8.1+ |
When Key Type is Hex Key, then a Key, which is expressed as a sequence of hexadecimal characters, needs to be specified. The type of Key required will vary based on the WPA Mode and Encryption Type specified, since it will need to be either a WEP 40 bit Key, a WEP 104 bit Key, or a 256 bit TKIP/AES-CCMP Key.
NOTE: Currently, the parm value encryption process is not documented and the key that is needed to encrypt is not published. Therefore, an MDM cannot currently use encrypted Keys or Passphrases since there is no way to store an encrypted, server-supplied password in an XML.
If WEP is not selected and Protect Key is false:
If WEP is not selected and Protect Key is true:
If WEP is selected, the encryption type is WEP-40, and Protect Key is false:
If WEP is selected, the encryption type is WEP-40, and Protect Key is true:
If WEP is selected, the encryption type is WEP-104, and Protect Key is false:
If WEP is selected, the encryption type is WEP-104, and Protect Key is true:
Parm Name: HexKeyWEPClear, HexKeyWEPEncrypted, HexKeyWPAClear, HexKeyWPAEncrypted
Requires:
- MX: 4.2+
Some Wi-Fi infrastructure that implements a network using WEP encryption may support multiple WEP keys and a WEP index to indicate which key to use at any given time.
NOTE: Android does not currently support multiple WEP keys per network. Therefore, only the first WEP key (
wep[0]
) is supported.
Shown if: The Network Action is "Add" and the Security Mode is "Personal" and the WPA Mode is "WEP"
Parm Name: WepKeyIndex
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | wep[0] |
MX: + |
|||
2 | wep[1] |
MX: + |
|||
3 | wep[2] |
MX: + |
|||
4 | wep[3] |
MX: + |
Used to enter an unencrypted password for PEAP GTC Authentication. Leave blank if no password is required. This parameter supports Static and Dynamic PEAP-GTC Profiles. Static profiles require a pre-defined password specified when configuring the network. Dynamic profiles do not require a pre-defined password to be specified when configured; the password field can be left blank, thereby allowing the user to log in with no password when prompted.
Parm value input rules:
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License on devices using a dynamic profile. See techdocs.zebra.com/licensing.
Shown if: The selected Authentication Code is "PEAP GTC" and Protect Password box is "Unchecked"
Parm Name: PasswordClearPEAPGTC
Requires:
- MX: 9.1+
Used to enter an encrypted password for PEAP GTC Authentication. Leave blank if no password is required. This parameter supports Static and Dynamic PEAP-GTC Profiles. Static profiles require a pre-defined password specified when configuring the network. Dynamic profiles do not require a pre-defined password to be specified when configured; the password field can be left blank, thereby allowing the user to log in with no password when prompted.
Parm value input rules:
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License on devices using a dynamic profile. See techdocs.zebra.com/licensing.
Shown if: The selected Authentication Code is "PEAP GTC" and Protect Password box is "Checked"
Parm Name: PasswordEncryptedPEAPGTC
Requires:
- MX: 9.1+
Controls whether Wi-Fi hotspot settings can be configured on the device.
Hotspot functionality is supported only on the following Zebra devices running Android 6.x Marshmallow or later:
* Purchase of an MDNA Enterprise license required to use this feature.
† Supports use of only the 2.4GHz band when configured as a hotspot.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Parm Name: UseHotspotOptions
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | (unchecked) | Prevents Wi-Fi hotspot settings from being configured. |
MX: 6.3+ |
||
1 | (checked) | Allows Wi-Fi hotspot settings to be configured. |
MX: 6.3+ |
Used to enter the Wi-Fi hotspot Service Set Identifier (SSID), the name visible to devices attempting to select the hotspot as an internet access point.
Parm value input rules:
Shown if: The "Specify Hotspot Options" checkbox is checked and "Hotspot" is set to "Enable"
Parm Name: HotspotSSID
Requires:
- MX: 6.3+
Used to enter which RF band(s) the device will use for 802.11 communications when configured as a Wi-Fi access point (AP). This parameter is usually set automatically through negotiation with the Wi-Fi infrastructure. However, it might sometimes be desirable to limit Wi-Fi communications to certain bands, leaving other bands free for other purposes.
Shown if: The "Specify Hotspot Options" checkbox is checked and "Hotspot" is set to "Enable"
Parm Name: HotspotBand
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | 2.4GHz | Enables the 2.4GHz band for hotspot communications. |
MX: 6.3+ |
||
1 | 5GHz | Enables the 5GHz band for hotspot communications. |
MX: 6.3+ |
Used to set the Wi-Fi communication channel to be used by devices connecting to the device as a Wi-Fi access point (AP) on the 2.4GHz band.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Specify Hotspot Options" checkbox is checked and "Hotspot Band" is "2.4GHz"
Parm Name: Hotspot24GHz
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
1 | 1 | Selects channel 1 on the 2.4GHz band |
MX: 6.3+ |
||
2 | 2 | Selects channel 2 on the 2.4GHz band |
MX: 6.3+ |
||
3 | 3 | Selects channel 3 on the 2.4GHz band |
MX: 6.3+ |
||
4 | 4 | Selects channel 4 on the 2.4GHz band |
MX: 6.3+ |
||
5 | 5 | Selects channel 5 on the 2.4GHz band |
MX: 6.3+ |
||
6 | 6 | Selects channel 6 on the 2.4GHz band |
MX: 6.3+ |
||
7 | 7 | Selects channel 7 on the 2.4GHz band |
MX: 6.3+ |
||
8 | 8 | Selects channel 8 on the 2.4GHz band |
MX: 6.3+ |
||
9 | 9 | Selects channel 9 on the 2.4GHz band |
MX: 6.3+ |
||
10 | 10 | Selects channel 10 on the 2.4GHz band |
MX: 6.3+ |
||
11 | 11 | Selects channel 11 on the 2.4GHz band |
MX: 6.3+ |
Used to set the Wi-Fi communication channel to be used by devices connecting to the device as a Wi-Fi access point (AP) on the 5GHz band.
Note: The 5GHz band is not supported on the Zebra ET56. For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Specify Hotspot Options" checkbox is checked and "Hotspot Band" is "5GHz"
Parm Name: Hotspot5GHz
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
36 | 36 | Selects channel 36 on the 5GHz band |
MX: 6.3+ |
||
40 | 40 | Selects channel 40 on the 5GHz band |
MX: 6.3+ |
||
44 | 44 | Selects channel 44 on the 5GHz band |
MX: 6.3+ |
||
48 | 48 | Selects channel 48 on the 5GHz band |
MX: 6.3+ |
||
52 | 52 | Selects channel 52 on the 5GHz band |
MX: 6.3+ |
||
60 | 60 | Selects channel 60 on the 5GHz band |
MX: 6.3+ |
||
64 | 64 | Selects channel 64 on the 5GHz band |
MX: 6.3+ |
||
100 | 100 | Selects channel 100 on the 5GHz band |
MX: 6.3+ |
||
104 | 104 | Selects channel 104 on the 5GHz band |
MX: 6.3+ |
||
108 | 108 | Selects channel 108 on the 5GHz band |
MX: 6.3+ |
||
112 | 112 | Selects channel 112 on the 5GHz band |
MX: 6.3+ |
||
116 | 116 | Selects channel 116 on the 5GHz band |
MX: 6.3+ |
||
120 | 120 | Selects channel 120 on the 5GHz band |
MX: 6.3+ |
||
124 | 124 | Selects channel 124 on the 5GHz band |
MX: 6.3+ |
||
128 | 128 | Selects channel 128 on the 5GHz band |
MX: 6.3+ |
||
132 | 132 | Selects channel 132 on the 5GHz band |
MX: 6.3+ |
||
136 | 136 | Selects channel 136 on the 5GHz band |
MX: 6.3+ |
||
140 | 140 | Selects channel 140 on the 5GHz band |
MX: 6.3+ |
||
149 | 149 | Selects channel 149 on the 5GHz band |
MX: 6.3+ |
||
153 | 153 | Selects channel 153 on the 5GHz band |
MX: 6.3+ |
||
157 | 157 | Selects channel 157 on the 5GHz band |
MX: 6.3+ |
||
161 | 161 | Selects channel 161 on the 5GHz band |
MX: 6.3+ |
||
165 | 165 | Selects channel 165 on the 5GHz band |
MX: 6.3+ |
Controls whether user credentials is required on a device before allowing it to connect to the Wi-Fi hotspot.
Shown if: The "Specify Hotspot Options" checkbox is checked and "Hotspot" is set to "Enable"
Parm Name: HotspotSecurityMode
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | Open | Allows any device to connect to the Wi-Fi hotspot without entering credentials. |
MX: 6.3+ |
||
1 | WPA2/PSK | Requires user credentials to be entered before allowing a connection to the Wi-Fi hotspot. |
MX: 6.3+ |
Determines whether the hotspot password stored on the device is encrypted, thereby preventing access to the password by an application or malicious exploit.
Shown if: Hotspot is set to "Enable" and Hotspot Security mode is not "Open"
Parm Name: ProtectHotspotPassphrases
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | (unchecked) | Stores hotspot passwords as clear text |
MX: 6.3+ |
||
1 | (checked) | Stores hotspot password as encrypted text |
MX: 6.3+ |
Controls whether the device user is permitted to change the state (active/inactive) of the hotspot on the device. When Enabled, the device user can "toggle" the hotspot on and off, controlling its use as an internet access point for nearby devices by sharing its cellular connection. When Disabled, the device user can view the hotspot state but cannot change it.
Shown if: The "Use Hotspot Options" checkbox is checked
Parm Name: ToggleHotspot
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 8.1+ |
||
1 | Turn on | Allows the device user to change the state (active/inactive) of the hotspot on the device. |
MX: 8.1+ |
||
0 | Turn off | Prevents the device user from changing the state (active/inactive) of the hotspot on the device. |
MX: 8.1+ |
Used to provide a password for accessing the hotspot and to store it as clear text.
Parm value input rules:
Shown if: The "Specify Hotspot Options" is checked, the "Protect Hotspot Passphrase" checkbox is unchecked and "Hotspot" is set to "Enable"
Parm Name: HotspotPassphraseClear
Requires:
- MX: 6.3+
Used to provide a password for accessing the hotspot and to store it in encrypted form.
Parm value input rules:
Shown if: The "Specify Hotspot Options" and "Protect Hotspot Passphrase" checkboxes are checked, "Hotspot" is set to "Enable" and "Hotspot Security Mode" is "WPA2/PSK"
Parm Name: HotspotPassphraseEncrypted
Requires:
- MX: 6.3+
This is the On/Off switch for the Wi-Fi Hotspot feature on the device (if supported). When enabled, the device acts as an internet access point for nearby devices, sharing its cellular connection according to the settings configured using the hotspot parameters in the sections that follow.
Note: For Zebra Professional-series devices, this feature requires purchase of a Mobility DNA Enterprise License. See techdocs.zebra.com/licensing.
Shown if: The "Use Hotspot Options" checkbox is checked
Parm Name: Hotspot
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
1 | Enable | Enables the device to be used as a Wi-Fi hotspot. |
MX: 6.3+ |
||
0 | Disable | Disables use of the device as a Wi-Fi hotspot. |
MX: 6.3+ |
Determines whether OmniTrail device location services are used and their options configurable. OmniTrail comprises a set of services available in some Zebra devices that enable highly accurate, secure and power-efficient device locationing. OmniTrail can locate a device to within about five (5) feet (1.5 meters).
OmniTrail is supported on the following Zebra devices with MX 6.3 or later:
Note: Support for OmniTrail services has been removed from QC8956-platform devices running Android 8.x (Oreo) and later.
Parm Name: UseOmniTrailOptions
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | (unchecked) | Disables OmniTrail device location services and options. |
MX: 6.3+ |
||
1 | (checked) | Enables OmniTrail device location services and configuration of options. |
MX: 6.3+ |
This is the On/Off switch for OmniTrail location services and options on the device.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailEnable
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
1 | Enable | Enables OmniTrail device location services and options. |
MX: 6.3+ |
||
0 | Disable | Disables OmniTrail device location services and options. |
MX: 6.3+ |
Specifies the type of OmniTrail services to be used according to the access points in use at the facility.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailType
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
2 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
1 | Enable | Enables OmniTrail services for Extreme Networks APs. |
MX: 6.3+ |
||
0 | Disable | Enables OmniTrail services for Cisco APs. |
MX: 6.3+ |
Used to enter the interval (in ms) at which to emit a locational beacon. More frequent beacon emmissions are generally more effective at determining location of devices that are indoors or within other tightly bounded spaces.
Parm value input rules:
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailInterval
Requires:
- MX: 6.3+
Used to select the OmniTrail Subtype, which can help differentiate between regular and special OmniTrail beacons on the Cisco or Extreme Networks access point selected in OmniTrailType parameter.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailSubtype
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
16 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
0 | 0 | Sets the OmniTrail Subtype to 0. |
MX: 6.3+ |
||
1 | 1 | Sets the OmniTrail Subtype to 1. |
MX: 6.3+ |
||
2 | 1 | Sets the OmniTrail Subtype to 2. |
MX: 6.3+ |
||
3 | 3 | Sets the OmniTrail Subtype to 3. |
MX: 6.3+ |
||
4 | 4 | Sets the OmniTrail Subtype to 4. |
MX: 6.3+ |
||
5 | 5 | Sets the OmniTrail Subtype to 5. |
MX: 6.3+ |
||
6 | 6 | Sets the OmniTrail Subtype to 6. |
MX: 6.3+ |
||
7 | 7 | Sets the OmniTrail Subtype to 7. |
MX: 6.3+ |
||
8 | 8 | Sets the OmniTrail Subtype to 8. |
MX: 6.3+ |
||
9 | 9 | Sets the OmniTrail Subtype to 9. |
MX: 6.3+ |
||
10 | 10 | Sets the OmniTrail Subtype to 10. |
MX: 6.3+ |
||
11 | 11 | Sets the OmniTrail Subtype to 11. |
MX: 6.3+ |
||
12 | 12 | Sets the OmniTrail Subtype to 12. |
MX: 6.3+ |
||
13 | 13 | Sets the OmniTrail Subtype to 13. |
MX: 6.3+ |
||
14 | 14 | Sets the OmniTrail Subtype to 14. |
MX: 6.3+ |
||
15 | 15 | Sets the OmniTrail Subtype to 15. |
MX: 6.3+ |
Used to assign a Priority level from 0–3 (lowest to highest) for the OmniTrail beacon frame on Extreme Networks access points.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailPriority
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
4 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
0 | 0 | Sets the OmniTrail Priority to 0 (lowest). |
MX: 6.3+ |
||
1 | 1 | Sets the OmniTrail Priority to 1. |
MX: 6.3+ |
||
2 | 2 | Sets the OmniTrail Priority to 2. |
MX: 6.3+ |
||
3 | 3 | Sets the OmniTrail Priority to 3 (highest). |
MX: 6.3+ |
Used to set a Flag for the OmniTrail beacon frame on Extreme Networks access points.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailFlag
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
4 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
||
3 | 3 | Sets the OmniTrail flag to 3. |
MX: 6.3+ |
||
2 | 2 | Sets the OmniTrail flag to 2. |
MX: 6.3+ |
||
1 | 1 | Sets the OmniTrail flag to 1. |
MX: 6.3+ |
||
0 | 0 | Sets the OmniTrail flag to 0. |
MX: 6.3+ |
Controls the Wi-Fi operating mode to be used by OmniTrail device location services.
Shown if: The "Specify OmniTrail Options" checkbox is checked
Parm Name: OmniTrailDataRateOptions
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | abg | Sets Wi-Fi for 802.11abg mode. |
MX: 6.3+ |
||
1 | 11n | Sets Wi-Fi for 802.11n mode. |
MX: 6.3+ |
||
2 | 11ac | Sets Wi-Fi for 802.11ac mode. |
MX: 6.3+ |
||
3 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current Wi-Fi setting; any previously selected setting is retained. |
MX: 6.3+ |
Sets the data rate used when OmniTrail device location services operate in 802.11abg mode.
Shown if: The "Specify OmniTrail Options" checkbox is checked and "OmniTrail DataRate Options" is set to "abg"
Parm Name: OmnitrailDataRates_abg
Option | Name | Description | Note | Status | Requires |
---|---|---|---|---|---|
0 | 1 | Sets the data rate to 1 Mbps |
MX: 6.3+ |
||
1 | 2 | Sets the data rate to 2 Mbps |
MX: 6.3+ |
||
2 | 5.5 | Sets the data rate to 5.5 Mbps |
MX: 6.3+ |
||
3 | 6 | Sets the data rate to 6 Mbps |
MX: 6.3+ |
||
4 | 9 | Sets the data rate to 9 Mbps |
MX: 6.3+ |
||
5 | 11 | Sets the data rate to 11 Mbps |
MX: 6.3+ |
||
6 | 12 | Sets the data rate to 12 Mbps |
MX: 6.3+ |
||