Verbinden Ihres Sidewalk-Geräts und Anzeigen des Uplink-Metadatenformats

In diesem Tutorial verwenden Sie den MQTT-Testclient, um die Konnektivität zu testen und die Nachrichten anzuzeigen, die zwischen Ihrem Endgerät und der AWS Cloud ausgetauscht werden. Abonnieren Sie im MQTT-Testclient das Thema, das Sie bei der Erstellung der IoT-Regel für Ihr Ziel angegeben haben, um Nachrichten zu empfangen. Sie können mithilfe der SendDataToWirelessDevice-API-Operation auch eine Downlink-Nachricht von AWS IoT Core für Amazon Sidewalk an Ihr Gerät senden. Sie können überprüfen, ob die Nachricht verschickt wurde, indem Sie die Benachrichtigung über den Nachrichtenübermittlungsstatus aktivieren.

Senden von Downlink-Nachrichten an Ihr Endgerät

Verwenden Sie die SendDataToWirelessDevice-API-Operation oder den send-data-to-wireless-device-CLI-Befehl, um Downlink-Nachrichten von AWS IoT Core für Amazon Sidewalk an Ihr Sidewalk-Endgerät zu senden. Das folgende Beispiel veranschaulicht die Ausführung dieses Befehls. Die Nutzlastdaten sind die zu sendende Binärdatei mit base64-Verschlüsselung.

aws iotwireless send-data-to-wireless-device \
    --id "<Wireless_Device_ID>" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}

Im Folgenden sehen Sie ein Beispiel für die Ausführung dieses Befehls. Dabei handelt es sich um eine ID der Downlink-Nachricht, die an das Gerät gesendet wurde.

{
    MessageId: "6011dd36-0043d6eb-0072-0008"
}

Anzeigen des Formats von Uplink-Nachrichten auf dem Gerät

Sobald Ihr Gerät verbunden ist, können Sie das Thema abonnieren (z. B. project/sensor/observed), das Sie bei der Erstellung der Zielregel angegeben haben, und sich die Uplink-Nachrichten des Geräts ansehen.

Wenn Sie bei der Erstellung Ihres Ziels einen Themennamen angegeben haben, können Sie das Thema abonnieren, um Uplink-Nachrichten von Ihrem Endgerät zu überwachen. Wechseln Sie zum MQTT-Testclient auf der Seite Test der AWS IoT-Konsole auf, geben Sie den Themennamen ein (z. B. project/sensor/observed) und wählen Sie dann Abonnieren.

Das folgende Beispiel zeigt das Format der Uplink-Nachrichten, die von Sidewalk-Geräten an AWS IoT gesendet werden. Das WirelessMetadata enthält Metadaten zur Nachrichtenanforderung.

{
   "PayloadData":"ZjRlNjY1ZWNlNw==",
   "WirelessDeviceId":"wireless_device_id",   
   "WirelessMetadata":{
      "Sidewalk":{
         "CmdExStatus":"Cmd",
         "SidewalkId":"device_id",
         "Seq":0,
         "MessageType":"messageType"
      }
    }
}   

Die folgende Tabelle zeigt eine Definition der verschiedenen Parameter in den Uplink-Metadaten. Die device-id ist die ID des WLAN-Geräts, z. B. ABCDEF1234, und der messageType ist der Typ der Uplink-Nachricht, die vom Gerät empfangen wurde.