# Connectez votre appareil Sidewalk et visualisez le format des métadonnées de liaison montante
<a name="iot-sidewalk-connect-uplink-metadata"></a>

Dans ce didacticiel, vous allez utiliser le client de test MQTT pour tester la connectivité et voir les messages échangés entre votre terminal et le AWS Cloud. Pour recevoir des messages, dans le client de test MQTT, abonnez-vous à la rubrique spécifiée lors de la création de la règle IoT pour votre destination. Vous pouvez également envoyer un message de liaison descendante depuis AWS IoT Core pour Amazon Sidewalk à votre appareil à l’aide de l’opération d’API `SendDataToWirelessDevice`. Vous pouvez vérifier que le message a été remis en activant la notification d’événement d’état de remise du message.

**Note**  
Pour plus d’informations sur la connexion et la configuration de votre plate-forme matérielle, consultez [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) et [Configuration du kit de développement matériel (HDK)](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html) dans la documentation *Amazon Sidewalk*.

## Envoyer des messages de liaison descendante à votre terminal
<a name="iot-sidewalk-downlink-message"></a>

Utilisez l’opération d’API [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) ou la commande d’interface de ligne de commande [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) pour envoyer des messages de liaison descendante depuis AWS IoT Core pour Amazon Sidewalk à votre terminal Sidewalk. Voici un exemple de la marche à suivre. Les données de charge utile sont le binaire à envoyer, codé en base64.

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

Vous trouverez ci-dessous un exemple de résultat de l’exécution de cette commande, qui est un identifiant du message de liaison descendante envoyé à l’appareil.

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

**Note**  
L’API `SendDataToWirelessDevice` peut renvoyer un ID de message, mais le message risque de ne pas être livré correctement. Pour vérifier l’état du message envoyé à l’appareil, vous pouvez activer les événements relatifs à l’état de livraison des messages pour vos comptes et appareils Sidewalk. Pour plus d’informations sur l’activation de cet événement, consultez [Notifications d’événements pour les ressources Sidewalk](iot-sidewalk-events.md). Pour plus d’informations sur ce type d’événement, consultez [Événements d’envoi de messages](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sidewalk-message-delivery-events.html).

## Afficher le format des messages en liaison montante depuis l’appareil
<a name="iot-sidewalk-uplink-metadata"></a>

Une fois que vous avez connecté votre appareil, vous pouvez vous abonner à la rubrique (par exemple, *`project/sensor/observed`*) que vous avez spécifiée lors de la création de la règle de destination et observer les messages de liaison montante provenant de l’appareil. 

Si vous avez indiqué un nom de rubrique lors de la création de votre destination, vous pouvez vous abonner à la rubrique pour surveiller les messages en liaison montante provenant de votre terminal. Accédez au [client de test MQTT](https://console.aws.amazon.com/iot/home#/test) sur la page **Test** de la console AWS IoT, entrez le nom du sujet (par exemple, *`project/sensor/observed`*), puis choisissez **S’abonner**.

L’exemple suivant illustre le format des messages de liaison montante envoyés par les appareils Sidewalk à AWS IoT. `WirelessMetadata` contient des métadonnées relatives à la demande de message.

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

Le tableau suivant présente une définition des différents paramètres des métadonnées de liaison montante. `device-id` est l’ID de l’appareil sans fil, tel que `ABCDEF1234` et le `messageType` est le type de message de liaison montante reçu de l’appareil.


**Paramètres des métadonnées de la liaison montante Sidewalk**  

| Paramètre | Description | Type | Obligatoire | 
| --- | --- | --- | --- | 
| PayloadData |  Charge utile des messages envoyés depuis l’appareil sans fil.   | Chaîne | Oui | 
| WirelessDeviceID | L’identifiant de l’appareil sans fil qui envoie les données | Chaîne | Oui | 
| Sidewalk.CmdExStatus |  État d’exécution de la commande. Les messages de type réponse doivent inclure le code d’état, `COMMAND_EXEC_STATUS_SUCCESS`. Toutefois, les notifications peuvent ne pas inclure le code d’état.  | Énumération | Non | 
| Sidewalk.NackExStatus |  État de réponse, qui peut être `RADIO_TX_ERROR` ou`MEMORY_ERROR`.   | Tableau de chaînes | Non |