DeviceCentral Manager

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

StageNow - 4.3

Overview

The Device Central Manager (DeviceCentralMgr) 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.

Main Functionality

  • Enable/Disable display of:
    • Firmware update button
    • Bluetooth On/Off button
    • Smart Leash settings panel
  • Turn On/Off:
    • Smart Leash audio feedback
    • Smart Leash haptic feedback
  • Configure Smart Leash:
    • Audio feedback sound ringtone or file
    • Audio feedback initial volume
    • Audio feedback repeat count
    • Haptic (vibration) feedback duration
  • Restrict Bluetooth pairing to a single device per device class

Bluetooth Control Show/Hide

Controls whether the Bluetooth On/Off button is shown in the Device Central app on the device, which allows the device user to change the state (active/inactive) of the Bluetooth radio through the app. This parameter does NOT change the state of the Bluetooth radio nor prevent the device user from changing the state through the Android Settings panel.

Parm Name: BluetoothOnOffControl

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 8.1+

1 Enable Shows the Bluetooth On/Off button in the Device Central app on the device, which allows the device user to change the Bluetooth state (active/inactive) through the app.

MX: 8.1+

2 Disable Hides the Bluetooth On/Off button in the Device Central app on the device, preventing the device user from changing the Bluetooth state (active/inactive) through the app.

MX: 8.1+

Bluetooth Pairing Control

Controls whether the device is permitted to pair with more than one Bluetooth device per device class (i.e. one headset and one printer). This parameter does not effect existing device pairings.

More information:

Note: This feature is deprecated in Device Central; it will be removed from a future version. Zebra recommends using Bluetooth Manager with MX 10.1 or later to perform this function.

Parm Name: BluetoothPairingControl

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 8.1+

1 Single Pairing Per Device Class Limits the device to a single Bluetooth pairing for each device class.

MX: 8.1+

2 Multiple Pairings Per Device Class Allows the device to pair with more than one device in a Bluetooth device class.

MX: 8.1+

Firmware Update Button Show/Hide

Controls whether the "Firmware Update" button is shown in the Device Central app on the device. Pressing this button initiates the firmware update process on the device.

Parm Name: FwUpdateButton

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 8.1+

1 Enable Shows the 'Firmware Update' button in the Device Central app on the device, allowing the device user to initiate a firmware update, if desired.

MX: 8.1+

2 Disable Hides the 'Firmware Update' button in the Device Central app on the device, preventing the device user from initiating a firmware update.

MX: 8.1+

Smart Leash Settings UI Show/Hide

Controls whether Smart Leash settings panel is accessible by the device user.

Parm Name: SmartLeashSettingsUI

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

1 Enable Allows the device user to access Smart Leash settings.

MX: 10.2+

2 Disable Prevents the device user from accessing Smart Leash settings.

MX: 10.2+

Smart Leash State

This is the On/Off switch for Smart Leash, which can help reduce misplacement of attached peripherals (i.e. wireless headsets, scanners and printers) by notifying the device user with sound and/or vibration when they've changed their work area and left a peripheral behind.

Parm Name: SmartLeashState

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

1 Turn On Activates Smart Leash on the device.

MX: 10.2+

2 Turn Off Deactivates Smart Leash on the device.

MX: 10.2+

Smart Leash Audio Feedback Enable/Disable

Controls Smart Leash audio feedback, which plays a sound when the device user changes their work area and leaves a connected wireless peripheral behind.

Parm Name: SmartLeashAudioFeedback

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

1 Enable Activates Smart Leash audio feedback on the device.

MX: 10.2+

2 Disable Deactivates Smart Leash audio feedback on the device.

MX: 10.2+

Smart Leash Audio Feedback Sound

Used to enter the name of an existing ringtone or the path and file name to play when a Smart Leash event is triggered. Supports .wav, .ogg, .mp3 and .m4a files.

Parm value input rules:

  • Name of device ringtone or name and path to a .wav, .ogg, .mp3 and .m4a file on the device

Shown if: Smart Leash Audio Feedback is set to "Enable"

Parm Name: SmartLeashAudioFeedbackSound

Requires:

  • MX: 10.2+

Smart Leash Audio Feedback Volume

Used to control the initial volume level (as a percentage of the device maximum from 1–100) of the audio feedback sound played when a Smart Leash event is triggered.

Parm value input rules:

  • Integer from 1–100

Shown if: Smart Leash Audio Feedback is set to "Enable"

Parm Name: SmartLeashAudioFeedbackVolume

Requires:

  • MX: 10.2+

Smart Leash Audio Feedback Repeat

Used to control the number of times the selected audio feedback ringtone or file is played when a Smart Leash event is triggered. Entering "0" causes the audio feedback sound to be played one time only.

Parm value input rules:

  • Integer from 0–100

Shown if: Smart Leash Audio Feedback is set to "Enable"

Parm Name: SmartLeashAudioFeedbackRepeatCount

Requires:

  • MX: 10.2+

Smart Leash Haptic Feedback Enable/Disable

Controls Smart Leash haptic feedback, which causes the device to vibrate when the device user changes their work area and leaves a connected wireless peripheral behind.

Parm Name: SmartLeashHapticFeedback

Option Name Description Note Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 10.2+

1 Enable Activates Smart Leash haptic (vibration) feedback on the device.

MX: 10.2+

2 Disable Deactivates Smart Leash haptic (vibration) feedback on the device.

MX: 10.2+

Smart Leash Haptic Feedback Time

Controls the length of time (in ms) the device vibrates when a Smart Leash event is triggered. Supported range is 500 ms (half a second) to 1800000 ms (30 minutes).

Parm value input rules:

  • Integer from 500–1800000

Shown if: Smart Leash Haptic Feedback is set to "Enable"

Parm Name: SmartLeashHapticFeedbackTime

Requires:

  • MX: 10.2+

Examples

Show "Firmware update" and "Bluetooth on/off" buttons in DeviceCentral app, allow pairing of multiple Bluetooth devices per class:


<wap-provisioningdoc>
  <characteristic version="8.1" type="DeviceCentralMgr">
    <parm name="FwUpdateButton" value="1" />
    <parm name="BluetoothOnOffControl" value="1" />
    <parm name="BluetoothPairingControl" value="2" />
  </characteristic>
</wap-provisioningdoc>


Hide "Firmware update" and "Bluetooth on/off" buttons in DeviceCentral app, allow pairing of one Bluetooth device per class:


<wap-provisioningdoc>
  <characteristic version="8.1" type="DeviceCentralMgr">
    <parm name="FwUpdateButton" value="2" />
    <parm name="BluetoothOnOffControl" value="2" />
    <parm name="BluetoothPairingControl" value="1" />
  </characteristic>
</wap-provisioningdoc>