About MX

Mobility Extensions

Overview

The MX Management System (MXMS) is an XML-based communication framework that provides a common interface for managing the capabilities and behaviors of Zebra Android devices. The XML documents used by the framework conform to the Open Mobile Alliance specification for Client Provisioning (OMA-CP) and the Microsoft MSPROV DTD format on which it's based (read more). The framework affords developers and administrators an extensible, efficient, reliable and scalable means to configure and administer devices in their organization. MXMS exposes capabilities provided by the underlying CSPs on a device, which provide uniform access to privileged and unprivileged APIs. Each CSP exposes its capabilities using DSD files included with the MDM Toolkit. A DSD tool, loaded with the DSD files for a particular device or set of devices, can generate XML code that when sent to the MXMS running on the device, can change the devices' configuration and/or behavior.


Android 11 Transition

The Zebra OS architecture for Android devices is undergoing a major transformation. This is accordance with Google-mandated changes to device security and data privacy, as well as platform enhancements Zebra is developing to reduce (replaced "eliminate") proprietary technologies and help ensure a smooth transition. While many of the changes are transparent, actions will be required for most customers and partners either now or in the near future, particularly for data persistence and for apps that share and/or use shared data.

Zebra has selected Android 11 as the "transitional" OS version. Zebra devices running Android 11 will accept current and future methods of device configuration. This is intended to allow organizations to continue using their present staging methods while gradually transitioning to the new ways being introduced. Learn more. Zebra devices running Android 13 WILL accept XML for staging, and most MX features will be available in devices moving forward. The following key defines how access to the remaining features will change for devices running Android 13.

Queries are not supported on Zebra devices running Android 11 or later.


MX Feature Disposition

The disposition of each MX parameter and option is indicated with an icon in the Status column of the MX Feature Matrix (see image, below). Parameters with no icon can be configured as normal, using Zebra StageNow or Zebra OEMConfig and a company's own Enterprise Mobility Management (EMM) system. Newly created StageNow Profiles will automatically output the barcode type appropriate for the MX version selected in the StageNow desktop tool. Profiles created with StageNow 5.4 or earlier can be opened with StageNow 6.0 and exported to the new format for targeting devices running Android 13 or later.

image An icon in the 'Status' column indicates whether (and how) each MX parameter or option is changing.

Feature dispositions and the corresponding icons are explained below. Hovering over an icon displays a brief explanation of its meaning. Clicking an icon links to this page.

Icon Key

On devices running Android 13 or later:

– (No icon) Feature available now and in the future with no change required to apps. Existing StageNow Profiles require conversion to new format to target Android 13 devices.

Feature available ONLY through Managed Configurations. Deprecated in MX 11.

Feature available only through eXML barcode(s) or .bin file(s) generated by StageNow.

Feature accessible ONLY through Android system APIs. Deprecated in MX 11.

Feature accessible through StageNow and OEMConfig (via EMM), and sometimes also through Android system APIs, as noted. Deprecated in MX 11.

Feature accessible ONLY through Android Device Policy Manager (DPM) APIs. Deprecated in MX 11, discontinued in MX 14.

Feature accessible through StageNow and/or OEMConfig (via EMM), or through Android Device Policy Manager (DPM) APIs.

Feature MIGHT be limited by Scoped Storage for apps targeting API 30 (Android 11) and later.

Feature replaced by Delegation Scopes and accessible only through StageNow 6.0 and/or OEMConfig 11.2. Deprecated in MX 11.

Feature not available in devices running Android 13. Deprecated in MX 11.


Color Key

DARK GREEN - App changes NOT required; existing StageNow Profiles require conversion to new format.

LIGHT GREEN - App changes MIGHT be required; feature implemented only through Android system APIs.

ORANGE - Changes ARE required for apps and for StageNow Profiles and/or OEMConfig steps.

RED - Feature discontinued on devices running Android 13 and later.

What Comes Next?

Scoped Storage

Introduced with Android 10 (API level 29), scoped storage was originally intended to provide more user control over stored files and reduce the clutter that often occurs on external device storage over time. It limits apps targeting API 29 (and later) to an app-specific device folder and to media types it creates. In practical terms, scoped storage could limit or prevent an app from accessing device folders formerly available, including the /enterprise partition on Zebra devices. Enhancements delivered with Android 11 (API level 30) enforce greater protections on app and user data stored externally. For more information, see Scoped Storage in the FAQ.

From the Android Development Community:

Managed Configurations

Part of Zebra's process for modernizing its mobile OS strategy has been to evaluate the features currently in MX and to implement them as Managed Configurations whenever possible. Many hundreds of features can already be accessed through Zebra OEMConfig and though major EMM systems using Zebra's OEMConfig schema. This method will remain in place for the foreseeable future. Aside from OEMConfig, Zebra is enhancing its other apps–including DataWedge, Device Central and Workstation Connect–to be configurable through schema of their own.

Learn more about Zebra OEMConfig.


XML Phased Out

Legacy MX carried out its device configuration activities using Zebra-specific XML, which was generated by Zebra's StageNow and EMDK desktop tools. To help ease the transition away from XML, Zebra devices running Android 11 are able to process either XML or eXML for device and app configuration. The ability to generate eXML for device control will be added to EMDK and StageNow in early 2022, and XML will be deprecated and eventually discontinued from those tools. Devices with Android 13 (and later) will no longer support configuration through XML.

Learn more about Zebra's new device architecture.

Also See


Version History

The following section lists the major features and enhancements added to the MX versions indicated.

Added in MX 13.3

Supported only on devices running Android 11 or later.


Added in MX 13.2

Supported only on devices running Android 11 or later.

MX 13.2 features are supported by StageNow 5.12 and later.


Added in MX 13.1

Supported only on devices running Android 11 or later.

MX 13.1 features are supported by StageNow 5.11 and later.


Added in MX 11.9

Supported only on devices running Android 11 or later.

MX 11.9 features are supported by StageNow 5.10 and later.


Added in MX 11.8

Supported only on devices running Android 11 or later.

  • Clock adds the ability to:
    • Allow an administrator to set a sync threshold, specifying the maximum difference between the time on the device clock and that of its selected NTP server.
  • Touch Manager adds the ability to:

MX 11.8 features are supported by StageNow 5.9 and later.


Added in MX 11.7

Supported only on devices running Android 11 or later.

MX 11.7 features are supported by StageNow 5.9 and later.


Added in MX 11.6

Supported only on devices running Android 11 or later.

MX 11.6 features are supported by StageNow 5.8 and later.


Added in MX 11.5

Supported only on devices running Android 11 or later.

MX 11.5 features are supported by StageNow 5.8 and later.


Added in MX 11.4

Supported only on devices running Android 11 or later.

MX 11.4 features are supported by StageNow 5.7 and later.


Added in MX 11.3

Supported only on devices running Android 11 or later.

MX 11.3 features are supported by StageNow 5.6 and later.


Added in MX 11.2

Supported only on devices running Android 11 or later.

  • AudioVolumeUI Manager adds the ability to:
  • AudioVolumeUI Manager deprecates the abilities to:
    • Merge ring/notification and system into a single stream
    • Merge Bluetooth and wired headset volume limit for Ring, Notification, System, Alarm, KVS and VVS streams
    • Remove UI label, UI icon and control parameters
    • Remove Receiver Volume Limit for streams (except for voice calls)
  • License Manager adds the ability to:

MX 11.2 is supported by StageNow 5.5 and later.

*Deprecated features remain available but are no longer being advanced and will be removed from a future MX version.


Added in MX 11.1

Supported only on devices running Android 11 or later.

MX 11.1 features are supported by StageNow 5.4 and later.


Added in MX 10.5

MX 10.5 adds the following major features and enhancements:

MX 10.5 features are supported by StageNow 5.3 and later.


Added in MX 10.4

MX 10.4 adds the following major features and enhancements:

MX 10.4 features are supported by StageNow 5.2 and later.


Added in MX 10.3

MX 10.3 adds the following major features and enhancements:

  • New App Manager feature:
    • Allow/Disallow individual app upgrades
  • New Bluetooth Manager feature:
    • Erase all data about paired peripherals on device
  • New DHCP Option Manager feature:
    • Select between DHCPv4 and DHCPv6 clients on device (or use both)
  • New NFC Manager feature:
    • Enable/Disable logging of NFC events on device
  • New WorryFree Wi-Fi Manager feature:
    • Minimum password and temporary password length increased to eight (8) characters

MX 10.3 features are supported by StageNow 5.1 and later.


Added in MX 10.2

MX 10.2 adds the following major features and enhancements:

  • New Access Manager features:
    • Enter the Token received from a caller
  • New Beacon Manager CSP:
    • Controls Bluetooth Low Energy beacon on mobile computers
  • New Bluetooth Manager features:
    • Configure single pairing of accessories
    • Define trusted devices
    • Enhancements to silent pairing rules
  • New Clock features:
    • Enter date and time in local or Universal Coordinate format
  • New Display Manager features:
    • Control automatic screen rotation
    • Enable/disable adaptive brightness
    • Set device brightness level
  • New KeyMapping Manager features:
    • Support for additional key codes
  • New License Manager features:
    • Supports URI-based license sources
  • New Power Manager features:
    • Enable/disable/configure battery saver options
  • New PowerKey Manager features:
    • Set touch mode options
  • New Touch Manager features:
    • Support and control latest Zebra devices
  • New UI Manager features:
    • Show/hide percentage of battery charge on screen
  • New Wi-fi features:
    • Configure Fine Timing Measurement
    • Control encryption options

Added in MX 10.1

MX 10.1 adds the following major features and enhancements:

  • Enhanced Display Manager now allows an admin to:
    • Control device-screen orientation (automatic rotation on/off)
  • Enhanced File Manager now allows an admin to configure the following file upload actions:
    • Enter a target URI
    • Enter source path and file name
    • Select the upload order (oldest or newest first, or alpha-sorted by file name)
    • Delete source file(s) after uploading
    • Name uploaded files using a naming pattern
    • Replace the destination file with source if duplicate name
    • Skip copying and remove file from the source
    • Skip copying and keep file at the source
  • Enhanced Power Manager now allows an admin to:
    • Control state of Battery Saver mode (on/off)
    • Control Battery Saver Control mode (automatic/manual)
    • Set Battery percentage of charge to automatically turn Battery Saver Mode on
  • Enhanced UI Manager now allows an admin to:
    • Control Battery Percentage display in status bar (show/hide)

Added in MX 10.0

MX 10.0 adds the following major features and enhancements:

  • Enhanced Power Manager now allows an admin to:
    • OS Upgrade via streaming (full-package upgrade only using http or https; supported on Android 10 and later)
    • OS Downgrade via streaming (full-package downgrade only using http or https; supported on Android 10 and later)
  • Enhanced Access Manager now allows an admin to:
    • Auto-grant permissions to an app to prevent permission "pop-up" to appear on device
    • Designate a CSP as "Protected" from unauthorized use
    • Designate a Function Group (features selected from different CSPs) as "Protected" from unauthorized use

Added in MX 9.3

  • Enhanced File Manager now allows an admin to:
    • Download a file or files from a redirected URL (i.e. Tiny URL)
    • Download a file from multiple redirected URLs
  • Enhanced App Manager now allows an admin to control background data usage on a per-application basis.
  • Enhanced Bluetooth Manager now allows silent pairing using a Bluetooth MAC address or PIN.
  • Enhanced GPRS Manager APN parameters now support IPv4, IPv6 and the IPv4/IPv6 "dual-stack" protocol.
  • Enhanced KeyMapping Manager now supports the "grey" key and W1 and W2 buttons.

Added in MX 9.2

  • Enhanced Power Manager now allows an admin to control individual hardware wake up methods (buttons, keycodes)
  • Enhanced Display Manager now allows an admin to control device font and display size.
  • Enhanced Access Manager can now:
    • Prevent one application from stopping another without explicit permission
    • Perform remote device troubleshooting with enhanced visibility and control
  • Enhanced Cellular Manager implements several new device locking mechanisms.
  • Enhanced Keymapping Manager now supports:
    • Intent extras
    • "Rotate" and "minus" keys

Added in MX 9.1

  • Enhanced UI Manager now allows an admin to:
    • Control whether password characters are displayed briefly on the screen as they're entered (otherwise masked at all times)
  • Enhanced App Manager now allows an admin to:
    • Erase all data created by an app specified in the Package parameter
  • Enhanced Power Manager now allows an admin to:
    • Select hardware signals as the device wake-up method
    • Select mappable keycodes as the device wake-up method
  • Enhanced GMS Manager now allows an admin to:
    • Select and enable a subset of GMS apps and services to run on a device (i.e. Chrome browser, Google Maps, Firebase Cloud messaging)

Added in MX 9.0

  • Enhanced Battery Manager now allows an admin to:
    • Specify a critically low battery threshold
  • Enhanced UI Manager now allows an admin to:
    • Control user access to the Large Key Indicator (MC93 device only)
    • Turn the Large Key Indicator on or off (MC93 device only)

Added in MX 8.4

  • Enhanced GPRS Manager now allows an admin to:
    • Specify the Mobile Virtual Network Operator (MVNO) type for an Access Point Name (APN)
    • Specify APN MVNO Match Data
  • Enhanced UI Manager now allows an admin to:
    • Control user access to the On-Screen Power Button
    • Control user access to the Status Bar
  • Enhanced Wi-Fi CSP can now enable/disable:
    • Aggregated MAC Protocol Data Unit (AMPDU)
    • Gratuitous ARP address resolution protocol
    • 2g Channel Bonding (40MHz-wide channel in 2.4GHz band)
    • Configuration of Extended WLAN settings

Added in MX 8.3

  • New NFC Manager CSP adds these new capabilities:
    • Enable/Disable:
    • NFC radio and its ability to communicate
    • NFC Data Exchange Format
    • Peer-to-Peer mode
    • CPU boost mode
    • Card Emulation mode
    • NFC usage when the Android "lock screen" is displayed
    • Select type A, B, F, or V tags for use
    • Select communication speed for Types A and B cards (TC55)
    • Select communication speed for ISO 14443-4 cards (TC75)
    • Select the Polling mode to balance performance with battery usage
    • Reset device to default NFC settings
  • Enhanced Access Manager adds these new features:
    • Select the Action to perform for Access to Protected Services
    • Specify a Service Identifier for a Service
    • Specify Package Name of a Service Caller
    • Specify a File name for the Signature of a Caller
  • Enhanced Cellular Manager adds this new feature:
    • Specify an APN authentication type
  • Enhanced KeyMapping Manager added this new feature:
    • Select a key behavior for 'Diamond' mode
  • Enhanced Wi-Fi CSP adds this new feature:
    • Enable/Disable Wi-Fi verbose logging
  • Enhanced File Manager can download and expand archive files by from a local PC or a server

Added in MX 8.2

  • Enhanced UI Manager adds these new features:
    • Enable/disable long-press on HOME key
    • Enable/disable date in Notification panel
    • Enable/disable long press on Recent Apps header icon to control access to app info

Added in MX 8.1

  • Enhanced Power Manager adds these new actions:
    • Specify an on-device file to verify an OS update
    • Specify whether to suppress auto-reboot following an A/B upgrade
  • Enhanced Battery Manager adds these new actions:
    • Enable/disable use of Battery Swap Mode UI
    • Enable/disable “battery charging” LED
  • Enhanced Bug Report Manager adds a new action:
    • Specify a time before expiration (in days) to store or email bug reports or send them to the cloud
  • Enhanced Cellular Manager adds these new actions:
    • Enable/disable user access to public land mobile network (PLMN) a device uses
    • Specify the MCC/MNC network PLMN LockSet
    • Show/hide PLMN lock UI
    • Determine the status of PLMN lock UI
    • Enable/disable Dual SIM Standby
    • Get the status of DSDS
  • Enhanced DHCP Option Manager adds these new actions:
    • Enable/disable requests for a custom DHCP option from server
    • Request or disable a specified DHCP Option
    • Enable/disable sending of a custom DHCP Option to server
    • Send or disable a specified DHCP Option
    • Send a value with a specified custom DHCP Option
  • Enhanced License Manager adds these new actions:
    • Specify an Activation ID to return a license from the device
    • Specify server friendly name for returning one or all licenses and for deleting license source
    • Select the license source type to be used to return one or all licenses
  • Enhanced Settings Manager adds these new actions:
    • Enable/disable the slide out drawer for accessing Android system settings
  • Enhanced UI Manager adds these new actions:
    • Enable/disable Split Screen mode
    • Enable/disable Do Not Disturb mode
    • Enable/disable Multi-user mode
  • Enhanced Wi-Fi adds these new actions:
    • Enable/disable MAC address randomization
    • Enable/disable Call Admission Control
    • Enable/disable user control of Hotspot state (active/inactive)

Added in MX 8.0

  • Enhanced App Manager adds these new actions:
    • Clear Application Cache
    • Enable/disable All GMS Applications on the "Safe to Disable" list
  • Enhanced License Manager adds these new actions:
    • Select a licensing file to be embedded in the XML
    • Select a pre-activated license source
    • Query product-specific license information
    • Specify product name to be queried
    • Select the method used to supply the license .bin file
  • Enhanced Power Manager adds a new action:
    • Enable/disable PTT and scan buttons to wake the device from suspend mode
  • Enhanced Settings Manager adds a new action:
    • Enable/disable tethering and portable hotspot features
  • Enhanced UI Manager adds these new actions:
    • Enable/disable the Magnification Gesture
    • Show/hide the Virtual KeyBoard while Physical Keyboard is active
  • New AutoTrigger Manager CSP is used to configure automatic scan-triggering, which initiates scanning when a scan target is brought within proximity of the device sensor. Currently supports the Zebra PS20 Personal Shopper device only.
  • New DeviceCentral Manager CSP allows configuration of settings on the device for Zebra Device Central, an enterprise tool for viewing connection state, battery status, firmware version and other device conditions from a central console.
  • New Fota Manager CSP controls the Firmware Over The Air (FOTA) Client on the device, allowing administrators to perform OS updates on Zebra devices without a physical connection. The FOTA Client app comes preinstalled on supported devices and is configured to communicate with the Zebra update server.


See the MX Feature Matrix for complete feature lists


Definition of Terms

Android Open Source Project (AOSP)

AOSP is the method that Google uses to release and distribute the source code for the Android Operating System for royalty-free use by the open source community. OEMs are free to use, modify, and extend AOSP as needed, subject to certain standard licensing requirements. Each BSP for any of the Zebra Android devices includes an operating system that was derived--directly or indirectly--from AOSP. These BSPs also generally include modifications and/or enhancements beyond AOSP that provide additional value to Zebra customers.

Board Support Package (BSP)

A BSP is the method used by Zebra device teams to deliver the operating system for Zebra devices. Every device ships with a specific BSP version--reported via the "Build number" field--pre-installed that is suitable for use on that device model. The BSP version that ships in devices of a particular model may or may not be updated when a new BSP becomes available for that device model. A BSP generally can be updated by downloading a newer (or sometimes older) BSP from the Zebra support website and applying it to the device via the OS Update Process for that device.

Configuration Service Provider (CSP)

A CSP is a device code module that implements the ability to set and query the configuration of a subsystem on a device (e.g. Clock, Wi-Fi, etc.). The capabilities that are supported and exposed by a CSP are defined by a corresponding DSD.

A CSP is a plug-in to the MXMF which can ship as part of the MXMF, be included in a BSP along with the MXMF, or be downloaded to a device as needed. Before it can be used on a device, a CSP must be registered with the MXMF on that device and all calls to a CSP must go through the MXMF. The MXMF and CSPs communicate through XML files that conform to the XML.DTD, as described in the MX MF XML DTD document.

Document Type Definition (DTD)

A DTD is a standards-based non-XML document that defines the syntax of a class of related XML documents. It is used to enter the elements that are allowed to appear within all XML documents that are used for a specific purpose.

The following DTDs are used by the MXMF:

  • XML.DTD (described in the document MX MF XML DTD)
    • This DTD defines the syntax of XML Documents that can be consumed by CSPs that registered with the MXMF and that can be used to set and query the configuration of the device systems associated with those CSPs
  • DSD.DTD (described in the document MX MF DSD DTD)
    • This DTD defines the syntax of DSD documents that are used to define the capabilities of CSPs

Document Semantics Definition (DSD)

A DSD is an XML document that conforms to the DSD.DTD as described in the document MX MF DSD DTD, and that corresponds to and describes the capabilities of a CSP. It is used by tools to enable programmatic generation of XML that can then be consumed by a CSP. Some examples of these tools are EMDK Profile Manager, StageNow, and MDM Console.

A DSD is created and maintained by the author of a CSP and each CSP must have a corresponding DSD that must be supplied when the CSP registers with the MXMF. A CSP and its corresponding DSD should generally be produced, maintained, and distributed together.

Mobility Extensions (MX)

MX is the umbrella term used to refer collectively to the experience and configuration capabilities offered by Zebra Android devices. MX represents all the value that a BSP offers over and above that provided by the Android operating system, including:

  • Changes and extensions to the Android OS (implemented by Zebra OSX)
  • Value-Add features such as key mapping and threat management
  • The MX Management Framework (MXMF)
  • Configuration Service Providers (CSPs)
  • Changes and extensions to standard applications (i.e. Settings UI, Browser, Email Client, etc.)

MX Management Framework (MXMF)

MXMF is a device subsystem that provides an interface to applications that wish to set or query the configuration of device subsystems. It does not directly implement any set or query functions, but provides a framework that supports and hosts CSPs that do so. MXMF can be built into a BSP or can be added to a BSP after a device is shipped (via a patch applied via the OS update process). Applications and the MXMF communicate through an interchange of XML files that conform to the XML.DTD, as described in the MX MF XML DTD document.

Operating System Extensions (OSX)

OSX is the term used to refer to a Zebra-proprietary implementation of changes and extensions to the standard AOSP as included in a BSP. The version of OSX in a device is the primary way to determine which changes and extensions are present in the operating system of that device. The root OSX version number always matches the root number of the Android version that it extends. For example, Android 5.x would always be extended by OSX 5.x. As a general rule, the version of OSX in a device can be changed ONLY by loading a different BSP (containing a different version of OSX) into that device using the OS update process.

MX Management System (MXMS)

MXMS is a term used to refer to the MXMF and all CSPs that are registered with the MXMF at a given point in time. It provides the ability to set and/or query the configuration of the device subsystems for which CSPs are registered with MXMF. Two types of CSPs are included:

  • CSPs that are built into the MXMF, such as the CertMgr CSP
  • CSPs that are built into a device and pre-registered with MXMF, such as the Wi-Fi CSP

MXMS can be thought of as "the MXMF and a collection of currently registered CSPs." Although applications submit XML to the MXMF, it is more accurate to describe the MXMS (not just the MXMF) as the entity through which applications set and/or query configuration settings.

Note: All components described above may or may not be present on a device. Specifically, MXMF and the CSPs may be absent. Therefore, some or all of the components required for the device might need to be installed before they could be configured.

Multi-user Capabilities

Zebra devices and MX support Android Multi-user capabilities with the following provisions:

  • MX works only in the Primary user/profile and never in a secondary user/profile.
  • If Android Multi-user mode is enabled and a secondary user is created, MX will fail if invoked in the secondary user.
  • Secondary users inherit settings applied using MX in the Primary user. If a Work Profile is created (by enrolling a Profile Owner), MX fails if invoked in the Work Profile but the Work Profile inherits settings applied using MX in the Primary user's profile.

Operating System Extensions (OSX)

OSX is the term used to refer to a Zebra-proprietary implementation of changes and extensions to the standard AOSP as included in a BSP. The version of OSX in a device is the primary way to determine which changes and extensions are present in the operating system of that device. The root OSX version number always matches the root number of the Android version that it extends. For example, Android 5.x would always be extended by OSX 5.x. As a general rule, the version of OSX in a device can be changed ONLY by loading a different BSP (containing a different version of OSX) into that device using the OS update process.


MX Architecture and Data Flow

System components:

  • MXMS
    • MXMF
    • CSPs
      • Unprivileged
      • Privileged
    • AOSP APIs
      • Unprivileged
      • Privileged
    • OSX APIs
      • Privileged
    • Core Applications

Overview

img

Android Device BSP

img

MX on Devices

The MX version on a specific device can be effected by:

  • OS Updates
  • EMDK for Android Device Runtime Updates

While new CSPs can be introduced with each version of MX, and pre-existing CSPs can receive new capabilities, MX updates will not generally remove or change pre-existing behaviors or capabilities unless specifically noted.


Related guides: