Power Manager

注意：要仅显示特定设备上存在的功能，请从下面的 SmartDocs 栏中选择一个或多个过滤器。

StageNow - 2.10

概述

Power Manager (PowerMgr) 允许应用程序在设备上执行某些与 OS 和电源相关的操作，如重置为刚出厂时的状态，将设备置于睡眠模式，重新启动或执行 OS 更新。在有些设备上，如 VC80x 车载数据终端以及类似配备的 Zebra 设备上，它还可以控制设备加热器，以及根据车载数据终端、类似配备的 Zebra 设备的点火状态执行操作。PowerMgr 仅执行操作；除了确定实施 PowerMgr 本身的 CSP 的版本之外，它不支持其他任何查询。

值得注意的是，PowerMgr 操作（如重新启动和重置）一旦执行，就会阻止执行请求 XML 文档提交的后续操作，包括提交结果 XML 到发送原始请求的应用程序。因此，Zebra 建议将 Condition Manager 与 PowerMgr 结合使用，确保在设备上存在相应的条件后，再尝试执行“有风险”的操作，如操作系统更新，因为这些有风险的操作失败可能使设备变得不可用、功能严重受限，还可能需要维修。

主要功能

  • 重新启动设备
  • 将设备置于睡眠模式
  • 在设备上执行企业重置
  • 绕过“设置向导”（GMS 欢迎屏幕）
  • 在设备上执行恢复出厂设置
  • 擦除设备（擦除所有存储）
  • 更新设备上的操作系统
  • 在一个步骤中执行多个更新
  • 启用/禁用假睡模式
  • 在 VC80x 车载数据终端和类似配备的 Zebra 设备上：
    • 打开和关闭特定串行端口和 USB 端口的电源
    • 控制触摸面板、电池以及串行端口和 USB 端口上的加热器
    • 设置打开和关闭加热器的温度阈值（摄氏度）
    • 设置设备随着车载数据终端和类似配备的 Zebra 设备的点火开关自动打开和/或关闭
    • 设置设备自动关闭的延迟（分钟）

睡眠模式

在 Android 设备上，睡眠模式将关闭设备显示屏，使某些子系统进入低功耗状态。根据设备配置设置，某些应用程序和/或子系统（如 Wi-Fi 和蜂窝）可能会保持活动状态。

重新启动

重新启动 Android 设备通常会导致丢失易失性信息，例如应用程序状态和瞬态数据。非易失性数据，如设备设置和存储的应用程序和数据将被保留。重新启动有时称为“重置”或“普通重置”，但是不要与“企业重置”或“恢复出厂设置”（下文有解释）混淆。

注意：“重新启动”操作将导致设备立即重启，阻止执行任何后续操作，包括提交结果 XML 到发送原始请求的应用程序。

企业重置

企业重置旨在将设备恢复到企业定义的默认状态，这通常由 /enterprise 分区的内容来确定。在 Zebra Android 设备上，企业重置与“恢复出厂设置”相同，区别在于保留了 /enterprise 分区。此操作仅在运行 Android 4.4 KitKat 以及更高版本的 Zebra 设备上受支持。在运行 Android Jelly Bean 等较低版本的 Zebra Android 设备上，如果使用了合适的 OS 更新 ZIP 文件，可使用“OS 更新”操作来执行相同的操作。

注意：此操作将导致设备重新启动（进入恢复模式），阻止执行任何后续操作，包括提交结果 XML 到发送原始请求的应用程序。

恢复出厂设置

“恢复出厂设置”旨在将设备返回到它刚出厂时的状况，与其内部存储卡相关的某些状况除外（参见下文）。在 Zebra Android 设备上，“恢复出厂设置”将擦除所有关键分区，以及包含 /data、/cache 和 /enterprise 分区的存储卡。此操作仅在运行 Android 4.4 KitKat 以及更高版本的 Zebra 设备上受支持。在运行 Android Jelly Bean 等较低版本的 Zebra Android 设备上，如果使用了合适的 OS 更新 ZIP 文件，可使用“OS 更新”操作来执行相同的操作。

注意：此操作将导致设备重新启动（进入恢复模式），阻止执行任何后续操作，包括提交结果 XML 到发送原始请求的应用程序。

重置存储卡

“恢复出厂设置”在以下条件下将擦除存储卡：

  • 该卡实施在 /data 或 /enterprise 分区内

“恢复出厂设置”在以下条件下将不会擦除存储卡：

  • 该卡使用其自己的专用分区进行实施
  • 卡可采用物理方式删除

完整设备擦除

“完整设备擦除”旨在将设备返回到它从工厂出货时的状况，具有当前的操作系统加上后续的操作系统更新。在 Zebra Android 设备上，“完整设备擦除”与“恢复出厂设置”相同，只不过它还会无条件地擦除所有存储卡。此操作仅在运行 Android 4.4 KitKat 以及更高版本的 Zebra 设备上受支持。在运行 Android Jelly Bean 等较低版本的 Zebra Android 设备上，如果使用了合适的 OS 更新 ZIP 文件，可使用“OS 更新”操作来执行相同的操作。

注意：此操作将导致设备重新启动（进入恢复模式），阻止执行任何后续操作，包括提交结果 XML 到发送原始请求的应用程序。

操作系统更新

“操作系统更新”允许使用指定的操作系统更新 Zip 文件或包含操作系统更新和/或补丁程序列表的文本文件替换操作系统或打补丁。根据文件的内容，此过程还可用于执行企业重置、恢复出厂设置或完整设备擦除，以方便安装文件中包含的更新或补丁程序。

注意：此操作将导致设备重新启动（进入恢复模式），阻止执行任何后续操作，包括提交结果 XML 到发送原始请求的应用程序。

重置操作

用于在设备上调用 OS 或电源相关的操作。有关重置操作的重要信息，请仔细阅读概述部分。

参数名称：ResetAction

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会对设备执行操作；任何以前选择的设置都将保留。

MX：4.2+
1 睡眠模式 将设备置于睡眠模式，减少电源使用和某些应用程序功能。有关详细信息，请参阅“概述”。

MX：4.1+
4 重新启动 重新启动设备上的操作系统，这会重置易失性存储器并终止执行任何后续的 PowerMgr 操作（非易失性设置和存储将会保留）。

MX：4.2+

Android API：16+
5 企业重置 执行企业重置，这会将设备返回到通常由 /enterprise 分区的内容确定的企业定义的默认状态。有关详细信息，请参阅“概述”。

OSX：4.2+

MX：4.2+

Android API：19+
6 恢复出厂设置 执行恢复出厂设置，这会擦除所有数据分区，包括 /data、/cache 和 /enterprise 以及某些存储卡。有关详细信息，请参阅“概述”。

OSX：4.2+

MX：4.2+

Android API：19+
7 完整设备擦除 擦除设备和存储卡上的所有数据（如有）。有关详细信息，请参阅“概述”。

OSX：4.2+

MX：4.2+

Android API：19+
8 操作系统更新 使用指定的操作系统更新 Zip 文件在设备上启动操作系统更新。有关详细信息，请参阅“概述”。

MX：4.1+

Android API：16+

操作系统更新文件

用于指定在使用“操作系统更新重置操作”更新设备时使用的文件的路径和文件名。操作系统更新文件必须是正在应用的特定 .zip 文件，或者是包含要按照从上到下的所需顺序应用的补丁程序列表的文本文件（扩展名为 .upl）。

例如，.zip 文件 M99N0KXXVPUCP14500.zip 和 CFE-M99-L-N0-010101_G_00_02.zip 要按该顺序应用，则应该按如下方式创建操作系统更新文本文件：

//Contents of the "osupdate.upl" text file: package:M99N0KXXVPUCP14500.zip package:CFE-M99-L-N0-010101_G_00_02.zip // Note the package files are preceded by the notation "package:"

更新文件规则

  • 所需文件必须在设备上，然后才能启动重置操作。
  • .upl 文件和所有引用的 .zip 文件必须在相同的设备文件夹中。
  • 用于存储文件的文件夹必须是符合以下 Android 位置规则和设备位置规则的受支持位置。
  • 位置规则和特征因设备而异。
  • 这些设备不支持 .upl 文件：
    • TC70 KitKat
    • TC70 Lollipop
    • TC75 KitKat
    • TC75 Lollipop

Android 位置规则

  • 更新文件位置不能被 SdCardMgr 阻止或通过其他任何方式阻止。

  • 可移动介质必须实际存在。在可移动介质（如 Micro SD 卡）上实施的存储分区在启动重置操作时必须插入设备。

  • 位置不能加密。加密的位置不能用于操作系统更新。例如，如果为特定存储卡启用全存储卡加密，则该卡中没有适合用于操作系统更新的位置。同样，如果在存储卡上装载了加密文件系统，那么该卡也不适合操作系统更新。

  • 在更新文件位置，更新实体必须具有写入权限。

  • 仿真存储卡在 Jelly Bean 上不受支持。运行 KitKat 及更高版本的设备不受此限制的影响。

  • 不支持 Adoptable Storage。Zebra 设备默认情况下未实施 Android Adoptable Storage 规格，此规格是对 SD 卡进行格式化以用于单个设备。合并的 SD 卡不能用于存储更新文件。

注意：使用此参数指定的路径通常与文件传输到设备时写入文件的路径相同。但是，在目的地相同时，路径名有时可能会显示得不相同，当使用此参数指定时，有些这样的路径可能无法启动操作系统更新。因此，Zebra 建议在向 PowerMgr 指定操作系统更新文件时，使用下表中的路径。

设备位置规则

设备型号 Android 版本 支持的路径 备注
ET1N0 JB 4.1-4.3.1 /sdcard

/data/tmp

 可移动的 Micro SD 卡（必须实际存在）

内部数据分区（文件夹存在，并且全局可写）
ET1N2 JB 4.1-4.3.1 /sdcard

/data/tmp

 可移动的 Micro SD 卡（必须实际存在）

内部数据分区（文件夹存在，并且全局可写）
MC32 JB 4.1-4.3.1 /sdcard

/data/tmp

 可移动的 Micro SD 卡（必须实际存在）

内部数据分区（文件夹存在，并且全局可写）
MC40 JB 4.1-4.3.1 /sdcard

/data/tmp

 内部存储卡

内部数据分区（文件夹存在，并且全局可写）
MC40 KK 4.4 /sdcard

/storage/sdcard0

 内部存储卡

内部存储卡
MC67 JB 4.1-4.3.1 /sdcard

/data/tmp

 可移动的 Micro SD 卡（必须实际存在）

内部数据分区（文件夹存在，并且全局可写）
TC55 KK w/GMS 4.4 /sdcard

/storage/sdcard0

/storage/sdcard1

 内部存储卡

内部存储卡

可移动的 Micro SD 卡（必须实际存在）
TC55 KK 4.4 /sdcard

/storage/sdcard0

/storage/sdcard1

 内部存储卡

内部存储卡

可移动的 Micro SD 卡（必须实际存在）
TC70 GA1 KK 4.4 /sdcard

/storage/sdcard0

/storage/sdcard1

/data/tmp

 可移动的 Micro SD 卡（必须实际存在）

可移动的 Micro SD 卡（必须实际存在）

内部存储卡

内部数据分区（文件夹存在，并且全局可写）
TC75 KK 4.4 /sdcard

/storage/sdcard0

/data/tmp

 内部存储卡

内部存储卡

内部数据分区（文件夹存在，并且全局可写）
（多个）

Lollipop 和更高版本

 /data/tmp/public Zebra 推荐使用此路径；它在运行 Android 5.0 Lollipop 和更高版本的所有设备上都受支持。请参阅以下“注意”。


注意：运行 Android Lollipop 和 Marshmallow 的 Zebra 设备可能支持上表中建议的位置之外的更新文件位置。其他受支持的位置可能包括：

  • /storage/sdcard0 （内部）
  • /storage/sdcard1 （外部）

但是，对此类位置的支持可能会面临到不受 Zebra 控制的更改。Zebra 建议在正常工作的设备上测试任何更新过程，然后才考虑使用该过程进行大规模部署。

参数值输入规则：

  • 1 到 255 个字符的字符串，其中包含 OS 更新 .zip 或 .upl 文件的完整路径和文件名

在以下条件下显示：重置操作是“操作系统更新”

参数名称：ZipFile

需要：

  • MX：4.1+
  • Android API：16+

绕过设置向导

控件在通过 PowerMgr 启动企业重置后，是否绕过“Android 设备设置向导”（也称为“欢迎屏幕”）。仅适用于安装了 Google Mobile Services (GMS) 的设备并且仅在通过 PowerMgr 启动企业重置时适用。

重要说明：此设置不会保留在设备上。如果在企业重置后需要绕过 SUW，必须在用于启动企业重置的相同配置文件中包括此参数。

参数名称：SUWByPass

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）将导致不对设备采取操作；使用默认值。

MX：7.1+
1 是 导致在通过 PowerMgr 启动的企业重置后跳过 Android 设备设置向导。

MX：7.1+
2 否 允许在通过 PowerMgr 启动企业重置后执行设置向导（默认）。

MX：7.1+

端口操作

用于指定要在选定端口上执行的操作。在端口不需要电源时为其关闭电源可帮助减少针脚腐蚀。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数名称：PortAction

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会对设备执行操作；任何以前选择的设置都将保留。

MX：7.1+
1 打开输出电源 为选定的端口应用电源。

MX：7.1+
2 关闭输出电源 为选定端口关闭电源。

MX：7.1+

端口选择

用于选择要使用“端口操作”参数执行操作（如打开或关闭电源）的端口。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

在以下条件下显示：端口操作不是“无操作”

参数名称：PortSelect

选项 名称 说明需要
1 串行端口 1 为指定的操作选择串行端口 1。

MX：7.1+
2 串行端口 2 为指定的操作选择串行端口 2。

MX：7.1+
3 USB 端口 2 为指定的操作选择 USB 端口 2。

MX：7.1+

加热器操作

这是用于在设备加热器上执行操作的开/关键，包括使用相关阈值参数设置温度阈值的能力。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数名称：HeaterAction

选项 名称 说明需要
0 无操作 此值（或 XML 中缺少此参数）导致不会对设备执行操作；任何以前选择的设置都将保留。

MX：7.1+
1 启用 启用选定的加热器。

MX：7.1+
2 禁用 禁用选定的加热器。

MX：7.1+
3 设置开/关阈值 允许为所选加热器设置温度阈值。

MX：7.1+

加热器选择

用于指定要使用“加热器操作”参数执行操作的设备加热器。设备加热器用于补偿外部温度和湿度水平，以帮助保持正常的设备运行，防止屏幕和/或内部出现结霜或冷凝，以及使设备电池保持在最佳温度。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数名称：HeaterSelect

选项 名称 说明需要
1 串行 IO 选择连接到串行端口的加热器。

MX：7.1+
2 USB IO 选择连接到 USB 端口的加热器。

MX：7.1+
3 电池 选择电池加热器。

MX：7.1+
4 触摸面板 选择触摸面板加热器。

MX：7.1+

加热器开阈值

用于指定应打开设备加热器的温度（摄氏度）。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数值输入规则：

  • -30 到 50 的整数值

在以下条件下显示：加热器操作是“设置开/关阈值”

参数名称：OnThreshold

需要：

  • MX：7.1+

加热器关阈值

用于指定应关闭设备加热器的温度（摄氏度）。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数值输入规则：

  • -30 到 50 的整数值

在以下条件下显示：加热器操作是“设置开/关阈值”

参数名称：OffThreshold

需要：

  • MX：7.1+

自动电源控制（复选框）

指示是否配置自动电源控制。当启用时（值=1），将使用在“自动电源”参数中配置的设置。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数值输入规则：

  • 整数值

参数名称：AutoPowerControl

需要：

  • MX：7.1+

自动开机

用于控制设备在车载数据终端和类似配备的 Zebra 设备点火开关打开时是否开机。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

在以下条件下显示：自动电源控制是“已选中”

参数名称：AutoPowerOn

选项 名称 说明需要
0 从不 设备在车载数据终端和类似配备的 Zebra 设备点火开关打开时不开机。

MX：7.1+
1 当点火开关打开时 设备在车载数据终端和类似配备的 Zebra 设备点火开关打开时开机。

MX：7.1+

自动关机

用于控制设备在车载数据终端和类似配备的 Zebra 设备点火开关关闭是否关机。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

在以下条件下显示：自动电源控制是“已选中”

参数名称：AutoPowerOff

选项 名称 说明需要
0 从不 设备在车载数据终端和类似配备的 Zebra 设备点火开关关闭时不关机。

MX：7.1+
1 当点火开关关闭时 设备在车载数据终端和类似配备的 Zebra 设备点火开关关闭时关机。

MX：7.1+

自动关机超时

用于指定设备在车载数据终端和类似配备的 Zebra 设备点火开关关闭后等待多长时间（分钟）后关机。默认值为 30 分钟。此功能仅适用于 VC80x 车载数据终端和类似配备的 Zebra 设备。

参数值输入规则：

  • 0 到 60 分钟的整数值（0=无）
  • 如果未输入值，将使用默认值 30（分钟）

在以下条件下显示：自动电源控制是“已选中”和自动关机操作是“当点火开关关闭时”

参数名称：AutoPowerOffTimeout

需要：

  • MX：7.1+

假睡模式启用/禁用

这是设备上假睡模式节能功能的开/关键。当假睡模式启用时，只有设备上使用“白名单”专门列出的应用程序可以阻止设备进入这种低功耗状态。可使用 App Manager CSP 如此指定应用程序。

参数名称：DozeModeUsage

选项 名称 说明需要
0 不更改 此值（或 XML 中缺少此参数）导致不会对设备执行操作；任何以前选择的设置都将保留。

MX：7.2+
1 启用 在设备上启用假睡模式节能功能。

MX：7.2+
2 禁用 在设备上禁用假睡模式节能功能。

MX：7.2+

示例

重新启动设备

<wap-provisioningdoc><characteristic type="PowerMgr" version="4.2" ><parm name="ResetAction" value="4"/></characteristic></wap-provisioningdoc>

执行企业重置

<wap-provisioningdoc><characteristic type="PowerMgr" version="4.2" ><parm name="ResetAction" value="5"/></characteristic></wap-provisioningdoc>

执行恢复出厂设置

<wap-provisioningdoc><characteristic type="PowerMgr" version="4.2" ><parm name="ResetAction" value="6"/></characteristic></wap-provisioningdoc>

执行完整设备擦除

<wap-provisioningdoc><characteristic type="PowerMgr" version="4.2" ><parm name="ResetAction" value="7"/></characteristic></wap-provisioningdoc>

执行操作系统更新

<wap-provisioningdoc><characteristic type="PowerMgr" version="4.2" ><parm name="ResetAction" value="8"/><characteristic type="file-details"><parm name="ZipFile" value="/sdcard/osupdate.zip"/></characteristic></characteristic></wap-provisioningdoc>

打开串行端口 1 的电源

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="PortAction" value="1" /><characteristic type="port-details"><parm name="PortSelect" value="Serial Port 1" /></characteristic></characteristic></wap-provisioningdoc>

关闭 USB 端口 2 的电源

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="PortAction" value="2" /><characteristic type="port-details"><parm name="PortSelect" value="USB Port 2" /></characteristic></characteristic></wap-provisioningdoc>

随车辆电源一起立即打开和关闭车载数据终端

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="AutoPowerControl" value="1" /><characteristic type="auto-power-details"><parm name="AutoPowerOff" value="1" /><parm name="AutoPowerOffTimeout" value="0" /><parm name="AutoPowerOn" value="1" /></characteristic></characteristic></wap-provisioningdoc>

在车辆熄火 10 分钟后关闭车载数据终端；不自动关闭设备

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="AutoPowerControl" value="1" /><characteristic type="auto-power-details"><parm name="AutoPowerOff" value="1" /><parm name="AutoPowerOffTimeout" value="10" /><parm name="AutoPowerOn" value="0" /></characteristic></characteristic></wap-provisioningdoc>

使触摸面板加热器在 -10°C 到 5°C 的温度范围内工作

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="HeaterAction" value="3" /><characteristic type="heater-details"><parm name="HeaterSelect" value="4" /><parm name="OnThreshold" value="-10" /><parm name="OffThreshold" value="5" /></characteristic></characteristic></wap-provisioningdoc><wap-provisioningdoc><characteristic type="PowerMgr"><parm name="HeaterAction" value="1" /><characteristic type="heater-details"><parm name="HeaterSelect" value="4" /></characteristic></characteristic></wap-provisioningdoc>

禁用 USB IO 加热器

<wap-provisioningdoc><characteristic type="PowerMgr"><parm name="HeaterAction" value="2" /><characteristic type="heater-details"><parm name="HeaterSelect" value="2" /></characteristic></characteristic></wap-provisioningdoc>