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 Display Manager (DisplayMgr) provides control of certain display-screen features on the device.
This is the On/Off switch for automatic screen rotation, which automatically rotates the display based on orientation of the device.
Parm Name: Autorotate
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current behavior; any previously selected setting is retained. |
MX: 10.1+ Android API: 27+ |
|
| 1 | Turn On | Enables the screen to rotate automatically when device orientation changes. |
MX: 10.1+ Android API: 27+ |
|
| 2 | Turn Off | Disables automatic screen rotation; the display remains in its current orientation regardless of device movement. |
MX: 10.1+ Android API: 27+ |
This is the On/Off switch for Adaptive Brightness on the device, which automatically adjusts screen brightness based on input from the ambient light sensor.
Parm Name: Adaptivebrightness
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current behavior; any previously selected setting is retained. |
MX: 10.2+ Android API: 27+ |
|
| 1 | Turn On | Enables the device to automatically adapt screen brightness based on ambient light. |
MX: 10.2+ Android API: 27+ |
|
| 2 | Turn Off | Prevents the device from automatically adapting screen brightness. |
MX: 10.2+ Android API: 27+ |
Controls whether a device display can be made blank when triggered by the signal set in the Screen Blanking Signal parameter. Blanking the screen blocks all user interaction with the device and its apps.
This feature was developed for safety reasons and is intended for use with vehicle-mount computers while the vehicle is in motion. It can be activated, for example, by an electrical signal wired to the vehicle accelerator. For more information about connecting a Zebra device to vehicle wiring, please refer to the Integrator Guide that accommpanied the unit.
Parm Name: ScreenBlanking
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do Nothing | This value (or the absence of this parm from the XML) will cause no change to the current behavior; any previously selected setting will be retained. |
MX: 7.1+ |
|
| 1 | Never blanked | Prevents blanking of the screen. |
MX: 7.1+ |
|
| 2 | When Triggered by Signal | Enables the screen to be blanked when triggered by a signal external to the device. |
MX: 7.1+ |
Used to enter the screen backlight brightness level (from 0-100) as a percentage of the maximum. Enter -1 to leave current device setting unchanged. On devices running Android 9.x Pie and later, which support setting brightness while Adaptive Brightness is On, input from the ambient light sensor causes this setting to change. To prevent automatic changes, set Adaptive Brightness to Off.
Parm value input rules:
Parm Name: Brightnesslevel
Requires:
- MX: 10.2+
- Android API: 27+
Controls whether a device enters suspend (sleep) mode based on its connection to an external power source. Device otherwise operates according to settings in the Developer Options section of the Android Settings panel. Note: This feature is enabled by default on Zebra VC80x vehicle computers.
Parm Name: StayAwake
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do Nothing | This value (or the absence of this parm from the XML) will cause no change to the current behavior; any previously selected setting will be retained. |
MX: 7.2+ Android API: 17+ |
|
| 1 | Enable | Prevents the device from entering suspend (sleep) mode when it is connected to an external power source. |
MX: 7.2+ Android API: 17+ |
|
| 2 | Disable | Allows the device to enter suspend (sleep) mode regardless of its connection to an external power source. |
MX: 7.2+ Android API: 17+ |
Used to select the size of UI elements displayed on the device. NOTE: The "Larger" and "Largest" settings apply only to larger screens such as those of tablets and vehicle computers.
Parm Name: DisplaySize
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do Nothing | This value (or the absence of this parm from the XML) causes no change to the current behavior; any previously selected setting is retained. |
MX: 9.2+ Android API: 27+ |
|
| SMALL | Small | Sets the size of UI elements at one step smaller than Android default size. |
MX: 9.2+ Android API: 27+ |
|
| DEFAULT | Default | Sets the Android default size for UI elements. |
MX: 9.2+ Android API: 27+ |
|
| LARGE | Large | Sets the size of UI elements at one step larger than Android default size. |
MX: 9.2+ Android API: 27+ |
|
| LARGER | Larger | Sets the size of UI elements at two steps larger than Android default size (large screens only). |
MX: 9.2+ Android API: 27+ |
|
| LARGEST | Largest | Sets the size of UI elements at three steps larger than Android default size (large screens only). |
MX: 9.2+ Android API: 27+ |
Used to select the size of alpha-numeric characters appearing in UI elements displayed on the device screen.
Parm Name: FontSize
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do Nothing | This value (or the absence of this parm from the XML) causes no change to the current behavior; any previously selected setting is retained. |
MX: 9.2+ |
|
| 0.85 | Small | Sets the font to one size smaller than the Android default size. |
MX: 9.2+ |
|
| 1 | Default | Sets the font to the Android default size. |
MX: 9.2+ |
|
| 1.15 | Large | Sets the font to one size larger than the Android default size. |
MX: 9.2+ |
|
| 1.3 | Largest | Sets the font to two sizes larger than the Android default size. |
MX: 9.2+ |
Used to enter a delay (in ms) after a signal change is detected before blanking or unblanking the screen. Default value is 1000 ms (one second).
Parm value input rules:
Parm Name: ScreenBlankingDebounceDelay
Requires:
- MX: 7.1+
Used to enter which external signal will control Screen Blanking, if enabled. Inputs 1 and 2 correspond to serial ports 1 and 2 on the Zebra VC80x vehicle-mounted computer. Other devices might differ. The serial port can be used to determine whether the vehicle’s accelerator pedal is pressed. For more information about connecting a Zebra device to vehicle wiring, please refer to the Integrator Guide that accommpanied the unit.
Parm Name: ScreenBlankingSignal
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 1 | Input 1 | Sets the screen blanking signal to Input 1 (VC80x serial port 1). |
MX: 7.1+ |
|
| 2 | Input 2 | Sets the screen blanking signal to Input 2 (VC80x serial port 2). |
MX: 7.1+ |
Controls whether to blank the screen when the signal designated in the Screen Blank Signal parameter is present or absent.
Parm Name: ScreenBlankingSignalPolarity
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 1 | Blank screen when vehicle goes active (ON) | Sets the screen to go blank when a signal is present. |
MX: 7.1+ |
|
| 2 | Blank screen when vehicle goes inactive (OFF) | Sets the screen to go blank when a signal is absent. |
MX: 7.1+ |
Used to set the length of time the device waits during periods of inactivity (without screen touches or key presses) before turning off the screen to conserve power. Ideally, this interval should represent a balance between battery preservation and user convenience.
Note: Android supports only the display-screen timeout settings shown in the table below. Entering a value between any two supported values changes the setting to the closest supported value. Entered values outside the minimum or maximum shown are ignored and trigger an error in the Result XML document.
Parm Name: TimeoutInterval
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do not change | This value (or the absence of this parm from the XML) causes no change to the current display screen timeout interval; any previously selected setting is retained. |
MX: 4.3+ Android API: 1+ |
|
| 15 | 15 seconds after Display Timeout | Causes the display screen to timeout after 15 seconds of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 30 | 30 seconds after Display Timeout | Causes the display screen to timeout after 30 seconds of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 60 | 1 minute after Display Timeout | Causes the display screen to timeout after one minute of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 120 | 2 minutes after Display Timeout | Causes the display screen to timeout after two minutes of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 300 | 5 minutes after Display Timeout | Causes the display screen to timeout after five minutes of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 600 | 10 minutes after Display Timeout | Causes the display screen to timeout after 10 minutes of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 1800 | 30 minutes after Display Timeout | Causes the display screen to timeout after 30 minutes of device-user inaction. |
MX: 4.3+ Android API: 1+ |
|
| 65535 | Never | Keeps the display screen on at all times despite any period of device-user inaction. |
MX: 9.2+ |
Controls whether a device can use Android's built-in screen capture capability, which captures the contents of the screen and saves it to a file on the device.
Note: The method of capturing the screen generally involves a combination of simultaneous key presses that varies from one device to another.
Parm Name: ScreenShotUsage
| Option | Name | Description | Note | Requires |
|---|---|---|---|---|
| 0 | Do Nothing | This value (or the absence of this parm from the XML) causes no change to the current behavior; any previously selected setting is retained. |
OSX: 3.6,4.5 ONLY NOT IN OSX 4.0 - 4.4 MX: 5.0+ |
|
| 1 | Enable | Enables the ability to use the Android screen capture feature. |
OSX: 3.6,4.5 ONLY NOT IN OSX 4.0 - 4.4 MX: 5.0+ |
|
| 2 | Disable | Disables the ability to use the Android screen capture feature. |
OSX: 3.6,4.5 ONLY NOT IN OSX 4.0 - 4.4 MX: 5.0+ |
The sample below turns on the screen-blanking feature, selects serial port 1 on the Zebra VC80x vehicle-mounted computer as the signal port with standard-polarity wiring, and sets a two second (2000 ms) delay.
<wap-provisioningdoc>
<characteristic type="DisplayMgr">
<parm name="ScreenBlanking" value="2" />
<characteristic type="screen-blanking-details">
<parm name="ScreenBlankingSignal" value="1" />
<parm name="ScreenBlankingPolarity" value="1" />
<parm name="ScreenBlankingDebounceDelay" value="2000" />
</characteristic>
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="DisplayMgr">
<parm name="ScreenBlanking" value="1" />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type="DisplayMgr">
<parm name="StayAwake" value="2" />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type=”DisplayMgr”>
<parm name=”FontSize” value=”1.15” />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type=”DisplayMgr”>
<parm name=”DisplaySize” value=”LARGE” />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type=”DisplayMgr”>
<parm name=”Autorotate” value=”1” />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type=”DisplayMgr”>
<parm name=” Adaptivebrightness” value=”1” />
</characteristic>
</wap-provisioningdoc>
<wap-provisioningdoc>
<characteristic type=”DisplayMgr”>
<parm name=” Brightnesslevel” value=”80” />
</characteristic>
</wap-provisioningdoc>