接続ステータスイベント - AWS IoT Wireless
接続ステータスイベントの仕組みLoRaWAN ゲートウェイの MQTT トピックの形式接続ステータスイベントのメッセージペイロード

接続ステータスイベント

AWS IoT Core for LoRaWAN では、AWS IoT にオンボードした LoRaWAN ゲートウェイの接続ステータスイベントを通知するメッセージを発行できます。LoRaWAN ゲートウェイの接続ステータスが接続済みまたは切断済みに変更されたときに通知する接続ステータスイベント。

接続ステータスイベントの仕組み

ゲートウェイを AWS IoT Core for LoRaWAN にオンボーディングした後、ゲートウェイを AWS IoT Core for LoRaWAN に接続して、その接続ステータスを確認できます。このイベントは、ゲートウェイ接続ステータスが接続済みまたは切断済みに変更されたときに通知します。ゲートウェイのオンボーディングおよび AWS IoT Core for LoRaWAN への接続の詳細については、「ゲートウェイを AWS IoT Core for LoRaWAN にオンボードする」および「LoRaWAN ゲートウェイを接続し、接続ステータスを確認する」を参照してください。

LoRaWAN ゲートウェイの MQTT トピックの形式

LoRaWAN ゲートウェイ用に予約された MQTT トピックでは、次の形式を使用します。これらのトピックをサブスクライブしている場合は、AWS アカウント に登録されているすべての LoRaWAN ゲートウェイが通知を受信できます。

  • リソースレベルのトピックの場合:

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

  • 識別子のトピックの場合:

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

コードの説明は以下のとおりです。

{eventName}

{eventName} は connection_status である必要があります。

{eventType}

{eventType} は、connected または disconnected のいずれかになります。

{resourceID}

{resourceID} は gateway_eui または wireless_gateway_id のいずれかになります。

たとえば、次のトピックをサブスクライブして、すべてのゲートウェイが AWS IoT Core for LoRaWAN に接続されたときにイベント通知を受け取ることができます。

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

また、ワイルドカード文字 + を使用して、複数のトピックを同時にサブスクライブできます。ワイルドカード文字 + は、次のトピックなど、その文字を含むレベル内の任意の文字列に一致します。

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

注記

予約済みトピックをサブスクライブするには、ワイルドカード文字 # を使用できません。

トピックをサブスクライブするときに + ワイルドカードを使用する方法の詳細については、AWS IoT デベロッパーガイドの「MQTT トピックフィルター」を参照してください。

接続ステータスイベントのメッセージペイロード

以下は、接続ステータスイベントのメッセージペイロードを示しています。

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

ペイロードには以下の属性が含まれます。

eventId

AWS IoT Core for LoRaWAN によって生成される一意のイベント ID (文字列)。

eventType

発生したイベントのタイプ。connected または disconnected のいずれかを設定できます。

wirelessGatewayId

LoRaWAN ゲートウェイの ID。

timestamp

イベントが発生したときの Unix タイムスタンプ。

GatewayEui

ゲートウェイラベルまたはゲートウェイのドキュメントにあるゲートウェイの一意の識別子。