

# Gerenciamento de dispositivos com o AWS IoT Core for LoRaWAN
<a name="lorawan-manage-end-devices"></a>

A seguir estão algumas considerações importantes ao usar dispositivos com o AWS IoT Core for LoRaWAN. Para obter informações sobre como adicionar o dispositivo ao AWS IoT Core for LoRaWAN, consulte [Integrar os dispositivos ao AWS IoT Core for LoRaWAN](lorawan-onboard-end-devices.md).

## Considerações sobre dispositivos
<a name="lorawan-devices-criteria"></a>

Quando for selecionar um dispositivo que deseja usar para se comunicar com o AWS IoT Core for LoRaWAN, considere o seguinte.
+ Sensores disponíveis
+ Capacidade de bateria
+ Consumo de energia
+ Custo
+ Tipo de antena e alcance da transmissão

## Uso de dispositivos com gateways qualificados para o AWS IoT Core for LoRaWAN
<a name="lorawan-devices-qualified-gateways"></a>

Os dispositivos usados podem ser emparelhados com gateways sem fio qualificados para uso com o AWS IoT Core for LoRaWAN. É possível encontrar esses gateways e kits de desenvolvedor no [Catálogo de dispositivos do parceiro da AWS](https://devices.amazonaws.com/search?page=1&sv=iotclorawan). Também recomendamos considerar a proximidade desses dispositivos aos gateways. Para ter mais informações, consulte [Usar gateways qualificados do AWS Partner Device Catalog](lorawan-manage-gateways.md#lorawan-qualified-gateways).

## Versão LoRaWAN
<a name="lorawan-lorawan-version"></a>

O AWS IoT Core for LoRaWAN é compatível com todos os dispositivos que estão em conformidade com as especificações LoRaWAN 1.0.x ou 1.1 padronizadas pela LoRa Alliance.

## Modos de ativação
<a name="lorawan-activation-modes"></a>

Antes que o dispositivo LoRaWAN possa enviar dados de uplink, é preciso concluir um processo chamado procedimento de *ativação* ou *adesão*. Para ativar o dispositivo, você pode usar a OTAA (ativação sem fio) ou a ABP (ativação por personalização). Recomendamos usar a OTAA para ativar o dispositivo porque novas chaves de sessão são geradas para cada ativação, o que o torna mais seguro.

A especificação do dispositivo sem fio se baseia na versão e modo de ativação do LoRaWAN, que determina as chaves raiz e as chaves de sessão geradas para cada ativação. Para ter mais informações, consulte [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).

## Classes de dispositivos
<a name="lorawan-device-classes"></a>

Dispositivos LoRaWAN podem enviar mensagens de uplink a qualquer momento. Escutar mensagens de downlink consome a capacidade de bateria e reduz a duração dela. O protocolo LoRaWAN especifica três classes de dispositivos LoRaWAN.
+ Os dispositivos de classe A dormem a maior parte do tempo e escutam mensagens de downlink apenas por um curto período de tempo. Esses dispositivos são, na maioria, sensores alimentados por bateria com uma vida útil de bateria de até 10 anos.
+ Os dispositivos de classe B podem receber mensagens em slots de downlink programados. Esses dispositivos são, na maioria, atuadores alimentados por bateria.
+ Os dispositivos de classe C nunca dormem e escutam as mensagens recebidas continuamente, portanto, não há muito atraso no recebimento das mensagens. Esses dispositivos são, na maioria, atuadores alimentados pela rede elétrica.

Para acessar mais informações dessas considerações sobre dispositivos sem fio, consulte os recursos mencionados em [Saiba mais sobre o LoRaWAN](what-is-lorawan.md#lorawan-learn-more).

**Topics**
+ [

## Considerações sobre dispositivos
](#lorawan-devices-criteria)
+ [

## Uso de dispositivos com gateways qualificados para o AWS IoT Core for LoRaWAN
](#lorawan-devices-qualified-gateways)
+ [

## Versão LoRaWAN
](#lorawan-lorawan-version)
+ [

## Modos de ativação
](#lorawan-activation-modes)
+ [

## Classes de dispositivos
](#lorawan-device-classes)
+ [

# Executar a taxa de dados adaptativa (ADR) com o AWS IoT Core for LoRaWAN
](iot-lorawan-adr.md)
+ [

# Gerenciar a comunicação entre os dispositivos LoRaWAN e o AWS IoT
](lorawan-device-cloud-communication.md)
+ [

# Gerenciar o tráfego LoRaWAN de redes de dispositivos públicas LoRaWAN (Everynet)
](iot-lorawan-roaming.md)

# Executar a taxa de dados adaptativa (ADR) com o AWS IoT Core for LoRaWAN
<a name="iot-lorawan-adr"></a>

Para otimizar o consumo de energia de transmissão do dispositivo e, ao mesmo tempo, garantir que as mensagens dos dispositivos finais sejam recebidas nos gateways, o AWS IoT Core for LoRaWAN utiliza a taxa de dados adaptativa. A taxa de dados adaptativa instrui os dispositivos finais a otimizarem a taxa de dados, a potência de transmissão e o número de retransmissões enquanto tentam reduzir a taxa de erros dos pacotes recebidos nos gateways. Por exemplo, se o dispositivo final estiver localizado próximo aos gateways, a taxa de dados adaptativa reduzirá a potência de transmissão e aumentará a taxa de dados. 

**Topics**
+ [

## Como funciona a taxa de dados adaptativa (ADR)
](#iot-lorawan-adr-algorithm)
+ [

## Configurar limites de taxa de dados (CLI)
](#iot-lorawan-adr-use)

## Como funciona a taxa de dados adaptativa (ADR)
<a name="iot-lorawan-adr-algorithm"></a>

Para habilitar a ADR, o dispositivo deve definir o bit ADR no cabeçalho do quadro. Depois que o bit ADR é definido, o AWS IoT Core for LoRaWAN envia o comando `LinkADRReq` do MAC e os dispositivos respondem com o comando `LinkADRAns`, que inclui o status de ACK do comando ADR. Depois que os dispositivos aceitarem (ACK) o comando ADR, ele seguirá as instruções da ADR do AWS IoT Core for LoRaWAN e ajustará os valores dos parâmetros de transmissão para obter a taxa de dados ideal. 

O algoritmo ADR do AWS IoT Core for LoRaWAN utiliza as informações de SINR no histórico de metadados de uplink para determinar a potência de transmissão e a taxa de dados ideais a serem utilizadas pelos dispositivos. O algoritmo utiliza as vinte mensagens de uplink mais recentes que se iniciam quando o bit ADR é definido no cabeçalho do quadro. Para determinar o número de retransmissões, ele usa a taxa de erro de pacote (PER), que é uma porcentagem do número total de pacotes perdidos. Ao utilizar esse algoritmo, você só pode controlar o intervalo de taxas de dados, ou seja, os limites mínimo e máximo das taxas de dados.

## Configurar limites de taxa de dados (CLI)
<a name="iot-lorawan-adr-use"></a>

Por padrão, o AWS IoT Core for LoRaWAN executará a ADR quando você definir o bit ADR no cabeçalho do quadro do dispositivo LoRaWAN. É possível controlar os limites mínimo e máximo da taxa de dados ao criar um perfil de serviço para os dispositivos LoRaWAN utilizando a operação de API [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) do AWS IoT Wireless ou o comando [https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html) da AWS CLI.

**nota**  
Não é possível especificar os limites mínimo e máximo da taxa de dados ao criar um perfil de serviço no Console de gerenciamento da AWS. Só é possível especificá-los utilizando a API do AWS IoT Wireless ou a AWS CLI.

Para especificar os limites mínimo e máximo da taxa de dados, utilize os parâmetros `CreateServiceProfile` e `DrMax` com a operação de API `DrMin`. Os limites mínimo e máximo padrão da taxa de dados são 0 e 15. Por exemplo, o comando da CLI a seguir define um limite mínimo de 3 para a taxa de dados e um limite máximo de 12.

```
aws iotwireless create-service-profile \ 
    --lorawan DrMin=3,DrMax=12
```

A execução desse comando gera um ID e um nome do recurso da Amazon (ARN) para o perfil de serviço.

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

É possível obter os valores dos parâmetros especificados utilizando a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html) do AWS IoT Wireless ou o comando [https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html) da CLI. 

```
aws iotwireless get-service-profile --id "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
```

A execução desse comando gera os valores para os parâmetros do perfil de serviço.

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

Se você criou vários perfis, poderá utilizar a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListServiceProfiles.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListServiceProfiles.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/list-service-profiles.html](https://docs.aws.amazon.com/cli/latest/reference/list-service-profiles.html) da AWS CLI para listar os perfis de serviço na Conta da AWS e utilizar a API `GetServiceProfile` ou o comando `get-service-profile` da CLI para recuperar o perfil de serviço para o qual você personalizou os limites da taxa de dados. 

# Gerenciar a comunicação entre os dispositivos LoRaWAN e o AWS IoT
<a name="lorawan-device-cloud-communication"></a>

Após conectar um dispositivo LoRaWAN ao AWS IoT Core for LoRaWAN, os dispositivos podem começar a enviar mensagens para a nuvem. As mensagens de uplink são mensagens enviadas pelo seu dispositivo e recebidas pelo AWS IoT Core for LoRaWAN. Dispositivos LoRaWAN podem enviar mensagens de uplink a qualquer momento, que são então encaminhadas para outros AWS service (Serviço da AWS) e aplicativos hospedados na nuvem. Mensagens enviadas do AWS IoT Core for LoRaWAN e outros AWS service (Serviço da AWS) e aplicativos para seus dispositivos são chamadas de mensagens de downlink.

Veja a seguir como é possível visualizar e gerenciar mensagens de uplink e downlink enviadas entre os seus dispositivos e a nuvem. É possível manter uma fila de mensagens de downlink e enviá-las para seus dispositivos na ordem em que elas foram adicionadas à fila.

**Topics**
+ [

# Visualizar o formato das mensagens de uplink enviadas a partir de dispositivos LoRaWAN
](lorawan-uplink-metadata-format.md)
+ [

# Formar uma fila de mensagens de downlink para enviar para dispositivos LoRaWAN
](lorawan-downlink-queue.md)

# Visualizar o formato das mensagens de uplink enviadas a partir de dispositivos LoRaWAN
<a name="lorawan-uplink-metadata-format"></a>

Após conectar um dispositivo LoRaWAN ao AWS IoT Core for LoRaWAN, é possível observar o formato da mensagem de uplink que você receberá do seu dispositivo sem fio.

## Antes de poder observar as mensagens de uplink
<a name="lorawan-uplink-metadata-prerequisites"></a>

É preciso ter integrado seu dispositivo sem fio e conectado seu dispositivo ao AWS IoT para que ele possa transmitir e receber dados. Para acessar informações sobre a integração de dispositivos ao AWS IoT Core for LoRaWAN, consulte [Integrar os dispositivos ao AWS IoT Core for LoRaWAN](lorawan-onboard-end-devices.md).

## O que contêm as mensagens de uplink?
<a name="lorawan-uplink-metadata-contains"></a>

Dispositivos LoRaWAN se conectam ao AWS IoT Core for LoRaWAN usando gateways LoRaWAN. A mensagem de uplink recebido do dispositivo conterá as seguintes informações.
+ Dados de carga que correspondem à mensagem criptografada de carga enviada a partir do dispositivo sem fio.
+ Metadados sem fio que englobam:
  + Informações do dispositivo, como DevEui, taxa de dados e canal de frequência no qual o dispositivo está operando.
  + Parâmetros adicionais opcionais e informações de gateway sobre gateways conectados ao dispositivo. Os parâmetros do gateway abrangem o EUI do gateway, o SNR e o RSSi.

  Usando os metadados sem fio, é possível obter informações úteis sobre o dispositivo sem fio e os dados transmitidos entre seu dispositivo e o AWS IoT. Por exemplo, é possível usar o parâmetro `AckedMessageId` para verificar se a última mensagem de downlink confirmada foi recebida pelo dispositivo. Opcionalmente, se você optar por incluir as informações de gateway, será possível identificar se deseja mudar para um canal de gateway mais forte que esteja mais próximo do dispositivo.

## Como fazer para observar as mensagens de uplink?
<a name="lorawan-uplink-metadata-observe"></a>

Após integrar seu dispositivo, é possível usar o [cliente de teste MQTT](https://console.aws.amazon.com/iot/home#/test) na página **Teste** do console do AWS IoT para assinar o tópico que foi especificado ao criar seu destino. Você passará a ver mensagens depois que o dispositivo estiver conectado e começar a enviar dados de carga.

O diagrama a seguir identifica os principais elementos em um sistema LoRaWAN conectado ao AWS IoT Core for LoRaWAN, que mostra o plano de dados primário e como os dados fluem pelo sistema.

![\[Imagem exibindo como os dados do AWS IoT Core for LoRaWAN são transmitidos a partir de um dispositivo sem fio para o AWS IoT e outros serviços.\]](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/images/iot-lorawan-data-flow.png)


Quando o dispositivo sem fio começa a enviar dados de uplink, o AWS IoT Core for LoRaWAN agrupa as informações de metadados sem fio com a carga e as envia para seus aplicativos da AWS.

## Exemplo de mensagem de uplink
<a name="lorawan-uplink-metadata-example"></a>

O exemplo a seguir exibe o formato da mensagem de uplink recebida do seu dispositivo.

```
{
    "WirelessDeviceId": "5b58245e-146c-4c30-9703-0ca942e3ff35", 
    "PayloadData": "Cc48AAAAAAAAAAA=",    
    "WirelessMetadata":
    {
        "LoRaWAN":
        {
            "ADR": false,
            "Bandwidth": 125,
            "ClassB": false,
            "CodeRate": "4/5",
            "DataRate": "0",
            "DevAddr": "00b96cd4",
            "DevEui": "58a0cb000202c99",            
            "FOptLen": 2,
            "FCnt": 1,
            "Fport": 136,   
            "Frequency": "868100000",     
            "Gateways": [
             {
                    "GatewayEui": "80029cfffe5cf1cc",      
                    "Snr": -29,
                    "Rssi": 9.75
             }
             ],  
            "MIC": "7255cb07",  
            "MType": "UnconfirmedDataUp",
            "Major": "LoRaWANR1",
            "Modulation": "LORA", 
            "PolarizationInversion": false,    
            "SpreadingFactor": 12,                         
            "Timestamp": "2021-05-03T03:24:29Z"
            
        }
    }
}
```

### Exclusão de metadados do gateway dos metadados de uplink
<a name="lorawan-uplink-metadata-example2"></a>

Se quiser excluir as informações de metadados do gateway dos metadados de uplink, desative o parâmetro **AddGwMetadata** quando criar o perfil de serviço. Para acessar informações sobre como desabilitar esse parâmetro, consulte [Adicionar perfis de serviço](lorawan-define-profiles.md#lorawan-service-profiles).

Nesse caso, você não verá a seção `Gateways` nos metadados de uplink, como ilustrado no exemplo a seguir.

```
{  
    "WirelessDeviceId": "0d9a439b-e77a-4573-a791-49d5c0f4db95",
    "PayloadData": "AAAAAAAA//8=",
    "WirelessMetadata": {
        "LoRaWAN": {
            "ClassB": false,
            "CodeRate": "4/5",
            "DataRate": "1",
            "DevAddr": "01920f27",
            "DevEui": "ffffff10000163b0",
            "FCnt": 1,
            "FPort": 5,
            "Timestamp": "2021-04-29T05:19:43.646Z"
    }
  }
}
```

# Formar uma fila de mensagens de downlink para enviar para dispositivos LoRaWAN
<a name="lorawan-downlink-queue"></a>

Aplicações hospedadas na nuvem e outros AWS service (Serviço da AWS)s podem enviar mensagens de downlink para os seus dispositivos sem fio. Mensagens de downlink são mensagens enviadas a partir do AWS IoT Core for LoRaWAN para o seu dispositivo sem fio. É possível agendar e enviar mensagens de downlink para cada dispositivo que você integrou ao AWS IoT Core for LoRaWAN.

Se tiver múltiplos dispositivos para os quais deseja enviar uma mensagem de downlink, é possível usar um grupo de multicast. Os dispositivos de um grupo de multicast compartilham o mesmo endereço multicast, que é, então, distribuído para um todo um grupo de dispositivos destinatários. Para ter mais informações, consulte [Crie grupos de multicast para enviar uma carga de downlink para vários dispositivos](lorawan-multicast-groups.md). 

## Como uma fila de mensagens de downlink funciona
<a name="lorawan-how-downlink-works"></a>

A classe de dispositivo de um dispositivo LoRaWAN determina como as mensagens da fila são enviadas para o dispositivo. Dispositivos de classe A enviam uma mensagem de uplink ao AWS IoT Core for LoRaWAN para indicar que o dispositivo está disponível para recebimento de mensagens de downlink. Os dispositivos de classe B podem receber mensagens em slots de downlink regulares. Os dispositivos de classe C podem receber mensagens de downlink a qualquer momento. Para acessar mais informações sobre classes de dispositivos, consulte [Classes de dispositivos](lorawan-manage-end-devices.md#lorawan-device-classes).

O seguinte mostra como as mensagens são colocadas em fila e enviadas para seus dispositivos de classe A.

1. O AWS IoT Core for LoRaWAN armazena em buffer a mensagem de downlink que você adicionou à fila com a porta do quadro, os dados da carga e os parâmetros do modo de reconhecimento especificados com o console do AWS IoTou a API do AWS IoT Wireless.

1. O dispositivo LoRaWAN envia uma mensagem de uplink indicando que ele está on-line e pode começar a receber mensagens de downlink.

1. Caso você tenha adicionado mais de uma mensagem de downlink à fila, o AWS IoT Core for LoRaWAN envia a primeira mensagem de downlink na fila para o seu dispositivo com o sinalizador de reconhecimento (ACK) definido.

1. Seu dispositivo envia uma mensagem de uplink para o AWS IoT Core for LoRaWAN imediatamente ou permanece inativo até a próxima mensagem de uplink e inclui o sinalizador ACK na mensagem.

1. Quando o AWS IoT Core for LoRaWAN recebe a mensagem de uplink com o sinalizador ACK, ele retira a mensagem de downlink da fila, indicando que o seu dispositivo recebeu a mensagem de downlink com êxito. Se o sinalizador ACK estiver ausente da mensagem de uplink após três verificações, a mensagem será descartada.

## Executar operações de fila de downlink com o console
<a name="lorawan-downlink-queue-console"></a>

É possível usar o Console de gerenciamento da AWS para enfileirar mensagens de downlink e retirar mensagens individuais, ou toda a fila, conforme necessário. Com dispositivos de classe A, após um uplink ser recebido do dispositivo para indicar que ele está on-line, as mensagens em fila são enviadas para o dispositivo. Depois que a mensagem for enviada, ela será automaticamente removida da fila.

**Colocar mensagens de downlink em fila**  
Para criar uma fila de mensagens de downlink

1. Acesse o [hub Dispositivos do console do AWS IoT](https://console.aws.amazon.com/iot/home#/wireless/devices) e selecione o dispositivo para o qual deseja enfileirar mensagens de downlink.

1. Na seção **Mensagens de downlink** da página de detalhes do dispositivo, selecione **Enfileirar mensagens de downlink**.

1. Especifique os parâmetros a seguir para configurar sua mensagem de downlink:
   + **FPort**: selecione a porta do quadro usada pelo dispositivo para comunicação como o AWS IoT Core for LoRaWAN.
   + **Carga**: especifique a mensagem de carga que deseja enviar para o seu dispositivo. O tamanho máximo da carga é de 242 bytes. Se a taxa de dados adaptativa (ADR) estiver ativada, o AWS IoT Core for LoRaWAN a utiliza para escolher a taxa de dados ideal para o tamanho da carga. É possível otimizar ainda mais a taxa de dados conforme necessário.
   + **Modo de reconhecimento**: confirme se o dispositivo recebeu a mensagem de downlink. Se uma mensagem exigir esse modo, você verá uma mensagem de uplink com o sinalizador ACK no seu fluxo de dados e a mensagem será retirada da fila.

1. Para adicionar sua mensagem de downlink à fila, selecione **Enviar**.

Sua mensagem de downlink foi adicionada à fila. Caso não veja sua mensagem, ou se receber uma mensagem de erro, você pode solucionar o erro conforme descrito em [Solucionar erros na fila de mensagens de downlink](#lorawan-downlink-queue-troubleshoot). 

**nota**  
Depois que sua mensagem de downlink for adicionada à fila, não será mais possível editar os parâmetros **FPort**, **Carga** e **Modo de reconhecimento**. Para enviar uma mensagem de downlink com valores diferentes para esses parâmetros, é possível excluir essa mensagem e enfileirar uma nova mensagem de downlink com os valores de parâmetros atualizados.

A fila lista as mensagens de downlink adicionadas. Para visualizar a carga das mensagens de uplink e downlink trocadas entre seus dispositivos e o AWS IoT Core for LoRaWAN, use o analisador de rede. Para ter mais informações, consulte [Monitorar sua frota de recursos sem fio em tempo real usando o analisador de rede](network-analyzer-overview.md).

**Listar fila de mensagens de downlink**  
A mensagem de downlink criada por você será adicionada à fila. Cada mensagem de downlink subsequente será adicionada à fila após essa mensagem. Você pode visualizar uma lista de mensagens de downlink na seção **Mensagens de downlink** da página de detalhes do dispositivo. Depois que um uplink for recebido, as mensagens serão enviadas para o dispositivo. Depois que uma mensagem de downlink for recebida pelo dispositivo, ela será removida da fila. A mensagem seguinte, então, sobe na fila para ser enviada ao seu dispositivo.

**Excluir mensagens de downlink individuais ou limpar toda a fila**  
Cada mensagem de downlink é retirada da fila automaticamente depois de ser enviada ao seu dispositivo. Também é possível excluir mensagens individuais ou remover toda a fila de downlink. Essas ações são irreversíveis.
+ Caso localize mensagens na fila que não deseje enviar, selecione as mensagens e selecione **Excluir**.
+ Se não quiser enviar nenhuma mensagem da fila para o dispositivo, é possível remover toda a fila selecionando **Limpar fila de downlink**.

## Executar operações de fila de downlink com a API
<a name="lorawan-downlink-queue-api"></a>

É possível usar a API do AWS IoT Wireless para enfileirar mensagens de downlink e retirar mensagens individuais, ou toda a fila, conforme necessário.

**Colocar mensagens de downlink em fila**  
Para criar uma fila de mensagens de downlink, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_SendDataToWirelessDevice.html) ou o comando [cli/latest/reference/iotwireless/send-data-to-wireless-device.html](cli/latest/reference/iotwireless/send-data-to-wireless-device.html) da CLI.

```
aws iotwireless send-data-to-wireless-device \
    --id "11aa5eae-2f56-4b8e-a023-b28d98494e49" \
    --transmit-mode "1" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata LoRaWAN={FPort=1}
```

Executando o comando, a saída gera um `MessageId` para a mensagem de downlink. Em alguns casos, mesmo que você receba o `MessageId`, os pacotes podem ser descartados. Para obter mais informações sobre como resolver o erro, consulte [Solucionar erros na fila de mensagens de downlink](#lorawan-downlink-queue-troubleshoot).

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

**Listar mensagens de downlink na fila**  
Para listas todas as mensagens de downlink da fila, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListQueuedMessages.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListQueuedMessages.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-queued-messages.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-queued-messages.html) da CLI.

```
aws iotwireless list-queued-messages
```

Por padrão, um máximo de 10 mensagens de downlink são exibidas ao executar esse comando.

**Remover mensagens de downlink individuais ou limpar toda a fila**  
Para remover mensagens individuais da fila ou limpar a fila inteira, use a operação de API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteQueuedMessages.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteQueuedMessages.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-queued-messages.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-queued-messages.html) da CLI.
+ Para remover mensagens individuais, forneça o `messageID` das mensagens que deseja remover para um dispositivo sem fio, especificado pelo `wirelessDeviceId`.
+ Para limpar a fila de downlinks inteira, especifique o `messageID` como `*` para um dispositivo sem fio, especificado pelo `wirelessDeviceId`.

## Solucionar erros na fila de mensagens de downlink
<a name="lorawan-downlink-queue-troubleshoot"></a>

Aqui estão algumas objetos para verificar, se não estiver obtendo os resultados esperados:
+ 

**As mensagens de downlink não aparecem no console do AWS IoT**  
Se não estiver vendo sua mensagem de downlink na fila depois de adicioná-la conforme descrito em [Executar operações de fila de downlink com o console](#lorawan-downlink-queue-console), seu dispositivo talvez não tenha concluído um processo chamado procedimento de *ativação* ou *adesão*. Esse procedimento é realizado quando seu dispositivo é integrado ao AWS IoT Core for LoRaWAN. Para ter mais informações, consulte [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).

  Após integrar seu dispositivo ao AWS IoT Core for LoRaWAN, é possível monitorá-lo para verificar se a adesão e a readesão foram bem-sucedidas usando o analisador de rede ou o Amazon CloudWatch. Para ter mais informações, consulte [Ferramentas de monitoramento](monitoring-cloudwatch.md#monitoring-tools).
+ 

**Pacotes de mensagens de downlink ausentes ao usar a API**  
Quando você usa a operação da API `SendDataToWirelessDevice`, a API retorna um único `MessageId`. Entretanto, não é possível confirmar se o dispositivo LoRaWAN recebeu a mensagem de downlink. Os pacotes de downlink podem ser descartados em casos como quando o dispositivo não concluiu o procedimento de adesão. Para acessar mais informações sobre como solucionar esse erro, consulte a seção anterior.
+ 

**Erro de ARN ausente ao enviar mensagem de downlink**  
Quando enviar uma mensagem de downlink para seu dispositivo a partir da fila, você pode receber um erro de nome do recurso da Amazon (ARN) ausente. Esse erro pode ocorrer porque o destino não foi especificado da maneira correta para o dispositivo que está recebendo a mensagem de downlink. Para solucionar esse erro, verifique os detalhes do destino do dispositivo.

# Gerenciar o tráfego LoRaWAN de redes de dispositivos públicas LoRaWAN (Everynet)
<a name="iot-lorawan-roaming"></a>

É possível conectar seus dispositivos LoRaWAN à nuvem em minutos usando redes LoRaWAN disponíveis publicamente. O AWS IoT Core for LoRaWAN agora é compatível com a cobertura de rede da Everynet nos EUA e no Reino Unido. Quando usar a rede pública, você pagará uma taxa de conectividade de rede pública por cada dispositivo todos os meses. O preço se aplica a todas as Regiões da AWS em que a conectividade de rede pública é oferecida. Para acessar mais informações sobre os preços desse atributo, consulte a [página Definição de preço do AWS IoT Core](https://aws.amazon.com/iot-core/pricing/).

**Importante**  
A rede pública é operada e oferecida como um serviço diretamente pela Everynet. Antes de usar esse atributo, consulte os [Termos de serviço da AWS](https://aws.amazon.com/service-terms/) aplicáveis. Além disso, se usar uma rede pública por meio do AWS IoT Core for LoRaWAN, determinadas informações de dispositivos LoRaWAN, como `DevEUI` e `JoinEUI` serão replicadas nas regiões onde o AWS IoT Core for LoRaWAN estiver disponível.

O AWS IoT Core for LoRaWAN é compatível com a rede pública LoRaWAN, de acordo com a especificação da LoRa Alliance para roaming, descrita em [LoRaWAN Backend Interfaces 1.0 Specification](https://lora-alliance.org/wp-content/uploads/2020/11/lorawantm-backend-interfaces-v1.0.pdf). O recurso de rede pública pode ser utilizado para conectar os dispositivos finais que estão fora da rede doméstica. Para oferecer compatibilidade com esse recurso e fornecer cobertura de rádio ampliada, o AWS IoT Core for LoRaWAN utiliza a Everynet como parceira.

## Benefícios de usar uma rede pública LoRaWAN
<a name="lorawan-roaming-benefits"></a>

Seus dispositivos LoRaWAN podem usar uma rede pública para conexão com a nuvem, o que reduz o tempo de implantação e o tempo e custo necessários para manutenção de uma rede LoRaWAN privada.

Usando uma rede pública LoRaWAN, você receberá benefícios como extensão de cobertura, execução de núcleo sem rede de rádio e densificação de cobertura. Esse atributo pode ser usado para:
+ Fornecer cobertura a dispositivos quando eles saírem da rede doméstica, como o *Dispositivo A* na imagem exibida na seção [Arquitetura de suporte de rede pública LoRaWAN](lorawan-roaming-works.md#lorawan-roaming-architecture).
+ Ampliar a cobertura para dispositivos que não possuem um gateway LoRa para se conectar, como o *Dispositivo B* na imagem exibida na seção [Arquitetura de suporte de rede pública LoRaWAN](lorawan-roaming-works.md#lorawan-roaming-architecture). O dispositivo poderá, então, usar o gateway fornecido pelo parceiro para se conectar à rede doméstica.

Os dispositivos LoRaWAN podem usar uma rede pública para conexão com a nuvem utilizando o recurso de roaming, o que reduz o tempo de implantação e o tempo e o custo necessários para manutenção de uma rede LoRaWAN privada.

As seções a seguir descrevem a arquitetura de suporte da rede pública, o funcionamento do suporte da rede pública LoRaWAN e como usar esse atributo.

**Topics**
+ [

## Benefícios de usar uma rede pública LoRaWAN
](#lorawan-roaming-benefits)
+ [

# Como funciona o suporte da rede pública LoRaWAN
](lorawan-roaming-works.md)
+ [

# Como usar o suporte de rede pública
](lorawan-roaming-use.md)

# Como funciona o suporte da rede pública LoRaWAN
<a name="lorawan-roaming-works"></a>

O AWS IoT Core for LoRaWAN é compatível com o atributo de roaming passivo, conforme a especificação LoRa Alliance. Com o roaming passivo, o processo de roaming é inteiramente transparente para o dispositivo final. Os dispositivos finais em roaming fora da rede doméstica podem se conectar aos gateways nessa rede pública e trocar dados de uplink e de downlink utilizando o servidor de aplicações. Os dispositivos permanecem conectados à rede doméstica no decorrer de todo o processo de roaming.

**nota**  
O AWS IoT Core for LoRaWAN é compatível somente com o atributo sem estado do roaming passivo. O roaming de transferência não é compatível. No roaming de transferência, o dispositivo mudará para outra operadora quando viajar para fora da rede doméstica.

**Topics**
+ [

## Conceitos da rede pública LoRaWAN
](#lorawan-roaming-concepts)
+ [

## Arquitetura de suporte de rede pública LoRaWAN
](#lorawan-roaming-architecture)

## Conceitos da rede pública LoRaWAN
<a name="lorawan-roaming-concepts"></a>

Esses conceitos são utilizados pelo recurso de rede pública compatível com o AWS IoT Core for LoRaWAN.

**Servidor da rede LoRaWAN (LNS)**  
Um LNS é um servidor privado autônomo que pode ser executado nas suas instalações ou pode ser um serviço baseado em nuvem. O AWS IoT Core for LoRaWAN é um LNS que oferece serviços na nuvem.

**Servidor de rede doméstica (hNS)**  
A rede doméstica é a rede à qual pertence o dispositivo. O servidor de rede doméstica (hNS) é um LNS em que o AWS IoT Core for LoRaWAN armazena os dados de provisionamento do dispositivo, como `DevEUI`, `AppEUI` e chaves de sessão. 

**Servidor de rede visitada (vNS)**  
A rede visitada é a rede através da qual o dispositivo recebe cobertura quando sai da rede doméstica. O servidor de rede visitada (vNS) é um LNS que tem um acordo comercial e técnico com os hNS para poder atender ao dispositivo final. O parceiro da AWS, Everynet, atua como a rede visitada para oferecer cobertura.

**Servidor de rede de atendimento (sNS)**  
O servidor de rede de atendimento (sNS) é um LNS que lida com os comandos MAC para o dispositivo. Só pode haver um sNS para uma sessão LoRa.

**Servidor de rede de encaminhamento (fNS)**  
O servidor de rede de encaminhamento (fNS) é um LNS que gerencia os gateways de rádio. Pode ser que haja zero ou mais fNS envolvidos em uma sessão LoRa. Esse servidor de rede gerencia o encaminhamento dos pacotes de dados que são recebidos do dispositivo para a rede doméstica.

## Arquitetura de suporte de rede pública LoRaWAN
<a name="lorawan-roaming-architecture"></a>

O seguinte diagrama de arquitetura demonstra como o AWS IoT Core for LoRaWAN faz parceria com a Everynet para oferecer conectividade de rede pública. Nesse caso, o *Dispositivo A* está conectado ao hNS (servidor de rede doméstica) fornecido pelo AWS IoT Core for LoRaWAN meio de um gateway LoRa. Quando o Dispositivo A sai da rede doméstica, ele ingressa em uma rede visitada e é coberto pelo servidor de rede visitada (vNS) oferecido pela Everynet. O vNS também amplia a cobertura ao *Dispositivo B*, que não tem um gateway LoRa ao qual se conectar.

É possível visualizar as informações de cobertura da rede pública no console do AWS IoT, conforme descrito na seção a seguir.

![\[Imagem que mostra como o AWS IoT Core for LoRaWAN utiliza roaming para oferecer atender a dispositivos que saem de uma rede doméstica e para ampliar a cobertura a dispositivos que não têm um gateway ao qual se conectar.\]](http://docs.aws.amazon.com/pt_br/iot-wireless/latest/developerguide/images/iot-lorawan-roaming-architecture.png)


 O AWS IoT Core for LoRaWAN usa uma funcionalidade de hub de roaming, em conformidade com a [Recomendação técnica do de hub de roaming LoRaWAN da LoRa Alliance](https://lora-alliance.org/wp-content/uploads/2022/01/TR010-1.0.0-LoRaWAN-Roaming-Hub.pdf). O hub de roaming oferece um endpoint para a Everynet rotear o tráfego recebido a partir do dispositivo final. Nesse caso, a Everynet atua como um servidor de rede de encaminhamento (fNS) para encaminhar o tráfego recebido a partir do dispositivo. Ela usa uma API RESTful de HTTP, conforme definido pela especificação da LoRa Alliance.

**nota**  
Se o dispositivo sair da rede doméstica e entrar em um local onde tanto a rede doméstica quanto a Everynet estiverem disponíveis, ele se conectará ao primeiro gateway que aparecer (LoRa ou Everynet).

Ao visitar uma rede pública, os hNS e o servidor de rede de atendimento (sNS) são separados. Pacotes de uplink e downlink são, então, trocados entre os sNS e os hNS.

# Como usar o suporte de rede pública
<a name="lorawan-roaming-use"></a>

Para habilitar a compatibilidade com a rede pública Everynet, especifique determinados parâmetros de roaming ao criar um perfil de serviço. Nesta versão beta, esses parâmetros estão disponíveis quando você utiliza a API do AWS IoT Wireless ou a AWS CLI. As seções a seguir mostram os parâmetros que devem ser habilitados e como habilitar a rede pública utilizando a AWS CLI.

**nota**  
Só é possível ativar o suporte de rede pública ao criar um novo perfil de serviço. Não é possível atualizar um perfil existente para habilitar a rede pública usando esses parâmetros.

**Topics**
+ [

## Parâmetros de roaming
](#lorawan-roaming-parameters)
+ [

## Habilitar o suporte de rede pública para dispositivos
](#lorawan-roaming-enable)

## Parâmetros de roaming
<a name="lorawan-roaming-parameters"></a>

Especifique os seguintes parâmetros quando criar um perfil de serviço para um dispositivo. Especifique esses parâmetros ao adicionar um perfil de serviço no hub [Perfis](https://console.aws.amazon.com/iot/home#/wireless/profiles) do console do AWS IoT ou utilizando a operação de API [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 o comando [https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html) da AWS CLI.

**nota**  
O AWS IoT Core for LoRaWAN não é compatível com roaming de transferência. Na criação do perfil de serviço, não é possível ativar o parâmetro `HrAllowed` que especifica se o roaming de transferência deve ser usado.
+ Ativação de roaming permitida (`RaAllowed`): esse parâmetro especifica se a ativação de roaming deve ser habilitada. A ativação de roaming possibilita que um dispositivo final seja ativado sob a cobertura de uma vNS. Ao usar o atributo de roaming, `RaAllowed` deve ser definido como `true`.
+ Roaming passivo permitido (`PrAllowed`): esse parâmetro especifica se o roaming passivo deve ser habilitado. Ao usar o atributo de roaming, `PrAllowed` deve ser definido como `true`.

## Habilitar o suporte de rede pública para dispositivos
<a name="lorawan-roaming-enable"></a>

Para habilitar o suporte de rede pública LoRaWAN nos dispositivos, execute o procedimento a seguir.

**nota**  
Só é possível ativar o recurso de rede pública para dispositivos OTAA. Esse atributo não é compatível com dispositivos que usem ABP como método de ativação.

1. 

**Crie um perfil de serviço com parâmetros de roaming**

   Crie um perfil de serviço habilitando os parâmetros de roaming.
**nota**  
Na criação de um perfil de dispositivo para o dispositivo que você associará a esse perfil de serviço, recomendamos especificar um valor grande para o parâmetro `RxDelay1`, ao menos maior que 2 segundos.
   + 

**Usar o console de AWS IoT**  
Vá para o hub [Perfis](https://console.aws.amazon.com/iot/home#/wireless/profiles) do console do AWS IoT e selecione **Adicionar perfil de serviço**. Na criação do perfil, selecione **Habilitar rede pública**.
   + 

**Uso da API AWS IoT Wireless**  
Para habilitar o roaming ao criar um perfil de serviço, utilize a operação de API [CreateServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/create-service-profile.html) da CLI, conforme mostrado no exemplo a seguir.

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

     A saída da execução desse comando retorna o ARN e o ID do perfil de serviço.

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

1. 

**Verifique os parâmetros de roaming no perfil de serviço**

   Para verificar os parâmetros de roaming especificados, é possível visualizar o perfil do serviço no console ou usar o comando `get-service-profile` da CLI, conforme exibido no exemplo abaixo.
   + 

**Usar o console de AWS IoT**  
Vá para o hub [Perfis](https://console.aws.amazon.com/iot/home#/wireless/profiles) do console do AWS IoT e selecione o perfil que você criou. Na guia **Configuração do perfil** da página de detalhes, você poderá ver **RaAllowed** **PrAllowed** definidos como `true`.
   + 

**Uso da API AWS IoT Wireless**  
Para visualizar os parâmetros de roaming ativados por você, use a operação de API [GetServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html) ou o comando [https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html](https://docs.aws.amazon.com/cli/latest/reference/get-service-profile.html) da CLI, conforme exibido no exemplo abaixo.

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

     A saída da execução desse comando retorna os detalhes do perfil de serviço, incluindo os valores dos parâmetros de roaming. `RaAllowed` e `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. 

**Anexe o perfil de serviço aos dispositivos**

   Anexe o perfil de serviço criado com os parâmetros de roaming aos dispositivos finais. Também é possível criar um perfil de dispositivo e adicionar um destino para os dispositivos sem fio. Você usará esse destino para rotear mensagens de uplink que são enviadas a partir do seu dispositivo. Para acessar mais informações sobre como criar perfis de dispositivos e um destino, consulte [Adicionar perfis de dispositivos](lorawan-define-profiles.md#lorawan-device-profiles) e [Adicionar destinos ao AWS IoT Core for LoRaWAN](lorawan-create-destinations.md).
   + 

**Integração de dispositivos novos**  
Caso ainda não tenha integrado seus dispositivos, especifique esse perfil de serviço, que será usado ao adicionar seu dispositivo ao AWS IoT Core for LoRaWAN. O seguinte comando mostra como você pode usar o comando `create-wireless-device` da CLI para adicionar um dispositivo usando o ID do perfil de serviço criado por você. Para obter informações sobre como adicionar o perfil de serviço utilizando o console, consulte [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).

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

     O exemplo a seguir mostra o conteúdo do arquivo *`createdevice.json`*.

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

     A saída da execução desse comando produz o ARN e o ID do dispositivo sem fio.

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

**Atualização de dispositivos existentes**  
Se já tiver integrado seus dispositivos, é possível atualizar seus dispositivos sem fio existentes para usar esse perfil de serviço. O seguinte comando mostra como você pode usar o comando `update-wireless-device` da CLI para atualizar um dispositivo usando o ID do perfil de serviço criado por você.

     ```
     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"
     ```

     Esse comando não retorna nenhuma saída. É possível usar a API `GetWirelessDevice` ou o comando `get-wireless-device` da CLI para obter as informações atualizadas.

1. 

**Conectar o dispositivo à nuvem usando a Everynet**

   Como o roaming foi habilitado, seu dispositivo deve agora realizar uma adesão para obter um novo `DevAddr`. Quando você utiliza o OTAA, o dispositivo LoRaWAN envia uma solicitação de junção e o servidor de rede pode permitir a solicitação. Depois, ele pode se conectar ao Nuvem AWS com a cobertura de rede fornecida pela Everynet. Para obter instruções sobre como realizar o procedimento de ativação ou adesão com o seu dispositivo, consulte a documentação do dispositivo.
**nota**  
É possível habilitar o recurso de roaming e a conexão à rede pública somente para dispositivos que utilizam o OTAA como o método de ativação. Dispositivos ABP não são compatíveis. Para obter instruções sobre como realizar o procedimento de ativação ou adesão com o seu dispositivo, consulte a documentação do dispositivo. Consulte [Modos de ativação](lorawan-manage-end-devices.md#lorawan-activation-modes). 
Para desabilitar o recurso de roaming para os dispositivos, é possível desassociá-los desse perfil de serviço e associá-los a outro perfil de serviço que tenha os parâmetros de roaming definidos como `false`. Após a mudança para esse perfil de serviço, os dispositivos devem realizar outra junção para que não continuem executando na rede pública.

1. 

**Trocar mensagens de uplink e downlink**

   Depois que o dispositivo se conectar ao AWS IoT Core for LoRaWAN, será possível começar a trocar mensagens entre seu dispositivo e a nuvem.
   + 

**Visualizar mensagens de uplink**  
Ao enviar mensagens de uplink a partir dos seus dispositivos, o AWS IoT Core for LoRaWAN entrega essas mensagens para a sua Conta da AWS usando o destino configurado anteriormente. Essas mensagens serão enviadas a partir do seu dispositivo para a nuvem pela rede da Everynet.

     É possível visualizar as mensagens usando o nome da regra do AWS IoT ou usar o cliente MQTT para assinar o tópico MQTT especificado na criação do destino. Para acessar mais informações sobre o nome da regra e outros detalhes do destino que você especificar, consulte [Adicionar um destino usando o console](lorawan-create-destinations.md#lorawan-create-destination-console).

     Para acessar mais informações sobre a visualização de mensagens de uplink e o formato, consulte, [Visualizar o formato das mensagens de uplink enviadas a partir de dispositivos LoRaWAN](lorawan-uplink-metadata-format.md).
   + 

**Enviar mensagens de downlink**  
É possível enfileirar e enviar mensagens de downlink para seus dispositivos a partir do console ou usando o comando de API do AWS IoT Wireless, `SendDataToWirelessDevice`, ou o comando da AWS CLI, `send-data-to-wireless-device`. Para acessar informações sobre como enfileirar e enviar mensagens de downlink, consulte [Formar uma fila de mensagens de downlink para enviar para dispositivos LoRaWAN](lorawan-downlink-queue.md).

     O seguinte código exibe um exemplo de como você pode enviar uma mensagem de downlink usando o comando `send-data-to-wireless-device` da CLI. Você especifica o ID do dispositivo sem fio para receber os dados, a carga, se deve usar o modo de reconhecimento e os metadados sem fio.

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

     Executando o comando, a saída gera um `MessageId` para a mensagem de downlink.
**nota**  
Em alguns casos, mesmo que você receba o `MessageId`, os pacotes podem ser descartados. Para acessar informações sobre como solucionar problemas em tais cenários, consulte [Solucionar erros na fila de mensagens de downlink](lorawan-downlink-queue.md#lorawan-downlink-queue-troubleshoot).

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

**Visualizar as informações de cobertura**  
Depois de habilitar a rede pública, será possível visualizar as informações de cobertura da rede no console do AWS IoT. Acesse o hub [https://console.aws.amazon.com/iot/home#/wireless/network-coverage](https://console.aws.amazon.com/iot/home#/wireless/network-coverage) do console do AWS IoT e, então, pesquise locais para visualizar as informações de cobertura de seus dispositivos no mapa.
**nota**  
Esse atributo utiliza o Amazon Location Service para exibir as informações de cobertura dos seus dispositivos em um mapa de localização da Amazon. Antes de usar os mapas de localização da Amazon, examine os Termos e Condições do Amazon Location Service. Observe que a AWS pode transmitir suas consultas de API para o provedor de dados de terceiros selecionado, que pode estar fora da Região da AWS que você usa atualmente. Para obter mais informações, consulte [Termos de serviço da AWS](https://aws.amazon.com/service-terms).