

# Aggiungi il dispositivo wireless ad AWS IoT Core per LoRaWAN
<a name="lorawan-end-devices-add"></a>

Se stai aggiungendo il dispositivo wireless per la prima volta, ti consigliamo di utilizzare la console. Naviga sulla pagina **Intro** [AWS IoT Core per LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing) della console AWS IoT, scegli **Get started (Nozioni di base)**, quindi scegli **Add device (Aggiungi dispositivo)**. Se hai già aggiunto un dispositivo, scegli **View device (Visualizza il dispositivo)** per visualizzare il gateway aggiunto. Se desideri aggiungere altri dispositivi, scegli **Add device (Aggiungi dispositivo)**.

In alternativa, puoi anche aggiungere dispositivi wireless dalla pagina [ Devices (Dispositivi)](https://console.aws.amazon.com/iot/home#/wireless/devices) della console AWS IoT.

## Aggiungi le specifiche del dispositivo wireless ad AWS IoT Core per LoRaWAN utilizzando la console
<a name="lorawan-end-device-spec-console"></a>

Scegli una **Specificazione del dispositivo wireless** in base al tuo metodo di attivazione e alla versione LoRaWAN. Una volta selezionati, i dati vengono crittografati con una chiave che AWS possiede e gestisce per te. 

**Modalità di attivazione OTAA e ABP**  
Prima che il tuo dispositivo LoRaWAN possa inviare dati uplink, devi completare un processo chiamato *Attivazione* o *Procedura join*. Per attivare il dispositivo, è possibile utilizzare OTAA (attivazione per via etere) o ABP (Attivazione per personalizzazione).

ABP non richiede una procedura di join e utilizza chiavi statiche. Quando si utilizza OTAA, il dispositivo LoRaWAN invia una richiesta di join e il server di rete può permettere la richiesta. Si consiglia di utilizzare OTAA per attivare il dispositivo in quanto vengono generate nuove chiavi di sessione per ogni attivazione così da renderlo più sicuro.

**Versione di LoRaWAN**  
Quando utilizzi OTAA, il dispositivo LoRaWAN e le applicazioni ospitate nel cloud condividono le chiavi di root. Queste chiavi di root dipendono dal fatto che tu stia utilizzando la versione v1.0.x o v1.1. v1.0.x ha solo una chiave di root, **AppKey** (Chiave applicazione) mentre v1.1 ha due chiavi root, **AppKey** (Chiave applicazione) e **NwkKey** (Chiave di rete). Le chiavi di sessione sono derivate in base alle chiavi di root per ogni attivazione. Sia **NwkKey** che **AppKey** sono valori esadecimali a 32 cifre forniti dal fornitore wireless.

**EUI del dispositivo wireless**  
Dopo aver selezionato l'opzione **Wireless device specification (Specificazione del dispositivo wireless)**, vengono visualizzati i parametri EUI (Extended Unique Identifier) per il dispositivo wireless sulla console. Puoi trovare queste informazioni sulla documentazione relativa al dispositivo o al fornitore wireless.
+ **DevEUI**: valore esadecimale a 16 cifre univoco per il dispositivo e trovato sull'etichetta del dispositivo o sulla relativa documentazione.
+ **AppEUI**: valore esadecimale a 16 cifre univoco per il server di join e trovato nella documentazione del dispositivo. Nella versione v1.1 di LoRaWAN, **AppEUI** viene chiamato **JoinEUI**.

Per ulteriori informazioni sugli identificatori univoci, le chiavi di sessione e le chiavi root, fai riferimento alla documentazione della [ LoRa Alliance](https://lora-alliance.org/about-lorawan).

## Aggiungere le specifiche del dispositivo wireless ad AWS IoT Core per LoRaWAN utilizzando l'API
<a name="lorawan-end-device-spec-api"></a>

Se stai aggiungendo un dispositivo wireless utilizzando l'API, prima di creare il dispositivo wireless devi creare il tuo profilo di servizio e dispositivo. Utilizzerai il profilo del dispositivo e l'ID profilo del servizio durante la creazione del dispositivo wireless. Per informazioni su come creare questi profili usando l'API, consulta [Aggiungi un profilo del dispositivo utilizzando l'API](lorawan-define-profiles.md#lorawan-device-profile-api).

Negli elenchi seguenti vengono descritte le operazioni API che eseguono le attività associate all'aggiunta, all'aggiornamento o all'eliminazione di un profilo di servizio.

**Operazioni API Wireless AWS IoT per i profili di servizio**
+ [CreateWirelessDevice](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)

Per l'elenco completo delle operazioni e dei tipi di dati disponibili per creare e gestire le risorse AWS IoT Core per LoRaWAN, consulta la [documentazione di riferimento delle API Wireless AWS IoT](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html)

**Come utilizzare AWS CLI per creare un dispositivo wireless**  
Puoi utilizzare AWS CLI per creare un dispositivo wireless utilizzando il comando [create-wireless-device](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). L'esempio seguente crea un dispositivo wireless utilizzando un file input.json per immettere i parametri.

**Nota**  
È inoltre possibile eseguire questa procedura con l'API utilizzando i metodi dell'API AWS corrispondenti ai comandi CLI illustrati di seguito. 

**Contenuto di 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
}
```

È possibile fornire questo file come input per il comando `create-wireless-device`.

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

Per informazioni sulle CLI utilizzabili, consulta [Riferimento AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) 