Ativar eventos para recursos sem fio

Antes que os assinantes dos tópicos reservados possam receber mensagens, você deve ativar as notificações de eventos. Para fazer isso, você pode usar o AWS Management Console ou a API do AWS IoT Wireless ou a AWS CLI.

Configurações do evento

Você pode configurar eventos para enviar notificações para todos os recursos que pertencem a um tipo específico ou para recursos sem fio individuais. O tipo de recurso pode ser um gateway sem fio, uma conta de parceiro do Sidewalk ou um dispositivo sem fio, que pode ser um dispositivo LoRaWAN ou Sidewalk. Para obter informações sobre o tipo de eventos que você pode ativar para seus dispositivos sem fio, consulte Tipos de eventos para recursos LoRaWAN e Tipos de eventos para recursos do Sidewalk.

Todos os recursos

Você pode ativar eventos de forma que todos os recursos na sua Conta da AWS pertencentes a um determinado tipo de recurso recebam notificações. Por exemplo, você pode ativar um evento que notifique você sobre alterações no status da conexão de todos os gateways LoRaWAN com os quais você se integrou AWS IoT Core for LoRaWAN. O monitoramento desses eventos ajudará você a receber notificações em casos como quando certos gateways LoRaWAN em sua frota de recursos são desconectados ou se um farol for perdido para vários dispositivos Sidewalk em sua Conta da AWS.

Recursos individuais

Você também pode adicionar recursos individuais do LoRaWAN e do Sidewalk à configuração do seu evento e ativar as notificações para eles. Isso ajudará você a monitorar recursos individuais de um tipo específico. Por exemplo, você pode adicionar dispositivos LoRaWAN e Sidewalk selecionados à sua configuração e receber notificações de eventos de adesão ou de estado de registro de dispositivos para esses recursos.

Pré-requisitos

Seu recurso LoRaWAN ou Sidewalk deve ter uma política apropriada que permita receber notificações de eventos. Para ter mais informações, consulte Política para receber notificações de eventos sem fio.

Habilitar notificações usando o AWS Management Console

Para habilitar mensagens de eventos do console, vá para a guia Configurações do console de AWS IoT e, em seguida, vá para a seção de notificação de eventos LoRaWAN e Sidewalk.

Você pode ativar notificações para todos os recursos na sua Conta da AWS pertencentes a um determinado tipo de recurso e monitorá-los.

Para ativar as notificações para todos os recursos

1. Na seção de notificação de eventos LoRaWAN e Sidewalk, vá para a guia Todos os recursos, escolha Ação e, em seguida, escolha Gerenciar eventos.

2. Ative os eventos que você deseja monitorar e escolha Atualizar eventos. Se você não quiser mais monitorar determinados eventos, escolha Ação, selecione Gerenciar eventos e, em seguida, desative esses eventos.

Você também pode ativar notificações para recursos individuais na sua Conta da AWS pertencentes a um determinado tipo de recurso e monitorá-los.

Para ativar as notificações para recursos individuais

1. Na seção de notificação de eventos LoRaWAN e Sidewalk, escolha Ação e, em seguida, escolha Adicionar recursos.

2. Selecione o recursos e eventos para os quais quer receber notificações:

   1. Escolha se você deseja monitorar eventos para seus recursos LoRaWAN ou recursos do Sidewalk.

   2. Dependendo do tipo de recurso, você pode escolher os eventos que deseja habilitar para os recursos. Você poderá se inscrever nesses eventos e receber notificações. Se você escolher:

      • Recursos LoRaWAN: Você pode habilitar eventos de ingresso para seus dispositivos LoRaWAN ou eventos de status de conexão para seus gateways LoRaWAN.

      • Recursos do Sidewalk: é possível habilitar o Estado do registro do dispositivo ou eventos de proximidade ou ambos para as contas de parceiros do Sidewalk e dispositivos Sidewalk.

3. Dependendo do tipo de recurso e dos eventos escolhidos, selecione os dispositivos sem fio ou gateways que você deseja monitorar. Você pode selecionar até 250 recursos para todos os recursos combinados.

4. Escolha Enviar para adicionar seus recursos.

Os recursos que você adicionar aparecerão com seus tópicos de MQTT na guia do seu tipo de recurso na seção de notificação de eventos LoRaWAN e Sidewalk do console.

• Os eventos de ingresso no LoRaWAN e os eventos para seus dispositivos Sidewalk aparecerão na seção Dispositivos sem fio do console.

• Os eventos de status de conexão para seus gateways LoRaWAN aparecerão na seção Gateways sem fio.

• O estado do registro do dispositivo e os eventos de proximidade de suas contas do Sidewalk aparecerão na guia Contas do Sidewalk.

Inscreva-se em tópicos usando o cliente MQTT

Dependendo se você ativou eventos para todos os recursos ou para tipos de recursos individuais, os eventos que você ativou aparecerão no console com seus tópicos do MQTT na guia Todos os recursos ou na guia do tipo de recurso especificado.

• Se você escolher um dos tópicos do MQTT, poderá acessar o cliente do MQTT para se inscrever nesses tópicos e receber mensagens.

• Se você adicionou vários eventos, pode se inscrever em vários tópicos do evento e receber notificações sobre eles. Para se inscrever em vários tópicos, escolha seus tópicos, selecione Ação e, em seguida, selecione Inscrever-se.

Habilitar notificações usando a AWS CLI

Você pode configurar eventos e adicionar recursos à sua configuração usando a API AWS IoT Wireless ou o AWS CLI.

Ativar as notificações para todos os recursos

Você pode habilitar notificações para todos os recursos em sua Conta da AWS que pertencem a um determinado tipo de recurso e monitorá-los usando a API UpdateEventConfigurationByResourceTypes ou o comando da CLI update-event-configuration-by-resource-types. Por exemplo:

aws iotwireless update-event-configuration-by-resource-types \ 
   --cli-input-json input.json

Conteúdo de input.json

{   
   "DeviceRegistrationState": { 
      "Sidewalk": { 
         "AmazonIdEventTopic": "Enabled"
      }
   },
   "ConnectionStatus": { 
      "LoRaWAN": { 
         "WirelessGatewayEventTopic": "Enabled"
      }
   }
}

nota

Todas as aspas (") são recuadas com uma barra invertida (\).

Você pode obter a configuração atual do evento chamando a API GetEventConfigurationByResourceTypes ou usando o comando da CLI get-event-configuration-by-resource-types. Por exemplo:

aws iotwireless get-event-configuration-by-resource-types

Ativar as notificações para recursos individuais

Para adicionar recursos individuais à sua configuração de eventos e controlar quais eventos são publicados usando a API ou a CLI, chame a API UpdateResourceEventConfiguration ou use o comando da CLI update-resource-event-configuration. Por exemplo:

aws iotwireless update-resource-event-configuration \ 
   --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ 
   --identifier-type WirelessDeviceId \ 
   --cli-input-json input.json

Conteúdo de input.json

{  
   "Join": { 
      "LoRaWAN": { 
         "DevEuiEventTopic": "Disabled"
      },
      "WirelessDeviceIdEventTopic": "Enabled"
   }
}

nota

Todas as aspas (") são recuadas com uma barra invertida (\).

Você pode obter a configuração atual do evento chamando a API GetResourceEventConfiguration ou usando o comando da CLI get-resource-event-configuration. Por exemplo:

aws iotwireless get-resource-event-configuration \ 
    --identifier-type WirelessDeviceId \ 
    --identifier 1ffd32c8-8130-4194-96df-622f072a315f

Listar configurações do evento

Você também pode usar a API AWS IoT Wireless ou a AWS CLI para listar as configurações de eventos em que pelo menos um tópico do evento foi ativado. Para listar as configurações, use a operação da API ListEventConfigurations ou o comando da CLI list-event-configurations. Por exemplo:

aws iotwireless list-event-configurations --resource-type WirelessDevice