Network Connection Manager

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.

EMDK For Xamarin - 8.0

Overview

The Network Connection Manager (NetworkConnectionMgr) allows an administrator to set preferences for device connection to cellular (WWAN) and Wi-Fi (WLAN) networks to help ensure that devices use the optimal network at all times. NetworkConnectionMgr allows administrators to manage and deploy lists of access points for wireless networks, rank them in order of priority, and/or set minimum signal levels when establishing connections with a set time interval for attempting to improve connections.

Main Functionality

  • Enable/Disable Zebra-enhanced network connection features on the device
  • Set a minimum signal strength for connection to a cellular (WWAN) access point
  • Set a minimum signal strength for connection to a Wi-Fi (WWAN) access point
  • Set a period of time to wait before re-evaluating the quality of the current connection (Wi-Fi only)
  • Deploy prioritized lists of cellular and/or Wi-Fi network names to devices for connection

Access Point Action

Used to select an Action to perform for managing the list of cellular (WWAN) and/or Wi-Fi (WLAN) network names on the device. Cellular networks are identified by their operator name, plus their associated mobile country code (MCC) and mobile network code (MNC). Wi-Fi networks are identified by their SSID.

Parm Name: AccessPointAction

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.9+

Android API: 30+

1 Add/Replace Copies to the device the prioritized list of APs contained in the file specified in the "Network Names List File" parameter, replacing any pre-existing network names on the device.

MX: 11.9+

Android API: 30+

2 Delete all Removes all network names currently stored on the device.

MX: 11.9+

Android API: 30+

Network Names

Used to enter the name of a .txt file containing a prioritized list of cellular (WWAN) and/or Wi-Fi (WLAN) networks. The first name on the list is given the highest priority for connection; each subsequent name gets a lesser priority.

Contents of this file replaces any pre-existing values on the device. Once stored on the device, file contents cannot be edited. To add, delete or change list entries, a new list file must be created and pushed to the device.

Parm input value rules:

  • String of at least one (1) character containing a list of Access Point Names, one entry per line
  • Each line must contain an access technology identifier ("WLAN" or "WWAN") followed by the access point information (SSID or [Operator Name]_MCC-MNC)*, separated by underscore character(s) (see example list file, below).

Example list file:

WLAN_SSID1
WWAN_TestNetwork_001-01
WLAN_SSID2
WWAN_TestNet2_001-02

* MCC = mobile country code; MNC = mobile network code

Shown if: Access Point Action is "Add/Replace"

Parm Name: networkNamesListFile

Requires:

  • MX: 11.9+
  • Android API: 30+

Connection Features Enable/Disable

Controls whether Network Connection Manager enhancement features such as prioritized networks and minimum signal strength for connection are used on the device.

Parm Name: networkConnectionManagerFeatures

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.9+

Android API: 30+

1 Turn On Enables Network Connection Manager enhancement features on the device.

MX: 11.9+

Android API: 30+

2 Turn Off Disables Network Connection Manager enhancement features on the device.

MX: 11.9+

Android API: 30+

Enhanced Connection Parameters (checkbox)

Used to select whether to set preset connection requirements (e.g. AP signal strength) on the device when connecting to a network.

Parm Name: configs

Option Name Description Note Status Requires
0 (unchecked) Prevents selection of preset signal-strength requirements; uses current settings on device.

MX: 11.9+

Android API: 30+

1 (checked) Allows selection of preset signal-strength requirements, replacing pre-existing settings on device.

MX: 11.9+

Android API: 30+

Minimum Signal for WLAN

Used to enter the minimum signal level (in dBm) for connection to a Wi-Fi (WLAN) network. Values range from -90 dBm (poor) to -30 dBm (excellent). A value of "0" (default) is ignored, causing no change to any current value.

Parm input value rules:

  • String representing a negative number to indicate signal strength
  • Entering "0" causes no change to current value, if any

Shown if: Enhanced Connection Parameters (configs) is "checked"

Parm Name: signalLevelToConnectWLAN

Requires:

  • MX: 11.9+
  • Android API: 30+

Minimum Signal for WWAN

Used to enter the minimum signal level (in dBm) for connection to a cellular (WWAN) network. Values range from -156 dBm (poor) to -31 dBm (excellent). A value of "0" (default) is ignored, causing no change to any current value.

Parm input value rules:

  • String representing a negative number to indicate signal strength
  • Entering "0" causes no change to current value, if any

Shown if: Enhanced Connection Parameters (configs) is "checked"

Parm Name: signalLevelToConnectWWAN

Requires:

  • MX: 11.9+
  • Android API: 30+

Refresh Interval

Used to enter a time interval (in seconds) to wait before comparing the quality of the current connection against those from the list of cellular and Wi-Fi access points stored on the device. A value of "0" (default) is ignored, causing no change to any current value.

Parm input value rules:

  • Positive integer of any length (600 = 10 min.)
  • Entering "0" causes no change to current value, if any

Shown if: Enhanced Connection Parameters (configs) is "checked"

Parm Name: refreshInterval

Requires:

  • MX: 11.9+
  • Android API: 30+