Abrufen der Geräte-JSON-Dateien für die Bereitstellung - AWS IoT Wireless
Abrufen der JSON-Datei (Konsole)Abrufen der JSON-Datei (CLI)Nächste Schritte

Abrufen der Geräte-JSON-Dateien für die Bereitstellung

Nachdem Sie Ihr Sidewalk-Gerät zu AWS IoT Core für Amazon Sidewalk hinzugefügt haben, laden Sie die JSON-Datei mit den für die Bereitstellung Ihres Endgeräts erforderlichen Informationen herunter. Sie können diese Informationen über die AWS IoT-Konsole oder die AWS CLI abrufen. Weitere Informationen zur Bereitstellung des Geräts finden Sie unter Bereitstellung und Registrierung Ihres Endgeräts in der Dokumentation zu Amazon Sidewalk.

Abrufen der JSON-Datei (Konsole)

Abrufen der JSON-Datei für die Bereitstellung Ihres Sidewalk-Geräts:

  1. Gehen Sie zum Sidewalk-Geräte-Hub.

  2. Wählen Sie das Gerät aus, das Sie AWS IoT Core für Amazon Sidewalk hinzugefügt haben, um dessen Details anzuzeigen.

  3. Rufen Sie die JSON-Datei ab, indem Sie auf der Detailseite des hinzugefügten Geräts die Option JSON-Datei des Geräts herunterladen auswählen.

    Daraufhin wird eine certificate.json-Datei mit den erforderlichen Informationen für die Bereitstellung Ihres Endgeräts heruntergeladen. Nachfolgend ist ein Beispiel für eine JSON-Datei dargestellt. Sie enthält die Gerätezertifikate, private Schlüssel, die Sidewalk-Herstellungsseriennummer (SMSN) und die DeviceTypeID.

    {
  "p256R1": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbH ... DANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw==",
  "eD25519": "grg8izXoVvQ86cPVm0GMyWuZYHEBbbHD ... UiZmntHiUr1GfkTOFMYqRB+Aw==",
  "metadata": {    
    "devicetypeid": "fe98",
    "applicationDeviceArn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/897ce68e-3ca2-4ed0-85a2-30b0666c4052",
    "applicationDeviceId": "897ce68e-3ca2-4ed0-85a2-30b0666c4052",
    "smsn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A",
    "devicePrivKeyP256R1": "3e704bf8d319b3a475179f1d68c60737b28c708f845d0198f2d00d00c88ee018",
    "devicePrivKeyEd25519": "17dacb3a46ad9a42d5c520ca5f47f0167f59ce54d740aa13918465faf533b8d0"
  },
  "applicationServerPublicKey": "5ce29b89c2e3ce6183b41e75fe54e45f61b8bb320efbdd2abd7aefa5957a316b"
}

Auf der Detailseite Ihres Sidewalk-Geräts finden Sie auch folgende Informationen:

  • Die Geräte-ID, der Amazon-Ressourcenname (ARN) und Details zu allen AWS IoT-Objekten, mit denen das Gerät verknüpft ist.

  • Das Geräteprofil und die Zieldetails.

  • Der Zeitpunkt, zu dem die letzte Uplink-Nachricht vom Gerät empfangen wurde.

  • Der Status, der angibt, ob Ihr Gerät bereitgestellt oder registriert wurde.

Abrufen der JSON-Datei (CLI)

Speichern Sie die API-Antwort auf das Abrufen von Informationen über Ihr Geräteprofil und Ihr WLAN-Gerät als JSON-Dateien, z. B. vorübergehend als wireless_device.json und device_profile.json, um die JSON-Dateien für die Bereitstellung Ihres Sidewalk-Endgeräts mithilfe der AWS IoT Core für Amazon Sidewalk-API oder der AWS CLI abzurufen. Sie werden sie für die Bereitstellung Ihres Sidewalk-Geräts benötigen.

Im Folgenden wird gezeigt, wie die JSON-Dateien abgerufen werden.

Schritt 1: Abrufen der Geräteprofilinformationen als JSON-Datei

Verwenden Sie die GetDeviceProfile-API-Operation oder den get-device-profile-CLI-Befehl, um Informationen zu Ihrem Geräteprofil abzurufen, das Sie Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzugefügt haben. Geben Sie die Profil-ID an, um Informationen zu Ihrem Geräteprofil abzurufen.

Die API gibt anschließend Informationen über das Geräteprofil zurück, das der angegebenen Kennung und der Geräte-ID entspricht. Sie speichern diese Antwortinformationen als Datei und geben ihr einen Namen wie device_profile.json.

Im Folgenden wird ein Beispiel für einen CLI-Befehl gezeigt:

aws iotwireless get-device-profile \ 
    --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json

Wenn Sie diesen Befehl ausführen, werden die Parameter Ihres Geräteprofils, der öffentliche Schlüssel des Anwendungsservers und die DeviceTypeIDausgegeben. Im Folgenden wird eine JSON-Datei mit beispielhaften Antwortinformationen aus der API gezeigt. Weitere Informationen über die Parameter in der API-Antwort finden Sie unter GetDeviceProfile.

GetDeviceProfile-API-Antwort (Inhalt von device_profile.json)

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "Name": "Sidewalk_profile",
    "LoRaWAN": null,
    "Sidewalk":
    {        
        "ApplicationServerPublicKey": "a123b45c6d78e9f012a34cd5e6a7890b12c3d45e6f78a1b234c56d7e890a1234",
        "DAKCertificateMetadata": [
            {                
                "DeviceTypeId: "fe98",
                "CertificateId": "43564A6D2D50524F544F54595045",
                "FactorySupport": false,
                "MaxAllowedSignature": 1000                
            }
        ],
        "QualificationStatus": false
    }
}

Schritt 2: Abrufen der Sidewalk-Geräteinformationen als JSON-Datei

Verwenden Sie die GetWirelessDevice-API-Operation oder den get-wireless-device-CLI-Befehl, um Informationen zu Ihrem Sidewalk-Gerät abzurufen, das Sie Ihrem Konto für AWS IoT Core für Amazon Sidewalk hinzugefügt haben. Geben Sie die Kennung des WLAN-Geräts an, die Sie beim Hinzufügen Ihres Geräts erhalten haben, um Informationen über Ihr Endgerät abzurufen.

Die API gibt anschließend Informationen über das Gerät aus, das der angegebenen Kennung und der Geräte-ID entspricht. Speichern Sie diese Antwortinformationen als JSON-Datei. Geben Sie der Datei einen aussagekräftigen Namen wie wireless_device.json.

Das folgende Beispiel zeigt die Ausführung des Befehls mit der CLI:

aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \ 
    --identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json

Wenn Sie diesen Befehl ausführen, werden die Gerätedetails, Gerätezertifikate, private Schlüssel und die Sidewalk-Herstellungsseriennummer (SMSN) ausgegeben. Das folgende Beispiel veranschaulicht das Ergebnis der Ausführung dieses Befehls. Weitere Informationen über die Parameter in der API-Antwort finden Sie unter GetWirelessDevice.

GetWirelessDevice-API-Antwort (Inhalt von wireless_device.json)

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678",
    "DestinationName": "SidewalkDestination",   
    "Type": "Sidewalk",
    "Sidewalk": {        
        "CertificateId": "4C7438772D50524F544F54595045",
        "DeviceCertificates": [
            {
                "SigningAlg": "Ed25519",
                "Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNl7NKe4ounb5UMQtLjnm7zOUPYOqghCeVOLCBUiQe2ZiMBEW18JDUXIhffPobqZgohK91+LKFJ10X/F+GeltcafZcFKhS+O5NPcVNR/fHYaf/cn5iUbRwlz/T+ODXvGdwkBkgDyFgoUJgn7JdzFjaneE5qzTWXUbL79i1sXToGGjP8hiD9jJhidPWhIswleydAWgO1OZGA4CjzIaSGVM1VtaLB0VDphAkEpjMkZrtVDH3S8U1vDZTVi6YSbnkYZgfWv/uMMBfgAeL8Tdv5LkFIPIB3ZX9zt8zzmAuFRzI4MuNjWfIDnOF6AKu37WWU6/QYhZoQrW9D/wndiCcsRGl+ANn367r/HE02Re4DOiCfs9f2rjc4LT1LKt7g/KW2ii+W+9HYvvY0bBAI+AHx6Cx4j+djabTsvrgW2k6NU2zUSM7bdDP3z2a2+Z4WzBji/jYwt/OP8rpsy5Ee4ywXUfCsfQ0rKOr0zay6yh27p3I3MZle2oCO4JIlqK0VbIQqsXzSSyp6XXS0lhmuGugZ1AAADGz+gFBeX/ZNN8VJwnsNfgzj4me1HgVJdUo4W9kvx9cr2jHWkC3Oj/bdBTh1+yBjOC53yHlQK/l1GHrEWiWPPnE434LRxnWkwr8EHD4oieJxC8fkIxkQfj+gHhU79Z+oAAYAAAzsnf9SDIZPoDXF0TdC9POqTgld0oXDl2XPaVD4CvvLearrOSlFv+lsNbC4rgZn23MtIBM/7YQmJwmQ+FXRup6Tkubg1hpz04J/09dxg8UiZmntHiUr1GfkTOFMYqRB+Aw=="
            },
            {
                "SigningAlg": "P256r1",
                "Value": "hDdkJw9L2uMCORjImjMHqzNR6nYYh6QKncSl5GthQNmHmGU8a+SOqDXWwDNt3VSntpbTTQl7cMIusqweQo+JPXXWElbGh7eaxPGz4ZeF5yM2cqVNUrQr1lX/6lZ+OLuycrFrLzzB9APi0NIMLqV/Rt7XJssHQs2RPcT1ul/2XVpa6ztULJeQi2JwhTb/k48wbh/EvafG/ibrIBIx9v7/dwGRAPKHq7Uwb9hHnhpa8qNOUtjeUdIwJNh9vCBFX9s22t4PdortoFxbXo9C149PDDD4wqUHJGYlCsVX/Sqqjf7Aug3h5dwdYN6cDgsuuiOm0+aBcXBGpkh7OxVxlwXkIP+11dt23TkrSUKd0B01sc9Mc/0yEBCzx5RutKBwsefzyOl4vQX3AHgV7oD/XV73THMgGiDxQ55CPaaxN/pm791VkQ76BSZaBeF+Su6tg0k/eQneklt8Du5uqkyBHVxy8MvxsBIMZ73vIFwUrLHjDeq3+nOOyQqSBMnrHKU2mAwN3zb2LolwjPkKNOh1+NNnv99L2pBcNCnhnoBULWmWAZNXJpMx9QrcSwI9AHylcgUbGQJgf9Ryun+BgewzYNdWrXyKkp4O3ZDa4f+5SVWvbY5eyDDXcohvz/OcCtuRjAkzKBCvIjBDnCv1McjVdCO3+utizGntfhAo1RZstnOoRkgVF2WuMT9IrUmzYximuTXUmWtjyFSTqgNBZwHWUTlMmjlpLCVzZQWM4zOisXUAAALPsP34BS6EzJO5AsS5pC7QTpjBtAbLN9SdXOT9w4H1x8Nkp0ujLxWRN37IEy0V9DrPK2w1g74uqWPfUPnSBjtvM55JnQpmm23WQNvHa1Vr6zmWDjzjHpcNirPbzXyBlKEhkX4xylaSMnm4UrVXtAMaAJ/csC4HPTKr3dazdvEkhwGAAAIFByCjSp/5WHc4AhsyjMvKCsZQiKgiI8ECwjfXBaSZdY4zYsRlO3FC428H1atrFChFCZT0Bqt5LPXD38bMSB+vAUJiP8XqiEdXeqf2mYMJ5ykoDpwkve/cUQfPpjzFQlQfvwjBwiJDANKkOKoNT3bUGz+/f/pyTE+xMRdIUBZ1Bw=="
            }
        ],
        "DeviceProfileId": "0ff5b0c6-f149-4498-af34-21993acd52a7",
        "PrivateKeys": [
            {
                "SigningAlg": "Ed25519",
                "Value": "2c24d4572327f23b9bef38097137c29224a9e979081b3d90124ac9dfa477934e"
            },
            {
                "SigningAlg": "P256r1",
                "Value": "38d526f29cfaf142f596deca187bd809ef71bc13435eedc885b63bb825d63def"
            }
        ],        
        "SidewalkManufacturingSn": "843764270F4BDAE3023918C89A3307AB3351EA761887A40A9DC4A5E46B6140D9",
        "Status": "PROVISIONED"
    },
    
    ...
    
}

Nächste Schritte

Speichern Sie vorrübergehend die JSON-Dateien wireless_device.json und device_profile.json, da Sie sie im nächsten Schritt zur Bereitstellung und Registrierung Ihres Endgeräts für die Verbindung mit der Hardwareplattform benötigen werden. Weitere Informationen finden Sie unter Bereitstellung und Registrierung Ihres Endgeräts in der Dokumentation zu Amazon Sidewalk.