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

# 在控制台中开始使用 Device Advisor
<a name="da-console-guide"></a>

本教程可帮助您开始使用 AWS IoT Core Device Advisor 控制台。Device Advisor 提供了一些特征，如必需的测试和签名的资格报告等。您可以使用这些测试和报告来确定设备的资格并在 [AWS 合作伙伴设备目录](https://devices.amazonaws.com/)中列出设备，详见 [AWS IoT Core 资格计划](https://aws.amazon.com/partners/dqp/)。

有关使用 Device Advisor 的更多信息，请参阅 [Device Advisor 工作流](device-advisor-workflow.md) 和 [Device Advisor 详细控制台工作流](device-advisor-console-tutorial.md)。

要完成本教程，请执行 [设置](device-advisor-setting-up.md) 中概述的步骤。

**注意**  
以下各项支持设备顾问 AWS 区域：  
美国东部（弗吉尼亚州北部）
美国西部（俄勒冈）
亚太地区（东京）
欧洲地区（爱尔兰）

**开始使用**

1. 在 [AWS IoT 控制台的](https://console.aws.amazon.com//iot)导航窗格中的**测试**下，选择 **Device Advisor**。然后，选择控制台上的**开始演练**按钮。  
![\[Device Advisor 是一项针对物联网设备的完全托管测试功能，用于验证与物联网设备的安全交互 AWS IoT Core、识别软件问题并获取测试结果。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-gs.png)

1. **Device Advisor 入门**页面概述了创建测试套件和对您的设备运行测试所需的各个步骤。您还可以在此处查找适用于您账户的 Device Advisor 测试端点。您必须在用于测试的设备上配置固件或软件，以连接到此测试端点。

   要完成此教程，您首先要[创建事物和证书](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html#da-create-thing-certificate)。查看**工作原理**下的信息后，选择**下一步**。  
![\[测试物联网设备连接的步骤：选择协议、创建测试套件、配置设备设置。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-gs1.png)

1.  在**步骤 1：选择协议**中，从列出的选项中选择协议。然后选择**下一步**。  
![\[设备顾问界面显示了选择用于测试物联网设备的通信协议（MQTT 3.1.1、MQTT 3.1.1 以上 WebSocket、MQTT 5、MQTT 5 以上） WebSocket的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-protocol.png)

1. 在 **Step 2**（步骤 2）中，您可以创建和配置自定义测试套件。自定义测试套件必须拥有至少一个测试组，并且每个测试组必须拥有至少一个测试用例。我们为您添加了 **MQTT Connect** 测试使用案例，以便您能开始操作。

   选择**测试套件属性**。  
![\[Device Advisor 中的“创建测试套件”屏幕，用户可以在其中创建和配置测试组和测试案例，以使用 MQTT 协议测试物联网设备。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-test-suite-create.png)

   创建测试套件时需提供测试套件属性。您可以配置如下套件级属性：
   + **测试套件名称**：输入测试套件的名称。
   + **超时**（可选）：当前测试套件中每个测试用例的超时（以秒为单位）。如果您未指定超时值，则将使用默认值。
   + **标签**（可选）：向测试套件添加标签。

   完成后，选择 **Update properties**（更新属性）。  
![\[用于更新测试套件属性的表单，包括名称、超时和添加标签的功能。包含“更新属性”按钮。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-test-suite-properties.png)

1. （可选）要更新测试套件组配置，请选择测试组名称旁的**编辑**按钮。
   + **名称**：输入测试套件组的自定义名称。
   + **超时**（可选）：当前测试套件中每个测试用例的超时（以秒为单位）。如果您未指定超时值，则将使用默认值。

   完成后，选择**完成**以继续。  
![\[显示一个名为“Test group 1”的测试组，其中包含配置超时和添加更多测试组的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-test-suite-config.png)

1. （可选）要更新测试用例的测试用例配置，请选择测试用例名称旁边的**编辑**按钮。
   + **名称**：输入测试套件组的自定义名称。
   + **超时**（可选）：所选测试使用案例的超时（以秒为单位）。如果您未指定超时值，则将使用默认值。

   完成后，选择**完成**以继续。  
![\[“创建测试套件”界面，显示了配置测试套件、测试组以及各个测试案例以测试物联网设备的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-test-case-config.png)

1. （可选）要向测试套件添加更多测试组，请选择**添加测试组**，然后按照步骤 5 中的说明进行操作。

1. （可选）要添加更多测试使用案例，请将**测试使用案例**部分中的测试使用案例拖到您的任何测试组中。  
![\[“创建测试套件”界面，用户可以在其中创建和配置测试组和测试案例，以使用 MQTT 协议测试物联网设备。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-drag.png)

1. 您可以更改测试组和测试使用案例的顺序。要进行更改，请在列表中向上或向下拖动列出的测试使用案例。Device Advisor 按照您列出的测试顺序运行测试。

   配置测试套件后，选择 **Next**（下一步）。

1. 在**步骤 3** 中，选择要使用设备顾问进行测试 AWS IoT 的事物或证书。如果您没有任何现有的事物或证书，请参阅[设置](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html)。  
![\[配置选项，其中包括选择协议、创建测试套件、配置设备设置以及查看测试运行和结果。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-device-settings.png)

1. 您可以配置设备角色，设备顾问使用该角色代表您的测试设备执行 AWS IoT MQTT 操作。仅对于 **MQTT 连接**测试使用案例，自动选择**连接**操作。这是因为设备角色需要此权限才能运行测试套件。对于其它测试使用案例，将选择相应的操作。

   为每个选定的操作提供资源值。例如，对于**连接**操作，提供客户端 ID，您的设备使用该 ID 连接到 Device Advisor 端点。您可以使用逗号分隔的值提供多个值，并使用通配符（\$1）作为值的前缀。例如，要为任何以 `MyTopic` 开头的主题提供发布权限，请输入 **MyTopic\$1** 作为资源值。  
![\[设备顾问界面，您可以在其中选择设备角色并定义连接、发布、订阅和管理 MQTT 主题和客户端的权限。 IDs\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-device-role.png)

   要使用之前从[设置](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html)中创建的设备角色，请选择**选择现有角色**。然后，在**选择角色**下选择您的设备角色。  
![\[用于选择设备角色的 Web 表单界面，其中包含创建新角色或选择名为 “DeviceAdvisorServiceRole” 的现有角色的选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-select-device-role.png)

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

1. 在**测试端点**部分中，选择最适合您的使用案例的端点。要使用相同的测试套件同时运行多个测试套件 AWS 账户，请选择**设备级端点**。要一次运行一个测试套件，请选择**账户级端点**。  
![\[为测试选择账户级端点或设备级端点的选项，提供了端点 URL 和“下一步”按钮。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-endpoint.png)

1. **步骤 4** 显示了所配置的所选测试设备、测试端点、测试套件和测试设备角色的概览。要对某个部分进行更改，请对于要编辑的部分选择**编辑**按钮。确认测试配置后，选择**运行**以创建测试套件并运行测试。
**注意**  
为了获得最佳结果，您可以在启动套件运行之前，将选定的测试设备连接到 Device Advisor 测试端点。我们建议您为设备建立一个机制，以便每五秒尝试连接到测试端点一次，最多持续一到两分钟。  
![\[设备配置控制台，显示了设备角色详细信息、测试端点以及取消、返回或运行选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-device-review.png)  
![\[设备配置控制台，显示了设备角色详细信息、测试端点以及取消、返回或运行选项。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-device-review-contd.png)

1. 在导航窗格的**测试**下的，选择 **Device Advisor**，然后选择**测试运行和结果**。选择测试套件运行以查看其运行详细信息和日志。  
![\[表示正在对设备 “” MyThing 进行 MQTT 3.1.1 测试的测试套件接口。\]](http://docs.aws.amazon.com/zh_cn/iot/latest/developerguide/images/da-console-runs-results.png)

1. 要访问该套件的 Amazon CloudWatch 日志，请运行：
   + 选择 “**测试套件** CloudWatch 日志” 以查看测试套件运行的日志。
   + 为任何**测试用例选择测试用例日志**，以查看特定于测试用例的 CloudWatch 日志。

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