# Connexion de passerelles et d’appareils à AWS IoT Core for LoRaWAN AWS IoT Core for LoRaWAN vous permet de connecter et de gérer des appareils sans fil LoRaWAN (réseau étendu longue portée à faible consommation) et vous évite d’avoir à développer et à exploiter un réseau LNS. Les appareils et passerelles WAN longue portée (LoRaWAN) peuvent se connecter à AWS IoT Core en utilisant AWS IoT Core for LoRaWAN. ## Conventions de dénomination pour vos appareils, passerelles, profils et destinations Avant de commencer à utiliser AWS IoT Core for LoRaWAN et à créer les ressources, tenez compte de la convention de dénomination de vos appareils, de vos passerelles et de votre destination. AWS IoT Core for LoRaWAN attribue des identifiants uniques aux ressources que vous créez pour les appareils sans fil, les passerelles et les profils ; toutefois, vous pouvez également donner à vos ressources des noms plus descriptifs afin de faciliter leur identification. Avant d’ajouter des appareils, des passerelles, des profils et des destinations à AWS IoT Core for LoRaWAN, réfléchissez à la façon dont vous allez les nommer afin de faciliter leur gestion. Vous pouvez ajouter des balises aux ressources lorsque vous créez ces dernières. Avant d’ajouter vos appareils LoRaWAN, réfléchissez à la manière dont vous pourriez utiliser les balises pour identifier et gérer vos ressources AWS IoT Core for LoRaWAN. Les balises peuvent être modifiées une fois que vous les avez ajoutées. Pour plus d’informations sur la dénomination et le balisage, consultez [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md). ## Mappage des données de l’appareil aux données de service Les données des appareils sans fil LoRaWAN sont souvent codées pour optimiser la bande passante. Ces messages codés arrivent à AWS IoT Core for LoRaWAN dans un format qui peut ne pas être facilement utilisé par d’autres services AWS. AWS IoT Core for LoRaWAN utilise les règles AWS IoT qui peuvent utiliser les fonctions AWS Lambda pour traiter et décoder les messages de l’appareil dans un format utilisable par d’autres services AWS. Pour transformer les données des appareils et les envoyer à d’autres services AWS, vous devez connaître : + Le format et le contenu des données envoyées par les appareils sans fil. + Le service auquel vous souhaitez envoyer les données. + Le format requis par le service. À l’aide de ces informations, vous pouvez créer la règle AWS IoT qui effectue la conversion et envoie les données converties aux services AWS qui les utiliseront. ## Utilisation de la console pour intégrer votre appareil et votre passerelle vers AWS IoT Core for LoRaWAN Vous pouvez utiliser l’interface de la console ou l’API pour ajouter votre passerelle et vos appareils LoRaWAN. Si vous utilisez AWS IoT Core for LoRaWAN pour la première fois, nous vous recommandons d’utiliser la console. L’interface de console est particulièrement pratique lorsque vous gérez quelques ressources AWS IoT Core for LoRaWAN à la fois. Lorsque vous gérez un grand nombre de ressources AWS IoT Core for LoRaWAN, envisagez de créer des solutions plus automatisées à l’aide de l’API AWS IoT Wireless. La plupart des données que vous saisissez lors de la configuration des ressources AWS IoT Core for LoRaWAN sont fournies par les fournisseurs des appareils et sont spécifiques aux spécifications LoRaWAN qu’ils prennent en charge. Les rubriques suivantes décrivent comment vous pouvez décrire vos ressources AWS IoT Core pour LoRaWAN et utiliser la console ou l’API pour ajouter vos passerelles et appareils. **Note** Si vous utilisez un réseau public pour connecter vos appareils LoRaWAN au cloud, vous pouvez ignorer l’intégration de vos passerelles. Pour en savoir plus, consultez [Gestion du trafic LoRaWAN à partir des réseaux publics des appareils LoRaWAN (Everynet)](iot-lorawan-roaming.md). **Topics** + [Conventions de dénomination pour vos appareils, passerelles, profils et destinations](#lorawan-naming-convention) + [Mappage des données de l’appareil aux données de service](#lorawan-service-device-data) + [Utilisation de la console pour intégrer votre appareil et votre passerelle vers AWS IoT Core for LoRaWAN](#lorawan-console) + [Intégrez vos passerelles pour AWS IoT Core for LoRaWAN](lorawan-onboard-gateways.md) + [Intégrez vos appareils à AWS IoT Core for LoRaWAN](lorawan-onboard-end-devices.md) # Intégrez vos passerelles pour AWS IoT Core for LoRaWAN Si vous l’utilisez AWS IoT Core for LoRaWAN pour la première fois, vous pouvez ajouter votre première passerelle et votre premier appareil LoRaWAN à l’aide de la console. **Note** Si vous utilisez un réseau public pour connecter vos appareils LoRaWAN au cloud, vous pouvez ignorer l’intégration de vos passerelles. Pour en savoir plus, consultez [Gestion du trafic LoRaWAN à partir des réseaux publics des appareils LoRaWAN (Everynet)](iot-lorawan-roaming.md). **Avant d’intégrer votre passerelle** Avant d’intégrer votre passerelle pour AWS IoT Core for LoRaWAN, nous vous recommandons de : + Utilisez des passerelles qualifiées pour être utilisées avec AWS IoT Core for LoRaWAN. Ces passerelles se connectent à AWS IoT Core sans aucun paramètre de configuration supplémentaire et exécutent la version 2.0.4 ou ultérieure du logiciel [LoRa Basics Station](https://doc.sm.tc/station). Pour en savoir plus, consultez [Gestion des passerelles avec AWS IoT Wireless](lorawan-manage-gateways.md). + Tenez compte de la convention de dénomination des ressources que vous créez afin de pouvoir les gérer plus facilement. Pour en savoir plus, consultez [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md). + Préparez à l’avance les paramètres de configuration propres à chaque passerelle, ce qui facilite la saisie des données dans la console. Les paramètres de configuration de la passerelle sans fil dont AWS IoT a besoin pour communiquer avec la passerelle et la gérer incluent l’EUI de la passerelle et sa bande de fréquence LoRa. **Topics** + [Envisagez la sélection de la bande de fréquence et ajoutez le rôle IAM nécessaire](lorawan-rfregion-permissions.md) + [Ajoutez une passerelle vers AWS IoT Core for LoRaWAN](lorawan-onboard-gateway-add.md) + [Connectez votre passerelle LoRaWAN et vérifiez son état de connexion](lorawan-gateway-connection-status.md) # Envisagez la sélection de la bande de fréquence et ajoutez le rôle IAM nécessaire Avant d’ajouter votre passerelle à AWS IoT Core for LoRaWAN, nous vous recommandons de prendre en compte la bande de fréquence dans laquelle votre passerelle fonctionnera et d’ajouter le rôle IAM nécessaire pour connecter votre passerelle à AWS IoT Core for LoRaWAN. **Note** Si vous ajoutez votre passerelle à l’aide de la console, cliquez sur **Créer un rôle** dans la console pour créer le rôle IAM nécessaire afin de pouvoir ensuite ignorer ces étapes. Vous devez effectuer ces étapes uniquement si vous utilisez la CLI pour créer la passerelle. ## Envisagez de sélectionner des bandes de fréquences LoRa pour vos passerelles et la connexion de vos appareils AWS IoT Core for LoRaWAN prend en charge les bandes de fréquences EU863-870, US902-928, AU915 et AS923-1, que vous pouvez utiliser pour connecter vos passerelles et appareils physiquement présents dans les pays qui prennent en charge les plages de fréquences et les caractéristiques de ces bandes. Les bandes EU863-870 et US902-928 sont couramment utilisées en Europe et en Amérique du Nord, respectivement. La bande AS923-1 est couramment utilisée en Australie, en Nouvelle-Zélande, au Japon et à Singapour, entre autres pays. L’AU915 est utilisé notamment en Australie et en Argentine. Pour plus d’informations sur la bande de fréquences à utiliser dans votre région ou votre pays, consultez la section [Paramètres régionaux LoRaWAN®](https://lora-alliance.org/resource_hub/rp2-101-lorawan-regional-parameters-2/). LoRa Alliance publie des spécifications LoRaWAN et des documents sur les paramètres régionaux qui peuvent être téléchargés sur le site Web de LoRa Alliance. Les paramètres régionaux de la LoRa Alliance aident les entreprises à décider de la bande de fréquences à utiliser dans leur région ou leur pays. La mise en œuvre de la bande de fréquences AWS IoT Core for LoRaWAN suit les recommandations du document de spécification des paramètres régionaux. Ces paramètres régionaux sont regroupés dans un ensemble de paramètres radio, ainsi qu’une allocation de fréquence adaptée à la bande industrielle, scientifique et médicale (ISM). Nous vous recommandons de travailler avec les équipes de conformité pour vous assurer que vous respectez toutes les exigences réglementaires applicables. ## Ajoutez un rôle IAM pour permettre au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle Cette procédure décrit comment ajouter un rôle IAM qui permettra au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle. Assurez-vous d’effectuer cette procédure avant qu’une passerelle LoRaWAN essaie de se connecter AWS IoT Core for LoRaWAN ; toutefois, vous ne devez effectuer cette procédure qu’une seule fois. **Ajoutez le rôle IAM pour permettre au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle** 1. Ouvrez la page [Centre de rôles de la console IAM](https://console.aws.amazon.com/iam/home#/roles) et choisissez **Créer un rôle**. 1. Si vous pensez avoir déjà ajouté le rôle **IoTWirelessGatewayCertManagerRole**, entrez dans la barre de recherche. **IoTWirelessGatewayCertManagerRole** Si vous voyez un rôle **IOTWirelessGatewayCertManagerRole** dans les résultats de recherche, vous disposez du rôle IAM nécessaire. Vous pouvez quitter la procédure maintenant. Si les résultats de recherche sont vides, vous ne possédez pas le rôle IAM nécessaire. Continuez la procédure pour l’ajouter. 1. Dans l’onglet **Sélectionner le type d’entité d’approbation**, choisissez **Autre Compte AWS**. 1. Dans **ID de compte**, entrez votre Compte AWS identifiant, puis choisissez **Suivant : Autorisations**. 1. Dans la zone de recherche, saisissez **AWSIoTWirelessGatewayCertManager**. 1. Dans la liste des résultats de recherche, sélectionnez la politique nommée **AWSIOTWirelessGatewayCertManager**. 1. Sélectionnez **Suivant : Balises**, puis **Suivant : Vérification**. 1. Dans **Nom du rôle**, saisissez **IoTWirelessGatewayCertManagerRole**, puis choisissez **Créer un rôle**. 1. Pour modifier le nouveau rôle, dans le message de confirmation, choisissez **IOTWirelessGatewayCertManagerRole**. 1. Dans **Récapitulatif**, choisissez l’onglet **Relations d’approbation**, puis choisissez **Modifier la relation d’approbation**. 1. Dans l’onglet **Document de politique**, modifiez la `Principal` propriété pour qu’elle ressemble à cet exemple. ``` "Principal": { "Service": "iotwireless.amazonaws.com" }, ``` Après avoir modifié la `Principal` propriété, le document de politique complet doit ressembler à cet exemple. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotwireless.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Pour enregistrer vos modifications et quittez, sélectionnez **Mettre à jour la politique d’approbation**. Vous avez maintenant créé le rôle **IoTWirelessGatewayCertManagerRole**. Vous n’aurez pas besoin de le refaire. Si vous avez effectué cette procédure lors de l’ajout d’une passerelle, vous pouvez fermer cette fenêtre ainsi que la console IAM, puis revenir à la AWS IoT console pour terminer l’ajout de la passerelle. # Ajoutez une passerelle vers AWS IoT Core for LoRaWAN Vous pouvez ajouter votre passerelle à AWS IoT Core for LoRaWAN à l’aide de la console ou de la CLI. Avant d’ajouter votre passerelle, nous vous recommandons de prendre en compte les facteurs mentionnés dans la section **Avant d’intégrer votre passerelle** de [Intégrez vos passerelles pour AWS IoT Core for LoRaWAN](lorawan-onboard-gateways.md). Si vous ajoutez votre passerelle pour la première fois, nous vous recommandons d’utiliser la console. Si vous souhaitez plutôt ajouter votre passerelle à l’aide de la CLI, vous devez déjà avoir créé le rôle IAM nécessaire pour que la passerelle puisse se connecter àAWS IoT Core for LoRaWAN Pour plus d’informations sur la création de ce rôle, consultez [Ajoutez un rôle IAM pour permettre au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle](lorawan-rfregion-permissions.md#lorawan-onboard-permissions). ## Ajouter une passerelle à l’aide de la console Accédez à la page d’[AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing)**introduction** de la console AWS IoT et choisissez **Commencer**, puis choisissez **Ajouter une passerelle**. Si vous avez déjà ajouté une passerelle, choisissez **Afficher la passerelle** pour afficher la passerelle que vous avez ajoutée. Si vous souhaitez ajouter d’autres passerelles, choisissez **Ajouter une passerelle**. 1. **Fournir des détails sur la passerelle et des informations sur les bandes de fréquences** Utilisez la section **Détails de la passerelle** pour fournir des informations sur les données de configuration de l’appareil, telles que l’EUI de la passerelle et la configuration de la bande de fréquence. + **L’EUI de la passerelle** L’EUI (Identifiant unique étendu) du dispositif de passerelle individuel. L’EUI est un code alphanumérique à 16 chiffres, par exemple `c0ee40ffff29df10`, qui identifie de manière unique une passerelle dans votre réseau LoRaWAN. Ces informations sont spécifiques à votre modèle de passerelle et vous pouvez les trouver sur votre appareil de passerelle ou dans son manuel d’utilisation. **Note** L’EUI de la passerelle est différent de l’adresse MAC Wi-Fi que vous pouvez voir imprimée sur votre appareil passerelle. L’EUI suit une norme EUI-64 qui identifie de manière unique votre passerelle et ne peut donc pas être réutilisée dans d’autres Compte AWS ou régions. + **Bande de fréquence (RFRegion)** La bande de fréquence de la passerelle. Vous pouvez choisir entre`US915`, `EU868`, `AU915` ou `AS923-1`, en fonction de ce que prend en charge votre passerelle et du pays ou de la région depuis lequel la passerelle se connecte physiquement. Pour plus d’informations sur les bandes, veuillez consulter [Envisagez de sélectionner des bandes de fréquences LoRa pour vos passerelles et la connexion de vos appareils](lorawan-rfregion-permissions.md#lorawan-frequency-bands). 1. **Spécifiez les données de configuration de votre passerelle sans fil (facultatif)** Ces champs sont facultatifs et vous pouvez les utiliser pour fournir des informations supplémentaires sur la passerelle et sa configuration. + **Nom, description et balises de votre passerelle** Les informations contenues dans ces champs facultatifs proviennent de la façon dont vous organisez et décrivez les éléments de votre système sans fil. Vous pouvez attribuer un **nom** à la passerelle, utiliser le champ **Description** pour fournir des informations sur la passerelle et utiliser des **balises** pour ajouter des paires clé-valeur de métadonnées relatives à la passerelle. Pour plus d’informations sur la dénomination et la description de vos ressources, veuillez consultez [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md). + **Configuration LoRaWAN à l’aide de sous-bandes et de filtres** En option, vous pouvez également spécifier les données de configuration LoRaWAN, telles que les sous-bandes que vous souhaitez utiliser et les filtres permettant de contrôler le flux de trafic. Pour le didacticiel, vous pouvez ignorer ces champs. Pour en savoir plus, consultez [Configuration des sous-bandes et des capacités de filtrage de votre passerelle](lorawan-subband-filter-configuration.md). 1. **Associez un objet AWS IoT à la passerelle** Spécifiez s’il faut créer un AWS IoT objet et l’associer à la passerelle. Les objets dans AWS IoT peuvent faciliter la recherche et la gestion de vos appareils. Associer un objet à votre passerelle permet à cette dernière d’accéder à d’autres fonctionnalités AWS IoT Core. 1. **Création et téléchargement du certificat de passerelle** Pour authentifier votre passerelle afin qu’elle puisse communiquer en toute sécurité avec AWS IoT, votre passerelle LoRaWAN doit présenter une clé privée et un certificat à AWS IoT Core for LoRaWAN. Créez un **certificat de passerelle** afin que AWS IoT puisse vérifier l’identité de votre passerelle à l’aide de la norme X.509. Cliquez sur le bouton **Créer un certificat** et téléchargez les fichiers du certificat. Vous les utiliserez ultérieurement pour configurer votre passerelle. 1. **Copiez les points de terminaison CUPS et LNS et téléchargez les certificats** Votre passerelle LoRaWAN doit se connecter à un point de terminaison CUPS ou LNS lors de l’établissement d’une connexion à AWS IoT Core for LoRaWAN. Nous vous recommandons d’utiliser le point de terminaison CUPS car il permet également de gérer la configuration. Pour vérifier l’authenticité des points de terminaison AWS IoT Core for LoRaWAN, votre passerelle utilisera un certificat de confiance pour chacun des points de terminaison CUPS et LNS. Cliquez sur le bouton **Copier** pour copier les points de terminaison CUPS et LNS. Vous aurez besoin de ces informations ultérieurement pour configurer votre passerelle. Cliquez ensuite sur le bouton **Télécharger les certificats de confiance du serveur** pour télécharger les certificats de confiance pour les points de terminaison CUPS et LNS. 1. **Créez le rôle IAM pour les autorisations de passerelle** Vous devez ajouter un rôle IAM qui permet au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle. **Note** Au cours de cette étape, vous créez le rôle **IoTWirelessGatewayCertManager**. Vous pouvez ignorer cette étape si vous avez déjà créé ce rôle. Vous devez le faire avant qu’une passerelle LoRaWAN essaie de se connecter à AWS IoT Core for LoRaWAN, mais vous ne devez le faire qu’une seule fois. Pour créer le rôle IAM **IoTWirelessGatewayCertManager** pour votre compte, cliquez sur le bouton **Créer un rôle**. Si le rôle existe déjà, sélectionnez-le dans la liste déroulante. Cliquez sur **Soumettre** pour terminer la création de la passerelle. ## Ajout d’une passerelle à l’aide de l’API Si vous ajoutez une passerelle pour la première fois à l’aide de l’API ou de la CLI, vous devez ajouter le rôle IAM **IoTWirelessGatewayCertManager** afin que la passerelle puisse se connecter à AWS IoT Core for LoRaWAN. Pour plus d’informations sur la création du rôle, voir la section [Ajoutez un rôle IAM pour permettre au serveur de configuration et de mise à jour (CUPS) de gérer les informations d’identification de la passerelle](lorawan-rfregion-permissions.md#lorawan-onboard-permissions). Les listes suivantes décrivent les actions d’API qui exécutent les tâches associées à l’ajout, la mise à jour ou la suppression d’une passerelle LoRaWAN. **Actions d’API AWS IoT Wireless pour les passerelles AWS IoT Core for LoRaWAN** + [Création d'une passerelle sans fil](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html) + [GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html) + [ListWirelessGateways](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessGateways.html) + [ UpdateWirelessGateway ](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html) + [DeleteWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessGateway.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser AWS CLI pour ajouter une passerelle** Vous pouvez utiliser AWS CLI pour créer une passerelle sans fil à l’aide de la commande [create-wireless-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html). L’exemple suivant permet créer une passerelle d’appareil sans fil LoRaWAN. Vous pouvez également fournir un fichier `input.json` contenant des informations supplémentaires telles que le certificat de passerelle et les informations d’identification de mise en service. **Note** Vous pouvez également effectuer cette procédure avec l’API en utilisant les méthodes de l’API AWS qui correspondent aux commandes d’interface de ligne de commande indiquées ici. ``` aws iotwireless create-wireless-gateway \ --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \ --name "myFirstLoRaWANGateway" \ --description "Using my first LoRaWAN gateway" --cli-input-json input.json ``` Pour plus d’informations sur les CLI que vous pouvez utiliser, veuillez consulter la [AWS CLI référence](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) # Connectez votre passerelle LoRaWAN et vérifiez son état de connexion Avant de pouvoir vérifier l’état de la connexion à la passerelle, vous devez déjà avoir ajouté votre passerelle et l’avoir connectée à AWS IoT Core for LoRaWAN. Pour plus d’informations sur l’ajout de votre passerelle, veuillez consulter [Ajoutez une passerelle vers AWS IoT Core for LoRaWAN](lorawan-onboard-gateway-add.md). ## Connecter votre passerelle à AWS IoT Core for LoRaWAN Après avoir ajouté votre passerelle, connectez-vous à l’interface de configuration de votre passerelle pour saisir les informations de configuration et les certificats d’approbation. Après avoir ajouté les informations de la passerelle à AWS IoT Core for LoRaWAN, ajoutez des informations AWS IoT Core for LoRaWAN à l’appareil de passerelle. La documentation fournie par le fournisseur de la passerelle doit décrire le processus de téléchargement des fichiers de certificat sur la passerelle et de configuration de l’appareil de passerelle avec lequel communiquer avec AWS IoT Core for LoRaWAN. **Passerelles qualifiées pour être utilisées avec AWS IoT Core for LoRaWAN** Pour obtenir des instructions sur la configuration de votre passerelle LoRaWAN, reportez-vous à la section de AWS IoT Core for LoRaWANl’atelier consacrée à la [configuration de l’appareil de passerelle](https://iotwireless.workshop.aws/en/200_gateway/400_configuregateway.html). Vous trouverez ici des informations sur les instructions de connexion des passerelles pouvant être utilisées avec AWS IoT Core for LoRaWAN. **Passerelles compatibles avec le protocole CUPS** Les instructions suivantes indiquent comment connecter vos passerelles qui prennent en charge le protocole CUPS. 1. Téléchargez les fichiers suivants que vous avez obtenus lors de l’ajout de votre passerelle. + Certificat de l’appareil de passerelle et fichiers de clé privée. + Fichier de certificat d’approbation pour le point de terminaison CUPS ,`cups.trust`. 1. Spécifiez l’URL de point de terminaison CUPS que vous avez obtenue à l’étape précédente. Le format du nom du point de terminaison est `prefix.cups.lorawan.region.amazonaws.com:443`. Pour plus d’informations sur la façon d’obtenir ces informations, veuillez consulter [Ajoutez une passerelle vers AWS IoT Core for LoRaWAN](lorawan-onboard-gateway-add.md). **Passerelles compatibles avec le protocole LNS** Les instructions suivantes indiquent comment connecter vos passerelles qui prennent en charge le protocole LNS. 1. Téléchargez les fichiers suivants que vous avez obtenus lors de l’ajout de votre passerelle. + Certificat de l’appareil de passerelle et fichiers de clé privée. + Fichier de certificat d’approbation pour le point de terminaison LNS, `lns.trust`. 1. Spécifiez l’URL de point de terminaison LNS que vous avez obtenue à l’étape précédente. Le format du nom du point de terminaison est https://`prefix.lns.lorawan.region.amazonaws.com:443`. Pour plus d’informations sur la façon d’obtenir ces informations, veuillez consulter [Ajoutez une passerelle vers AWS IoT Core for LoRaWAN](lorawan-onboard-gateway-add.md). Après avoir connecté votre passerelle à AWS IoT Core for LoRaWAN, vous pouvez vérifier l’état de votre connexion et obtenir des informations sur la date de réception du dernier lien montant à l’aide de la console ou de l’API. ## Vérifier l’état de connexion à la passerelle à l’aide de la console Pour vérifier l’état de la connexion à l’aide de la console, accédez à la page [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) de la console AWS IoT et choisissez la passerelle que vous avez ajoutée. Dans la section **des détails spécifiques au LoRaWAN** de la page des détails de la passerelle, vous verrez l’état de la connexion ainsi que la date et l’heure de réception de la dernière liaison montante. ## Vérifiez l’état de la connexion à la passerelle à l’aide de l’API Pour vérifier l’état de connexion à l’aide de l’API, utilisez l’API `GetWirelessGatewayStatistics`. Cette API n’a pas de corps de demande et contient uniquement un corps de réponse qui indique si la passerelle est connectée et quand la dernière liaison montante a été reçue. ``` HTTP/1.1 200 Content-type: application/json { “ConnectionStatus”: “Connected”, “LastUplinkReceivedAt”: “2021-03-24T23:13:08.476015749Z”, “WirelessGatewayId”: “30cbdcf3-86de-4291-bfab-5bfa2b12bad5" } ``` # Intégrez vos appareils à AWS IoT Core for LoRaWAN Après avoir intégré votre passerelle à AWS IoT Core for LoRaWAN et vérifié son état de connexion, vous pouvez intégrer vos appareils sans fil. Pour plus d’informations sur l’intégration de vos passerelles, veuillez consulter [Intégrez vos passerelles pour AWS IoT Core for LoRaWAN](lorawan-onboard-gateways.md). Les appareils LoRaWAN utilisent un protocole LoRaWAN pour échanger des données avec des applications hébergées dans le cloud. AWS IoT Core for LoRaWAN prend en charge les appareils conformes aux spécifications LoRaWAN 1.0.x ou 1.1 normalisées par LoRa Alliance. Un appareil LoRaWAN contient généralement un ou plusieurs capteurs et acteurs. Les appareils envoient des données de télémétrie en liaison montante via des passerelles LoRaWAN à AWS IoT Core for LoRaWAN. Les applications hébergées dans le cloud peuvent contrôler les capteurs en envoyant des commandes en liaison descendante aux appareils LoRaWAN via des passerelles LoRaWAN. **Avant d’intégrer votre appareil sans fil** Avant d’intégrer votre appareil sans fil à AWS IoT Core for LoRaWAN, vous devez disposer à l’avance des informations suivantes : + **Spécification LoRaWAN et configuration de l’appareil sans fil** Les paramètres de configuration propres à chaque appareil étant prêts à l’avance, l’entrée des données dans la console se fait plus facilement. Les paramètres spécifiques que vous devez saisir dépendent de la spécification LoRaWAN utilisée par l’appareil. Pour obtenir la liste complète de ses spécifications et paramètres de configuration, consultez la documentation de chaque appareil. + **Nom et description de l’appareil (facultatif).** Les informations contenues dans ces champs facultatifs proviennent de la façon dont vous organisez et décrivez les éléments de votre système sans fil. Pour plus d’informations sur la dénomination et la description de vos ressources, veuillez consulter [Description de vos ressources AWS IoT Wireless](iotwireless-describe-resources.md). + **Profils d’appareils et de services** Préparez certains paramètres de configuration des appareils sans fil qui sont partagés par de nombreux appareils et peuvent être stockés dans AWS IoT Core for LoRaWAN sous forme de profils d’appareils et de services. Les paramètres de configuration se trouvent dans la documentation de l’appareil ou sur l’appareil lui-même. Vous devez identifier un profil d’appareil qui correspond aux paramètres de configuration de l’appareil, ou en créer un si nécessaire, avant d’ajouter l’appareil. Pour en savoir plus, consultez [Ajoutez des profils à AWS IoT Core for LoRaWAN](lorawan-define-profiles.md). + **Destination AWS IoT Core for LoRaWAN** Chaque appareil doit être affecté à une destination qui traitera ses messages à envoyer à AWS IoT et à d’autres services. Les règles AWS IoT qui traitent et envoient les messages de l’appareil sont spécifiques au format des messages de l’appareil. Pour traiter les messages provenant de l’appareil et les envoyer au service approprié, identifiez la destination que vous allez créer pour les messages de l’appareil et attribuez-la à l’appareil. **Topics** + [Ajout de votre appareil sans fil à AWS IoT Core for LoRaWAN](lorawan-end-devices-add.md) + [Ajoutez des profils à AWS IoT Core for LoRaWAN](lorawan-define-profiles.md) + [Ajout de destinations à AWS IoT Core for LoRaWAN](lorawan-create-destinations.md) + [Créez des règles pour traiter les messages des appareils LoRaWAN](lorawan-destination-rules.md) + [Connectez votre appareil LoRaWAN et vérifiez son état de connexion.](lorawan-device-connection-status.md) # Ajout de votre appareil sans fil à AWS IoT Core for LoRaWAN Si vous ajoutez votre appareil sans fil pour la première fois, nous vous recommandons d’utiliser la console. Accédez à la page [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing)**Introduction** de la AWS IoT console, choisissez **Commencer**, puis sélectionnez **Ajouter un appareil**. Si vous avez déjà ajouté un appareil, choisissez **Afficher l’appareil** pour afficher la passerelle que vous avez ajoutée. Si vous souhaitez ajouter d’autres appareils, choisissez **Ajouter un appareil**. Vous pouvez également ajouter des appareils sans fil depuis la page [ Appareils](https://console.aws.amazon.com/iot/home#/wireless/devices) de la console AWS IoT. ## Ajoutez les spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de la console Choisissez une **spécification d’appareil sans fil** en fonction de votre méthode d’activation et de la version LoRaWAN. Une fois sélectionnées, vos données sont chiffrées à l’aide d’une clé qu’AWS détient et gère pour vous. **Modes d’activation OTAA et ABP** Avant que votre appareil LoRaWAN puisse envoyer des données de liaison montante, vous devez effectuer un processus appelé procédure *d’activation* ou de *connexion*. Pour activer votre appareil, vous pouvez utiliser OTAA (activation par voie hertzienne) ou ABP (activation par personnalisation). ABP ne nécessite pas de procédure de jointure et utilise des clés statiques. Lorsque vous utilisez OTAA, votre appareil LoRaWAN envoie une demande de connexion et le serveur réseau peut autoriser la demande. Nous vous recommandons d’utiliser l’OTAA pour activer votre appareil, car de nouvelles clés de session sont générées à chaque activation, ce qui le rend plus sûr. **Version LoRaWAN** Lorsque vous utilisez OTAA, votre appareil LoRaWAN et les applications hébergées dans le cloud partagent les clés racines. Ces clés racines varient selon que vous utilisez la version v1.0.x ou v1.1. La version v1.0.x ne possède qu’une seule clé racine, **AppKey** (clé d’application), tandis que la version 1.1 possède deux clés racine, **AppKey** (clé d’application) et **NWKKey** (clé réseau). Les clés de session sont dérivées en fonction des clés racines de chaque activation. **NWKKey** et **AppKey** sont des valeurs hexadécimales à 32 chiffres fournies par votre fournisseur de services sans fil. **Les EUI d’appareil sans fil** Après avoir sélectionné la **spécification de l’appareil sans fil**, les paramètres EUI (Identifiant unique étendu) de l’appareil sans fil s’affichent sur la console. Vous trouverez ces informations dans la documentation de l’appareil ou du fournisseur du réseau sans fil. + **DevEUI** : valeur hexadécimale à 16 chiffres propre à votre appareil et figurant sur l’étiquette de l’appareil ou sur sa documentation. + **AppEUI** : valeur hexadécimale à 16 chiffres propre au serveur de jointure et figurant dans la documentation de l’appareil. Dans LoRaWAN version 1.1, la valeur **AppEUI** est appelée **JoinEUI**. Pour plus d’informations sur les identifiants uniques, les clés de session et les clés racine, consultez la documentation [LoRa Alliance](https://lora-alliance.org/about-lorawan). ## Ajout des spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de l’API Si vous ajoutez un appareil sans fil à l’aide de l’API, vous devez d’abord créer votre profil d’appareil et votre profil de service avant de créer l’appareil sans fil. Vous utiliserez le profil de l’appareil et l’ID du profil de service lors de la création de l’appareil sans fil. Pour plus d’informations sur la création de ces profils à l’aide de l’API, veuillez consulter [Ajout d’un profil d’appareil à l’aide de l’API](lorawan-define-profiles.md#lorawan-device-profile-api). Les listes suivantes décrivent les actions d’API qui exécutent les tâches associées à l’ajout, à la mise à jour ou à la suppression d’un profil de service. **Actions d’API AWS IoT Wireless pour les profils de service** + [Créer un appareil sans fil](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) + [GetWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) + [ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html) + [ UpdateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDevice.html) + [DeleteWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDevice.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser le AWS CLI pour créer un appareil sans fil** Vous pouvez utiliser le AWS CLI pour créer un appareil sans fil à l’aide de la commande [create-wireless-device](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). L’exemple suivant crée un appareil sans fil en utilisant un fichier input.json pour saisir les paramètres. **Note** Vous pouvez également effectuer cette procédure avec l’API en utilisant les méthodes de l’API AWS qui correspondent aux commandes d’interface de ligne de commande indiquées ici. **Contenu de input.json** ``` { "Description": "My LoRaWAN wireless device" "DestinationName": "IoTWirelessDestination" "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Name": "SampleIoTWirelessThing" "Type": LoRaWAN } ``` Vous pouvez fournir ce fichier comme entrée pour la commande `create-wireless-device`. ``` aws iotwireless create-wireless-device \ --cli-input-json file://input.json ``` Pour plus d’informations sur les CLI que vous pouvez utiliser, veuillez consulter la [AWS CLI référence](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) # Ajoutez des profils à AWS IoT Core for LoRaWAN Les profils d’appareils et de services peuvent être définis pour décrire les configurations courantes des appareils. Ces profils décrivent les paramètres de configuration partagés par les appareils afin de faciliter l’ajout de ces appareils. AWS IoT Core for LoRaWAN prend en charge les profils d’appareils et les profils de service. Les paramètres de configuration et les valeurs à saisir dans ces profils sont fournis par le fabricant de l’appareil. ## Ajout des profils d’appareil Les profils d’appareil définissent les capacités de l’appareil et les paramètres de démarrage que le serveur réseau utilise pour configurer le service d’accès radio LoRaWAN. Il inclut la sélection de paramètres tels que la bande de fréquence LoRa, la version des paramètres régionaux LoRa et la version MAC de l’appareil. Pour en savoir plus sur les différentes bandes de fréquences, veuillez consulter [Envisagez de sélectionner des bandes de fréquences LoRa pour vos passerelles et la connexion de vos appareils](lorawan-rfregion-permissions.md#lorawan-frequency-bands). ### Ajout d’un profil d’appareil à l’aide de la console Si vous ajoutez un appareil sans fil à l’aide de la console comme décrit dans[Ajoutez les spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de la console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), après avoir ajouté les spécifications de l’appareil sans fil, vous pouvez ajouter le profil de votre appareil. Vous pouvez également ajouter des appareils sans fil depuis la page [ Profils](https://console.aws.amazon.com/iot/home#/wireless/profiles) de la AWS IoT console sur l’onglet **LoRaWAN**. Vous pouvez choisir parmi les profils d’appareil par défaut ou créer un nouveau profil d’appareil. Nous vous recommandons d’utiliser les profils d’appareil par défaut. Si votre application vous demande de créer un profil d’appareil, fournissez un **nom de profil d’appareil**, sélectionnez la **bande de fréquence (RFRegion)** que vous utilisez pour l’appareil et la passerelle, et conservez les valeurs par défaut pour les autres paramètres, sauf indication contraire dans la documentation de l’appareil. ### Ajout d’un profil d’appareil à l’aide de l’API Si vous ajoutez un appareil sans fil à l’aide de l’API, vous devez créer le profil de votre appareil avant de créer l’appareil sans fil. Les listes suivantes décrivent les actions d’API qui exécutent les tâches associées à l’ajout, à la mise à jour ou à la suppression d’un profil de service. **Actions AWS IoT Wireless d’API pour les profils de service** + [Créer un profil d'appareil](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) + [GetDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) + [ListDeviceProfiles](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDeviceProfiles.html) + [ UpdateDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDeviceProfile.html) + [DeleteDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDeviceProfile.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser le AWS CLI pour créer un profil d’appareil** Vous pouvez utiliser le AWS CLI pour créer un profil d’appareil à l’aide de la commande [create-device-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). L’exemple suivant crée un profil d’appareil. ``` aws iotwireless create-device-profile ``` L’exécution de cette commande crée automatiquement un profil d’appareil avec un identifiant que vous pouvez utiliser lors de la création de l’appareil sans fil. Vous pouvez désormais créer le profil de service à l’aide de l’API suivante, puis créer l’appareil sans fil à l’aide des profils d’appareil et de service. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` Pour plus d’informations sur les CLI que vous pouvez utiliser, veuillez consulter la [AWS CLI référence](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) ## Ajout des profils de services Les profils de service décrivent les paramètres de communication dont l’appareil a besoin pour communiquer avec le serveur d’applications. ### Ajout d’un profil de service à l’aide de la console Si vous ajoutez un appareil sans fil à l’aide de la console comme décrit dans[Ajoutez les spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de la console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), après avoir ajouté le profil de l’appareil, vous pouvez ajouter votre profil de service. Vous pouvez également ajouter des appareils sans fil depuis la page [Profils](https://console.aws.amazon.com/iot/home#/wireless/profiles) de la AWS IoT console sur l’onglet **LoRaWAN**. Nous vous recommandons de laisser le paramètre **AddGWMetadata** activé afin de recevoir des métadonnées de passerelle supplémentaires pour chaque charge utile, telles que le RSSI et le SNR pour la transmission des données. ### Ajout d’un profil de service à l’aide de l’API Si vous ajoutez un appareil sans fil à l’aide de l’API, vous devez d’abord créer votre profil de service avant de créer l’appareil sans fil. Les listes suivantes décrivent les actions d’API qui exécutent les tâches associées à l’ajout, à la mise à jour ou à la suppression d’un profil de service. **Actions AWS IoT Wireless d’API pour les profils de service** + [Créer un profil de service](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html) + [GetServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html) + [ListServiceProfiles](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListServiceProfiles.html) + [UpdateServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateServiceProfile.html) + [DeleteServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteServiceProfile.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser le AWS CLI pour créer un profil de service** Vous pouvez utiliser le AWS CLI pour créer un service à l’aide de la commande [create-service-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-service-profile.html). L’exemple suivant crée un profil de service. ``` aws iotwireless create-service-profile ``` L’exécution de cette commande crée automatiquement un profil de service avec un identifiant que vous pouvez utiliser lors de la création de l’appareil sans fil. Vous pouvez désormais créer l’appareil sans fil à l’aide des profils d’appareil et de service. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` # Ajout de destinations à AWS IoT Core for LoRaWAN AWS IoT Core pour les destinations LoRaWAN, décrivez la règle AWS IoT qui traite les données d’un appareil à des fins d’utilisation par les services AWS. Étant donné que la plupart des appareils LoRaWAN n’envoient pas de données vers AWS IoT Core pour LoRaWAN dans un format utilisable par les services AWS, une règle AWS IoT doit d’abord les traiter. La règle AWS IoT contient l’instruction SQL qui interprète les données de l’appareil et les actions de règle de rubrique qui envoient le résultat de l’instruction SQL aux services qui l’utiliseront. Si vous ajoutez votre destination pour la première fois, nous vous recommandons d’utiliser la console. ## Ajout d’une destination à l’aide de la console Si vous ajoutez un appareil sans fil à l’aide de la console comme décrit dans[Ajoutez les spécifications de votre appareil sans fil à AWS IoT Core for LoRaWAN à l’aide de la console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), après avoir déjà ajouté les spécifications et les profils de l’appareil sans fil à AWS IoT Core for LoRaWAN comme décrit précédemment, vous pouvez continuer et ajouter une destination. Vous pouvez également ajouter une destination AWS IoT Core for LoRaWAN depuis la page [Destinations](https://console.aws.amazon.com/iot/home#/wireless/destinations) de la console AWS IoT. Pour traiter les données d’un appareil, spécifiez les champs suivants lors de la création d’une destination AWS IoT Core pour LoRaWAN, puis choisissez **Ajouter une destination**. + **Détails de la destination** Entrez un **nom de destination** et une description facultative pour votre destination. + **Nom de la règle** La règle AWS IoT configurée pour évaluer les messages envoyés par votre appareil et traiter les données de celui-ci. Le nom de la règle sera mappé à votre destination. La destination a besoin de la règle pour traiter les messages qu’elle reçoit. Vous pouvez choisir de traiter les messages en invoquant une règle AWS IoT ou en les publiant sur l’agent de messages AWS IoT. + Si vous choisissez **Entrez un nom de règle**, entrez un nom, puis choisissez **Copier** pour copier le nom de règle que vous allez entrer lors de la création de la règle AWS IoT. Vous pouvez soit choisir **Créer une règle** pour créer la règle maintenant, soit accéder au centre de [règles](https://console.aws.amazon.com/iot/home#/create/rule) de la AWS IoT console et créer une règle portant ce nom. Vous pouvez également entrer une règle et utiliser le paramètre **Avancé** pour spécifier un nom de rubrique. Le nom du sujet est fourni lors de l’invocation de la règle et est accessible à l’aide de l’`topic`expression topic contenue dans la règle. Pour plus d’informations sur les règles du AWS IoT, consultez [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html). + Si vous choisissez **Publier sur AWS IoT l’agent de messages**, entrez le nom du sujet. Vous pouvez ensuite copier le nom du sujet MQTT et plusieurs abonnés peuvent s’abonner à ce sujet pour recevoir les messages publiés sur ce sujet. Pour en savoir plus, consultez [https://docs.aws.amazon.com/iot/latest/developerguide/topics.html](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html). Pour plus d’informations sur les règles AWS IoT, veuillez consulter [Créez des règles pour traiter les messages des appareils LoRaWAN](lorawan-destination-rules.md). + **Nom du rôle** Le rôle IAM qui autorise les données de l’appareil à accéder à la règle nommée dans **Nom de la règle**. Dans la console, vous pouvez créer une nouvelle fonction du service ou sélectionner une fonction du service existant. Si vous créez un nouvelle fonction du service, vous pouvez soit entrer un nom de rôle (par exemple,**IoTWirelessDestinationRole**), soit le laisser vide AWS IoT Core for LoRaWAN pour générer un nouveau nom de rôle. AWS IoT Core for LoRaWAN créera ensuite automatiquement le rôle IAM avec les autorisations appropriées en votre nom. Pour plus d’informations sur les rôles IAM, veuillez consulter [Utilisation de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html). ## Ajout d’une destination à l’aide de l’API Si vous souhaitez plutôt ajouter une destination à l’aide de la CLI, vous devez déjà avoir créé la règle et le rôle IAM pour votre destination. Pour plus d’informations sur les détails dont une destination a besoin dans le rôle, veuillez consulter [Création d’un rôle IAM pour vos destinations](#lorawan-create-destinations-roles). La liste suivante contient les actions d’API qui exécutent les tâches associées à l’ajout, à la mise à jour ou à la suppression d’une destination. **Actions d’API AWS IoT Wireless pour les destinations** + [Créer une destination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) + [GetDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDestination.html) + [ListDestinations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDestinations.html) + [ UpdateDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDestination.html) + [DeleteDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDestination.html) Pour obtenir la liste complète des actions et des types de données disponibles pour créer et gérer des ressources AWS IoT Core for LoRaWAN, veuillez consulter la [AWS IoT Wirelessréférence de l’API](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Comment utiliser le AWS CLI pour ajouter une destination** Vous pouvez utiliser le AWS CLI pour ajouter une destination à l’aide de la commande [create-destination.](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-destination.html) L’exemple suivant montre comment créer une destination en saisissant le nom d’une règle `RuleName` à l’aide de la valeur du paramètre `expression-type`. Si vous souhaitez spécifier un nom de rubrique pour la publication ou l’abonnement à l’agent de messages, remplacez la valeur du paramètre `expression-type` par `MqttTopic` d. ``` aws iotwireless create-destination \ --name IoTWirelessDestination \ --expression-type RuleName \ --expression IoTWirelessRule \ --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole ``` L’exécution de cette commande crée une destination avec le nom de destination, le nom de règle et le nom de rôle spécifiés. Pour plus d’informations sur les noms de règles et de rôles pour les destinations, veuillez consulter [Créez des règles pour traiter les messages des appareils LoRaWAN](lorawan-destination-rules.md) et [Création d’un rôle IAM pour vos destinations](#lorawan-create-destinations-roles). Pour plus d’informations sur les CLI que vous pouvez utiliser, veuillez consulter la [AWS CLIréférence](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html). ## Création d’un rôle IAM pour vos destinations Les destinations AWS IoT Core for LoRaWAN nécessitent des rôles IAM qui donnent à AWS IoT Core for LoRaWAN les autorisations nécessaires pour envoyer des données à la règle AWS IoT. Si un tel rôle n’est pas déjà défini, vous devez le définir pour qu’il apparaisse dans la liste des rôles. Lorsque vous utilisez la console pour ajouter une destination, AWS IoT Core for LoRaWAN crée automatiquement un rôle IAM pour vous, comme décrit précédemment dans cette rubrique. Lorsque vous ajoutez une destination à l’aide de l’API ou de la CLI, vous devez créer le rôle IAM pour votre destination. **Création d’une politique IAM pour votre rôle de destination AWS IoT Core for LoRaWAN** 1. Ouvrez la page [Centre de politiques de la console IAM](https://console.aws.amazon.com/iam/home#/policies). 1. Sélectionnez **Créer une politique**, puis l’onglet **JSON**. 1. Dans l’éditeur, supprimez tout contenu de l’éditeur et collez ce document de politique. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:DescribeEndpoint", "iot:Publish" ], "Resource": "*" } ] } ``` 1. Choisissez **Réviser la politique**, puis dans l’onglet **Nom**, entrez un nom pour la politique. Vous avez besoin de ce nom pour l’utiliser dans la procédure suivante. Vous pouvez également décrire cette politique dans **Description**, si vous le souhaitez. 1. Sélectionnez **Créer une politique**. **Création d’un rôle IAM pour votre rôle de destination AWS IoT Core for LoRaWAN** 1. Ouvrez la page [ Centre de rôles de la console IAM](https://console.aws.amazon.com/iam/home#/roles) et choisissez **Créer un rôle**. 1. Dans l’onglet **Sélectionner le type d’entité d’approbation**, choisissez **Autre Compte AWS**. 1. Dans **ID de compte**, entrez votre Compte AWS identifiant, puis choisissez **Suivant : Autorisations**. 1. Dans le champ de recherche, entrez le nom de la politique IAM que vous avez créée dans la procédure précédente. 1. Dans les résultats de la recherche, vérifiez la politique IAM que vous avez créée dans la procédure précédente. 1. Sélectionnez **Suivant : Balises**, puis **Suivant : Vérification)**. 1. Dans l’onglet **Nom du rôle**, saisissez un nom pour votre rôle, puis sélectionnez **Créer un rôle**. 1. Dans le message de confirmation, sélectionnez le nom du rôle que vous avez créé pour modifier le nouveau rôle. 1. Dans **Récapitulatif**, choisissez l’onglet **Relations d’approbation**, puis choisissez **Modifier la relation d’approbation**. 1. Dans l’onglet **Document de politique**, modifiez la `Principal` propriété pour qu’elle ressemble à cet exemple. ``` "Principal": { "Service": "iotwireless.amazonaws.com" }, ``` Après avoir modifié la `Principal` propriété, le document de politique complet doit ressembler à cet exemple. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotwireless.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Pour enregistrer vos modifications et quittez, sélectionnez **Mettre à jour la politique d’approbation**. Une fois ce rôle défini, vous pouvez le retrouver dans la liste des rôles lorsque vous configurez vos destinations AWS IoT Core for LoRaWAN. # Créez des règles pour traiter les messages des appareils LoRaWAN Les règles AWS IoT envoient des messages de l’appareil à d’autres services. Les règles AWS IoT peuvent également traiter les messages binaires reçus d’un appareil LoRaWAN afin de les convertir dans d’autres formats afin de faciliter leur utilisation par d’autres services. AWS IoT Core for LoRaWANLes [destinations](lorawan-create-destinations.md) associent un appareil sans fil à la règle qui traite les données des messages de l’appareil pour les envoyer à d’autres services. La règle agit sur les données de l’appareil dès que AWS IoT Core for LoRaWAN les reçoit. AWS IoT Core for LoRaWANLes [destinations](lorawan-create-destinations.md) peuvent être partagées par tous les appareils dont les messages ont le même format de données et qui envoient leurs données au même service. ## Comment les règles AWS IoT traitent les messages de l’appareil La manière dont une règle AWS IoT traite les données des messages d’un appareil dépend du service qui recevra les données, du format des données des messages de l’appareil et du format de données requis par le service. Généralement, la règle appelle une fonction AWS Lambda pour convertir les données des messages de l’appareil au format requis par un service, puis envoie le résultat au service. L’illustration suivante montre comment les données des messages sont sécurisées et traitées lorsqu’elles sont transférées de l’appareil sans fil vers un service AWS. ![\[Image montrant comment les données AWS IoT Core for LoRaWAN sont transmises d’un appareil sans fil à AWS IoT et d’autres services.\]](http://docs.aws.amazon.com/fr_fr/iot-wireless/latest/developerguide/images/iot-lorawan-data-flow.png) 1. L’appareil sans fil LoRaWAN chiffre ses messages binaires en utilisant le mode CTR AES128 avant de les transmettre. 1. AWS IoT Core for LoRaWAN déchiffre le message binaire et code la charge utile du message binaire déchiffré sous forme de chaîne base64. 1. Le message codé en base64 qui en résulte est envoyé sous forme de charge utile de message (non formatée en tant que document JSON) à la règle AWS IoT décrite dans la destination attribuée à l’appareil. 1. La règle AWS IoT dirige les données du message vers le service décrit dans la configuration de la règle. La charge utile binaire cryptée reçue du dispositif sans fil n’est ni modifiée ni interprétée par AWS IoT Core for LoRaWAN. La charge utile du message binaire déchiffré est codée uniquement sous forme de chaîne base64. Pour que les services puissent accéder aux éléments de données de la charge utile du message binaire, les éléments de données doivent être extraits de la charge utile par une fonction appelée par la règle. La charge utile du message codé en base64 est une chaîne ASCII, elle peut donc être stockée en tant que telle pour être analysée ultérieurement. ## Création de règles pour les appareils LoRaWAN AWS IoT Core for LoRaWAN utilise des règles AWS IoT pour envoyer en toute sécurité des messages de l’appareil directement à d’autres services AWS sans qu’il soit nécessaire d’utiliser l’agent de messages. En supprimant l’agent de messages du chemin d’ingestion, il réduit les coûts et optimise le flux de données. Pour qu’une règle AWS IoT Core for LoRaWAN envoie des messages de terminal à d’autres services AWS, elle nécessite une destination AWS IoT Core for LoRaWAN et une règle AWS IoT assignée à cette destination. La règle AWS IoT doit contenir une instruction de requête SQL et au moins une action de règle. Généralement, l’instruction de requête de la règle AWS IoT est composée des éléments suivants : + Une clause SQL SELECT qui sélectionne et met en forme les données de la charge utile du message + Un filtre de rubrique (l’objet FROM dans l’instruction de requête de règle) qui identifie les messages à utiliser + Une instruction conditionnelle facultative (une clause SQL WHERE) qui spécifie les conditions dans lesquelles agir L’instruction de requête de règle est présentée ci-dessous : ``` SELECT temperature FROM iot/topic' WHERE temperature > 50 ``` Lorsque vous créez des règles AWS IoT pour traiter les charges utiles des appareils LoRaWAN, il n’est pas nécessaire de spécifier la clause FROM dans le cadre de l’objet de requête de règles. L’instruction de requête de règle doit comporter la clause SQL SELECT et peut éventuellement contenir la clause WHERE. Si l’instruction de requête utilise la clause FROM, elle est ignorée. Voici un exemple d’instruction de requête de règle capable de traiter les charges utiles des appareils LoRaWAN : ``` SELECT WirelessDeviceId, WirelessMetadata.LoRaWAN.FPort as FPort, WirelessMetadata.LoRaWAN.DevEui as DevEui, PayloadData ``` Dans cet exemple, `PayloadData` est une charge utile binaire codée en base64 envoyée par votre appareil LoRaWAN. Voici un exemple d’instruction de requête de règle qui permet d’effectuer un décodage binaire de la charge utile entrante et de la transformer dans un format différent tel que JSON : ``` SELECT WirelessDeviceId, WirelessMetadata.LoRaWAN.FPort as FPort, WirelessMetadata.LoRaWAN.DevEui as DevEui, aws_lambda("arn:aws:lambda:::function:", { "PayloadData":PayloadData, "Fport": WirelessMetadata.LoRaWAN.FPort }) as decodingoutput ``` Pour plus d’informations sur l’utilisation des clauses SELECT AND WHERE, consultez [https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-reference.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-reference.html) Pour plus d’informations sur les règles AWS IoT et la façon de les créer et les utiliser, veuillez consulter le [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) et [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules-tutorial.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules-tutorial.html). Pour plus d’informations sur la création et l’utilisation des destinations AWS IoT Core for LoRaWAN, veuillez consulter [Ajout de destinations à AWS IoT Core for LoRaWAN](lorawan-create-destinations.md). Pour plus d’informations sur l’utilisation de charges utiles de messages binaires dans une règle, veuillez consulter [https://docs.aws.amazon.com/iot/latest/developerguide/binary-payloads.html](https://docs.aws.amazon.com/iot/latest/developerguide/binary-payloads.html). Pour plus d’informations sur la sécurité des données et le chiffrement utilisés pour protéger la charge utile des messages pendant leur trajet, veuillez consulter [Protection des données dans AWS IoT Wireless](data-protection.md). Pour une architecture de référence présentant un exemple de décodage binaire et de mise en œuvre des règles IoT, veuillez consulter [AWS IoT Core for LoRaWANExemples de solutions sur GitHub](https://github.com/aws-samples/aws-iot-core-lorawan/tree/main/transform_binary_payload). # Connectez votre appareil LoRaWAN et vérifiez son état de connexion. Avant de pouvoir vérifier l’état de connexion de l’appareil, vous devez avoir déjà ajouté votre appareil et l’avoir connecté à AWS IoT Core for LoRaWAN. Pour plus d’informations sur l’ajout de votre appareil, veuillez consulter [Ajout de votre appareil sans fil à AWS IoT Core for LoRaWAN](lorawan-end-devices-add.md). Après avoir ajouté votre appareil, consultez le manuel d’utilisation de celui-ci pour savoir comment lancer l’envoi d’un message de liaison montante depuis votre appareil LoRaWAN. ## Vérifier l’état de connexion de l’appareil à l’aide de la console Pour vérifier l’état de la connexion à l’aide de la console, accédez à la page [https://console.aws.amazon.com/iot/home#/wireless/devices](https://console.aws.amazon.com/iot/home#/wireless/devices) de la console AWS IoT et choisissez l’appareil que vous avez ajouté. Dans la section **Détails** de la page de détails des appareils sans fil, vous verrez la date et l’heure de réception de la dernière liaison montante. ## Vérifiez l’état de connexion de l’appareil à l’aide de l’API Pour vérifier l’état de connexion à l’aide de l’API, utilisez l’API `GetWirelessDeviceStatistics`. Cette API n’a pas de corps de demande et contient uniquement un corps de réponse qui indique quand la dernière liaison montante a été reçue. ``` HTTP/1.1 200 Content-type: application/json { “LastUplinkReceivedAt”: “2021-03-24T23:13:08.476015749Z”, "LoRaWAN": { "DataRate": 5, "DevEui": "647fda0000006420", "Frequency": 868100000 "Gateways": [ { "GatewayEui": "c0ee40ffff29df10", "Rssi": -67, "Snr": 9.75 } ], “WirelessDeviceId”: “30cbdcf3-86de-4291-bfab-5bfa2b12bad5" } ``` ## Étapes suivantes Maintenant que vous avez connecté votre appareil et vérifié l’état de la connexion, vous pouvez observer le format des métadonnées de liaison montante reçues de l’appareil en utilisant le [client de test MQTT](https://console.aws.amazon.com/iot/home#/test) sur la page **Test** de la console. AWS IoT Pour en savoir plus, consultez [Afficher le format des messages de liaison montante envoyés depuis des appareils LoRaWAN](lorawan-uplink-metadata-format.md).