# Verbinden Ihres Sidewalk-Geräts und Anzeigen des Uplink-Metadatenformats
<a name="iot-sidewalk-connect-uplink-metadata"></a>

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.

**Anmerkung**  
Informationen zum Verbinden und Einrichten Ihrer Hardwareplattform finden Sie unter [Bereitstellen und Registrieren Ihres Endgeräts](https://docs.sidewalk.amazon/provisioning/) und [Einrichten des Hardware Development Kits (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) in der *Dokumentation zu Amazon Sidewalk*.

## Senden von Downlink-Nachrichten an Ihr Endgerät
<a name="iot-sidewalk-downlink-message"></a>

Verwenden Sie die [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html)-API-Operation oder den [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/send-data-to-wireless-device.html)-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"
}
```

**Anmerkung**  
Die `SendDataToWirelessDevice`-API kann eine Nachrichten-ID zurückgeben, aber die Nachricht wird möglicherweise nicht erfolgreich übermittelt. Aktivieren Sie die Ereignisse zum Nachrichtenübermittlungsstatus für Ihre Sidewalk-Konten und -Geräte, um den Status der Nachricht zu überprüfen, die an das Gerät gesendet wurde. Weitere Informationen über die Aktivierung dieses Ereignisses finden Sie unter [Ereignisbenachrichtigungen für Sidewalk-Ressourcen](iot-sidewalk-events.md). Weitere Informationen zu diesem Ereignistyp finden Sie unter [Nachrichtenübermittlungsereignisse](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk-message-delivery-events.html).

## Anzeigen des Formats von Uplink-Nachrichten auf dem Gerät
<a name="iot-sidewalk-uplink-metadata"></a>

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](https://console.aws.amazon.com/iot/home#/test) 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.


**Sidewalk-Uplink-Metadatenparameter**  

| Parameter | Beschreibung | Typ | Erforderlich | 
| --- | --- | --- | --- | 
| PayloadData |  Die Nutzlastdaten der Nachricht, die vom WLAN-Gerät gesendet wird.   | String | Ja | 
| WirelessDeviceID | Die Kennung des WLAN-Geräts, das die Daten sendet. | String | Ja | 
| Sidewalk.CmdExStatus |  Laufzeitstatus des Befehls. Nachrichten vom Typ Antwort müssen den Statuscode `COMMAND_EXEC_STATUS_SUCCESS` enthalten. Benachrichtigungen enthalten jedoch möglicherweise nicht den Statuscode.  | Aufzählung | Nein | 
| Sidewalk.NackExStatus |  Antwortstatus der negativen Quittung, der `RADIO_TX_ERROR` oder `MEMORY_ERROR` sein kann.   | Zeichenfolgen-Array | Nein |