Ausführlicher Konsolen-Workflow von Device Advisor - AWS IoT Core

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Ausführlicher Konsolen-Workflow von Device Advisor

In diesem Tutorial erstellen Sie eine benutzerdefinierte Testsuite und führen Tests für das Gerät aus, das Sie in der Konsole testen möchten. Nach Abschluss der Tests können Sie die Testergebnisse und detaillierte Protokolle anzeigen.

Voraussetzungen

Sie müssen zuerst ein Ding und ein Zertifikat erstellen, bevor Sie dieses Tutorial abschließen können.

Erstellen einer Testsuite-Definition

  1. Erweitern Sie im Navigationsbereich in der AWS IoT -Konsole die Optionen Test, Device Advisor und wählen Sie dann Testsuites aus.

    Die Device Advisor-Oberfläche mit Optionen zur Erstellung von Testsuiten für qualifizierte Geräte, zur Durchführung von Langzeittests und benutzerdefinierten Testsuiten.

    Wählen Sie Testsuite erstellen aus.

  2. Wählen Sie entweder Use the AWS Qualification test suite oder Create a new test suite aus.

    Wählen Sie als Protokoll entweder MQTT 3.1.1 oder MQTT 5 aus.

    „Testsuite erstellen“ mit Optionen zur Auswahl des Testsuitetyps (AWS IoT Core Qualifikation, Langdauer oder Benutzerdefiniert) und des Protokolls (MQTT 3.1.1 oder MQTT 5).

    Wählen Sie ausUse the AWS Qualification test suite, ob Sie Ihr Gerät qualifizieren und es im Gerätekatalog für AWS Partner auflisten möchten. Wenn Sie diese Option wählen, werden die Testfälle, die für die Qualifizierung Ihres Geräts für das AWS IoT Core -Qualifizierungsprogramm erforderlich sind, vorab ausgewählt. Testgruppen und Testfälle können nicht hinzugefügt oder entfernt werden. Sie müssen trotzdem die Eigenschaften der Testsuite konfigurieren.

    Wählen Sie Create a new test suite aus, um eine benutzerdefinierte Testsuite zu erstellen und zu konfigurieren. Wir empfehlen, für erste Tests und zur Fehlerbehebung mit dieser Option zu beginnen. Eine benutzerdefinierte Testsuite muss mindestens eine Testgruppe haben und jede Testgruppe muss mindestens einen Testfall haben. Für die Zwecke dieses Tutorials wählen wir diese Option und wählen Weiter aus.

    Seite „Testsuite konfigurieren“, auf der Schritte zum Erstellen einer Testsuite mit Testgruppen und Fällen zum Testen von IoT-Geräten aufgeführt werden.
  3. Wählen Sie Eigenschaften der Testsuite aus. Sie müssen die Eigenschaften der Testsuite erstellen, wenn Sie Ihre Testsuite erstellen.

    Die Oberfläche „Testsuite konfigurieren“, die Optionen zum Erstellen von Testgruppen und zum Hinzufügen von Testfällen zum Testen der Funktionalität von IoT-Geräten zeigt.

    Füllen Sie unter Eigenschaften der Testsuite die folgenden Felder aus:

    • Name der Testsuite: Sie können die Suite mit einem benutzerdefinierten Namen erstellen.

    • Timeout (optional): Das Timeout in Sekunden für jeden Testfall in der aktuellen Testsuite. Wenn Sie keinen Timeout-Wert angeben, wird der Standardwert verwendet.

    • Tags (optional): Fügen Sie der Testsuite Tags hinzu.

    Das Fenster mit dem Titel „Eigenschaften der Testsuite“ zeigt Felder zur Angabe eines Testsuite-Namens, eines Timeouts und benutzerdefinierter Tags für eine Device Advisor-Demosuite.

    Wenn Sie fertig sind, wählen Sie Eigenschaften aktualisieren aus.

  4. Um die Konfiguration auf Gruppenebene zu ändern, wählen Sie unter Test group 1 Bearbeiten aus. Geben Sie dann einen Namen ein, um der Gruppe einen benutzerdefinierten Namen zu geben.

    Optional können Sie unter der ausgewählten Testgruppe auch einen Timeout-Wert in Sekunden eingeben. Wenn Sie keinen Timeout-Wert angeben, wird der Standardwert verwendet.

    Die Schnittstelle „Testsuite konfigurieren“ zur Erstellung von Testgruppen und Fällen zur Validierung der Funktionalität von IoT-Geräten.

    Wählen Sie Erledigt aus.

  5. Ziehen Sie einen der verfügbaren Testfälle aus Testfälle in die Testgruppe.

    Die Konfigurationsoberfläche für die Erstellung einer Testsuite in Device Advisor mit Optionen zum Hinzufügen von Testgruppen und Testfällen zum Testen von IoT-Geräten.
  6. Um die Konfiguration auf Testfallebene für den Testfall zu ändern, den Sie Ihrer Testgruppe hinzugefügt haben, wählen Sie Bearbeiten aus. Geben Sie dann einen Namen ein, um der Gruppe einen benutzerdefinierten Namen zu geben.

    Optional können Sie unter der ausgewählten Testgruppe auch einen Timeout-Wert in Sekunden eingeben. Wenn Sie keinen Timeout-Wert angeben, wird der Standardwert verwendet.

    Konfigurationsoberfläche für die Testsuite mit Optionen zur Konfiguration von Testgruppen, Testfällen, Timeout-Einstellungen und Startpunkten für die Ausführung der Testsuite.

    Wählen Sie Erledigt aus.

    Anmerkung

    Um der Testsuite weitere Testgruppen hinzuzufügen, wählen Sie Testgruppe hinzufügen aus. Folgen Sie den vorherigen Schritten, um weitere Testgruppen zu erstellen und zu konfigurieren oder um einer oder mehreren Testgruppen weitere Testfälle hinzuzufügen. Testgruppen und Testfälle können neu angeordnet werden, indem Sie einen Testfall auswählen und an die gewünschte Position ziehen. Device Advisor führt Tests in der Reihenfolge aus, in der Sie die Testgruppen und Testfälle definieren.

  7. Wählen Sie Weiter aus.

  8. Konfigurieren Sie in Schritt 3 eine Geräterolle, die Device Advisor verwendet, um AWS IoT MQTT-Aktionen im Namen Ihres Testgeräts auszuführen.

    Wenn Sie in Schritt 2 nur den MQTT-Connect-Testfall ausgewählt haben, wird die Connect-Aktion automatisch überprüft, da diese Berechtigung für die Geräterolle erforderlich ist, um diese Testsuite auszuführen. Wenn Sie andere Testfälle ausgewählt haben, werden die entsprechenden erforderlichen Aktionen überprüft. Stellen Sie sicher, dass die Ressourcenwerte für jede der Aktionen angegeben werden. Geben Sie beispielsweise für die Connect-Aktion die Client-ID an, mit der sich Ihr Gerät mit dem Device-Advisor-Endpunkt verbindet. Sie können mehrere Werte angeben, indem Sie die Werte durch Kommas trennen, und Sie können Präfixwerte auch mit einem Platzhalterzeichen (*) angeben. Um beispielsweise die Erlaubnis zur Veröffentlichung zu einem beliebigen Thema zu erteilen, das mit MyTopic beginnt, können Sie „MyTopic*“ als Ressourcenwert eingeben.

    Der Schritt „Wählen Sie eine Geräterolle“ in Device Advisor zum Erstellen einer Testsuite mit Optionen zum Erstellen einer neuen Rolle oder zum Auswählen einer vorhandenen Rolle sowie Feldern zur Angabe von Rollennamen, Berechtigungen und Ressourcendetails.

    Wenn Sie bereits zuvor eine Geräterolle erstellt haben und diese Rolle verwenden möchten, wählen Sie Eine vorhandene Rolle auswählen und anschließend unter Rolle auswählen Ihre Geräterolle aus.

    Die Seite zur Auswahl einer Geräterolle für Device Advisor-Tests mit Optionen zum Erstellen einer neuen Rolle oder zum Auswählen einer vorhandenen Rolle.

    Konfigurieren Sie Ihre Geräterolle mit einer der beiden verfügbaren Optionen und wählen Sie dann Weiter aus.

  9. Stellen Sie in Schritt 4 sicher, dass die in jedem der Schritte angegebene Konfiguration korrekt ist. Um die für einen bestimmten Schritt bereitgestellte Konfiguration zu bearbeiten, wählen Sie Bearbeiten für den entsprechenden Schritt aus.

    Nachdem Sie die Konfiguration überprüft haben, wählen Sie Testsuite erstellen aus.

    Die Testsuite sollte erfolgreich erstellt worden sein und Sie werden zur Seite Testsuites weitergeleitet, auf der Sie alle erstellten Testsuites anzeigen können.

    Wenn die Erstellung der Testsuite fehlgeschlagen ist, stellen Sie sicher, dass die Testsuite, die Testgruppen, die Testfälle und die Geräterolle gemäß den vorherigen Anweisungen konfiguriert wurden.

Ausführen einer Testsuite

  1. Erweitern Sie im Navigationsbereich in der AWS IoT -Konsole die Optionen Test, Device Advisor und wählen Sie dann Testsuites aus.

  2. Wählen Sie die Testsuite aus, für die Sie die Details der Testsuite anzeigen möchten.

    Die Konsole, auf der eine einzelne Testsuite mit dem Namen „Device Advisor Demo Suite“ angezeigt wird, die am 11. Mai 2021 erstellt wurde.

    Auf der Detailseite der Testsuite werden alle Informationen zur Testsuite angezeigt.

  3. Wählen Sie Aktionen und dann Testsuite ausführen aus.

    Die Demo-Suite-Seite mit der Schaltfläche „Testsuite ausführen“ und einem leeren Aktivitätsprotokoll, aus dem hervorgeht, dass keine vorherigen Testsuite-Ausführungen ausgeführt wurden.
  4. Unter Konfiguration ausführen müssen Sie eine AWS IoT Sache oder ein Zertifikat auswählen, das Sie mit Device Advisor testen möchten. Wenn Sie noch keine vorhandenen Dinge oder Zertifikate haben, erstellen Sie zunächst AWS IoT Core Ressourcen.

    Wählen Sie im Abschnitt Testendpunkt den Endpunkt aus, der am besten zu Ihrem Fall passt. Wenn Sie in future mehrere Testsuiten gleichzeitig mit demselben AWS Konto ausführen möchten, wählen Sie Endpunkt auf Geräteebene aus. Wenn Sie allerdings planen, jeweils nur eine Testsuite auszuführen, wählen Sie Endpunkt auf Kontoebene aus, um jeweils eine Testsuite auszuführen.

    Konfigurieren Sie Ihr Testgerät mit dem Testendpunkt des ausgewählten Device Advisors.

    Nachdem Sie ein Ding oder ein Zertifikat und einen Device-Advisor-Endpunkt ausgewählt haben, wählen Sie Test ausführen aus.

    Die Konfiguration für die Ausführung einer Testsuite AWS IoT Core, mit der Sie Testgeräte (Dinge oder Zertifikate) auswählen, einen Testendpunkt (auf Konto- oder Geräteebene) auswählen und optional Tags hinzufügen können.
  5. Wählen Sie im oberen Banner die Option Gehe zu den Ergebnissen, um die Details des Testlaufs anzuzeigen.

    Einzelheiten zu einer benutzerdefinierten Testsuite mit dem Titel „Device Advisor Demo Suite“, die derzeit den Status „Ausstehend“ hat.

Beenden einer Testsuite-Ausführung (optional)

  1. Erweitern Sie im Navigationsbereich in der AWS IoT -Konsole die Optionen Test, Device Advisor und wählen Sie dann Testläufe und Ergebnisse aus.

  2. Wählen Sie die laufende Testsuite, die Sie beenden möchten.

    Die Ergebnisse der Tests werden auf der Device Advisor-Konsole ausgeführt.
  3. Wählen Sie Aktionen und dann Testsuite beenden aus.

    Die Ergebnisse von Testläufen auf der Device Advisor-Konsole.
  4. Der Bereinigungsvorgang nimmt einige Minuten in Anspruch. Während der Bereinigungsvorgang läuft, ist der Status des Testlaufs STOPPING. Warten Sie, bis der Bereinigungsprozess abgeschlossen ist und sich der Status der Testsuite in den STOPPED-Status ändert, bevor Sie eine neue Suite ausführen.

    Die Ergebnisse der gestoppten Testläufe auf der Device Advisor-Konsole.

Anzeigen von Details und Protokolle der Testsuite-Ausführung

  1. Erweitern Sie im Navigationsbereich in der AWS IoT -Konsole die Optionen Test, Device Advisor und wählen Sie dann Testläufe und Ergebnisse aus.

    Diese Seite zeigt Folgendes an:

    • Anzahl der IoT-Dinge

    • Anzahl der IoT-Zertifikate

    • Anzahl der derzeit ausgeführten Testsuites

    • Alle Testsuite-Ausführungen, die erstellt wurden

  2. Wählen Sie die Testsuite aus, für die Sie die Details der Ausführung und die Protokolle anzeigen möchten.

    Ein Abschnitt mit Testläufen und Ergebnissen, in dem Details zu einer Testsuite mit dem Namen „Device Advisor-Demosuite“ angezeigt werden, die derzeit in Bearbeitung ist.

    Auf der Seite mit der Zusammenfassung der Testsuite wird der Status der aktuellen Testsuite-Ausführung angezeigt. Diese Seite wird automatisch alle 10 Sekunden aktualisiert. Wir empfehlen, dass Sie für Ihr Gerät einen Mechanismus entwickeln, mit dem Sie alle fünf Sekunden ein bis zwei Minuten lang versuchen können, eine Verbindung zu unserem Testendpunkt herzustellen. Sie können dann mehrere Testfälle nacheinander automatisiert ausführen.

    Das Testfallprotokoll, das einen erfolgreichen MQTT Connect-Test ohne angezeigte Systemmeldung anzeigt.
  3. Um auf die CloudWatch Protokolle für den Testsuite-Lauf zuzugreifen, wählen Sie Test Suite Log.

    Um auf die CloudWatch Protokolle für einen beliebigen Testfall zuzugreifen, wählen Sie Testfallprotokoll.

  4. Führen Sie auf der Grundlage Ihrer Testergebnisse eine Fehlerbehebung auf Ihrem Gerät durch, bis alle Tests bestanden sind.

Herunterladen eines AWS IoT -Qualifikationsberichts

Wenn Sie bei der Erstellung einer Testsuite die Option AWS IoT Qualifizierungstestsuite verwenden ausgewählt haben und eine Qualifizierungstestsuite ausführen konnten, können Sie einen Qualifizierungsbericht herunterladen, indem Sie auf der Übersichtsseite des Testlaufs die Option Qualifikationsbericht herunterladen wählen.

Testergebnisse des Qualifizierungsprogramms, die die bestandenen Tests für MQTT, TLS und andere Komponenten belegen.