Cellular 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 - 9.0

Overview

The Cellular Manager (CellularMgr) controls the way a device's cellular data connection is used. This CSP is supported only on Zebra Android devices equipped with a Wireless Wide Area Network (WWAN) adapter and access to a cellular data network. Attempts to use the CellularMgr on unsupported devices returns an error in the Result XML document.

The CellularMgr provides the ability to control the State (active/inactive) and Usage (enabled/disabled) of features. An option's "State" can be thought of as an "On/Off" switch; the feature is available to the device user and apps to make active or inactive as desired. The term "Usage" would be like a cover over the switch, locking it in its current position. When Usage of an option has been Disabled, the cover is closed and the position of the switch cannot be changed by the user or apps. Enabling Usage lifts the cover, enabling Cellular features to be turned on and off at will.

Main Functionality

  • Enable/Disable (control Usage of):
    • Data Roaming
    • Background Data
    • SIM Slot(s)
    • Change the public land mobile network (PLMN)
    • Cellular Data
    • Cellular Data Limit
  • Turn On/Off (control State of):
    • 5G New Radio features
    • Voice Over LTE (VoLTE) / Voice Over New Radio (VoNR)
    • Network type restrictions (GSM, NR, LTE and WCDMA)
    • Data Roaming
    • Background Data
    • Cellular Data
    • Cellular Data Limit
    • Call blocking (emergency calls always allowed)
  • Enter the length of time to override call blocking after an emergency call from the device
  • Enter a custom cellular data limit and warning threshold
  • Select SIM slot for calls
  • Select SIM slot for Voice Over LTE
  • Enter a timeout value for inactive SIM subscription
  • Set the number of unlock retries before service is required to unlock
  • Enter a list of acceptable Mobile Country Codes/Mobile Network Operator (MCC/MNO)
  • Store and erase Lock and Unlock codes
  • Show/hide PLMN user interface controls
  • Lock the device to:
    • A specific network type (GSM, NR, LTE or WCDMA)
    • A specific public land mobile network (PLMN)
    • A specific Mobile Network Operator, sometimes referred to as a "subsidy lock"
    • An individual ICCID (SIM card)
    • Access only by a service technician
  • On multi-SIM L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10:
    • Enable/disable Dual-SIM, Dual Standby (DSDS) mode
    • Enable/disable additional dual-SIM features:
    • Automatic or manual SIM selection for voice, data, messaging
    • Out-of-service counter for SIM auto-switch
  • Select "preferred" SIM slot for:
    • Network-type restrictions
    • Cellular services (all)
    • Text messages
    • Voice calls
    • Network mode (GSM, WCDMA, LTE, 5G, etc.)
  • Erase all eSIM memory
  • Erase specific eSIM profiles from eSIM memory

SIM Socket Usage Enable/Disable

Controls whether the device user can change the selected SIM Socket using the Select SIM Socket parameter. When Disabled, the SIM Socket cannot be selected by the device user. Supported on specific Zebra devices only.

Note: DEPRECATED: This feature will be discontinued in a future MX version. Supported only on WWAN-enabled devices with more than one SIM socket.

Parm Name: SimSocketUsage

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 user control over SIM Socket selection; any previously selected setting is retained.

MX: 6.2+

1 Enable Enables the device user to control which SIM Socket is used.

MX: 6.2+

2 Disable Prevents the user from changing the selected SIM Socket.

MX: 6.2+

SIM Socket Query

Used to enter a SIM card to which to send the query specified in the SIM Socket Query parameter.

Note: Supported only on WWAN-enabled devices with more than one SIM socket.

Parm Name: SimSocketQuery

Option Name Description Note Status Requires
1 SIM1 Sends a query to SIM1.

MX: 6.2+

2 SIM2 Sends a query to SIM2.

MX: 6.2+

3 SIM3 Sends a query to SIM3.

MX: 6.2+

4 SIM4 Sends a query to SIM4.

MX: 6.2+

Select SIM Socket

Used to select which SIM card is used to connect the device to the carrier network. Supported on specific Zebra devices only.

Note: Supported only on WWAN-enabled devices with more than one SIM socket.

Parm Name: SimSocketSelect

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change; the previously selected SIM socket is used.

MX: 6.2+

1 SIM1 Uses SIM1 to connect the device to the carrier network.

MX: 6.2+

2 SIM2 Uses SIM2 to connect the device to the carrier network.

MX: 6.2+

3 SIM3 Uses SIM3 to connect the device to the carrier network.

MX: 6.2+

4 SIM4 Uses SIM4 to connect the device to the carrier network.

MX: 6.2+

Data Roaming Enable/Disable

Controls whether the device user is permitted to change the state (active/inactive) of Data Roaming on the device. When Enabled, Data Roaming can be made active or inactive by the device user. When Disabled, the device user can view the state but cannot change it.

The Data Roaming option determines whether a device can communicate over cellular data networks other than the "home" network provided by the mobile operator with which the active SIM card is affiliated. The convenience of communicating over "foreign" networks while roaming must be weighed against the roaming charges imposed by foreign carriers.

Note: Supported on WWAN-enabled devices only.

Parm Name: DataRoamingUsage

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 usage of the Data Roaming Option; any previously selected setting is retained.

OSX: 4.4+

MX: 4.4+

1 Enable Enables the device user to control the state of Data Roaming on the device.

OSX: 4.4+

MX: 4.4+

2 Disable Prevents the device user from changing the state (active/inactive) of Data Roaming on the device; state can still be controlled programmatically.

OSX: 4.4+

MX: 4.4+

Data Roaming On/Off

This is the On/Off switch for Data Roaming, which gives a device user the option of allowing cellular data connections to be established while a device is outside its "home" network.

Note: Supported on WWAN-enabled devices only.

Parm Name: DataRoamingState

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 the current state of the Data Roaming; any previously selected setting is retained.

MX: 4.3+

Android API: 17+

1 Turn On Turns On Data Roaming, allowing cellular data connections while a device is outside the carrier's home network.

MX: 4.3+

Android API: 17+

2 Turn Off Turns Off Data Roaming, preventing cellular data connections while a device is outside the carrier's home network.

MX: 4.3+

Android API: 17+

Cellular Data Enable/Disable

Controls whether the device user is permitted to change the state (active/inactive) of cellular data on the device. When Enabled, cellular data can be made active or inactive by the device user. When Disabled, the device user can view the state but cannot change it.

Note: Supported on WWAN-enabled devices only.

Parm Name: CellularDataUsage

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 CellularMgr settings; any previously selected setting is retained.

MX: 6.3+

1 Enable Allows the device user to change the state (active/inactive) of cellular data on the device.

MX: 6.3+

2 Disable Prevents the device user from changing the state (active/inactive) of cellular data on the device; state can still be controlled programmatically.

MX: 6.3+

Cellular Data Limit Enable/Disable

Controls whether a limit can be placed on cellular data usage on the device. When Enabled, the device user or an app running on the device can access other parameters that turn data limiting on and off and that control the limit value (in MB per month) and the warning message displayed when the limit is reached. If this parameter is Disabled and cellular data is Enabled on the device, there is no means of limiting data usage over the cellular network, and all related parameters are inaccessible by apps or the device user.

Note: Supported on WWAN-enabled devices only.

Parm Name: CellularDataLimitUsage

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 CellularMgr settings; any previously selected setting is retained.

MX: 6.3+

1 Enable Enables a limit to be set on cellular data usage and the state (active/inactive) of the limit to be controlled by the device user.

MX: 6.3+

2 Disable Prevents a limit on cellular data usage from being set on the device.

MX: 6.3+

Cellular Data Limit On/Off

This is the On/Off switch for limiting cellular data (in MB per month) on the device, and the selector for applying the Android-default or a custom limitation. When Enabled using the Android default limit, the limit is the greater of 5GB or 1.2 times the value specified in the Cellular Data Warning Value parameter, to a maximum of 1TB. If the custom limit is selected, the limit is the value specified in the Cellular Data Limit Value parameter. Once the limit is reached, the cellular data connection is terminated until a new month begins or the restriction is lifted. If no value is specified with the Cellular Data Limit Value parameter, this parameter is ignored and the previously selected Cellular Data Limit State is retained.

Note: Supported on WWAN-enabled devices only.

Shown if: Cellular Data State is set to "Turn On"

Parm Name: CellularDataLimitState

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 CellularMgr settings; any previously selected setting is retained.

MX: 6.3+

1 Enable and set default limit Limits cellular data usage to the Android default value.

MX: 6.3+

2 Enable and set custom limit Limits cellular data usage to the amount set in the Cellular Data Limit Value parameter.

MX: 6.3+

3 Disable Prevents a limit on cellular data usage from being imposed on the device.

MX: 6.3+

Cellular Data Limit Value

Used to enter the limit (in MB per month) of cellular data usage by the device. Once the limit is reached, the cellular data connection is terminated until a new month begins or the restriction is lifted.

Parm value input rules:

  • Integer from 5-1048576 (5MB-1TB) corresponding to the data usage monthly limit

Note: Supported on WWAN-enabled devices only.

Shown if: Cellular Data State is set to "Enable" and Cellular Data Limit State is set to "Enable and set custom limit"

Parm Name: CellularDataLimitValue

Requires:

  • MX: 6.3+

Cellular Data Warning

Controls whether the device user or an app running on the device can enter a threshold for cellular data usage that triggers a warning.

Note: Supported on WWAN-enabled devices only.

Shown if: Cellular Data State is set to "Turn On"

Parm Name: CellularDataWarning

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 CellularMgr settings; any previously selected setting is retained.

MX: 6.3+

1 Set new warning Enables a data limit warning threshold (in MB) to be specified.

MX: 6.3+

Set Cellular Data Warning

Used to enter a threshold (in MB per month) for cellular data usage after which a warning is displayed on the device.

Parm value input rules:

  • Integer from 5-1048576 (5MB-1TB) corresponding to the data usage limit

Note: Supported on WWAN-enabled devices only.

Shown if: Cellular Data State is set to "Turn On" and Cellular Data Warning is set to "Set new warning"

Parm Name: CellularDataWarningValue

Requires:

  • MX: 6.3+

Background Data Enable/Disable

Controls whether the device user is permitted to change the state (active/inactive) of the background data usage on the device. When Enabled, background data can be made active or inactive by the device user. When Disabled, the device user can view the state but cannot change it.

Background data enablement determines whether applications that are not in the foreground are permitted to maintain a data connection over the cellular network (if they are capable of doing so). For example, some email applications continue to download messages while other apps are active or when the device's screen is turned off. When planning for cellular costs and bandwidth utilization, the convenience of having data ready "when it's asked for" must be weighed against the potential for data overage and roaming costs.

Note: Supported on WWAN-enabled devices only.

Parm Name: BackgroundDataUsage

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 CellularMgr settings; any previously selected setting is retained.

OSX: 4.4+

MX: 4.4+

1 Enable Enables the background data state (active/inactive) to be controlled by the device user.

OSX: 4.4+

MX: 4.4+

2 Disable Prevents the background data state (active/inactive) from being controlled by the device user; state can still be controlled programmatically.

OSX: 4.4+

MX: 4.4+

Background Data Blocking On/Off

This is the On/Off switch for background data communication blocking. When On, apps are allowed to use the cellular data connection only when in the foreground, and blocked at all other times. When Off, all background-capable apps are allowed to maintain a data connection whenever they're running, even if they're not in the foreground.

Note: Supported on WWAN-enabled devices only.

Shown if: Background Data Usage is set to "Enable"

Parm Name: BackgroundDataState

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 CellularMgr settings; any previously selected setting is retained.

OSX: 1.3+

MX: 4.3+

1 Turn On Prevents background-capable apps from using the cellular data connection when the app is not in the foreground.

OSX: 1.3+

MX: 4.3+

2 Turn Off Allows background-capable apps to use the cellular data connection when in the background or the foreground.

OSX: 1.3+

MX: 4.3+

Call Blocking Features (checkbox)

Controls whether the administrator has access to configuration of call blocking features, which can be used to prevent the device from recieving incoming calls and its user making outgoing, non-emergency calls. Emergency calls are always allowed regardless of this setting.

Parm Name: CallBlockingFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents configuration of call blocking features.

MX: 11.9+

1 (checked) Allows configuration of call blocking features.

MX: 11.9+

Incoming Calls Enable/Disable

Used to select whether to allow the device to receive incoming calls.

Parm Name: IncomingCalls

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+

1 Allowed Enables the device to receive incoming calls.

MX: 11.9+

2 Blocked Prevents the device from receiving incoming calls.

MX: 11.9+

Outgoing Calls Enable/Disable

Used to select whether to allow the device to make outgoing non-emergency calls. Emergency calls are always allowed.

Parm Name: OutgoingCalls

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+

1 Allowed Enables the device user to make outgoing calls.

MX: 11.9+

2 Blocked Prevents the user from making outgoing non-emergency calls.

MX: 11.9+

Emergency Callback Window

Used to enter the length of time (in minutes) to allow incoming calls after an emergency call is made from the device, overriding call blocking. This parameter is intended to allow the user to receive calls back from law enforcement authorities, emergency services or other parties contacted during an emergency.

Parm value input rules:

  • Integer of 1 or greater. If no value is entered, the default value of 5 is used.

Note: Supported on WWAN-enabled devices only.

Shown if: Incoming Calls is set to "Blocked"

Parm Name: EmergencyCallbackWindow

Requires:

  • MX: 11.9+

Manual PLMN Enable/Disable

Controls whether the device user can change the selected public land mobile network (PLMN), such as that of a carrier network.

Note: Supported on WWAN-enabled devices only.

Parm Name: ManualPlmnLock

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 celular settings; any previously selected setting is retained.

MX: 8.1+

1 Enable Enables the device user to change the selected PLMN.

MX: 8.1+

2 Disable Prevents the user from chaging the selected PLMN.

MX: 8.1+

Manual PLMN LockSet

Used to enter the PLMN LockSet for use on the device. This number includes the mobile country code (MCC) first, which is always three numerical digits, followed by the mobile network code (MNC), which can be two or three digits. Therefore when combined, entry must be expressed as either a single five- or six-digit number (MCCMNC i.e. XXXYY or XXXYYY).

Parm value input rules:

  • String of 5 or 6 numerical characters

Note: Supported on WWAN-enabled devices only.

Shown if: Manual PLMN Lock is set to "Enable"

Parm Name: ManualPlmnLockSet

Requires:

  • MX: 8.1+

PLMN Lock UI Show/Hide

Controls whether the PLMN locking switch appears in the Android Network Settings panel on the device.

Note: Supported on WWAN-enabled devices only.

Parm Name: ShowPlmnLock

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 cellular settings; any previously selected setting is retained.

MX: 8.1+

1 Enable Displays the PLMN locking switch in the Android Network Settings panel.

MX: 8.1+

2 Disable Hides the PLMN locking switch in the Android Network Settings panel.

MX: 8.1+

Dual-SIM Dual Standby Enable/Disable

Controls Dual-SIM Dual Standby (DSDS) mode. When enabled, both SIMs can make or receive calls and/or be designated primary/secondary or dedicated to voice/data, etc. Disabled by default (one SIM active a time).

Note: DEPRECATED: This feature will be discontinued in a future MX version. Supported only on WWAN-enabled SD660-platform devices with dual SIM slot running Android 8.x Oreo or Android 10. Not supported on L10a devices. Changing this setting requires reboot on devices running Android 10 or older.

Parm Name: DsdsUsage

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 cellular settings; any previously selected setting is retained.

MX: 8.1+

1 Enable Sets device to Dual-SIM, Dual Standby mode, enabling both SIMs to be active simultaneously.

MX: 8.1+

2 Disable Sets device to Dual-SIM, Single Standby mode, which allows only one active SIM at a time (default).

MX: 8.1+

DSDS Features (checkbox)

Controls whether the device administrator (DA) has access to configuration of Dual-SIM Dual Standby features.

IMPORTANT: The DSDS Usage parameter MUST be enabled (and device rebooted) before the DSDS Features box is checked and DSDS features are configured.

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Parm Name: DSDSFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents configuration of DSDS features.

MX: 10.0+

1 (checked) Allows configuration of DSDS features.

MX: 10.0+

DSDS Automatic Selection

Controls whether the device automatically selects which SIM card to use for cellular service based on preferences set in the Call, Data, Message and SIM subscription parameters below.

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Shown if: DSDS Features checkbox is "checked"

Parm Name: DsdsAutoService

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: 10.0+

1 Enable Sets the device to automatically select which SIM card to use for cellular service.

MX: 10.0+

2 Disable Prevents the device from automatically selecting which SIM card to use for cellular service.

MX: 10.0+

DSDS SIM Subscription

Allows selection of a SIM card as the "preferred" subscription choice when using Auto Service Selection and both SIM subscriptions are in service when a cellular service is initiated.

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Shown if: DSDS Features checkbox is "checked" and DSDS Auto-service is set to "Enable"

Parm Name: PreferredSimSubscription

Option Name Description Note Status Requires
0 SIM1 Sets SIM1 as the preferred subscription.

MX: 10.0+

1 SIM2 Sets SIM2 as the preferred subscription.

MX: 10.0+

Out-of-Service Timer

Used to enter the amount of time (in seconds) the device will wait during an "Out of Service" condition of the "preferred" SIM subscription before automatically switching to the alternate SIM. Maximum = 3600 (1 hr.).

Parm value input rules:

  • Accepts positive integer values from 1–3600

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Shown if: DSDS Features checkbox is "checked" and DSDS Auto-service is set to "Enable"

Parm Name: OOSTimer

Requires:

  • MX: 10.2+
  • Android API: 26+

DSDS Call Subscription

Allows selection of the SIM subscription to be used as "preferred" for voice calls when automatic SIM selection is NOT used.

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Shown if: DSDS Features checkbox is "checked" and DSDS Auto-service is set to "Disable"

Parm Name: DSDSCallSubscription

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: 10.0+

1 Ask Every Time Causes the device user to be prompted for SIM selection each time a voice call is initiated.

MX: 10.0+

2 SIM1 Sets SIM1 as the preferred subscription for voice calls; the device user is NOT prompted to choose.

MX: 10.0+

3 SIM2 Sets SIM2 as the preferred subscription for voice calls; the device user is NOT prompted to choose.

MX: 10.0+

DSDS Message Subscription

Allows selection of the SIM subscription to be used as "preferred" for message service usage when automatic SIM selection is NOT used.

Note: Supported only on L10, TC57 and TC77 devices running Android 8.x Oreo or Android 10.

Shown if: DSDS Features checkbox is "checked" and DSDS Auto-service is set to "Disable"

Parm Name: DSDSMessageSubscription

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: 10.0+

1 Ask Every Time Causes the device user to be prompted for SIM selection each time a text message is sent.

MX: 10.0+

2 SIM1 Sets SIM1 as the preferred subscription for messaging service.

MX: 10.0+

3 SIM2 Sets SIM2 as the preferred subscription for messaging service.

MX: 10.0+

DA Lock Type

Used to select how the device is locked– either to a Mobile Network Operator (MNO) or an Integrated Circuit Card Identifier (ICCID) SIM card serial number.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: DA Network Lock is "Lock" or "Unlock"

Parm Name: DALockType

Option Name Description Note Status Requires
0 Network Lock Locks the device by MNO.

MX: 9.2+

Android API: 26+

1 ICCID Lock Locks the device by SIM card.

MX: 9.2+

Android API: 26+

DA Advanced Features (checkbox)

Controls whether the device administrator (DA) has access to configuration of advanced features:

  • DA Lock Type
  • DA Network Lock
  • DA Unlock code
  • DA Unlock retry count

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: DAAdvancedFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents configuration of advanced features.

MX: 9.2+

Android API: 26+

1 (checked) Allows configuration of advanced features.

MX: 9.2+

Android API: 26+

Device Admin Network Lock

Used by a device administrator to Lock the device to a specific Mobile Network Operator (MNO) and Unlock it for use on other networks. This feature is sometimes referred to as a "subsidy lock" because it's often associated with the provision of carrier-subsidized devices.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: DeviceAdminNetworkLock

Option Name Description Note Status Requires
1 Lock Locks the MNO.

MX: 9.2+

2 Unlock Unlocks the MNO using a key code.

MX: 9.2+

Retry Count

Used to enter the maximum number of failed attempts to unlock the device, after which the unlock feature is disabled and a service technician is required to re-enable it.

Parm value input rules:

  • String from 1–2 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: DA Network Lock is "Lock" or "Unlock"

Parm Name: RetryCount

Requires:

  • MX: 9.2+
  • Android API: 26+

Service Tech Features (checkbox)

Controls access to Service Technician Advanced Features:

  • Service Tech Activation ID
  • Import MNO Lock
  • Export MNO Lock
  • Wipe MNO Lock

Note: Supported only on WWAN-enabled devices.

Parm Name: SvcAdvancedFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents Service Technician Features from being used.

MX: 9.2+

1 (checked) Allows Service Technician Features to be used.

MX: 9.2+

DA Unlock Code

Used to enter the Device Admin Lock/Unlock Code.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: DA Network Lock is "Lock" or "Unlock"

Parm Name: DAUnlockCode

Requires:

  • MX: 9.2+
  • Android API: 26+

Enter ICCID

Used to enter the Integrated Circuit Card Identifier (ICCID) number, which uniquely identifies a SIM card.

Parm value input rules:

  • String from 5–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: DA Network Lock is "Lock" and DA Lock Type is "ICCID Lock"

Parm Name: Iccid

Requires:

  • MX: 9.2+
  • Android API: 26+

MCC MNC List

Used to enter at least one mobile country code (MCC) and mobile network code (MNC) for use by the device. This number includes the MCC first–which is always three numerical digits–followed by the MNC, which can be two or three digits. Therefore when combined, each entry must be expressed as either a five- or six-digit number (MCCMNC i.e. XXXYY or XXXYYY).

Parm value input rules:

  • String from 5–255 characters
  • Separate multiple values using commas, such as "310410,31090,001001"

Note: Supported on WWAN-enabled devices only.

Shown if: DA Network Lock is "Lock" and DA Lock Type is "Network Lock" or "ICCID Lock"

Parm Name: MccMncList

Requires:

  • MX: 9.2+

MNO Advanced Features (checkbox)

Controls access to configuration of Mobile Network Operator (MNO) advanced features:

  • MNO Lock Action
  • MNO Certificate ID
  • MNO Unlock Code
  • MNO Control Key
  • MNO Retry Count
  • MNO MCCMNC List

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: MNOAdvancedFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents configuration of MNO advanced features.

MX: 9.2+

Android API: 26+

1 (checked) Allows configuration of MNO advanced features.

MX: 9.2+

Android API: 26+

MNO Lock Action

Used to Lock and Unlock the Mobile Network Operator (MNO) on the device using a key code provided by the MNO. This feature is sometimes referred to as a "subsidy lock" because it's often associated with the provision of carrier-subsidized devices.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: MNOLockAction

Option Name Description Note Status Requires
1 Lock Locks the MNO.

MX: 9.2+

2 Unlock Unlocks the MNO.

MX: 9.2+

MNO Certificate Key

Used to navigate to and capture the certificate file on the administrative host computer authorizing use of MNO advanced features.

Parm value input rules:

  • String of at least one (1) character

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: MNO Lock Action is "Lock"

Parm Name: MNOCertificateKey

Requires:

  • MX: 9.2+
  • Android API: 26+

Lock Codes Store/Erase

Used to manage Mobile Network Operator (MNO) Lock codes stored on the device. Codes provided by the MNO are stored on the device and used to lock and unlock the device's MNO.

Note: Supported on WWAN-enabled devices only.

Parm Name: StoreWipeMNOLock

Option Name Description Note Status Requires
1 StoreMNOLock Stores key code for locking and unlocking the MNO.

MX: 9.2+

2 WipeMNOLock Erases all MNO lock key codes stored in the device.

MX: 9.2+

MNO Unlock Code

Used to enter the Integrated Circuit Card Identifier (ICCID) number, which uniquely identifies a SIM card.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: MNO Lock Action is "Unlock"

Parm Name: MNOUnlockCode

Requires:

  • MX: 9.2+
  • Android API: 26+

MNO Control Key

Used to enter the 16-digit code to be used to Lock the device.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: MNO Lock Action is "Lock"

Parm Name: MNOControlKey

Requires:

  • MX: 9.2+
  • Android API: 26+

MNO Retry Count

Used to enter the maximum number of failed attempts to unlock the device, after which the unlock feature is disabled and a service technician is required to unlock the device.

Parm value input rules:

  • String from 1–2 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: MNO Lock Action is "Lock"

Parm Name: MNORetryCount

Requires:

  • MX: 9.2+
  • Android API: 26+

MNO MCC MNC List

Used to enter at least one mobile country code (MCC) and mobile network code (MNC) for use by the device. This number includes the MCC first–which is always three numerical digits–followed by the MNC, which can be two or three digits. Therefore when combined, each entry must be expressed as either a five- or six-digit number (MCCMNC i.e. XXXYY or XXXYYY).

Parm value input rules:

  • String from 5–255 characters
  • Separate multiple values using commas, such as "310410,31090,001001"

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: MNO Lock Action is "Lock"

Parm Name: MNOMccMncList

Requires:

  • MX: 9.2+
  • Android API: 26+

Service Tech Certificate Key

Used to navigate to and capture the certificate file on the administrative host computer to authorize use of Service Technician Advanced Features.

Parm value input rules:

  • String of at least one (1) character

Note: Supported on WWAN-enabled devices only.

Shown if: Service Tech Advanced Features is "checked"

Parm Name: SvcCertificateKey

Requires:

  • MX: 9.2+

Import MNO Lock Info (checkbox)

Controls whether to Import and restore Mobile Metwork Operator (MNO) Lock information from an SD card to restore an MNO Lock.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: ImportMNOLock

Option Name Description Note Status Requires
0 (unchecked) Prevents importation of MNO Lock information.

MX: 9.2+

1 (checked) Allows importation of MNO Lock information.

MX: 9.2+

Export MNO Lock Info (checkbox)

Controls whether Mobile Metwork Operator (MNO) Lock information is saved to internal device storage.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: ExportMNOLock

Option Name Description Note Status Requires
0 (unchecked) Prevents MNO Lock information from being saved to the SD card.

MX: 9.2+

Android API: 26+

1 (checked) Allows MNO Lock information to be saved to the SD card.

MX: 9.2+

Android API: 26+

Erase MNO Lock Info (checkbox)

Controls whether to remove (erase) the current Mobile Metwork Operator (MNO) Lock information stored internally on the device.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: WipeMNOLock

Option Name Description Note Status Requires
0 (unchecked) Leaves MNO Lock information stored on the device.

MX: 9.2+

1 (checked) Removes MNO Lock information from the device.

MX: 9.2+

eSIM Features (checkbox)

Controls the use of eSIM (embedded UICC) features. The Embedded Universal Integrated Circuit Card (eUICC) specification adds to existing SIM features the ability to store wireless-carrier plan and services information, global roaming, remote delivery of updates to apps and services, TCP/IP communications and processing and data storage capabilities.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Parm Name: eSIMFeatures

Option Name Description Note Status Requires
0 (unchecked) Prevents the use of eSIM (embedded UICC) features.

MX: 10.0+

Android API: 26+

1 (checked) Allows the use of eSIM (embedded UICC) features.

MX: 10.0+

Android API: 26+

SIM Service Type

Controls whether the device user can use the device for data and voice calls and only for data.

Note: Supported only on WWAN-enabled devices.

Parm Name: SimServiceType

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

MX: 10.0+

1 Voice + Data Enables the use of voice and data on the selected SIM.

MX: 10.0+

2 Data Only Prevents the device from making voice calls on the selected SIM.

MX: 10.0+

eSIM Slot ID

Used to select the slot that contains the eSIM on which to perform an Action.

Note: Supported only on WWAN-enabled devices with more than one SIM socket.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code"

Parm Name: eSimSlotId

Option Name Description Note Status Requires
0 SIM1 Identifies SIM1 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

1 SIM2 Identifies SIM2 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

eSIM Profile Action

Used to select an action to perform on the selected eSIM Profile.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code"

Parm Name: eSimProfile

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

MX: 10.0+

Android API: 26+

1 Enable Profile Enables the selected profile.

MX: 10.0+

Android API: 26+

2 Disable Profile Disbles the selected profile.

MX: 10.0+

Android API: 26+

3 Delete Profile Deleted the selected profile.

MX: 10.0+

Android API: 26+

4 Change Nickname Changes the name of the selected profile.

MX: 10.0+

Android API: 26+

Profile Nickname

Used to enter a friendly name for an eSIM Profile in the device.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code" OR "Use SM-DP+ Address"

Parm Name: ProfileNickname

Requires:

  • MX: 10.0+
  • Android API: 26+

Change Profile Nickname

Used to enter the existing Profile Nickname on which to perform the Action selected in the eSIM Profile Action parameter.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND eSIM Profile is NOT "Do Not Change"

Parm Name: ChangeProfileNickName

Requires:

  • MX: 10.0+
  • Android API: 26+

Updated Profile Nickname

Used to enter a new Profile Nickname when changing the Profile Nickname.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND eSIM Profile is "Change Nickname"

Parm Name: UpdatedProfileNickName

Requires:

  • MX: 10.0+
  • Android API: 26+

Add Profile

Controls whether to add a carrier eSIM profile using an activation code or Subscription Manager Data Preparation address, or SM-DP+, which encrypts carrier credentials for SIM activation over the air.

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked"

Parm Name: AddProfile

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

MX: 10.0+

Android API: 26+

1 Use Activation Code Enables the use of an activation code for adding a carrier eSIM profile.

MX: 10.0+

Android API: 26+

2 Use SM-DP+ Address Enables the use of an SM-DP+ address for adding a carrier eSIM profile.

MX: 10.0+

Android API: 26+

eSIM Activation Code

Used to enter the activation code for the eSIM in the device.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code"

Parm Name: eSimActivationCode

Requires:

  • MX: 10.0+
  • Android API: 26+

SM-DP+ Address

Used to enter the activation code for the eSIM in the device.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled SDM660-platform devices only.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code"

Parm Name: SmdpAddress

Requires:

  • MX: 10.0+
  • Android API: 26+

Profile Slot ID

Used to select the slot that contains the eSIM profile on which to perform an eSIM Profile Action.

Note: Supported only on WWAN-enabled devices with more than one SIM socket.

Shown if: eSIM Features checkbox is "checked" AND eSIM Profile is NOT "Do not change"

Parm Name: ProfileSlotId

Option Name Description Note Status Requires
0 SIM1 Identifies SIM1 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

1 SIM2 Identifies SIM2 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

SM-DP+ Slot ID

Used to select the slot that contains the eSIM profile to be activated.

Note: Supported only on WWAN-enabled devices with more than one SIM socket.

Shown if: eSIM Features checkbox is "checked" AND Add Profile is "Use Activation Code"

Parm Name: SmdpSlotId

Option Name Description Note Status Requires
0 SIM1 Identifies SIM1 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

1 SIM2 Identifies SIM2 as the slot containing the eSIM profile.

MX: 10.0+

Android API: 26+

eSIM SlotID for Memory Reset

Used to select the eSIM slotID for the memory erasure Action selected in eSIM Memory Reset Type parameter.

Note: Supported on WWAN-enabled devices only. WARNING: This action could cause the deletion of the current cellular subscription and require contact with the cellular provider to reinstate.

Parm Name: ESimMemoryResetSlotId

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 CellularMgr settings; any previously selected setting is retained.

MX: 11.1+

1 1 Selects eSIM slotID 1

MX: 11.1+

2 2 Selects eSIM slotID 2

MX: 11.1+

Preferred Network Mode

Used to select the preferred Network Mode to use for the specified SIM slot.

Not all devices and/or carriers support all listed Network Modes; unsupported selections are ignored.

Note: For WWAN-enabled devices only. This parameter is NOT SUPPORTED on devices with MX 13.2 or later; see Preferred 5G NR Mode.

Shown if: Preferred Network Mode Features is NOT "Turn Off" or "Do Not Change"

Parm Name: PreferredNetworkMode

Option Name Description Note Status Requires
0 GSM/WCDMA Enables usage of GSM and WCDMA networks only.

MX: 11.7+

1 GSM only Enables usage of GSM networks only.

MX: 11.7+

2 WCDMA only Enables usage of WCDMA networks only.

MX: 11.7+

9 GSM/WCDMA/LTE Enables usage of GSM, WCDMA and LTE networks only.

MX: 11.7+

11 LTE only Enables usage of LTE networks only.

MX: 11.7+

23 NR only Enables usage of New Radio (NR for 5G) networks only.

MX: 11.7+

24 NR/LTE Enables usage of NR and LTE networks only.

MX: 11.7+

26 NR/LTE/GSM/WCDMA Enables usage of NR, LTE, GSM and WCDMA networks only.

MX: 11.7+

28 NR/LTE/WCDMA Enables usage of NR, LTE and WCDMA networks only.

MX: 11.7+

Network Mode Slot ID

Used to select the the SIM slot to which to apply the selected Network Mode.

Note: Supported on WWAN-enabled devices only.

Shown if: Preferred Network Mode Features is NOT "Turn Off" or "Do Not Change"

Parm Name: NetworkModePreferredSlotId

Option Name Description Note Status Requires
0 SIM1 Applies selected Network Mode settings to SIM slot 1.

MX: 11.7+

1 SIM2 Applies selected Network Mode settings to SIM slot 2.

MX: 11.7+

Network Mode Features On/Off

Controls the state (On/Off) of Network Mode features, which can restrict communications to the selected Network Type, if supported by the carrier.

Note: Supported on WWAN-enabled devices only.

Parm Name: PreferredNetworkModeFeatures

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

1 Turn On Turns On Network Mode features for the specified SIM slot.

MX: 11.7+

2 Turn Off Resets the Network Mode for the specified SIM slot to its factory default state.

MX: 11.7+

eSIM Memory Reset Type

Used to select the type of eSIM data to permanently erase from the eSIM chip selected in the eSIM Memory Reset Slot ID parameter.

Note: Supported on WWAN-enabled devices only.

Shown if: eSIM Memory Reset SlotID is NOT "Do not change"

Parm Name: ESimMemoryResetType

Option Name Description Note Status Requires
1 Erase All Erases all data stored on the selected eSIM chip.

MX: 11.1+

2 Erase Test Profiles Removes only test profiles from the selected eSIM chip.

MX: 11.1+

3 Erase Operational Profiles Removes only operational profiles from the selected eSIM chip.

MX: 11.1+

4 Erase SMDP PLUS Address Removes Subscription Manager Data Preparation (SM-DP) information from the selected eSIM chip.

MX: 11.1+

5GNR Mode Setting On/Off

Controls configuration of the 5G New Radio. Selecting "Turn On" (option 1) allows the 5GNR in the selected SIM slot to be configured using the 5G Network Mode parameter.

This parameter does NOT control the state (on/off) of the 5G New Radio; it controls only the ability to configure the 5GNR.

Note: Supported on WWAN-enabled devices only. NOT supported on SDM660-platform devices.

Parm Name: Preferred5GNRModeFeatures

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: 13.2+

Android API: 30+

1 Turn On Turns on 5G NR configuration for the specified SIM slot, enabling the 5G Network Mode for the SIM to be set.

MX: 13.2+

Android API: 30+

2 Turn Off Disables configuration of the 5G New Radio in the specified SIM slot, returning the SIM to its factory-default settings.

MX: 13.2+

Android API: 30+

Preferred 5G Network Mode

Used to select standalone (SA) or non-standalone (NSA) 5G New Radio (NR) Mode for the specified SIM slot. While standalone mode is generally preferred for use in an enterprise, this setting is determined by the core network on which devices are to be used.

Note: For WWAN-enabled devices only. NOT supported on SDM660-platform devices.

Shown if: Preferred 5G NR Mode Features is set to "Turn on"

Parm Name: Preferred5GNRMode

Option Name Description Note Status Requires
0 SA + NSA Allows either stand-alone or non stand-alone 5G New Radio modes to be used.

MX: 13.2+

Android API: 30+

1 Non-Stand-Alone (NSA) only Allows only the non-standalone 5G New Radio mode to be used.

MX: 13.2+

Android API: 30+

2 Stand-Alone (SA) only Allows standalone 5G New Radio mode to be used.

MX: 13.2+

Android API: 30+

5G New Radio Slot ID

Used to select the SIM slot to which to apply the selected New Radio (NR) Mode.

Note: Supported only on WWAN-enabled devices with more than one SIM socket. NOT supported on SDM660-platform devices.

Shown if: Preferred 5G NR Mode Features is set to "Turn On"

Parm Name: Preferred5GNRModeSlotId

Option Name Description Note Status Requires
0 SIM1 Designates SIM1 as the slot to enable the selected 5G NR mode.

MX: 13.2+

Android API: 30+

1 SIM2 Designates SIM2 as the slot to enable the selected 5G NR mode.

MX: 13.2+

Android API: 30+

Voice Over LTE Actions

Controls whether to alter the current configuration to enable use of Voice over LTE (VoLTE) and/or Voice over New Radio (VoNR) for communication over public land mobile networks (PLMN), when possible. Selecting option 1 requires specification of a JSON file using the VoLTE Config MccMncList parameter.

Note: Supported on WWAN-enabled devices only.

Parm Name: VolteConfig

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: 13.2+

Android API: 30+

1 Configure using JSON file Allows a JSON file to be specified for configuring the device to use VoLTE/VoNR.

MX: 13.2+

Android API: 30+

Voice Over LTE JSON File

Used to select a JSON file on the administrator PC that contains lists of at least one Mobile Country Code (MCC) and one Mobile Network Code (MNC) to use for Voice Over LTE (VoLTE) and/or Voice over New Radio (VoNR). Submitting an unpopulated mccmnc list erases any previous settings.

The MCC/MNC is a five- or six-digit number that first indicates the country of operation (always three numerical digits) followed by the MNC, which is either two or three digits. When combined, each entry must therefore be expressed as either XXXYY or XXXYYY (where MCC = XXX and MNC = YY or YYY).

Parm value input rules:

  • File in JSON format containing at least one (1) character (an unpopulated mccmnc list erases previous settings)
  • File must be named VolteConfigMccMncList.json

Sample JSON Files

Populated mccmnc list


    {

      "enable_volte":[

        {"mccmnc": "310410"},

        {"mccmnc": "310260"},

        {"mccmnc": "311480"},

        {"mccmnc": "311882"}

      ],

      "enable_vonr":[

       {"mccmnc": "310410"}

      ]    

    }

Unpopulated mccmnc list


{

      "enable_volte":[



      ],

      "enable_vonr":[


      ]    

    }

Shown if: VoLTE Config Action is NOT "Do nothing"

Parm Name: VolteConfigMccMncList

Requires:

  • MX: 13.2+
  • Android API: 30+

Examples

Turn Off Data Roaming and Background Data


<wap-provisioningdoc>
    <characteristic type="CellularMgr" version="4.3" >
        <parm name="DataRoamingState" value="2"/>
        <parm name="BackgroundDataState" value="2"/>
    </characteristic>
</wap-provisioningdoc>