Événements relatifs à l’état d’enregistrement des appareils

Les événements relatifs à l’état d’enregistrement de l’appareil publient des notifications d’événements en cas de modification de l’état d’enregistrement de l’appareil, par exemple lorsqu’un appareil Sidewalk a été mis en service ou enregistré. Les événements vous fournissent des informations sur les différents états que traverse l’appareil entre le moment où il est mis en service et celui où il a été enregistré.

Comment fonctionnent les événements relatifs à l’état d’enregistrement des appareils

Lorsque vous intégrez votre appareil Sidewalk à Amazon Sidewalk et AWS IoT Wireless, AWS IoT Wireless effectue une opération create et que vous ajoutez votre appareil Sidewalk à votre Compte AWS. Votre appareil passe alors à l’état mis en service et eventType devient provisioned. Pour plus d'informations sur l'intégration de votre appareil, veuillez consulter Démarrage avec AWS IoT Core pour Amazon Sidewalk.

Une fois que l’appareil a été provisioned, Amazon Sidewalk effectue une opération register pour enregistrer votre appareil Sidewalk auprès de AWS IoT Wireless. Le processus d’enregistrement commence, au cours duquel les clés de chiffrement et de session sont configurées auprès de AWS IoT. Lorsque l’appareil est enregistré, eventType devient registered et votre appareil est prêt à être utilisé.

Une fois que l’appareil a été registered, Sidewalk peut envoyer une demande à deregister votre appareil. AWS IoT Wireless répond ensuite à la demande et redéfinit l’état de l’appareil à provisioned. Pour plus d’informations sur les états de l’appareil, veuillez consulter DeviceState.

Activer les notifications pour les événements relatifs à l’état d’enregistrement de l’appareil

Avant que les abonnés aux rubriques réservées à l’état d’enregistrement de l’appareil 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 Sidewalk de votre 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 rubriques MQTT pour les événements relatifs à l’état d’enregistrement des appareils

Pour vous informer des événements liés à l’état d’enregistrement des appareils, vous pouvez vous abonner aux rubriques réservées au MQTT qui commencent par le signe dollar ($). Pour plus d’informations, consultez Rubriques MQTT dans le Guide du développeur AWS IoT.

Les sujets MQTT réservés aux événements d’état d’enregistrement des appareils Sidewalk utilisent le format suivant :

Où :

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. Par exemple, si vous souhaitez être informé de tous les types d’événements possibles (provisioned et registered) et pour tous les appareils enregistrés sous un identifiant Amazon spécifique, vous pouvez utiliser le filtre de rubrique suivant :

$aws/iotwireless/events/device_registration_state/+/sidewalk/sidewalk_accounts/amazon_id/+

Charge utile des messages pour les événements relatifs à l’état d’enregistrement de l’appareil

Une fois que vous avez activé les notifications pour les événements relatifs à l’état d’enregistrement de l’appareil, les notifications d’événements sont publiées via MQTT avec une charge utile JSON. Ces événements contiennent l’exemple suivant de charge utile :

{    
    "eventId": "string", 
    "eventType": "provisioned|registered", 
    "WirelessDeviceId": "string",
    "timestamp": "timestamp",

    // Event-specific fields
    "operation": "create|deregister|register", 
    "Sidewalk": {
        "AmazonId": "string",
        "SidewalkManufacturingSn": "string"
    }
}

Les charges utiles contiennent les attributs suivants :