Événements de participation LoRaWAN - AWS IoT Wireless
Comment fonctionnent les événements de participationActiver les événements de participation à LoRaWANFormat des sujets MQTT pour les événements LoRaWANCharge utile des messages pour l’événement de participation à LoRaWAN

Événements de participation LoRaWAN

AWS IoT Core for LoRaWAN peut publier des messages pour vous informer des événements de participation aux appareils LoRaWAN auxquels vous vous connectez à AWS IoT. Les événements de participation vous avertissent lorsqu’une demande d’adhésion ou de réadhésion de type 0 ou de type 2 est reçue et que l’appareil s’est jointe à AWS IoT Core for LoRaWAN.

Comment fonctionnent les événements de participation

Lorsque vous intégrez vos appareils LoRaWAN avec AWS IoT Core for LoRaWAN, AWS IoT Core for LoRaWAN exécute une procédure de participation pour votre appareil avec AWS IoT Core for LoRaWAN. Votre appareil est alors activé pour être utilisé et peut envoyer un message par liaison ascendante pour indiquer qu’il est disponible. Une fois l’appareil connecté, des messages de liaison montante et descendante peuvent être échangés entre votre appareil et AWS IoT Core for LoRaWAN. Pour plus d'informations sur l'intégration de votre appareil, veuillez consulter Intégrez vos appareils à AWS IoT Core for LoRaWAN.

Vous pouvez activer les événements pour vous avertir lorsque votre appareil s’est joint à AWS IoT Core for LoRaWAN. Vous serez également averti si l’événement d’adhésion échoue, lorsqu’une demande de réadhésion de type 0 ou de type 2 est reçue et lorsqu’elle est acceptée.

Activer les événements de participation à LoRaWAN

Avant que les abonnés au LoRaWAN rejoignent les rubriques réservées puissent recevoir des messages, vous devez activer les notifications d’événements pour eux depuis AWS Management Console ou à l’aide de l’API ou de la CLI. Vous pouvez activer ces événements pour toutes les ressources LoRaWAN de vos ressources Compte AWS ou pour certaines d’entre elles. Pour plus d’informations sur l’activation de ces événements, consultez Activer les événements pour les ressources sans fil.

Format des sujets MQTT pour les événements LoRaWAN

Les rubriques MQTT réservées pour les appareils LoRaWAN utilisent le format suivant. Si vous êtes abonné à ces sujets, tous les appareils LoRaWAN enregistrés sur votre compte Compte AWS peuvent recevoir la notification :

  • Rubriques au niveau des ressources

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

  • Rubriques d’identification

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

Où :

{eventName}

{EventName} doit être join.

{eventType}

{EventType} peut être :

  • join_req_received

  • rejoin_req_0_received

  • rejoin_req_2_received

  • join_accepted

{resourceID}

{ResourceId} peut être dev_eui ou wireless_device_id.

Par exemple, vous pouvez vous abonner aux rubriques suivantes pour recevoir une notification d’événement lorsque AWS IoT Core for LoRaWAN a accepté une demande d’adhésion depuis vos appareils.

$aws/iotwireless/events/join/join_accepted/lorawan/wireless_devices/wireless_device_id/{id}

Vous pouvez également utiliser le caractère générique + pour vous abonner à plusieurs sujets en même temps. Le caractère générique + correspond à n’importe quelle chaîne du niveau qui contient le caractère, telle que la rubrique suivante :

$aws/iotwireless/events/join/join_req_received/lorawan/wireless_devices/wireless_device_id/+

Note

Vous ne pouvez pas utiliser le caractère générique # pour vous abonner aux rubriques réservées.

Pour plus d’informations sur l’utilisation du caractère générique + lors de l’abonnement à des rubriques, consultez Filtres de rubriques MQTT dans le Guide du développeur AWS IoT.

Charge utile des messages pour l’événement de participation à LoRaWAN

Ce qui suit montre la charge utile des messages pour l’événement de participation à LoRaWAN.

{
 // General fields
    "eventId": "string", 
    "eventType": "join_req_received|rejoin_req_0_received|rejoin_req_2_received|join_accepted",
    "WirelessDeviceId": "string",
    "timestamp": "timestamp",
 
 // Event-specific fields
    "LoRaWAN": {
        "DevEui": "string",
        
        // The fields below are optional indicating that it can be a null value.
        "DevAddr": "string", 
        "JoinEui": "string", 
        "AppEui": "string", 
    }
}

Les charges utiles contiennent les attributs suivants :

eventId

Un identifiant d’événement unique généré par AWS IoT Core for LoRaWAN (chaîne).

eventType

Type d’événement qui s’est produit. Il peut avoir l'une des valeurs suivantes :

  • join_req_received : Ce champ affichera les paramètres EUI JoinEui ou AppEui

  • rejoin_req_0_received

  • rejoin_req_2_received

  • join_accepted : Ce champ affichera le NetId et DevAddr.

wirelessDeviceId

ID de l’appareil LoRaWAN.

timestamp

L'horodatage Unix du moment où l'événement s'est produit.

DevEui

L’identifiant unique de l’appareil figurant sur l’étiquette de l’appareil ou sur la documentation de l’appareil.

DevAddr et EUI (facultatif)

Ces champs sont l’adresse facultative de l’appareil et les paramètres EUI JoinEUI ou AppEUI.