Cellular Manager

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

EMDK For Android - 7.3

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 programs or the device user 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. Enabling Usage lifts the cover, enabling the device user to control Cellular features.

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):
    • Data Roaming
    • Background Data
    • Cellular Data
    • Cellular Data Limit
  • Enter a custom cellular data limit and warning threshold
  • Select SIM Slot
  • 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 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 mode
    • Enable/disable additional dual-SIM features:
    • Automatic or manual SIM selection for voice, data, messaging
    • Out-of-service counter for SIM auto-switch

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: Supported only on WWAN-enabled devices with more than one SIM socket.

Parm Name: SimSocketUsage

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

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 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 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 (active/inactive) 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 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 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 On/Off

This is the On/Off switch for device users or apps to control the ability to establish a cellular data connection on the device. This parameter controls only cellular data; voice and SMS messaging apps are uneffected by this setting.

Note: Supported on WWAN-enabled devices only.

Parm Name: CellularDataState

Option Name Description Note 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 Turn On Allows a cellular data connection to be established on the device.

MX: 6.3+

2 Turn Off Prevents a cellular data connection from being established on the device.

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 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 "Enable"

Parm Name: CellularDataLimitState

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

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 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 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: Supported only on WWAN-enabled SD660-platform devices with dual SIM slot running Android 8.x Oreo or Android 10. Changing this setting requires reboot.

Parm Name: DsdsUsage

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

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

Parm Name: DSDSFeatures

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

Parm Name: DsdsAutoService

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

Parm Name: PreferredSimSubscription

Option Name Description Note 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 Auto-service is set to "Enable"

Parm Name: OOSTimer

Requires:

  • MX: 10.2+
  • Android API: 26+

DSDS Data Subscription

Allows selection of the SIM subscription to be used as "preferred" for cellular data 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 Auto-service is set to "Disable"

Parm Name: DSDSDataSubscription

Option Name Description Note 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 SIM1 Sets SIM1 as the preferred subscription for data service.

MX: 10.0+

2 SIM2 Sets SIM2 as the preferred subscription for data service.

MX: 10.0+

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 Auto-service is set to "Disable"

Parm Name: DSDSCallSubscription

Option Name Description Note 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 Auto-service is set to "Disable"

Parm Name: DSDSMessageSubscription

Option Name Description Note 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 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 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 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 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 Metwork Operator (MNO) advanced features:

  • MNO Lock Action
  • MNO Activation 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 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 Requires
1 Lock Locks the MNO.

MX: 9.2+

2 Unlock Unlocks the MNO.

MX: 9.2+

MNO Activation ID

Used to enter the license Activation ID to authorize use of MNO advanced features.

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: MNOActivationID

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 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 Activation ID

Used to enter the license Activation ID to authorize use of Service Technician Advanced Features.

Parm value input rules:

  • String from 1–255 characters

Note: Supported on WWAN-enabled devices only.

Shown if: Service Tech Advanced Features is "checked"

Parm Name: SvcActivationID

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 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 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 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 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 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 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: eSimSlotId

Option Name Description Note 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 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 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 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: ProfileSlotId

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

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>