Device Advisor 详细控制台工作流 - Amazon IoT Core
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Device Advisor 详细控制台工作流

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

先决条件

要完成此教程,您需要创建事物和证书

创建测试套件定义

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

  1. Amazon IoT 控制台的导航窗格中,展开 Test(测试)、Device Advisor,然后选择 Test suites(测试套件)。

    Device Advisor 界面,其中提供了为符合条件的设备及运行长时间测试创建测试套件、以及创建自定义测试套件的选项。

    选择 Create Test Suite(创建测试套件)。

  2. 选择 Use the Amazon Qualification test suiteCreate a new test suite

    对于协议,选择 MQTT 3.1.1MQTT 5

    “创建测试套件”界面,其中提供了供选择测试套件类型(Amazon IoT Core 资格认证、长时间或自定义)和协议(MQTT 3.1.1 或 MQTT 5)的选项。

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

    选择 Create a new test suite 来创建并配置自定义测试套件。我们建议从此选项开始进行初始测试和故障排除。自定义测试套件必须拥有至少一个测试组,并且每个测试组必须拥有至少一个测试使用案例。在本教程中,我们将选择此选项,然后选择 Next(下一步)。

    “配置测试套件”页面,其中显示了创建测试套件以及测试组和测试案例以测试物联网设备的步骤。
  3. 选择测试套件属性。创建测试套件时,您必须创建测试套件属性。

    “配置测试套件”界面,其中显示了创建测试组及添加测试案例以测试物联网设备功能的选项。

    Test suite properties(测试套件属性)项下,请填写以下内容:

    • Test suite name(测试套件名称):您可以使用自定义名称创建套件。

    • 超时(可选):当前测试套件中每个测试使用案例的超时时间(以秒为单位)。如果您未指定超时值,则将使用默认值。

    • 标签(可选):向测试套件添加标签。

    名为“测试套件属性”的窗口,显示了用于为 Device Advisor 演示套件指定测试套件名称、超时和自定义标签的字段。

    完成后,选择 Update properties(更新属性)。

  4. 要修改组级别配置,请在 Test group 1 下,选择 Edit(编辑)。然后,输入名称为组指定一个自定义名称。

    或者,您也可以在所选的测试组下输入超时值(以秒为单位)。如果您未指定超时值,则将使用默认值。

    “配置测试套件”界面,用于创建测试组和测试案例来验证物联网设备功能。

    选择完成

  5. 测试使用案例中拖动一个可用的测试使用案例加入测试组。

    Device Advisor 中用于创建测试套件的配置界面,其中提供了添加测试组和测试案例以测试物联网设备的选项。
  6. 要修改您添加到测试组的测试使用案例级别配置,请选择编辑。然后,输入名称为组指定一个自定义名称。

    或者,您也可以在所选的测试组下输入超时值(以秒为单位)。如果您未指定超时值,则将使用默认值。

    测试套件配置界面,其中提供了配置测试组、测试案例、超时设置和起点以执行测试套件的选项。

    选择完成

    注意

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

  7. 选择下一步

  8. 步骤 3中,配置 Device Advisor 将用于代表测试设备执行 Amazon IoTMQTT 操作的设备角色。

    如果您仅在步骤 2中选择 MQTT 连接测试使用案例,将自动检查连接操作,因为运行此测试套件需要对设备角色具有该权限。如果您选择了其他测试使用案例,将检查相应的所需操作。确保提供了每个操作的资源值。例如,对于连接操作,提供设备将连接到 Device Advisor 端点的客户端 id。您可以通过使用逗号分隔值来提供多个值,也可以使用通配符 (*) 字符提供前缀值。例如,为任何 MyTopic 开头的主题提供发布权限,您可以将“MyTopic*”作为资源值。

    Device Advisor 中用于创建测试套件的“选择设备角色”步骤,其中提供了创建新角色或选择现有角色的选项,以及用于指定角色名称、权限和资源详细信息的字段。

    如果您之前已经创建了设备角色,您希望使用该角色,请选择 Select an existing role(选择现有角色)然后在 Select role(选择角色)下面选择您的设备角色。

    用于为 Device Advisor 测试选择设备角色的页面,其中提供了创建新角色或选择现有角色的选项。

    使用提供的两个选项之一配置设备角色,然后选择 Next(下一步)。

  9. 步骤 4中,请确保每个步骤中提供的配置准确无误。要编辑为特定步骤提供的配置,请选择 Edit(编辑)用于相应的步骤。

    验证配置后,选择 Create test suite(创建测试套件)。

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

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

启动测试套件运行

  1. Amazon IoT 控制台的导航窗格中,展开测试Device Advisor,然后选择测试套件

  2. 选择要查看其测试套件详细信息的测试套件。

    显示名为“Device advisor demo suite”的单个测试套件,创建时间是 2021 年 5 月 11 日。

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

  3. 选择 Actions(操作),然后选择 Run test suite(运行测试套件)。

    演示套件页面,其中有一个“运行测试套件”按钮,以及显示之前没有运行过测试套件的空活动日志。
  4. Run configuration(运行配置)项下,您需要选择 Amazon IoT 事物或证书以使用 Device Advisor 进行测试。如果您没有任何现有事物或证书,请先创建 Amazon IoT Core 资源

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

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

    选择事物或证书以及 Device Advisor 端点后,选择运行测试

    用于在 Amazon IoT Core 上运行测试套件的配置,您可以选择测试设备(事物或证书)、选择测试端点(账户级或设备级),还可以选择添加标签。
  5. 选择顶部广告条的 Go to result(转到结果),以查看测试运行详细信息。

    状态为“待处理”、名为“Device Advisor demo suite”的自定义测试套件的详细信息。

停止测试套件运行(可选)

  1. Amazon IoT控制台的导航窗格中,展开 Test(测试)、Device Advisor,然后选择 Test run and results(测试运行和结果)。

  2. 选择要停止的正在进行的测试套件。

    Device Advisor 控制台上测试运行的结果。
  3. 选择 Actions(操作),然后选择 Stop test suite(停止测试套件)。

    Device Advisor 控制台上测试运行的结果。
  4. 此清理过程可能需要几分钟才能完成。清理程序运行时,测试运行状态将为 STOPPING。等待清理程序完成,并等待测试套件状态更改为 STOPPED 状态,然后再开始运行新套件。

    Device Advisor 控制台上测试运行的停止结果。

查看测试套件运行详细信息和日志

  1. Amazon IoT 控制台的导航窗格中,展开 Test(测试)、Device Advisor,然后选择 Test run and results(测试运行和结果)。

    本页面将显示:

    • IoT 事物的数量

    • IoT 证书的数量

    • 当前运行的测试套件数

    • 所有已创建的测试套件运行

  2. 选择要查看其运行详细信息和日志的测试套件。

    测试运行和结果部分,其中显示了当前正在进行的名为“Device Advisor demo suite”的测试套件的详细信息。

    运行摘要页面显示当前测试套件运行的状态。此页面每 10 秒自动刷新一次。我们建议您为设备建立一个机制,以便每五秒便尝试一次连接到测试端点,每次持续一到两分钟。然后,您能够以自动的方式按顺序运行多个测试使用案例。

    测试案例日志,显示了未出现任何系统消息的成功 MQTT Connect 测试。
  3. 要访问测试套件运行的 CloudWatch 日志,请选择 Test suite log(测试套件日志)。

    要访问任何测试使用案例的 CloudWatch 日志,请选择测试使用案例日志

  4. 根据您的测试结果,对您的设备进行故障排除操作,直到通过所有测试。

下载 Amazon IoT 资格报告

如果您在创建测试使用案例时选择了 使用 Amazon IoT 资格测试套件选项,并能够运行资格测试套件,则可以在测试运行摘要页面选择下载资格报告

资格认证计划测试结果,显示了 MQTT、TLS 及其他组件通过的测试。