Eventos de estado de registro del dispositivo

Los eventos de estado de registro del dispositivo publican notificaciones de eventos cuando se produce un cambio en el estado de registro del dispositivo, por ejemplo, cuando se ha aprovisionado o registrado un dispositivo de Sidewalk. Los eventos le proporcionan información sobre los distintos estados por los que pasa el dispositivo desde que se aprovisiona hasta que se registra.

Cómo funcionan los eventos de estado de registro del dispositivo

Cuando incorpora el dispositivo de Sidewalk con Amazon Sidewalk y AWS IoT Wireless, AWS IoT Wireless realiza una operación create y añade el dispositivo de Sidewalk a la Cuenta de AWS. A continuación, el dispositivo pasa al estado aprovisionado y el eventType pasa a provisioned. Para obtener más información sobre la configuración del proyecto, consulte Introducción a AWS IoT Core para Amazon Sidewalk.

Una vez provisioned el dispositivo, Amazon Sidewalk realiza una operación register para registrar el dispositivo de Sidewalk en AWS IoT Wireless. Comienza así el proceso de registro, donde se configuran el cifrado y las claves de sesión con AWS IoT. Cuando el dispositivo está registrado, el eventType pasa a registered y el dispositivo está listo para usarse.

Una vez que el dispositivo se haya registered, Sidewalk puede enviar una solicitud para deregister el dispositivo. A continuación, AWS IoT Wireless completa la solicitud y vuelve a cambiar el estado del dispositivo a provisioned. Para obtener más información acerca de los estados del dispositivo, consulte DeviceState.

Habilitación de notificaciones para los eventos de estado de registro del dispositivo

Para que los suscriptores de los temas reservados de estado de registro del dispositivo puedan recibir mensajes, debe habilitar las notificaciones de eventos para ellos desde la AWS Management Console o mediante la API o la CLI. Puede habilitar estos eventos para todos los recursos de Sidewalk de la Cuenta de AWS o para algunos recursos seleccionados. Para obtener información sobre cómo habilitar estos eventos, consulte Habilitación de eventos para recursos inalámbricos.

Formato de los temas MQTT para los eventos de estado de registro del dispositivo

Para notificarle los eventos de estado de registro del dispositivo, puede suscribirse a los temas reservados de MQTT que comiencen con un signo de dólar ($). Para obtener más información, consulte MQTT topics en la Guía del desarrollador de AWS IoT.

Los temas MQTT reservados para los eventos de estado de registro del dispositivo en Sidewalk utilizan el siguiente formato:

• Para temas de nivel de recursos:

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

• Para temas de identificador:

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

Donde:

{eventName}

{eventName} debe ser device_registation_state.

{eventType}

{eventType} puede ser provisioned o registered.

{resourceType}

{resourceType} puede ser sidewalk_accounts o wireless_devices.

{resourceID}

{resourceID} es amazon_id para {resourceType} de sidewalk_accounts y wireless_device_id para {resourceType} de wireless_devices.

También puede usar el carácter comodín + para suscribirse a varios temas al mismo tiempo. El carácter comodín + coincide con cualquier cadena del nivel que lo contiene. Por ejemplo, si quiere recibir notificaciones de todos los tipos de eventos posibles (provisioned y registered) y de todos los dispositivos registrados con un ID de Amazon concreto, puede usar el siguiente filtro de temas:

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

nota

No puede utilizar el carácter comodín # para suscribirse a los temas reservados. Para obtener más información sobre filtros de temas, consulte MQTT topic filters en la Guía del desarrollador de AWS IoT.

Carga de mensajes para los eventos de estado de registro del dispositivo

Después de habilitar las notificaciones de los eventos de estado de registro del dispositivo, las notificaciones de eventos se publican en MQTT con una carga JSON. Estos eventos contienen la siguiente carga de ejemplo:

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

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

La carga contiene los siguientes atributos:

eventId

Un ID de evento exclusivo (cadena).

eventType

El tipo de evento que se produjo. Puede ser provisioned o registered.

wirelessDeviceId

El identificador del dispositivo inalámbrico.

timestamp

La marca de tiempo Unix de cuándo se produjo el evento.

operación

La operación en la que se activó el evento. Los valores válidos son create, register y deregister.

sidewalk

El ID de Amazon Sidewalk o SidewalkManufacturingSn del que desea recibir notificaciones de eventos.