Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben - AWS IoT Wireless
Funktionsweise der Massenbereitstellung von SidewalkWichtige Überlegungen zur Massenbereitstellung von SidewalkCSV-DateiformatVerwendung der Massenbereitstellung von Sidewalk

Bereitstellung von Sidewalk-Geräten mithilfe von Importaufgaben

In diesem Abschnitt wird gezeigt, wie Sie Sidewalk-Geräte massenweise mithilfe der AWS IoT-Konsole, der AWS IoT Core für Amazon Sidewalk-API-Operationen oder der AWS CLI bereitstellen können. In den folgenden Abschnitten wird erläutert, wie Sie Ihre Sidewalk-Geräte in massenweise bereitstellen können.

Themen

Funktionsweise der Massenbereitstellung von Sidewalk

Die folgenden Schritte veranschaulichen die Massenbereitstellung.

  1. Starten einer Importaufgabe für WLAN-Geräte

    Erstellen Sie eine Importaufgabe und geben Sie die Sidewalk-Herstellungsseriennummer (SMSN) der Geräte an, die in AWS IoT Core für Amazon Sidewalk eingegliedert werden sollen, um Sidewalk-Geräte massenweise bereitzustellen. Sie haben die Sidewalk-Herstellungsseriennummer (SMSN) der Geräte als CSV-Datei in Ihrer E-Mail erhalten, nachdem der Hersteller die Kontrollprotokolle auf Amazon Sidewalk hochgeladen hat. Weitere Informationen über diesen Workflow und den Erhalt des Kontrollprotokolls finden Sie unter Herstellen von Amazon-Sidewalk-Geräten in der Dokumentation für Amazon Sidewalk.

  2. Ausführen des Importvorgangs im Hintergrund

    Wenn AWS IoT Core für Amazon Sidewalk die Importaufgabenanforderung empfängt, beginnt es mit der Einrichtung und startet einen Hintergrundprozess, der das System häufig abfragt. Sobald der Hintergrundprozess die Anweisung für die Importaufgabe erhält, beginnt er mit dem Lesen der CSV-Datei. AWS IoT Core für Amazon Sidewalk prüft gleichzeitig, ob die Kontrollprotokolle von Amazon Sidewalk empfangen wurden.

  3. Erstellen von Aufzeichnungen über WLAN-Geräte

    Wenn das Kontrollprotokoll von Amazon Sidewalk empfangen wird, überprüft AWS IoT Core für Amazon Sidewalk, ob die Seriennummern im Kontrollprotokoll mit den SMSN-Werten in der CSV-Datei übereinstimmen. Wenn die Seriennummern übereinstimmen, beginnt AWS IoT Core für Amazon Sidewalk mit der Erstellung von Datensätzen für drahtlose Geräte, die diesen Seriennummern entsprechen. Sobald alle Geräte eingegliedert wurden, wird die Importaufgabe als Abgeschlossen markiert.

Wichtige Überlegungen zur Massenbereitstellung von Sidewalk

Bei der Massenbereitstellung Ihrer Sidewalk-Geräte auf AWS IoT Core für Amazon Sidewalk sollten die folgenden wichtigen Überlegungen angestellt werden.

  • Sie müssen die Massenbereitstellung mit der AWS IoT-Konsole oder dem AWS IoT Core für Amazon Sidewalk-API-Operationen in demselben AWS-Konto durchführen, in dem Sie das Geräteprofil erstellt haben.

  • Bevor Sie Ihre Sidewalk-Geräte massenweise bereitstellen, muss Ihr Geräteprofil bereits DAK-Informationen enthalten, da dies auf den Werkssupport hinweist. Andernfalls können die Massenbereitstellung über die AWS IoT-Konsole oder die API-Operationen für die Massenbereitstellung fehlschlagen.

  • Nachdem Sie eine Importaufgabe gestartet haben, kann es mindestens 10 Minuten oder länger dauern, die CSV-Datei zu verarbeiten, die WLAN-Geräte zu importieren und sie in AWS IoT Core für Amazon Sidewalk einzugliedern.

  • Die Aufgabe zum Importieren von WLAN-Geräten läuft 90 Tage nach ihrem Start ab. Während dieser Zeit wird geprüft, ob die Kontrollprotokolle von Amazon Sidewalk empfangen wurden. Wenn das Kontrollprotokoll nicht vor Ablauf dieser 90 Tage bei Amazon Sidewalk eingeht, wird die Aufgabe als Abgeschlossen markiert. Außerdem wird eine Meldung angezeigt, dass sie abgelaufen ist, wenn Sie sich die Aufgabendetails ansehen. Der Onboarding-Status der Geräte in der Importaufgabe, die auf das Kontrollprotokoll gewartet haben, wird als Fehlgeschlagen markiert.

  • Wenn Sie versuchen, eine bereits erstellte Importaufgabe zu aktualisieren, können Sie der Aufgabe nur weitere Geräte hinzufügen. Sie können jederzeit neue Geräte hinzufügen, nachdem Sie die Importaufgabe erstellt haben oder bevor die Aufgabe auf Geräten gestartet wurde, die der Importaufgabe bereits hinzugefügt wurden. Wenn die Aktualisierungsdatei Seriennummern von Geräten enthält, die bereits in der ursprünglichen Importaufgabe enthalten waren, werden diese Seriennummern ignoriert.

  • Wenn Sie eine Aktualisierung anfordern, wird davon ausgegangen, dass dieselbe IAM-Rolle, die Sie bei der Erstellung der Importaufgabe verwendet haben, für den Zugriff auf die CSV-Datei im Amazon-S3-Bucket verwendet wurde.

  • Eine Importaufgabe kann nur gelöscht werden, wenn die Aufgabe bereits abgeschlossen wurde oder wenn die Aufgabe nicht aktualisiert werden konnte. Eine Aufgabe kann möglicherweise nicht aktualisiert werden, wenn eine falsche IAM-Rolle angegeben oder eine Amazon-S3-Bucket-Datei nicht gefunden wurde. Eine Importaufgabe kann nicht aktualisiert oder gelöscht werden, wenn sie sich im PENDING-Status befindet.

  • Die CSV-Datei, die Sie in die Aufgabe importieren, muss das im folgenden Abschnitt beschriebene Format haben.

CSV-Dateiformat

Die CSV-Datei, die in einem Amazon-S3-Bucket enthalten ist, den Sie für die Importaufgabe angeben, muss das folgende Format haben:

  • Zeile 1 muss das Schlüsselwort smsn beinhalten, das angibt, dass die importierte CSV-Datei die SMSN der zu importierenden Geräte enthält.

  • Zeile 2 und darauffolgende Zeilen müssen die SMSN der Geräte enthalten, die eingegliedert werden sollen. Die Geräte-SMSN muss das 64-Hex-Zeichenformat haben.

Diese JSON-Datei zeigt ein Beispiel für ein CSV-Dateiformat.

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Verwendung der Massenbereitstellung von Sidewalk

Nachfolgend wird beschrieben, wie Sie die Massenbereitstellung von Amazon Sidewalk verwenden.

  1. Angeben der Geräteseriennummern

    Geben Sie die Seriennummern der einzugliedernden Geräte an, um Ihre Sidewalk-Geräte bereitzustellen. Sie können Ihre Geräte mit einer der folgenden Methoden bereitstellen.

    • Stellen Sie jedes Gerät einzeln mit der zugehörigen Sidewalk-Herstellungsseriennummer (SMSN) bereit. Diese Methode ist nützlich, wenn Sie den Workflow testen und Ihr Gerät schneller eingliedern möchten, ohne eine CSV-Datei mit der entsprechenden IAM-Rolle hochladen oder warten zu müssen, bis die Geräte bereit sind, um in die Aufgabe eingegliedert zu werden.

    • Stellen Sie Geräte massenweise bereit, indem Sie due URL eines Amazon-S3-Buckets angeben, die die SMSN der bereitzustellenden Geräte in einer CSV-Datei enthält. Diese Methode ist vor allem dann nützlich, wenn Sie eine große Anzahl von Geräten eingliedern möchten. In diesem Fall kann es mühsam sein, jedes Gerät einzeln einzugliedern. Stattdessen müssen Sie nur den Pfad zu der CSV-Datei, die in einen Amazon-S3-Bucket hochgeladen wurde, und die IAM-Rolle für den Zugriff auf die Datei angeben.

  2. Abrufen der Importaufgabe und des Onboarding-Status des Geräts

    Für jede Importaufgabe, die Sie erstellen, können Sie Informationen über den Onboarding-Status der Aufgabe und der zur Aufgabe hinzugefügten Geräte abrufen. Sie können auch zusätzliche Statusinformationen anzeigen, z. B. den Grund, warum das Onboarding einer Aufgabe oder eines Geräts fehlgeschlagen ist. Weitere Informationen finden Sie unter

  3. (Optional) Aktualisieren oder Löschen einer Importaufgabe

    Sie können eine bereits erstellte Importaufgabe aktualisieren oder löschen.

    • Sie können eine Importaufgabe jederzeit aktualisieren und der Aufgabe weitere Geräte hinzufügen, bevor die Aufgabe auf bereits hinzugefügten Geräten gestartet wurde. AWS IoT Core für Amazon Sidewalk geht von derselben IAM-Rolle aus wie jene, die Sie bei der Erstellung der Importaufgabe verwendet haben. Wenn Sie die Aufgabe erstellen, geben Sie die neue CSV-Datei an, die die Seriennummern der Geräte enthält, die Sie der Aufgabe hinzufügen möchten.

      Anmerkung

      Wenn Sie eine bestehende Importaufgabe aktualisieren, können Sie der Aufgabe nur Geräte hinzufügen. AWS IoT Core für Amazon Sidewalk führt die Geräte, die sich bereits in der Importaufgabe befinden, und die Geräte, die Sie der Aufgabe hinzufügen möchten, zusammen. Wenn die neue Datei Seriennummern von Geräten enthält, die bereits in der ursprünglichen Importaufgabe enthalten waren, werden diese Seriennummern ignoriert.

    • Sie können Importaufgaben löschen, die bereits abgeschlossen wurden oder deren Aktualisierung fehlgeschlagen ist, z. B., wenn die IAM-Rolleninformationen falsch sind oder wenn beim Erstellen oder Aktualisieren einer Aufgabe keine S3-Bucket-Datei verfügbar ist.

Themen