Hinzufügen Ihres Geräteprofil und Ihres Sidewalk-Endgeräts - AWS IoT Wireless
Hinzufügen Ihres Sidewalk-Geräts (Konsole)Hinzufügen Ihres Sidewalk-Geräts (CLI)

Hinzufügen Ihres Geräteprofil und Ihres Sidewalk-Endgeräts

In diesem Abschnitt wird beschrieben, wie Sie ein Geräteprofil erstellen. Außerdem wird gezeigt, wie Sie die AWS IoT-Konsole und die AWS CLI verwenden, um Ihr Sidewalk-Endgerät zu AWS IoT Core für Amazon Sidewalk hinzuzufügen.

Hinzufügen Ihres Sidewalk-Geräts (Konsole)

Wechseln Sie im Geräte-Hub zur Registerkarte Sidewalk, wählen Sie Bereitstellung des Geräts und führen Sie dann die folgenden Schritte aus, um Ihr Sidewalk-Gerät mithilfe der AWS IoT-Konsole hinzuzufügen.

  1. Angeben der Gerätedetails

    Geben Sie die Konfigurationsinformationen für Ihr Sidewalk-Gerät an. Sie können auch ein neues Geräteprofil erstellen oder ein vorhandenes Profil für Ihr Sidewalk-Gerät auswählen.

    1. Geben Sie einen Gerätenamen und optional eine Beschreibung ein. Die Beschreibung kann bis zu 2048 Zeichen lang sein. Diese Felder können nach der Erstellung des Geräts noch bearbeitet werden.

    2. Wählen Sie ein Geräteprofil aus, das Sie Ihrem Sidewalk-Gerät zuordnen möchten. Wenn Sie bereits Geräteprofile haben, können Sie Ihr Profil auswählen. Wenn Sie ein neues Projekt erstellen, wählen Sie Neues Profil erstellen und geben Sie einen Namen für das Profil ein.

      Anmerkung

      Gehen Sie nach der Erstellung Ihres Profils zum Profile-Hub, um Ihrem Geräteprofil Tags anzuhängen, und bearbeiten Sie dann Ihr Profil, um diese Informationen hinzuzufügen.

    3. Geben Sie den Namen Ihres Ziels an, das Nachrichten von Ihrem Gerät an andere AWS-Services weiterleiten soll. Wenn Sie noch kein Ziel erstellt haben, gehen Sie zum Ziele-Hub, um Ihr Ziel zu erstellen. Anschließend können Sie dieses Ziel für Ihr Sidewalk-Gerät auswählen. Weitere Informationen finden Sie unter Hinzufügen eines Ziels zu Ihrem Sidewalk-Endgerät.

    4. Wählen Sie Weiter, um mit dem Hinzufügen Ihres Sidewalk-Geräts fortzufahren.

  2. Zuordnen des Sidewalk-Geräts zum AWS IoT-Objekt (optional)

    Sie können Ihr Sidewalk-Gerät einem AWS IoT-Objekt zuordnen. IoT-Objekte sind Einträge in der AWS IoT-Geräteregistrierung. Objekte erleichtern die Suche und Verwaltung Ihrer Geräte. Wenn Sie Ihrem Gerät ein Objekt zuordnen, kann Ihr Gerät auf andere AWS IoT Core-Features zugreifen.

    Wählen Sie Automatische Objektregistrierung, um Ihr Gerät einem Objekt zuzuordnen.

    1. Geben Sie einen eindeutigen Namen für das IoT-Objekt ein, das Sie Ihrem Sidewalk-Gerät zuordnen möchten. Bei Objektnamen wird zwischen Groß- und Kleinschreibung unterschieden. Außerdem müssen sie in Ihrem AWS-Konto und Ihrer AWS-Region eindeutig sein.

    2. Stellen Sie zusätzliche Konfigurationen für Ihr IoT-Objekt bereit, z. B. die Verwendung eines Objekttyps oder durchsuchbare Attribute, die zum Filtern aus einer Objektliste verwendet werden können.

    3. Wählen Sie Weiter und überprüfen Sie die Informationen zu Ihrem Sidewalk-Gerät. Wählen Sie dann Erstellen

Hinzufügen Ihres Sidewalk-Geräts (CLI)

Führen Sie die folgenden API-Operationen aus, um Ihr Sidewalk-Gerät hinzuzufügen und die JSON-Dateien herunterzuladen, die für die Bereitstellung Ihres Sidewalk-Geräts verwendet werden.

Schritt 1: Erstellen eines Geräteprofils

Verwenden Sie die CreateDeviceProfile-API-Operation oder den create-device-profile-CLI-Befehl, um ein Geräteprofil in Ihrem AWS-Konto zu erstellen. Wenn Sie Ihr Geräteprofil erstellen, geben Sie einen Namen und optionale Tags als Name-Wert-Paare an.

Mit dem folgenden Befehl wird beispielsweise ein Geräteprofil für Ihre Sidewalk-Gerät erstellt:

aws iotwireless create-device-profile \ 
    --name sidewalk_profile --sidewalk {}

Wenn Sie diesen Befehl ausführen, werden der Amazon-Ressourcenname (ARN)) und die Geräteprofil-ID ausgegeben.

{
    "DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Schritt 2: Hinzufügen Ihres Sidewalk-Geräts

Verwenden Sie die CreateWirelessDevice-API-Operation oder den create-wireless-device-CLI-Befehl, um Ihr Sidewalk-Gerät zu Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzuzufügen. Geben Sie bei der Erstellung Ihres Geräts zusätzlich zu einem optionalen Namen und einer Beschreibung für Ihr Sidewalk-Gerät die folgenden Parameter an.

Anmerkung

Verwenden Sie die AssociateWirelessDeviceWithThing-API-Operation oder den associate-wireless-device-with-thing-CLI-Befehl, um Ihr Sidewalk-Gerät einem AWS IoT-Objekt zuzuordnen.

Der folgende Befehl zeigt ein Beispiel für die Erstellung eines Sidewalk-Geräts:

aws iotwireless create-wireless-device \ 
     --cli-input-json "file://device.json"

Im Folgenden werden die Inhalte der device.json-Datei angezeigt.

Inhalt von device.json

{
  "Type": "Sidewalk",
  "Name": "SidewalkDevice",  
  "DestinationName": "SidewalkDestination",
  "Sidewalk": {
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"    
    }
}

Wenn Sie diesen Befehl ausführen, wird der Amazon-Ressourcenname (ARN)) ausgegeben.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678"
}