

# Adicione o dispositivo sem fio ao AWS IoT Core for LoRaWAN
<a name="lorawan-end-devices-add"></a>

Se você estiver adicionando o dispositivo sem fio pela primeira vez, recomendamos usar o console. Navegue até a página **Introdução** ao [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing) do console de AWS IoT, escolha **Iniciar** e, em seguida, escolha **Adicionar dispositivo**. Se você já adicionou um dispositivo, escolha **Exibir dispositivo** para ver o gateway que foi adicionado. Se você quiser adicionar mais dispositivos, escolha **Adicionar dispositivo**.

Como alternativa, você também pode adicionar dispositivos sem fio da página [Dispositivos](https://console.aws.amazon.com/iot/home#/wireless/devices) do console de AWS IoT.

## Adicione a especificação do dispositivo sem fio ao AWS IoT Core for LoRaWAN usando o console
<a name="lorawan-end-device-spec-console"></a>

Escolha uma **Especificação de dispositivo sem fio** com base no método de ativação e na versão LoRaWAN. Depois de selecionados, os dados são criptografados com uma chave que a AWS possui e gerencia para você. 

**Modos de ativação OTAA e ABP**  
Antes que o dispositivo LoRaWAN possa enviar dados de uplink, é preciso concluir um processo chamado *ativação* ou *adesão*. Para ativar o dispositivo, você pode usar o OTAA (ativação sem fio) ou o ABP (ativação por personalização).

O ABP não exige adesão e usa chaves estáticas. Quando você usa o OTAA, o dispositivo LoRaWAN envia uma adesão e o servidor de rede pode permitir a solicitação. Recomendamos que você use o OTAA para ativar o dispositivo porque novas chaves de sessão são geradas para cada ativação, o que o torna mais seguro.

**Versão LoRaWAN**  
Quando você usa o OTAA, o dispositivo LoRaWAN e os aplicativos hospedados em nuvem compartilham as chaves raiz. Essas chaves raiz dependem de você estar ou não usando a versão v1.0.x ou v1.1. A v1.0.x tem apenas uma chave raiz, **AppKey** (chave de aplicativo), enquanto a v1.1 tem duas chaves raiz, **AppKey** (chave de aplicativo) e **NwkKey** (chave de rede). As chaves de sessão são derivadas com base nas chaves raiz de cada ativação. Tanto **NwkKey** quanto **AppKey** são valores hexadecimais de 32 dígitos dados pelo fornecedor sem fio.

**EUIs de dispositivos sem fio**  
Depois de selecionar a **Especificação do dispositivo sem fio**, você verá os parâmetros EUI (Extended Unique Identifier) do dispositivo sem fio exibidos no console. Você pode encontrar essas informações na documentação do dispositivo ou do fornecedor sem fio.
+ **DevEUI**: valor hexadecimal de 16 dígitos exclusivo do dispositivo e encontrado no rótulo do dispositivo ou na documentação dele.
+ **AppEUI**: valor hexadecimal de 16 dígitos exclusivo do servidor de junção e encontrado na documentação do dispositivo. No LoRaWAN versão v1.1, o **AppEUI** é chamado de **JoinEUI**.

Para obter mais informações sobre identificadores exclusivos, chaves de sessão e chaves raiz, consulte a documentação da [LoRa Alliance](https://lora-alliance.org/about-lorawan).

## Adicione a especificação do dispositivo sem fio ao AWS IoT Core for LoRaWAN usando a API
<a name="lorawan-end-device-spec-api"></a>

Se estiver adicionando um dispositivo sem fio usando a API, você deverá criar o perfil de dispositivo e o perfil de serviço antes de criar o dispositivo sem fio. Você usará o perfil do dispositivo e a ID do perfil de serviço ao criar o dispositivo sem fio. Para obter informações sobre como criar esses perfis usando a API, consulte [Adicionar um perfil de dispositivo usando a API](lorawan-define-profiles.md#lorawan-device-profile-api).

As listas a seguir descrevem as ações de API que realizam as tarefas associadas à adição, atualização ou exclusão de um perfil de serviço.

**Ações da API AWS IoT Wireless para perfis de serviço**
+ [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)

Para ver a lista completa das ações e dos tipos de dados disponíveis para criar e gerenciar recursos do AWS IoT Core for LoRaWAN, consulte a [Referência da API AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html).

**Como usar a AWS CLI para criar um dispositivo sem fio**  
Você pode usar a AWS CLI para criar um dispositivo sem fio usando o comando [create-wireless-device](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). O exemplo a seguir cria um dispositivo sem fio usando um arquivo input.json para inserir os parâmetros.

**nota**  
Também é possível executar esse procedimento com a API usando os métodos na API da AWS que correspondam aos comandos da CLI mostrados aqui. 

**Conteúdo 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
}
```

É possível fornecer este arquivo como entrada para o comando `create-wireless-device`.

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

Para obter informações sobre as CLIs que você pode usar, consulte [Referência da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) 