本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Device Advisor 详细控制台工作流
<a name="device-advisor-console-tutorial"></a>

在本教程中，您将创建自定义测试套件，并对要在控制台中测试的设备运行测试。测试完成后，您可以查看测试结果和详细日志。

**Topics**
+ [先决条件](#da-detailed-prereqs)
+ [创建测试套件定义](#device-advisor-console-create-suite)
+ [启动测试套件运行](#device-advisor-console-run-test-suite)
+ [停止测试套件运行（可选）](#device-advisor-stop-test-run)
+ [查看测试套件运行详细信息和日志](#device-advisor-console-view-logs)
+ [下载 AWS IoT 资格报告](#device-advisor-console-qualification-report)

## 先决条件
<a name="da-detailed-prereqs"></a>

要完成此教程，您需要[创建事物和证书](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html#da-create-thing-certificate)。

## 创建测试套件定义
<a name="device-advisor-console-create-suite"></a>

创建测试套件，以便可以在设备上运行该套件并进行验证。

1. 在 [AWS IoT 控制台](https://console.aws.amazon.com//iot)的导航窗格中，展开 **Test**（测试）、**Device Advisor**，然后选择 **Test suites**（测试套件）。  
![\[Device Advisor 界面，其中提供了为符合条件的设备及运行长时间测试创建测试套件、以及创建自定义测试套件的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-testsuite.png)

   选择 **Create Test Suite**（创建测试套件）。

1. 选择 `Use the AWS Qualification test suite` 或 `Create a new test suite`。

   对于协议，选择 **MQTT 3.1.1** 或 **MQTT 5**。  
![\[“创建测试套件”，可选择测试套件类型（AWS IoT Core 资格、长持续时间或自定义）和协议（MQTT 3.1.1 或 MQTT 5）。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-create-test-suite.png)

   选择`Use the AWS Qualification test suite`获得资格并将您的设备发布到 AWS 合作伙伴设备目录中。通过选择此选项，可以预先选择使您的设备符合 AWS IoT Core 资格计划所需资格的测试使用案例。无法添加或删除测试组和测试使用案例。您仍然需要配置测试套件属性。

   选择 `Create a new test suite` 来创建并配置自定义测试套件。我们建议从此选项开始进行初始测试和故障排除。自定义测试套件必须拥有至少一个测试组，并且每个测试组必须拥有至少一个测试用例。在本教程中，我们将选择此选项，然后选择 **Next**（下一步）。  
![\[“配置测试套件”页面，其中显示了创建测试套件以及测试组和测试案例以测试物联网设备的步骤。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-configure-test-suite.png)

1. 选择**测试套件属性**。创建测试套件时，您必须创建测试套件属性。  
![\[“配置测试套件”界面，其中显示了创建测试组及添加测试案例以测试物联网设备功能的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-suite-properties.png)

   在 **Test suite properties**（测试套件属性）项下，请填写以下内容：
   + **Test suite name**（测试套件名称）：您可以使用自定义名称创建套件。
   + **超时**（可选）：当前测试套件中每个测试使用案例的超时时间（以秒为单位）。如果您未指定超时值，则将使用默认值。
   + **标签**（可选）：向测试套件添加标签。  
![\[名为“测试套件属性”的窗口，显示了用于为 Device Advisor 演示套件指定测试套件名称、超时和自定义标签的字段。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-suite-properties-1.png)

   完成后，选择 **Update properties**（更新属性）。

1. 要修改组级别配置，请在 `Test group 1` 下，选择 **Edit**（编辑）。然后，输入**名称**为组指定一个自定义名称。

   或者，您也可以在所选的测试组下输入**超时**值（以秒为单位）。如果您未指定超时值，则将使用默认值。  
![\[“配置测试套件”界面，用于创建测试组和测试案例来验证物联网设备功能。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-edit-test-group.png)

   选择**完成**。

1. 从**测试使用案例**中拖动一个可用的测试使用案例加入测试组。  
![\[Device Advisor 中用于创建测试套件的配置界面，其中提供了添加测试组和测试案例以测试物联网设备的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-configure-test-suite-step5.png)

1. 要修改您添加到测试组的测试使用案例级别配置，请选择**编辑**。然后，输入**名称**为组指定一个自定义名称。

   或者，您也可以在所选的测试组下输入**超时**值（以秒为单位）。如果您未指定超时值，则将使用默认值。  
![\[测试套件配置界面，其中提供了配置测试组、测试案例、超时设置和起点以执行测试套件的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-edit-test-case.png)

   选择**完成**。
**注意**  
要向测试套件添加更多测试组，请选择 **Add test group**（添加测试组）。按照上述步骤创建和配置更多的测试组，或将更多测试使用案例添加到一个或多个测试组。可以通过选择并拖动测试使用案例到目标位置来重新排序测试组和测试使用案例。Device Advisor 将按照定义的测试组和测试用例顺序运行测试。

1. 选择**下一步**。

1. 在**步骤 3** 中，配置设备顾问将使用该角色代表您的测试设备执行 AWS IoT MQTT 操作。

   如果您仅在**步骤 2**中选择 **MQTT 连接**测试使用案例，将自动检查**连接**操作，因为运行此测试套件需要对设备角色具有该权限。如果您选择了其他测试使用案例，将检查相应的所需操作。确保提供了每个操作的资源值。例如，对于**连接**操作，提供设备将连接到 Device Advisor 端点的客户端 id。您可以通过使用逗号分隔值来提供多个值，也可以使用通配符 (\$1) 字符提供前缀值。例如，为任何 `MyTopic` 开头的主题提供发布权限，您可以将“`MyTopic*`”作为资源值。  
![\[Device Advisor 中用于创建测试套件的“选择设备角色”步骤，其中提供了创建新角色或选择现有角色的选项，以及用于指定角色名称、权限和资源详细信息的字段。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-connect-role.png)

   如果您之前已经创建了设备角色，您希望使用该角色，请选择 **Select an existing role**（选择现有角色）然后在 **Select role**（选择角色）下面选择您的设备角色。  
![\[用于为 Device Advisor 测试选择设备角色的页面，其中提供了创建新角色或选择现有角色的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-existing-role.png)

   使用提供的两个选项之一配置设备角色，然后选择 **Next**（下一步）。

1. 在**步骤 4**中，请确保每个步骤中提供的配置准确无误。要编辑为特定步骤提供的配置，请选择 **Edit**（编辑）用于相应的步骤。

   验证配置后，选择 **Create test suite**（创建测试套件）。

   测试套件应能成功创建，并且您将被重定向到 **Test suite**（测试套件）页面，您可以在其中查看已创建的所有测试套件。

   如果测试套件创建失败，请确保已按照之前的说明配置测试套件、测试组、测试使用案例和设备角色。

## 启动测试套件运行
<a name="device-advisor-console-run-test-suite"></a>

1. 在 [AWS IoT 控制台](https://console.aws.amazon.com//iot)的导航窗格中，展开**测试**、**Device Advisor**，然后选择**测试套件**。

1. 选择要查看其测试套件详细信息的测试套件。  
![\[显示名为“Device advisor demo suite”的单个测试套件，创建时间是 2021 年 5 月 11 日。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-suites.png)

   测试套件详细信息页面将显示与测试套件相关的所有信息。

1. 选择 **Actions**（操作），然后选择 **Run test suite**（运行测试套件）。  
![\[演示套件页面，其中有一个“运行测试套件”按钮，以及显示之前没有运行过测试套件的空活动日志。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-run-test-suites.png)

1. 在 “**运行配置**” 下，您需要选择要使用设备顾问进行测试 AWS IoT 的事物或证书。如果您没有任何现有内容或证书，请先[创建 AWS IoT Core 资源](device-advisor-setting-up.md)。

   在**测试端点**中，选择最适合您使用案例的端点。如果您计划将来使用同一个 AWS 账户同时运行多个测试套件，请选择**设备级端点**。否则，如果您计划一次只运行一个测试套件，请选择**账户级别端点**。

   使用选定的 Device Advisor 的测试端点配置测试设备。

   选择事物或证书以及 Device Advisor 端点后，选择**运行测试**。  
![\[在上运行测试套件的配置 AWS IoT Core，允许您选择测试设备（东西或证书），选择测试端点（账户级别或设备级别），还可以选择添加标签。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-choose-thing-certificate.png)

1. 选择顶部广告条的 **Go to result**（转到结果），以查看测试运行详细信息。  
![\[状态为“待处理”、名为“Device Advisor demo suite”的自定义测试套件的详细信息。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-run-results.png)

## 停止测试套件运行（可选）
<a name="device-advisor-stop-test-run"></a>

1. 在 [AWS IoT 控制台](https://console.aws.amazon.com//iot)的导航窗格中，展开 **Test**（测试）、**Device Advisor**，然后选择 **Test run and results**（测试运行和结果）。

1. 选择要停止的正在进行的测试套件。  
![\[Device Advisor 控制台上测试运行的结果。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-suite-to-stop.PNG)

1. 选择 **Actions**（操作），然后选择 **Stop test suite**（停止测试套件）。  
![\[Device Advisor 控制台上测试运行的结果。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-stop-test-suite.PNG)

1. 此清理过程可能需要几分钟才能完成。清理程序运行时，测试运行状态将为 `STOPPING`。等待清理程序完成，并等待测试套件状态更改为 `STOPPED` 状态，然后再开始运行新套件。  
![\[Device Advisor 控制台上测试运行的停止结果。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-stopped-test-suite.PNG)

## 查看测试套件运行详细信息和日志
<a name="device-advisor-console-view-logs"></a>

1. 在 [AWS IoT 控制台](https://console.aws.amazon.com//iot)的导航窗格中，展开 **Test**（测试）、**Device Advisor**，然后选择 **Test run and results**（测试运行和结果）。

   本页面将显示：
   + IoT 事物的数量
   + IoT 证书的数量
   + 当前运行的测试套件数
   + 所有已创建的测试套件运行

1. 选择要查看其运行详细信息和日志的测试套件。  
![\[测试运行和结果部分，其中显示了当前正在进行的名为“Device Advisor demo suite”的测试套件的详细信息。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-test-suite-run.png)

   运行摘要页面显示当前测试套件运行的状态。此页面每 10 秒自动刷新一次。我们建议您为设备建立一个机制，以便每五秒便尝试一次连接到测试端点，每次持续一到两分钟。然后，您能够以自动的方式按顺序运行多个测试使用案例。  
![\[测试案例日志，显示了未出现任何系统消息的成功 MQTT Connect 测试。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-run-summary.png)

1. 要访问测试套件运行的 CloudWatch 日志，请选择**测试套件日志**。

   要访问任何测试用例的 CloudWatch 日志，请选择**测试用例日志**。

1. 根据您的测试结果，对您的设备进行[故障排除](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html#device-advisor-troubleshooting)操作，直到通过所有测试。

## 下载 AWS IoT 资格报告
<a name="device-advisor-console-qualification-report"></a>

如果您在创建**测试套件时选择了使用 AWS IoT 资格**测试套件选项，并且能够运行资格测试套件，则可以通过在测试运行摘要页面中选择**下载资格报告**来下载资格报告。

![\[资格认证计划测试结果，显示了 MQTT、TLS 及其他组件通过的测试。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-qualification-report.png)