Connection status events - Amazon IoT Core
How connection status events workFormat of MQTT topics for LoRaWAN gatewaysMessage payload for connection status events
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Connection status events

Amazon IoT Core for LoRaWAN can publish messages to notify you of connection status events for LoRaWAN gateways that you onboard to Amazon IoT. Connection status events notify you when the connection status of a LoRaWAN gateway changes to connected or disconnected.

How connection status events work

After you've onboarded your gateway to Amazon IoT Core for LoRaWAN, you can connect your gateway to Amazon IoT Core for LoRaWAN and verify its connection status. This event notifies you when your gateway connection status changes to connected or disconnected. For more information about onboarding and connecting your gateway to Amazon IoT Core for LoRaWAN, see Onboard your gateways to Amazon IoT Core for LoRaWAN and Connect your LoRaWAN gateway and verify its connection status.

Format of MQTT topics for LoRaWAN gateways

Reserved MQTT topics for LoRaWAN gateways use the following format. If you've subscribed to these topics, then all LoRaWAN gateways that are registered to your Amazon Web Services account can receive the notification:

  • For resource-level topics:

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

  • For identifier topics:

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

Where:

{eventName}

{eventName} must be connection_status.

{eventType}

{eventType} can be connected or disconnected.

{resourceID}

{resourceID} can be gateway_eui or wireless_gateway_id.

For example, you can subscribe to the following topics to receive an event notification when all your gateways have connected to Amazon IoT Core for LoRaWAN:

$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/{id}

You can also use the + wildcard character to subscribe to multiple topics at the same time. The + wildcard character matches any string in the level that contains the character, such as the following topic:

$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/+

Note

You can't use the wildcard character # to subscribe to the reserved topics. For more information about topic filters, see Topic filters.

For more information about using the + wildcard when subscribing to topics, see Topic filters.

Message payload for connection status events

The following shows the message payload for the connection status event.

{
 // General fields
    "eventId": "string", 
    "eventType": "connected|disconnected",
    "WirelessGatewayId": "string",
    "timestamp": "timestamp",
 
 // Event-specific fields
    "LoRaWAN": {
        "GatewayEui": "string"        
    }
}

The payload contains the following attributes:

eventId

A unique event ID that's generated by Amazon IoT Core for LoRaWAN (string).

eventType

The type of event that occurred. Can be connected or disconnected.

wirelessGatewayId

The ID of the LoRaWAN gateway.

timestamp

The Unix timestamp of when the event occurred.

GatewayEui

The unique identifier of the gateway found on the gateway label or gateway documentation.