

# Comment utiliser le support du réseau public
<a name="lorawan-roaming-use"></a>

Pour activer la prise en charge du réseau public d’Everynet, activez certains paramètres d’itinérance lors de la création du profil de service. Dans cette version bêta, ces paramètres sont disponibles lorsque vous utilisez l’API AWS IoT Wireless ou AWS CLI. Les sections suivantes indiquent les paramètres que vous devez activer et comment activer le réseau public à l’aide d’AWS CLI.

**Note**  
Vous ne pouvez activer le support du réseau public que lors de la création d'un nouveau profil de service. Vous ne pouvez pas mettre à jour un profil existant pour activer le réseau public à l'aide de ces paramètres.

**Topics**
+ [Paramètres d'itinérance](#lorawan-roaming-parameters)
+ [Activer la prise en charge des appareils par le réseau public](#lorawan-roaming-enable)

## Paramètres d'itinérance
<a name="lorawan-roaming-parameters"></a>

Spécifiez les paramètres suivants lors de la création d'un profil de service pour votre appareil. Spécifiez ces paramètres lors de l’ajout d’un profil de service à partir du hub [Profils](https://console.aws.amazon.com/iot/home#/wireless/profiles) de la console AWS IoT, ou en utilisant l’opération d’API AWS IoT Wireless, [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html) ou la commande AWS CLI, [https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html).

**Note**  
AWS IoT Core for LoRaWAN ne prend pas en charge le transfert en itinérance. Lors de la création du profil de service, vous ne pouvez pas activer le paramètre `HrAllowed` qui indique s'il faut utiliser l'itinérance de transfert.
+ Activation de l'itinérance autorisée (`RaAllowed`) : ce paramètre indique s'il faut activer l'itinérance. L'activation de l'itinérance permet à un terminal de s'activer sous la couverture d'un vNS. Lorsque vous utilisez la fonctionnalité d'itinérance, `RaAllowed` doit être réglée sur `true`.
+ Itinérance passive autorisée (`PrAllowed`) : ce paramètre indique s'il faut activer l'itinérance passive. Lorsque vous utilisez la fonctionnalité d'itinérance, `PrAllowed` doit être réglée sur `true`.

## Activer la prise en charge des appareils par le réseau public
<a name="lorawan-roaming-enable"></a>

Pour activer la prise en charge du réseau LoRaWAN public sur vos appareils, exécutez la procédure suivante.

**Note**  
Vous ne pouvez activer la fonctionnalité de réseau public que pour les appareils OTAA. Cette fonctionnalité n'est pas prise en charge pour les appareils qui utilisent ABP comme méthode d'activation.

1. 

**Création d'un profil de service avec des paramètres d'itinérance**

   Créez un profil de service en activant les paramètres d'itinérance.
**Note**  
Lorsque vous créez un profil d'appareil pour l'appareil que vous associerez à ce profil de service, nous vous recommandons de spécifier une valeur élevée pour le paramètre `RxDelay1` , au moins supérieure à 2s.
   + 

**Utilisation de la console AWS IoT**  
Accédez aux [Profiles](https://console.aws.amazon.com/iot/home#/wireless/profiles) hub de la console AWS IoT et choisissez **Ajouter un profil de service**. Lors de la création du profil, sélectionnez **Activer le réseau public**.
   + 

**Utilisation de l'API AWS IoT Wireless**  
Pour activer l’itinérance lors de la création d’un profil de service, utilisez l’opération d’API [CreateServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html) ou la commande d’interface de ligne de commande [https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html), comme illustré dans l’exemple ci-dessous.

     ```
     aws iotwireless create-service-profile \ 
         --region us-east-1 \
         --name roamingprofile1 \ 
         --lorawan '{"AddGwMetadata":true,"PrAllowed":true,"RaAllowed":true}'
     ```

     L'exécution de cette commande renvoie l'ARN et l'ID du profil de service en sortie.

     ```
     {
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
     }
     ```

1. 

**Vérifier les paramètres d'itinérance dans le profil de service**

   Pour vérifier les paramètres d'itinérance que vous avez spécifiés, vous pouvez consulter le profil de service dans la console ou à l'aide de la commande CLI `get-service-profile`, comme illustré dans l'exemple ci-dessous.
   + 

**Utilisation de la console AWS IoT**  
Accédez aux [Profiles](https://console.aws.amazon.com/iot/home#/wireless/profiles) hub de la console AWS IoT et et choisissez le profil que vous avez créé. Dans l'onglet **Configuration du profil** de la page de détails, vous verrez que **RAAllowed et PRAllowed** **sont** définis sur `true`.
   + 

**Utilisation de l'API AWS IoT Wireless**  
Pour afficher les paramètres d'itinérance que vous avez activés, utilisez l'opération d'API [GetServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html) ou la commande CLI[https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html), comme illustré dans l'exemple ci-dessous.

     ```
     aws iotwireless get-service-profile \ 
         --region us-east-1 \ 
         --id 12345678-a1b2-3c45-67d8-e90fa1b2c34d
     ```

     L'exécution de cette commande renvoie les détails du profil de service en sortie, y compris les valeurs des paramètres d'itinérance, `RaAllowed` et`PrAllowed`.

     ```
     {
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
         "Name": "roamingprofile1"
         "LoRaWAN": {
             "UlRate": 60,
             "UlBucketSize": 4096,
             "DlRate": 60,
             "DlBucketSize": 4096,
             "AddGwMetadata": true,
             "DevStatusReqFreq": 24,
             "ReportDevStatusBattery": false,
             "ReportDevStatusMargin": false,
             "DrMin": 0,
             "DrMax": 15,
             "PrAllowed": true,
             "RaAllowed": true,
             "NwkGeoLoc": false,
             "TargetPer": 5,
             "MinGwDiversity": 1
         }
     }
     ```

1. 

**Associer un profil de service aux appareils**

   Associez le profil de service que vous avez créé avec les paramètres d'itinérance à vos terminaux. Vous pouvez également créer un profil d'appareil et ajouter une destination pour vos appareils sans fil. Vous utiliserez cette destination pour acheminer les messages en liaison montante envoyés depuis votre appareil. Pour plus d'informations sur la création de profils d'appareils et d'une destination, consultez [Ajout des profils d’appareil](lorawan-define-profiles.md#lorawan-device-profiles) et[Ajout de destinations à AWS IoT Core for LoRaWAN](lorawan-create-destinations.md).
   + 

**Intégration de nouveaux appareils**  
Si vous n'avez pas encore intégré vos appareils, vous spécifiez ce profil de service à utiliser lors de l'ajout à AWS IoT Core for LoRaWAN. La commande suivante montre comment utiliser la commande CLI `create-wireless-device` pour ajouter un périphérique à l'aide de l'ID du profil de service que vous avez créé. Pour plus d’informations sur l’ajout du profil de service à l’aide de la console, consultez [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).

     ```
     aws iotwireless create-wireless-device --cli-input-json file://createdevice.json
     ```

     L’exemple suivant affiche le contenu du fichier *`createdevice.json`*.

     **Contenu de createdevice.json**

     ```
     {
         "Name": "DeviceA",  
         "Type": LoRaWAN,
         "DestinationName": "RoamingDestination1",
         "LoRaWAN": {
             "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
             "ServiceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d",
             "OtaaV1_1": {
                 "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
                 "JoinEui": "b4c231a359bc2e3d",
                 "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
             },
             "DevEui": "ac12efc654d23fc2"
         },
     }
     ```

     Le résultat de l'exécution de cette commande produit l'ARN et l'ID du périphérique sans fil en sortie.

     ```
     {
         "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f",
         "Id": "1ffd32c8-8130-4194-96df-622f072a315f"
     }
     ```
   + 

**Mise à jour des appareils existants**  
Si vous avez déjà intégré vos appareils, vous pouvez mettre à jour vos appareils sans fil existants pour utiliser ce profil de service. La commande suivante montre comment utiliser la commande CLI `update-wireless-device` pour mettre à jour un appareil à l'aide de l'ID du profil de service que vous avez créé.

     ```
     aws iotwireless update-wireless-device \
         --id "1ffd32c8-8130-4194-96df-622f072a315f" \
         --service-profile-id "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \ 
         --description "Using roaming service profile A"
     ```

     Cette commande ne produit aucune sortie. Vous pouvez utiliser l'API `GetWirelessDevice` ou la commande CLI `get-wireless-device` pour obtenir les informations mises à jour.

1. 

**Connectez l'appareil au cloud à l'aide d'Everynet**

   L'itinérance ayant été activée, votre appareil doit désormais effectuer une jointure pour en obtenir une nouvelle `DevAddr`. Si vous utilisez OTAA, votre appareil LoRaWAN envoie une demande de connexion et le serveur réseau peut autoriser la demande. Il peut ensuite se connecter à AWS Cloud à l'aide de la couverture réseau fournie par Everynet. Pour savoir comment effectuer la procédure d'activation ou s'inscrire pour votre appareil, consultez la documentation de l'appareil.
**Note**  
Vous pouvez activer la fonctionnalité d'itinérance et vous connecter au réseau public uniquement pour les appareils qui utilisent OTAA comme méthode d'activation. Les appareils ABP ne sont pas pris en charge. Pour savoir comment effectuer la procédure d'activation ou s'inscrire pour votre appareil, consultez la documentation de l'appareil. Consultez [Modes d'activation](lorawan-manage-end-devices.md#lorawan-activation-modes). 
Pour désactiver la fonctionnalité d'itinérance de vos appareils, vous pouvez dissocier les appareils de ce profil de service, puis les associer à un autre profil de service dont les paramètres d'itinérance sont définis sur `false`. Une fois que vous êtes passé à ce profil de service, vos appareils doivent effectuer une nouvelle connexion afin de ne pas continuer à fonctionner sur le réseau public.

1. 

**Échangez des messages en liaison montante et descendante**

   Une fois que votre appareil s'est connecté à AWS IoT Core for LoRaWAN, vous pouvez commencer à échanger des messages entre votre appareil et le Cloud.
   + 

**Afficher les messages par liaison montante**  
Lorsque vous envoyez des messages en liaison montante depuis vos appareils, AWS IoT Core for LoRaWAN transmet Compte AWS en utilisant la destination que vous avez configurée précédemment. Ces messages seront envoyés depuis votre appareil vers le Cloud via le réseau Everynet.

     Vous pouvez afficher les messages en utilisant le nom de la règle AWS IoT ou utiliser le client MQTT pour vous abonner à la rubrique MQTT spécifiée lors de la création de la destination. Pour plus d'informations sur le nom de la règle et autres détails de destination que vous spécifiez, consultez [Ajout d’une destination à l’aide de la console](lorawan-create-destinations.md#lorawan-create-destination-console).

     Pour plus d'informations sur l'affichage du message de liaison montante et son format, consultez [Afficher le format des messages de liaison montante envoyés depuis des appareils LoRaWAN](lorawan-uplink-metadata-format.md).
   + 

**Envoi de messages de liaison descendante**  
Vous pouvez mettre en file d'attente et envoyer des messages de liaison descendante à vos appareils depuis la console, ou en utilisant la commande AWS IoT Wireless API`SendDataToWirelessDevice`, ou la AWS CLI commande,`send-data-to-wireless-device`. Pour plus d'informations sur la mise en file d'attente et l'envoi de messages de liaison descendante, consultez [Mettre en file d'attente les messages de liaison descendante à envoyer aux appareils LoRaWAN](lorawan-downlink-queue.md).

     Le code suivant montre un exemple de la manière dont vous pouvez envoyer un message de liaison descendante à l'aide de la commande CLI `send-data-to-wireless-device`. Vous spécifiez l'ID du périphérique sans fil devant recevoir les données, la charge utile, l'utilisation du mode d'accusé de réception et les métadonnées sans fil.

     ```
     aws iotwireless send-data-to-wireless-device \
         --id "1ffd32c8-8130-4194-96df-622f072a315f" \
         --transmit-mode "1" \
         --payload-data "SGVsbG8gVG8gRGV2c2lt" \
         --wireless-metadata LoRaWAN={FPort=1}
     ```

     La sortie de l’exécution de cette commande génère un `MessageId` pour le message en liaison descendante.
**Note**  
Dans certains cas, même si vous les recevez le `MessageId`, les paquets peuvent être supprimés. Pour plus d'informations sur le dépannage de tels scénarios et leur résolution, consultez [Résoudre les erreurs de la file d’attente de messages en liaison descendante](lorawan-downlink-queue.md#lorawan-downlink-queue-troubleshoot).

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

**Afficher les informations de couverture**  
Après avoir activé le réseau public, vous pouvez consulter les informations de couverture du réseau dans la console AWS IoT. Accédez au hub de [https://console.aws.amazon.com/iot/home#/wireless/network-coverage](https://console.aws.amazon.com/iot/home#/wireless/network-coverage) de la AWS IoT console, puis recherchez des emplacements pour voir les informations de couverture de vos appareils sur la carte.
**Note**  
Cette fonctionnalité utilise le Amazon Location Service pour afficher les informations de couverture de vos appareils sur une carte de localisation Amazon. Avant d'utiliser les cartes de localisation Amazon, consultez les conditions générales d'Amazon Location Service. Notez que vos requêtes d'API AWS peuvent être transmises au fournisseur de données tiers que vous avez choisi, qui peut être autre que Région AWS que vous utilisez actuellement. Pour plus d'informations, consultez [Conditions de service AWS](https://aws.amazon.com/service-terms).