To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.
Input fields accept ENGLISH ONLY.
Queries from MX are not supported on Zebra devices running Android 11 or later. See alternative method.
EMDK For Xamarin - 8.0
The "SmartDocs" bar can customize this page to show only the features present on a particular Zebra device.
OSX, MX and Android version information for a device can be found in the Android Settings panel or by querying the device through ADB, EMDK or the MX CSP. More info.
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.
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+ |
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+ |
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+ |
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+ |
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+ |
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+ |
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+ |
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+ |
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:
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+
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+ |
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:
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+
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+ |
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+ |
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+ |
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+ |
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+ |
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:
Note: Supported on WWAN-enabled devices only.
Shown if: Incoming Calls is set to "Blocked"
Parm Name: EmergencyCallbackWindow
Requires:
- MX: 11.9+
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+ |
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:
Note: Supported on WWAN-enabled devices only.
Shown if: Manual PLMN Lock is set to "Enable"
Parm Name: ManualPlmnLockSet
Requires:
- MX: 8.1+
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+ |
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+ |
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+ |
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+ |
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+ |
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:
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+
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+ |
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+ |
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+ |
Controls whether the device administrator (DA) has access to configuration of advanced features:
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+ |
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+ |
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:
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+
Controls access to Service Technician Advanced Features:
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+ |
Used to enter the Device Admin Lock/Unlock Code.
Parm value input rules:
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+
Used to enter the Integrated Circuit Card Identifier (ICCID) number, which uniquely identifies a SIM card.
Parm value input rules:
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+
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:
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+
Controls access to configuration of Mobile Network Operator (MNO) advanced features:
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+ |
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+ |
Used to navigate to and capture the certificate file on the administrative host computer authorizing use of MNO advanced features.
Parm value input rules:
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+
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+ |
Used to enter the Integrated Circuit Card Identifier (ICCID) number, which uniquely identifies a SIM card.
Parm value input rules:
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+
Used to enter the 16-digit code to be used to Lock the device.
Parm value input rules:
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+
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:
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+
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:
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+
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:
Note: Supported on WWAN-enabled devices only.
Shown if: Service Tech Advanced Features is "checked"
Parm Name: SvcCertificateKey
Requires:
- MX: 9.2+
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+ |
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+ |
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+ |
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+ |
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+ |
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+ |
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+ |
Used to enter a friendly name for an eSIM Profile in the device.
Parm value input rules:
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+
Used to enter the existing Profile Nickname on which to perform the Action selected in the eSIM Profile Action parameter.
Parm value input rules:
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+
Used to enter a new Profile Nickname when changing the Profile Nickname.
Parm value input rules:
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+
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+ |
Used to enter the activation code for the eSIM in the device.
Parm value input rules:
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+
Used to enter the activation code for the eSIM in the device.
Parm value input rules:
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+
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+ |
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+ |
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+ |
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: Supported on WWAN-enabled devices only.
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+ |
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+ |
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+ |
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+ |