排查无线 LAN (802.11) 测试问题

  • 项目

本主题介绍适用于 WLAN 测试的一些常见故障排除提示。 开始时，请执行以下操作：

  1. 查看排查 Windows HLK 测试失败问题。

  2. 查看 Windows HLK 发行说明，了解当前测试问题。

  3. 对于失败的测试，请在 Windows HLK Studio 测试日志中查找可用信息。 如果找到可用信息，请解决问题并重新运行测试。

在 HLK 客户端计算机上对设备进行的更改未反映在 HLK Studio 中。 例如，计算机应处于“就绪”状态，但它不是此状态。

  1. 在客户端计算机上打开“命令提示符”窗口，然后运行 net stop wttsvc。

  2. 运行 net start wttsvc。 此命令会更新 C:\wtt\JobsWorkingDir\AssetCfg\Log\ 目录。

  3. 重启 HLK Studio。 可能需要等待几分钟，以便 HLK 控制器可轮询客户端计算机以查找设备列表中的更改。

尚未发现计算机池的计算机。

  1. 在 HLK 管理器中打开“作业监视器”窗口。

  2. 选择屏幕顶部的“显示查询生成器”按钮。

  3. 单击“计算机查询”选项卡。

  4. 为要查找的计算机定义搜索参数。 通常，可以设置单个规则，如“数据存储等于‘控制器名称’”。

  5. 右键单击刚定义的规则，然后单击“执行”。 内容丰富的计算机列表会填充所定义的查询字段下面的“计算机”列表。

  6. 将“计算机”列表中的任何计算机拖动到已创建的新计算机池中。

计算机似乎未运行为其计划的作业。

  1. 查看 DUT、SUT 和 AP 计算机上的 NIC 名称。  对于以太网，名称必须是 MessageDevice，对于 WLAN NIC，必须是 SupportDevice0 和 SupportDevice1。 如果不是，请手动将其重命名。

  2. 确保池中的每台计算机的状态为就绪。

    1. 在 HLK 管理器中打开“作业监视器”窗口。

    2. 在“计算机池”选项卡中，选择期望运行作业的计算机池。

    3. 如果计算机的状态不是“就绪”，请右键单击计算机，指向“更改状态”，然后单击“重置”。

    4. 几分钟后，刷新屏幕，状态会更改为“就绪”。

  3. 再次计划并启动作业。

在拓扑上安装测试 SoftAP 驱动程序时出现问题：设备管理器报告代码 52

安装 HLK 客户端之前，请勿安装 x64 测试 SoftAP 驱动程序。 安装 HLK 客户端时，会安装根证书。 由于测试 SoftAP 驱动程序签名取决于根证书的安装，因此设备管理器会报告设备代码 52。

为独立执行配置 NDISTest

通过安装独立于 HLK Studio 的 NDISTest，可以执行单个测试。 需要配置 DUT、SUT 和测试 SoftAP 才能启用独立执行。

注意

所有测试计算机都必须使用相同的处理器体系结构。

注意

若要对 NDISTest 进行故障排除，请尝试将调试程序附加到测试计算机。

配置受测支持设备 (SUT)

  1. 从以下 HLK 控制器复制所有 NDISTest 二进制文件和子目录：

    \\<ControllerName>\tests\<architecture>\nttest\nettest\ndis\ndistest.net\

    <ControllerName> 是 HLK 控制器计算机的名称， <体系结构> 是 x86 (（适用于基于 x86 的处理器) ）或 amd64 (（适用于基于 x64 的处理器) ）。

  2. 从安装目录启动 NDISTest.exe。 主窗体打开后，从“文件”菜单中选择“服务器”以启动服务器窗体。

  3. 从“消息设备”列表中选择消息设备。 此设备必须支持 IP，并且必须与稍后设置的客户端消息设备位于同一子网中。

  4. 从“支持设备”中选择 SUT 设备。 在此服务器上选择的支持设备会在服务器启动后对客户端可见。

  5. 从“作业”中选择“服务器”作业。 这是在单击启动按钮后启动的服务器端测试。

选择所有选项后，单击“启动”以启动服务器。

配置测试软件访问点（测试 SoftAP）

  1. 从以下 HLK 控制器复制所有 NDISTest 二进制文件和子目录：

    \\<ControllerName>\tests\<architecture>\nttest\nettest\ndis\ndistest.net\

    <ControllerName> 是 HLK 控制器计算机的名称， <体系结构> 是 x86 (（适用于基于 x86 的处理器) ）或 amd64 (（适用于基于 x64 的处理器) ）。

  2. 在测试 SoftAP 中为两个 Atheros WLAN 设备安装 SoftAP 驱动程序。 可以从设备管理器（可通过从命令提示符运行 devmgmt.msc 来打开）安装此驱动程序。 完成以下步骤：

    • 在设备管理器中，从 \\<ControllerName>\Tests\<architecture>\nttest\nettest\ndis\NDISTest.net\SoftAPMiniport\ 安装 SoftAP station 的驱动程序

      <ControllerName> 是 HLK 控制器计算机的名称，<architecture> 是 x86（适用于基于 x86 的处理器）或 amd64（适用于基于 x64 的处理器），具体取决于具有 SoftAP 设备的 HLK 客户端计算机的处理器体系结构。

  3. 从安装目录启动 NDISTest.exe。 主窗体打开后，从“文件”菜单中选择“服务器”以启动服务器窗体。

  4. 从“消息设备”列表中选择消息设备。 此设备必须是支持 IP 的设备，并且必须与稍后设置的客户端消息设备位于同一子网中。

  5. 从“AP 设备”中选择 AP 设备。 在此服务器上选择的 AP 设备会在服务器启动后对客户端可见。

  6. 从“作业”中选择“服务器”作业。 这是在单击启动按钮后启动的服务器端测试。

选择所有选项后，单击“启动”以启动服务器。

配置受测设备 (DUT)

  1. 从以下 HLK 控制器复制所有 NDISTest 二进制文件和子目录：

    \\<ControllerName>\tests\<architecture>\nttest\nettest\ndis\ndistest.net\

    <ControllerName> 是 HLK 控制器计算机的名称，<architecture> 是 x86（适用于基于 x86 的处理器）或 amd64（适用于基于 x64 的处理器）。

  2. 从安装目录启动 NDISTest.exe。 主窗体打开后，从“文件”菜单中选择“客户端”以启动客户端窗体。

  3. 从“测试目标”列表中选择测试目标。 对于网络设备，此测试目标应是“微型端口”。

  4. 从“测试设备”列表中选择测试设备。 这必须是特定于供应商的测试设备。

  5. 从“消息设备”列表中选择消息设备。 这应是支持 IP 的设备，与服务器消息设备位于同一子网中。 选择消息设备后，应显示 AP 设备部分，并且服务器 AP 设备应在列表中可用。

  6. 从“支持设备”中选择支持设备。 这必须是特定于供应商的支持设备。

  7. 从“AP 设备”中选择 AP 设备。 这必须是在服务器端选择的 AP 设备。

  8. 从“作业”部分中选择将在启动客户端后运行的测试。

选择所有选项后，单击“启动”以启动客户端。 选择的任何作业都会开始执行。 测试结果会存储在客户端上的以下日志记录子文件夹中：

<NDISTestRootFolder>/logs/<AdapterName>/

配置客户端数据包捕获

  1. 为独立执行配置测试拓扑。 有关详细信息，请参阅“为独立执行配置 NDISTest”。

  2. 设置第二个 SUT。 有关详细信息，请参阅“配置受测支持设备 (SUT)”。

  3. 从安装目录启动 NDISTest.exe。 主窗体打开后，从“视图”菜单中选择“调试”以在客户端上启动“数据包捕获”部分。

  4. 从“数据包捕获”中选择捕获设备。 这必须是在服务器端选择的支持设备。

  5. 从“作业”中选择将在启动客户端后运行的测试。

  6. 选择所有选项后，单击“启动”以启动客户端。

  7. 与测试对应的数据包捕获会在具有捕获设备的服务器上生成。 日志会位于以下日志记录子文件夹中：

    <NDISTestRootFolder>/logs/<AdapterName>/

在客户端上未显示“数据包捕获”部分时进行故障排除

验证是否关闭了消息中心用户界面。 如果 NDISTest 用户界面未最大化，则“数据包捕获”部分可能会隐藏在消息中心用户界面后面。

我想打开一个 bug。 我应在 bug 中添加的内容：

  • 创建包含失败测试的 .hlkx 包 - 请参阅“创建包”部分并将其附加到 bug 中。

  • 失败日志 - 请从测试运行中收集 ndistest 日志，并将其与包一起添加到 bug 中。  可执行以下操作查找日志：

  1. 打开 HLK 管理器

  2. 选择 资源管理器> 作业监视器

  3. 选择计划了测试的计算机池。

  4. 在右侧窗格中，选择 DUT 计算机。

  5. 在“作业执行状态”下，右键单击运行的测试的作业名称，然后选择“浏览作业日志”。

  6. 此时将打开一个资源管理器窗口，其中包含 AP、Server 和 Test 目录。  压缩这些目录并将其附加到 bug 中。

运行失败后如何重置计算机？

下表包含常见问题和解决方案。

症状

解决方案

VAN UI 不显示任何网络

1

我将 WLAN 设备连接到启用了 DHCP 的网络时，未获得 IP。

2

遇到奇怪的“反向通道”故障

2

（SUT、DUT 或 AP）计算机故障，现在所有测试都失败了

1,2,3

通过 HLK 运行时，NDISTest 未自动查找我的测试适配器

3

HLK 测试无法填充 MessageDevice 或 SupportDevice

3

我更新了我的 HLK 控制器但未更新我的客户端，现在遇到了从未见过的奇怪故障

移动到新控制器时，你还应重新生成你的客户端。 如果不可行，你需要从全部三台计算机中删除 ndprot630.sys，并从 AP 计算机中删除 ahr.sys 和 softap.sys。 所有这些文件均位于 c:\windows\system32\drivers 目录。 运行 NDISTest 时，将自动重新加载Ndprot630.sys，但不会被覆盖。 需要从新控制器复制ather.sys和Sofap.sys。

我的物理 AP 似乎不像以前那样正常工作了

你必须重置/重启你的物理 AP。 如果将其恢复出厂设置，请确保按设置说明设置通道和无线电。

我尝试了上述所有步骤，但没有任何效果

如果已尝试上述步骤但问题仍未解决，你可以卸载 WLAN 适配器然后重新安装。 确保在完成操作后将适配器重命名为 SupportDevice0。

Device.Network 测试

排查 Windows HLK 问题