

# Ajout de votre appareil sans fil à AWS IoT Core for LoRaWAN
<a name="lorawan-end-devices-add"></a>

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
<a name="lorawan-end-device-spec-console"></a>

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
<a name="lorawan-end-device-spec-api"></a>

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) 