# Démarrage avec AWS IoT Core pour Amazon Sidewalk
Cette section explique comment connecter vos terminaux Sidewalk à AWS IoT Core pour Amazon Sidewalk. Il explique comment connecter un terminal à Amazon Sidewalk et transmettre des messages entre eux. Vous en saurez également plus sur l’exemple d’application Sidewalk et vous découvrirez comment effectuer la surveillance des capteurs à l’aide d’AWS IoT Core pour Amazon Sidewalk. L’exemple d’application fournit un tableau de bord permettant de visualiser et de surveiller les modifications de la température du capteur.
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/images/sidewalk-getting-started.png)
Les rubriques suivantes vous aideront à démarrer avec AWS IoT Core pour Amazon Sidewalk.
**Topics**
+ [Essayez le didacticiel de surveillance des capteurs](sidewalk-gs-tutorial.md)
+ [Présentation de l’intégration de vos appareils Sidewalk](sidewalk-gs-workflow.md)
# Essayez le didacticiel de surveillance des capteurs
Cette section présente un exemple d’application Amazon Sidewalk sur GitHub qui explique comment surveiller la température d’un capteur. Dans ce didacticiel, vous utiliserez des scripts qui créent par programmation les ressources sans fil requises, provisionnent le terminal et flasher les fichiers binaires, puis connectent votre terminal à l’application. Les scripts qui utilisent les commandes AWS CLI et Python créent une pile AWS CloudFormation et des ressources sans fil, puis flasher les fichiers binaires et déployer l’application sur votre kit de développement matériel (HDK).
Le schéma suivant montre les étapes à suivre lorsque vous exécutez le [modèle d’application](https://github.com/aws-samples/aws-iot-core-for-amazon-sidewalk-sample-app) et connectez votre terminal Sidewalk à l’application. Pour obtenir des instructions détaillées, y compris les prérequis et la configuration de ce didacticiel, consultez le [document README](https://github.com/aws-samples/amazon-sidewalk-sample-iot-app/blob/main/README.md) sur *GitHub.*
![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/images/sidewalk-sensor-monitoring.png)
# Présentation de l’intégration de vos appareils Sidewalk
Cette section explique comment intégrer vos terminaux Sidewalk à AWS IoT Core pour Amazon Sidewalk. Pour intégrer vos appareils, ajoutez d’abord votre appareil Sidewalk, puis configurez et enregistrez votre appareil, puis connectez votre matériel à l’application cloud. Avant de lancer ce didacticiel, révisez et terminez le [Installation de Python et d’AWS CLI](setting-up-iotwireless.md#wireless-onboard-prereq).
Les étapes suivantes vous montrent comment intégrer et connecter vos terminaux Sidewalk à AWS IoT Core pour Amazon Sidewalk. Si vous souhaitez intégrer des appareils à l’aide du AWS CLI, vous pouvez vous référer aux exemples de commandes fournis dans cette section. Pour plus d’informations sur l’intégration des appareils à l’aide de la console AWS IoT, veuillez consulter [Connexion à AWS IoT Core pour Amazon Sidewalk](iot-sidewalk-onboard.md).
**Important**
Pour effectuer l’ensemble du processus d’intégration, vous devez également approvisionner et enregistrer votre terminal, puis connecter votre kit de développement matériel (HDK). Pour plus d’informations, consultez la section [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) dans la *documentation Amazon Sidewalk*.
**Topics**
+ [Étape 1 : Ajouter votre appareil Sidewalk à AWS IoT Core pour Amazon Sidewalk](#iot-sidewalk-qsg-step1)
+ [Étape 2 : créer une destination pour votre appareil Sidewalk](#iot-sidewalk-qsg-step2)
+ [Étape 3 : Mettre en service et enregistrer le terminal](#iot-sidewalk-qsg-step2)
+ [Étape 4 : Se connecter à un appareil Sidewalk et échanger des messages](#iot-sidewalk-qsg-step4)
## Étape 1 : Ajouter votre appareil Sidewalk à AWS IoT Core pour Amazon Sidewalk
Voici une vue d’ensemble des étapes que vous allez suivre pour ajouter votre terminal Sidewalk àAWS IoT Core pour Amazon Sidewalk. Stockez les informations que vous obtenez sur le profil de l’appareil et l’appareil sans fil que vous créez. Vous utiliserez ces informations pour mettre en service et enregistrer le terminal. Pour plus d'informations sur ces étapes, veuillez consulter [Ajout de votre appareil à AWS IoT Core pour Amazon Sidewalk](iot-sidewalk-create-device.md).
1.
**Création d’un profil d’appareil**
Créez un profil d’appareil contenant les configurations partagées pour vos appareils Sidewalk. Lors de la création du profil, spécifiez un `name` pour le profil sous forme de chaîne alphanumérique. Pour créer un profil, accédez à [l’onglet Sidewalk du centre Profiles](https://console.aws.amazon.com/iot/home#/wireless/profiles?tab=sidewalk) de la console AWS IoT et choisissez **Créer un profil**, ou utilisez l’opération d’API[https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-device-profile.html) comme indiqué dans cet exemple.
```
// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}
```
1.
**Créez votre terminal Sidewalk**
Créez votre terminal Sidewalk avec AWS IoT Core pour Amazon Sidewalk. Spécifiez un nom de destination et l’ID du profil d’appareil obtenu à l’étape précédente. Pour ajouter un appareil, accédez à [l’onglet Sidewalk du centre des appareils](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) de la console AWS IoT et choisissez **Mise en service d’un appareil**, ou utilisez l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html](https://docs.aws.amazon.com/cli/latest/reference/create-wireless-device.html) comme indiqué dans cet exemple.
**Note**
Spécifiez un nom pour votre destination qui soit propre à votre Compte AWS et Région AWS. Vous utiliserez le même nom de destination lorsque vous ajouterez votre destination à AWS IoT Core pour Amazon Sidewalk.
```
// Add your Sidewalk device by using the device profile ID.
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \
--destination-name SidewalkDestination \
--sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"
```
1.
**Obtenir le profil de l’appareil et les informations sur les appareils sans fil**
Obtenez le profil de l’appareil et les informations de l’appareil sans fil au format JSON. Le JSON contiendra des informations sur les détails de l’appareil, les certificats de l’appareil, les clés privées, `DeviceTypeId` et le numéro de série de fabrication (SMSN) de Sidewalk.
+ Si vous utilisez la console AWS IoT, vous pouvez utiliser [l’onglet Sidewalk du centre des appareils](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) pour télécharger un fichier JSON combiné pour votre terminal Sidewalk.
+ Si vous utilisez les opérations d’API, stockez les réponses obtenues à partir des opérations d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) et [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) comme fichiers JSON distincts, tels que *`device_profile.json`* et `wireless_device.json`.
```
// Store device profile information as a JSON file.
aws iotwireless get-device-profile \
--id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" > device_profile.json
// Store wireless device information as a JSON file.
aws iotwireless get-wireless-device --identifier-type WirelessDeviceId \
--identifier "23456789-abcd-0123-bcde-fabc012345678" > wireless_device.json
```
## Étape 2 : créer une destination pour votre appareil Sidewalk
Voici une vue d’ensemble des étapes que vous allez suivre pour ajouter votre destination à AWS IoT Core pour Amazon Sidewalk. À l’aide de la AWS Management Console, des opérations d’API AWS IoT Wireless ou de l’AWS CLI, exécutez les étapes suivantes pour créer une règle AWS IoT et une destination. Vous pouvez ensuite vous connecter à la plate-forme matérielle, consulter et échanger des messages. Pour un exemple de rôle IAM et de règle AWS IoT utilisés dans les exemples AWS CLI de cette section, veuillez consulter [Créer un rôle IAM et une règle IoT pour votre destination](sidewalk-destination-rule-role.md).
1.
**Créez un rôle IAM**
Créez un rôle IAM qui autorise AWS IoT Core pour Amazon Sidewalk à envoyer des données à la règle AWS IoT. Pour créer le rôle, utilisez l’opération d’API [https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) ou la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/iam/create-role](https://docs.aws.amazon.com/cli/latest/reference/iam/create-role). Vous pouvez nommer le rôle comme *`SidewalkRole`*.
```
aws iam create-role --role-name lambda-ex \
--assume-role-policy-document file://lambda-trust-policy.json
```
1.
**Création d’une règle pour la destination**
Créez une règle AWS IoT qui traitera les données de l’appareil et spécifiez le sujet dans lequel les messages sont publiés. Vous observerez les messages relatifs à ce sujet après vous être connecté à la plate-forme matérielle. Utilisez l’opération d’API AWS IoT Core, [https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateTopicRule.html), ou la commande AWS CLI, [https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html](https://docs.aws.amazon.com/cli/latest/reference/iot/create-topic-rule.html), pour créer une règle pour la destination.
```
aws iot create-topic-rule --rule-name Sidewalkrule \
--topic-rule-payload file://myrule.json
```
1.
**Créer une destination**
Créez une destination qui associe votre appareil Sidewalk à la règle IoT qui le traite pour une utilisation avec d’autres Services AWS. Vous pouvez ajouter une destination à l’aide du [centre de destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations) de la console AWS IoT, de l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) ou de la commande CLI [https://docs.aws.amazon.com/cli/latest/reference/create-destination.html](https://docs.aws.amazon.com/cli/latest/reference/create-destination.html).
```
aws iotwireless create-destination --name SidewalkDestination \
--expression-type RuleName --expression SidewalkRule \
--role-arn arn:aws:iam::123456789012:role/SidewalkRole
```
## Étape 3 : Mettre en service et enregistrer le terminal
À l’aide des commandes Python, vous pouvez mettre en service et enregistrer votre terminal. Le script de mise en service utilise les données JSON de l’appareil que vous avez obtenues pour générer une image binaire de fabrication, qui est ensuite flashée sur la carte matérielle. Vous enregistrez ensuite votre terminal pour le connecter à la plate-forme matérielle. Pour plus d’informations, consultez la section [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) dans la *documentation Amazon Sidewalk*.
**Note**
Lorsque vous enregistrez votre terminal Sidewalk, votre passerelle doit être connectée à Amazon Sidewalk, et votre passerelle et votre appareil doivent être à portée l’un de l’autre.
## Étape 4 : Se connecter à un appareil Sidewalk et échanger des messages
Une fois que vous avez enregistré votre terminal, vous pouvez le connecter et commencer à échanger des messages et des données de l’appareil.
1.
**Connectez votre terminal Sidewalk**
Connectez le HDK à votre ordinateur et suivez les instructions fournies par la documentation du fournisseur pour vous connecter à votre HDK. Pour plus d’informations, consultez la section [Mise en service et enregistrement de votre terminal](https://docs.sidewalk.amazon/provisioning/) dans la *documentation Amazon Sidewalk*.
1.
**Afficher et échanger des messages**
Utilisez le client MQTT pour vous abonner à la rubrique spécifiée dans la règle et afficher le message reçu. Vous pouvez également utiliser 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 CLI [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 un message en liaison descendante à votre appareil et vérifier l’état de la connectivité.
(Facultatif) Vous pouvez activer l’événement d’état d’envoie du message pour vérifier si le message de liaison descendante a bien été reçu.
```
aws iotwireless send-data-to-wireless-device \
--id "" \
--payload-data "SGVsbG8gVG8gRGV2c2lt" \
--wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}
```