附录(触摸板-附录)

Windows 精确式触摸板验证指南的附录,提供有关常见错误消息以及特定于 HID 的某些错误消息的信息。

错误消息

错误消息编号 错误消息 说明
1 用户显式使操作失败。 操作员通过热键使迭代/测试失败。
2 过多的迭代失败: 过多的迭代失败。 包括失败的迭代数。
3 在意外的时间收到输入。 测试未期望收到数据,但却收到了数据。 例如,在 Z 高度检测测试中可能发生这种情况。
5 收到过多的触点: 操作员放下的触点过少。 包括检测到的触点数。
6 收到的触点过少: 操作员放下了过多的触点。 包括检测到的触点数。
7 测试未收到足够的数据。

如果该错误发生在触点提起时,则表示测试要求接触持续特定的一段时间,但未达到该持续时间。

如果该错误发生在触点落下时,则表示测试收到了零接触帧作为第一个数据 – 这可能是按下非电容式按钮造成的,但更有可能发生了协议错误(设备发送空帧)。

9 收到了意外的触点。 在需要特定数量的触点的测试中,这表示触点在提起后落下。 所有触点落下应发生在所有触点提起之前。
10 几何数据超出预期范围: 仅适用于 Test.Geometry。 宽度和/或高度超出了测试的预期范围。 包括检测到的宽度和高度(以千分之一分米为单位)。
11 触点位移过大: 触点的整体 x/y 位移过大。 包括检测到的位移(以千分之一分米为单位)。
12 交互时间过短: 交互长度(从首次触点落下到最后一次触点提起的时间)过短。 包括检测到的交互长度(以毫秒为单位)。
13 交互时间过长: 交互长度(从首次触点落下到最后一次触点提起的时间)过长。 包括检测到的交互长度(以毫秒为单位)。
14 数据包离边缘过远: 表示第一个数据包离触摸板边缘过远。 包括与边缘的距离(以千分之一分米为单位)。
15 触点未沿直线移动: 触点偏离最佳拟合线过大。 包括检测到的与直线的最大偏差(以千分之一分米为单位)。
16 直线与轴的偏差过大: 仅适用于 Test.Linearity 系列测试。 触点朝 X 或 Y 方向位移过大。 包括偏差(以千分之一分米为单位)。
17 点的分隔不足: 仅适用于 Test.ConvergeDiverge 系列测试。 如果是在收敛,则表示起始点相互过于靠近。 如果是在发散,则表示结束点相互过于靠近。
18 点的分离过度: 仅适用于 Test.ConvergeDiverge 系列测试。 如果是在收敛,则表示结束点相互过于靠近。 如果是在发散,则表示起始点相互过于靠近。 包括点之间的距离(以千分之一分米为单位)。
20 位置增量过大: 两个数据包之间的位置增量过大,无法测试。 包括检测到的增量(以千分之一分米为单位)。
23 设备不支持最少触点数量: 该设备不支持所需的最少触点数量。 包括支持的触点数量。
24 设备支持的触点过多: 该设备支持的触点数超过了所需的最大数量。 包括支持的触点数量。
25 数据包不在预期位置: 仅适用于 Test.PositionalAccuracy 系列测试。 表示数据包的位置不在所需的位置。 包括数据包的位置(以千分之一分米为单位)。
26 边界区域外部没有数据包。 在涉及使用精确接触装置绘制直线的测试中,这表示整条线位于触摸板的边界区域内。
27 发现数据包向后行进。 仅适用于 Test.Linearity 系列测试。 表示发现某个数据包相对于数据包流的其余数据包向后行进。
28 DPI 过低: 仅适用于 Test.InputResolution。 表示触摸板上 X/Y 的逻辑范围,结合物理尺寸来看,该触摸板不支持所需的 DPI。 包括计算出的 DPI。
29 清除后发现设置了置信度位。 仅适用于 Test.Confidence。 表示发现在清除触点的置信度位后又为其设置了置信度位。
30 设置的置信度位过长: 仅适用于 Test.Confidence。 表示未在触点生命周期的足够早的阶段清除置信度位。 包括设置置信度位的时长(以毫秒为单位)。
31 找到的逻辑坐标百分比过低: 仅适用于 Test.InputResolution。 在给定迭代中收到的数据包中的 X 或 Y 坐标必须包括总范围的最小百分比。 包括实际找到的百分比。
32 必须以提升的权限运行此测试。 应以提升的权限启动 PTLogo 才能运行此测试。
33 设备不支持选择性报告。 设备不支持选择性报告。
34 重复的数据包: 仅适用于 Test.Linearity 系列测试。 表示两个连续数据包具有相同的 X/Y 位置,即使触点正在移动。 包括检测到的重复数据包的扫描时间。
35 找不到逻辑坐标: 仅适用于 Test.InputResolution。 表示在迭代期间任何数据包从未报告所需的 X 或 Y 坐标。 包括以逻辑单位表示的所需坐标。
36 始终设置了置信度。 仅适用于 Test.Confidence。 表示从未清除置信度位。
37 通过自动化失败。 测试通过自动化失败。
38 触点位移过小。 触点的初始 x/y 位移太小。 包括检测到的位移(以千分之一分米为单位)。
39 意外的按钮状态更改。 仅适用于 Test.RightClickReliability。 当从触摸板接收到仅按钮输入报告时发生。
40 设备高度太低。 仅适用于 Test.DeviceHeight。 触摸板的高度太低。 包括检测到的高度(以毫米为单位)。
41 设备宽度太低。 仅适用于 Test.DeviceWidth。 触摸板的宽度太低。 包括检测到的宽度(以毫米为单位)。

特定于 HID 的错误消息

下表列出了与 Windows 精确式触摸板设备测试相关的特定于 HID 的错误消息。

HID 错误编号 错误消息 说明
1 X 位大小无效。 Tx/Cx 的位计数超出范围 [1,32]。 仅在 C 存在时检查。
2 Y 位大小无效。 Ty/Cy 的位计数超出范围 [1,32]。 仅在 C 存在时检查。
3

数据包转换无效。

此错误消息可能与下列任一其他消息一同显示:

o“上次移动位置不同”

给定触点的“尖端开关清除”报告的坐标与“设置的最后一个尖端开关”报告的坐标不同。

o“缺少 tip-on”

第一个报告未设置尖端开关,或者连续有两个数据包未设置尖端开关。

o“缺少尖端”

在当前帧中,找不到在先前报告的帧中存在的、设置了尖端开关的触点。
4 扫描时间无效。

此错误消息可能与下列任一其他消息一同显示:

o“(不存在)”

设备不支持在其描述符中使用扫描时间。

o“(范围)”

报告的扫描时间超出逻辑范围。

o“(增量比时间的 1% 多 10ms 以上)”

帧到帧的扫描时间增量比时间的 1% 不止多 10ms。

o“(增量 > 16.7ms)”

帧到帧的扫描时间增量大于 16.7 毫秒。

o“(重复)”

扫描时间在两个连续帧中重复。

o“(帧中存在不同的值)”

扫描时间值对于给定帧的所有已报告触点不同。

o“(与挂钟时间有偏差)”

扫描时间的增量与系统时间相差太远。 扫描时间增量大于时钟时间的 5%。
5 X、Y 无效。

此错误消息可能与下列任一其他消息一同显示:

o“(T 无效)”

在 C、宽度或高度存在的情况下,Tx 和/或 Ty 不存在或不在其逻辑范围内。

o“(C 无效)”

在 T、宽度或高度存在的情况下,Cx 和/或 Cy 不存在或不在其逻辑范围内。

o“(T/C 组合无效)”

T 不包含在由 C、宽度和高度构成的边界框内。
6 宽度或高度无效。

此错误消息可能与下列任一其他消息一同显示:

o ""

宽度和/或高度存在,两者之一不存在,或者两者之一/两者在其逻辑范围外。

o“(0)”

宽度和/或高度存在,但两者之一/两者的逻辑值为零。
8 触点 ID 无效。

此错误消息可能与下列任一其他消息一同显示:

o“(不存在)”

设备不支持在其描述符中使用 ContactID。

o“(帧中存在重复项)”

触点 ID 在单个帧中重复(有时是由于报告的帧不完整造成的)。
14 帧中没有数据。 帧中没有触点,并且物理按钮未按下,但物理按钮之前未升起。
16 帧中的触点数量无效。 帧中的触点数量与报告的实际计数不匹配。
17 帧中的触点数超过最大值。 帧中的触点数超过了设备支持的最大触点数(由“最大计数”定义)。
18 采样率超出范围。 采样率不在所报告触点数的允许范围内。
21 实际计数无效。 设备不支持在其描述符中使用 ActualCount。
22 置信度无效。 置信度开关未设置(测试不是置信度测试)。

PTLogo 命令行开关

这些开关可以结合使用,仅用于调试目的。 不允许将这些开关用于认证测试运行。

开关 使用情况 目的
-startat # “Ptlogo.exe -startat # test.foo.json”(其中 # 表示给定 .json 测试的特定起始迭代) 用于跳转到给定测试中的特定迭代。
-NoHIDValidation “Ptlogo.exe –noHidValidation test.foo.json” 用于禁用特定测试的后台 HID 验证。
-noDesktop “Ptlogo.exe –noDesktop test.foo.json” 用于在启动测试的同一输入桌面上启动测试;对于在后台或其他调试工具中运行 digiinfo 很有用。
-alliters “Ptlogo.exe –alliters test.foo.json” 即使超过允许的最大失败迭代次数,也能使操作员完成所有测试迭代
-EnableHIDLogging “Ptlogo.exe –enableHIDLogging test.foo.json” 用于在特定测试期间启用 HID 日志记录,以生成 HID.log 文件来详细调试故障。