

# Adicionar perfis ao AWS IoT Core for LoRaWAN
<a name="lorawan-define-profiles"></a>

Perfis de dispositivos e serviços podem ser definidos para descrever configurações comuns de dispositivos. Esses perfis descrevem os parâmetros de configuração que são compartilhados pelos dispositivos para facilitar a adição desses dispositivos. O AWS IoT Core for LoRaWAN é compatível com perfis de dispositivos e perfis de serviços.

 Os parâmetros de configuração e os valores a serem inseridos nesses perfis são apresentados pelo fabricante do dispositivo.

## Adicionar perfis de dispositivos
<a name="lorawan-device-profiles"></a>

Os perfis de dispositivos definem os recursos do dispositivo e os parâmetros de inicialização que o servidor de rede usa para definir o serviço de acesso por rádio LoRaWAN. Ele inclui a seleção de parâmetros como faixa de frequência LoRa, versão de parâmetros regionais LoRa e versão MAC do dispositivo. Para conhecer as diferentes faixas de frequência, consulte [Considere a seleção de faixas de frequência LoRa para os gateways e conexão de dispositivos](lorawan-rfregion-permissions.md#lorawan-frequency-bands).

### Adicionar um perfil de dispositivo usando o console
<a name="lorawan-device-profile-console"></a>

Se você estiver adicionando um dispositivo sem fio usando o console conforme descrito em [Adicione a especificação do dispositivo sem fio ao AWS IoT Core for LoRaWAN usando o console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), depois de adicionar a especificação do dispositivo sem fio, você poderá adicionar o perfil do dispositivo. Se quiser, você também pode adicionar dispositivos sem fio da página [Perfis](https://console.aws.amazon.com/iot/home#/wireless/profiles) do console de AWS IoT na guia **LoRaWAN**.

Você pode escolher entre os perfis de dispositivo padrão ou criar um novo perfil de dispositivo. Recomendamos que você use os perfis de dispositivo padrão. Se o aplicativo exigir que você crie um perfil de dispositivo, dê um **Nome de perfil de dispositivo**, selecione a **Faixa de frequência (RfRegion)** que você está usando para o dispositivo e o gateway e mantenha as outras configurações nos valores padrão, a menos que especificado de outra forma na documentação do dispositivo.

### Adicionar um perfil de dispositivo usando a API
<a name="lorawan-device-profile-api"></a>

Se estiver adicionando um dispositivo sem fio usando a API, você deverá criar o perfil de dispositivo antes de criar o dispositivo sem fio.

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**
+ [CreateDeviceProfile](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)

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 perfil de dispositivo**  
Você pode usar a AWS CLI para criar um perfil de dispositivo usando o comando [create-device-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). O exemplo a seguir cria um perfil de dispositivo.

```
aws iotwireless create-device-profile
```

A execução desse comando cria automaticamente um perfil de dispositivo com uma ID que você pode usar ao criar o dispositivo sem fio. Agora você pode criar o perfil de serviço usando a seguinte API e, em seguida, criar o dispositivo sem fio usando os perfis de dispositivo e de serviço.

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

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) 

## Adicionar perfis de serviço
<a name="lorawan-service-profiles"></a>

Os perfis de serviço descrevem os parâmetros de comunicação de que o dispositivo precisa para se comunicar com o servidor de aplicativos.

### Adicionar um perfil de serviço usando o console
<a name="lorawan-service-profile-console"></a>

Se estiver adicionando um dispositivo sem fio usando o console conforme descrito em [Adicione a especificação do dispositivo sem fio ao AWS IoT Core for LoRaWAN usando o console](lorawan-end-devices-add.md#lorawan-end-device-spec-console), depois de adicionar o perfil do dispositivo, você poderá adicionar o perfil de serviço. Se quiser, você também pode adicionar dispositivos sem fio da página [Perfis](https://console.aws.amazon.com/iot/home#/wireless/profiles) do console de AWS IoT na guia **LoRaWAN**.

Recomendamos que você deixe a configuração **AddGWMetaData** ativada para receber metadados de gateway adicionais para cada carga útil, como RSSI e SNR para a transmissão de dados.

### Adicionar um perfil de serviço usando a API
<a name="lorawan-service-profile-api"></a>

Se você estiver adicionando um dispositivo sem fio usando a API, primeiro crie o perfil de serviço antes de criar o dispositivo sem fio.

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**
+ [CreateServiceProfile](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)

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 perfil de serviço**  
Você pode usar a AWS CLI para criar um serviço usando o comando [create-service-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-service-profile.html). O exemplo a seguir cria um perfil de serviço.

```
aws iotwireless create-service-profile
```

A execução desse comando cria automaticamente um perfil de serviço com uma ID que você pode usar ao criar o dispositivo sem fio. Agora você pode criar o dispositivo sem fio usando os perfis de dispositivo e de serviço.

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