Powerkey Manager

EMDK For Xamarin - 2.1

Overview

The PowerKeyMgr provides control over Power Key Menu options supported on the device.

Zebra Android devices display a menu with a long-press of the Power Key. Called the Power Key Menu, it offers the device user the ability to invoke various power-related functions, such as reset (reboot), power off, Airplane Mode, Touch Panel, Safe Mode, etc. The exact set of options that appear in the Power Key Menu varies based on the capabilities of the device.

The PowerKeyMgr provides the ability to turn supported menu options on or off. This allows a device to prevent the device user from accessing certain supported menu options that may perform undesired or sensitive operations that could interfere with the smooth operation of the device.

Note: The PowerKeyMgr can be used to prevent access to menu options that are supported on the device and can restore access to menu options to which access was previously prevented. It cannot provide access to menu options that are not supported on the device.

Zebra Android devices support a Screen Lock Timeout, controlled by the DevAdmin, that controls how long the device screen must remain off before a screen lock will appear when the display screen is turned back on. When the Power Key is used to turn the device off (as opposed letting the device screen time out) a screen lock can be required when the display screen is turned back on, even though the timeout was not reached. The PowerKeyMgr can enable or disable this functionality and control whether the device user can change this functionality via the in-device System Settings Menu.

Main Functionality

  • Allow or prevent use of the following Power Key Menu Options
    • Airplane Mode
    • Touch Panel
    • Safe Mode
  • Allow or prevent use of the Automatic Screen Lock Option in the System Settings Menu
  • Turn On or Off whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key

Airplane Mode Power Key Menu Option

Turning on Airplane Mode disables all radios, including the cellular radio, the Wi-Fi radio, and the Bluetooth radio. While Airplane Mode is turned off, radios other than the cellular radio can be turned back on individually. Turning off Airplane Mode turns on the cellular radio, but does not change the state of other radios.

This parm allows you to select whether or not Airplane Mode should be allowed to be turned on or off from the Airplane Mode menu option in the Power Key Menu.

Parm Name: AirPlaneMode

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to whether or not Airplane Mode can be turned on or off from the Airplane Mode menu option in the Power Key Menu.

OSX: 4.3+

MX: 4.3+

1 Show Menu Option This value will allow Airplane Mode to be turned on or off from the Airplane Mode Option in the Power Key Menu, if the Power Key Menu for the device supports this menu option.

OSX: 4.3+

MX: 4.3+

2 Do not show Menu Option <p>This value will prevent Airplane Mode from being turned on or off from the Airplane Mode menu option in the Power Key Menu.</p><p><b>Note:</b> Depending on the device, this value may cause the Airplane Mode Option in the Power Key menu to be hidden. However, this value will always prevent the user from using this option in the Power Key Menu.</p>

OSX: 4.3+

MX: 4.3+

Touch Panel Power Key Menu Option

Some Zebra Android devices provide the ability to turn the Touch Panel on and off from the Power Key Menu. Turning off the Touch Panel could be useful in situations where the device screen may come in contact with foreign objects, to prevent inadvertent activation of functions via the Touch Panel.

This parm allows you to select whether or not the Touch Panel should be allowed to be turned on or off from the Touch Panel menu option in the Power Key Menu.

Parm Name: TouchPanel

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to whether or not Touch Panel can be turned on or off from the Touch Panel menu option in the Power Key Menu.

MX: 5.0+

1 Show Menu Option This value will allow Touch Panel to be turned on or off from the Touch Panel Option in the Power Key Menu, if the Power Key Menu for the device supports this menu option.

MX: 5.0+

2 Do not show Menu Option <p>This value will prevent the Touch Panel from being turned on or off from the Touch Panel menu option in the Power Key Menu.</p><p><b>Note:</b> Depending on the device, this value may cause the Touch Panel Option in the Power Key menu to be hidden. However, this value will always prevent the user from using this option in the Power Key Menu.</p>

MX: 5.0+

Safe Mode Power Key Menu Option

Some Zebra Android devices provide the ability to boot into a Safe Mode. Safe Mode is typically used to perform troubleshooting operations that might be impeded by certain applications or services that would normally start when booting the device normally. Since booting into Safe Mode could render the operation of the device insecure and likely would impact the ability of the device to perform its production functions, it may be desirable to prevent device users from booting into Safe Mode under normal circumstances.

This parm allows you to select whether or not Safe Mode should be allowed to be turned on or off from the Safe Mode menu option in the Power Key Menu.

Parm Name: SafeMode

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to whether or not Safe Mode can be turned on or off from the Safe Mode menu option in the Power Key Menu.

OSX: 4.3+

MX: 4.3+

1 Show Menu Option This value will allow Safe Mode to be turned on or off from the Safe Mode Option in the Power Key Menu, if the Power Key Menu for the device supports this menu option.

OSX: 4.3+

MX: 4.3+

2 Do not show Menu Option <p>This value will prevent Safe Mode from being turned on or off from the Safe Mode menu option in the Power Key Menu.</p><p><b>Note:</b> Depending on the device, this value may cause the Safe Mode Option in the Power Key menu to be hidden. However, this value will always prevent the user from using this option in the Power Key Menu.</p>

OSX: 4.3+

MX: 4.3+

Automatic Screen Lock on Power Key Option

This parm allows you to select whether the device user will be allowed to use the option in the System Settings Menu to Turn On or Off whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

Parm Name: AutoScreenLockOption

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will not cause any change to whether or not the device user will be allowed to use the option in the System Settings Menu to Turn On or Off whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+

1 Show Menu Option This value will cause the device user to be allowed to use the option in the System Settings Menu to Turn On or Off whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+

2 Do not show Menu Option This value will cause the device user to be prevented from using the option in the System Settings Menu to Turn On or Off whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+

Automatic Screen Lock on Power Key State

This parm allows you to select whether a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

Parm Name: AutoScreenLockState

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will not cause any change to whether or not a screen lock will always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+

1 Turn on This value will cause a screen lock to always be required when the device screen is turned back on if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+

2 Turn off This value will cause a screen lock to not be required when the device screen is turned back on unless the device screen was off for at least the Screen Lock Timeout, even if the device screen was turned off using the Power Key.

OSX: 4.3+

MX: 4.3+