通过

HLK 移动测试工具和实用工具

HLK 提供了几个命令行工具，用于载入和设备控制。

KitsDeviceDetector.exe

KitsDeviceDetector 是在移动测试系统载入过程中使用的。

用法

KitsDeviceDetector.exe /<parameter>:<parameter value> …

支持的参数

参数 说明
/ImagePath:<Path to image.ffu> 可选。 如果提供，映像将被刷写到设备。
/ImageProfile:<Default|Health|Retail> 可选。 有效的类型包括“默认”、“运行状况”、“零售”。
/LowCost:<true/false> 可选。 通知 HLK 我们正在测试低成本设备。
/SDMemory:<true/false> 可选。 通知 HLK 测试设备具有额外的 SD 内存卡。
/SDCardImageInstalled 可选。
/DeviceName:<device name> 载入 USB 连接的电话时是必需的。
/DeviceId:<device ID> 载入 USB 连接的电话时是必需的。
/DeviceMacAddress:<Device MAC address> 可选。 载入 USB 连接的电话时从 DeviceId 派生。
/? 打印帮助菜单。
/logical:<logical connection> 可选。 指定逻辑连接 DLL。 默认值为 WPConLC.dll。
/physical:<physical connection> 指定物理连接 DLL。 对于 Aries 连接的设备是可选的。 对于 USB 连接的设备是必需的。
/machinepool:<machine pool> 必需。 用于放置载入设备的计算机池的名称。
(/DeviceFilters:<comma-delimited-list>)
注意 /DeviceFilters 只适用于某些物理连接插件。 该值应该是一个以逗号或分号分隔的设备列表，以限制发现范围。

示例

KitsDeviceDetector /ImagePath:\\servername\images\image.ffu
            /devicefilters:device1,device2 /ImageProfile:Default
            /LowCost:true /SDMemory:true

[使用 USB 连接的设备]

KitsDeviceDetector /Physical:Fake_PC.dll
            /machinepool:$\User
            /DeviceName:my-device
            /DeviceID:00000011-abc1-abc1-0000-000000000000

AriesUtil.exe

AriesUtil.exe 实现了初始设备发现，并提供了一种在 Aries 硬件保护装置或连接设备上执行操作的方法。 该工具提供了以下功能：

  • 发送发现广播
  • 枚举已与此主机关联/在此主机上注册的所有 Aries
  • 获取 Aries 的固件版本
  • 设置用于将调试消息从设备路由到主机的端口
  • 设置用于将日志消息从 Aries 本身路由到主机的端口
  • 对连接设备执行供电循环
  • 对 Aries 本身执行供电循环
  • 将映像刷写到连接设备
  • 将固件刷写到 Aries 本身

用法

AriesUtil.exe <action> [action-arguments ...]

支持的操作

操作 说明
Help [<action-name>] 显示常规帮助或有关特定命令的帮助。
枚举 列出已在此主机上注册的 Aries。
Discover [/Aries:<aries-names>] [/Adapter:<adapter>] [/TTL:<ttl>] [/TimeoutSec:(<seconds>|infinite) | /TimeoutMin:(<minutes>|infinite)] [/BroadcastAddr:<addr>][/BroadcastPort:<port>] [/ListenPort:<port>]

列出可响应发现广播的 Aries。

最常见的用例不指定任何参数。

/白羊座

用于指定 Aries 的筛选器列表以查找响应。

  • 找到所有指定的 Aries 后，可以在超时时间到期之前结束发现。
  • 如果未指定，则发现将继续列出任何响应的 Aries，直到超时时间到期。
  • 参数值可以是单个 Aries 名称，也可以是用逗号或分号分隔的 Aries 名称列表。 它也可以是通配符星号 () 字符，在这种情况下，将考虑在当前主机上注册的所有 Aries。
/适配器

用于指定要在其中发出发现广播的网络适配器。

/Ttl

用于指定发现广播的生存时间。

/TimeoutSec

用于指定发现广播的超时时间（以秒为单位）。

/TimeoutMin

用于指定发现广播的超时时间（以分钟为单位）。

/BroadcastAddr

用于指定要发送到的发现广播 IP 地址。

/BroadcastPort

用于指定要发送到的发现广播目标端口。

/ListenPort

用于指定要侦听的发现广播响应端口。
GetFirmwareVersion /Aries:<aries-name>

获取指定的 Aries 上当前安装的固件版本。

/Aries 参数值可以是单个 Aries 名称，也可以是用逗号或分号分隔的 Aries 名称列表。 它也可以是通配符星号 () 字符，在这种情况下，将选择在当前主机上注册的所有 Aries。
MapDebugPort /Aries:<aries-name> /Port:<port-number> 为连接到 Aries 的设备设置调试输出，以将其路由到指定端口上的本地主机。
MapSysLogPort /Aries:<aries-name> /Port:<port-number> [/Frequency:<minutes>] [/Verbosity:<Critical|Error|Warning|Informational>]

为连接到 Aries 的设备设置 SysLog 输出，以将其路由到指定端口上的本地主机。 “频率”选项控制 Aries 广播自己的运行状况检测信号的频率，默认为 5 分钟。

“详细程度”控制将显示的最大日志级别。 默认为“信息性”。
ResetDevice /Aries:<aries-name> [/AutoSkip:<true|false>] 重置连接到指定 Aries 的设备。 默认情况下，AutoSkip 已关闭。
ResetAries /Aries:<aries-name> [/Wait:<seconds>] [/SkipFail]

对 Aries 本身执行供电循环。 如果指定了 /Wait 选项，该工具将等待指定的秒数，使 Aries 在退出之前重新联机。

/Aries 参数值可以是单个 Aries 名称，也可以是用逗号或分号分隔的 Aries 名称列表。 它也可以是通配符星号 () 字符，在这种情况下，将选择在当前主机上注册的所有 Aries。

如果指定了 /SkipFail 参数，则操作期间遇到的任何失败都将被忽略，直到处理完整个 Aries 列表。
FlashDevice /Aries:<aries-name> /ImagePath:<path-to-image.ffu> 将 FFU 映像刷写到连接到指定 Aries 的设备上。
FlashAries /Aries:<aries-name> /App:<path-to-app-file> [/MLO:<path-to-mlo-file>] [/Wait:<seconds>] [/SkipFail]

将固件更新刷写到 Aries 本身。

如果指定了 /Wait 选项，该工具将等待指定的秒数，使 Aries 在退出之前重新联机。

如果指定了 /MLO 选项，加载程序将在刷写应用之前被刷写到 Aries。

/Aries 参数值可以是单个 Aries 名称，也可以是用逗号或分号分隔的 Aries 名称列表。 它也可以是通配符星号 () 字符，在这种情况下，将选择在当前主机上注册的所有 Aries。

如果指定了 /SkipFail 参数，则操作期间遇到的任何失败都将被忽略，直到处理完整个 Aries 列表。
StartPowMon /Aries:<aries-name> [/OutFile:<Output>] [/Duration:<seconds>]

为指定的 Aries 启动电源监视会话（如果尚不存在）。

请注意，电源监视是一项阻塞性的操作。 要停止活动的电源监视会话，必须调用 StopPowMon 操作。

如果指定了 /OutFile 选项，则包含电源采样数据的输出文件的名称将是传入的值，而不是默认值。

如果指定了 /Duration 选项，则电源监视会话将仅持续指定的持续时间。 持续时间以秒为单位。

/Aries 参数值只能是单个 Aries 名称。
StopPowMon /Aries:<aries-name> 停止指定的 Aries 的活动电源监视会话（如果存在）。
SignalOn /Aries:<aries-name> 同时为 Aries 和 Beagle Bone 启用 LED 脉冲。
SignalOff /Aries:<aries-name> 同时为 Aries 和 Beagle Bone 禁用 LED 脉冲。

示例

Aries 发现：

AriesUtil.exe Discover

刷写 Aries 连接移动设备：

AriesUtil.exe ...

启用 Autoskip：

AriesUtil.exe ResetDevice /Aries:myaries [/Autoskip:true]