Connectez votre appareil Sidewalk et visualisez le format des métadonnées de liaison montante

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 et Configuration du kit de développement matériel (HDK) dans la documentation Amazon Sidewalk.

Envoyer des messages de liaison descendante à votre terminal

Utilisez l’opération d’API SendDataToWirelessDevice ou la commande d’interface de ligne de commande send-data-to-wireless-device 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. Pour plus d’informations sur ce type d’événement, consultez Événements d’envoi de messages.

Afficher le format des messages en liaison montante depuis l’appareil

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 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 ouMEMORY_ERROR.	Tableau de chaînes	Non