Cellular Manager

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):
  • 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 (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:
  • Cellular services (all)
  • Text messages
  • Voice calls

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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+

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

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

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

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

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

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

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

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

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

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

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

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+

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+

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

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

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>