Notificações de eventos para AWS IoT Wireless - AWS IoT Wireless
Como seus recursos podem ser notificados sobre eventosPreços para eventos sem fio

Notificações de eventos para AWS IoT Wireless

AWS IoT Wireless pode publicar mensagens para notificar você sobre eventos nos dispositivos LoRaWAN e Sidewalk que você integra ao AWS IoT Core. Por exemplo, você pode receber notificações de eventos, como quando os dispositivos do Sidewalk em sua conta foram provisionados ou registrados.

Como seus recursos podem ser notificados sobre eventos

As notificações de eventos são publicadas quando determinados eventos ocorrem. Por exemplo, os eventos são gerados quando seu dispositivo Sidewalk é provisionado. Cada evento faz com que uma única notificação de evento seja enviada. As notificações de eventos são publicadas por meio do MQTT com uma carga JSON. O conteúdo da carga depende do tipo do evento.

nota

As notificações de eventos são publicadas pelo menos uma vez. É possível que elas sejam publicadas mais de uma vez. A ordenação das mensagens de eventos não é garantida.

Tipos de eventos e recursos

A tabela a seguir exibe os diferentes tipos de eventos para os quais você receberá notificações. Os tipos de eventos também dependem do tipo de recurso ser um dispositivo sem fio, um gateway sem fio ou uma conta do Sidewalk. Você também pode ativar eventos para seus recursos no nível do recurso, o que se aplica a todos os recursos de um tipo específico, ou para recursos selecionados, conforme descrito na seção a seguir. Para obter mais informações sobre os diferentes tipos de eventos, consulte Notificações de eventos para recursos LoRaWAN e Notificações de eventos para recursos do Sidewalk.

Tipos de eventos com base nos recursos
Recurso Tipo de recurso Tipo de evento
Dispositivo sem fio LoRaWAN Ingressar
Sidewalk

  • Estado de registro do dispositivo

  • Proximidade
Gateway sem fio LoRaWAN Status de conexão
Conta Sidewalk Sidewalk

  • Estado de registro do dispositivo

  • Proximidade

Política para receber notificações de eventos sem fio

Para receber notificações de eventos, o dispositivo deve utilizar uma política adequada que permita que ele se conecte ao gateway de dispositivos do AWS IoT e assine os tópicos de evento do MQTT. Você também deve assinar os filtros apropriados dos tópicos.

Veja a seguir um exemplo da política necessária para receber notificações para os vários eventos sem fio.

{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*",
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*"
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", 
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*"
        ]
    }]
}

Formato dos tópicos do MQTT para eventos sem fio

Para enviar notificações de eventos para seus recursos sem fio, o AWS IoT usa tópicos reservados do MQTT que começam com um cifrão ($). Você pode se inscrever e publicar nesses tópicos reservados. Entretanto, não é possível criar tópicos que comecem com um cifrão.

nota

Os tópicos do MQTT são específicos para sua Conta da AWS e usam o formatoarn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic. Para obter mais informações, consulte MQTT topics no Guia do desenvolvedor do AWS IoT.

Os tópicos reservados do MQTT para dispositivos sem fio usam o seguinte formato:

  • Tópicos em nível de recurso

    Esses tópicos se aplicam a todos os recursos de um tipo específico em sua Conta da AWS que você integrou à AWS IoT Wireless.

    $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources

  • Tópicos em nível de identificador

    Esses tópicos se aplicam a recursos selecionados de um tipo específico em sua Conta da AWS que você integrou à AWS IoT Wireless, especificados pelo identificador de recursos.

    $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}

Para obter mais informações sobre tópicos a nível de recurso e identificador, consulte Configurações do evento.

A tabela a seguir mostra exemplos de tópicos do MQTT para os vários eventos:

Eventos e tópicos do MQTT
Evento Tópico do MQTT Observações
Estado de registro do dispositivo Sidewalk
  • Tópico em nível de recurso

    $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices

  • Tópico em nível de identificador

    $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}

  • {eventType} pode ser registered ou provisioned

  • {resourceType} pode ser sidewalk_accounts ou wireless_devices

  • {resourceID} é o amazon_id para sidewalk_accounts e wireless_device_id para wireless_devices
Proximidade do Sidewalk
  • Tópico em nível de recurso

    $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices

  • Tópico em nível de identificador

    $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}

  • {eventType} pode ser beacon_discovered ou beacon_lost

  • {resourceType} pode ser sidewalk_accounts ou wireless_devices

  • {resourceID} é o amazon_id para sidewalk_accounts e wireless_device_id para wireless_devices
Junção LoRaWAN
  • Tópico em nível de recurso

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices

  • Tópico em nível de identificador

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}

  • {eventType} pode ser join_req_0_received ou join_req_2_received ou join_accepted

  • {resourceID} pode ser wireless_device_id ou dev_eui
Status de conexão do gateway LoRaWAN
  • Tópico em nível de recurso

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways

  • Tópico em nível de identificador

    $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}

  • {eventType} pode ser connected ou disconnected

  • {resourceID} pode ser wireless_gateway_id ou gateway_eui

Para obter mais informações sobre diferentes eventos, consulte Notificações de eventos para recursos LoRaWAN e Notificações de eventos para recursos do Sidewalk.

Se você se inscreveu nesses tópicos, receberá uma notificação quando uma mensagem for publicada em um dos tópicos de notificação do evento. Para obter mais informações, consulte MQTT reserved topics no Guia do desenvolvedor do AWS IoT.

Preços para eventos sem fio

Para obter informações sobre preços para se inscrever em eventos e receber notificações, consulte preços do AWS IoT Core.