Habilitación de eventos para recursos inalámbricos - AWS IoT Wireless

Habilitación de eventos para recursos inalámbricos

Para que los suscriptores de los temas reservados puedan recibir mensajes, debe habilitar las notificaciones de eventos. Para ello, puede utilizar la AWS Management Console, la API de AWS IoT Wireless o la AWS CLI.

Configuraciones de eventos

Puede configurar eventos para enviar notificaciones a todos los recursos que pertenecen a un tipo concreto o a recursos inalámbricos individuales. El tipo de recurso puede ser una puerta de enlace inalámbrica, una cuenta de socio de Sidewalk o un dispositivo inalámbrico, que puede ser un dispositivo LoRaWAN o de Sidewalk. Para obtener información sobre el tipo de eventos que puede habilitar para los dispositivos inalámbricos, consulte Tipos de eventos para los recursos de LoRaWAN y Tipos de eventos para los recursos de Sidewalk.

Todos los recursos

Puede habilitar los eventos de forma que todos los recursos en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto reciban notificaciones. Por ejemplo, puede habilitar un evento que le notifique los cambios en el estado de conexión en todas las puertas de enlace de LoRaWAN que haya incorporado con AWS IoT Core para LoRaWAN. Monitorizar estos eventos le ayudará a recibir notificaciones en casos como cuando algunas puertas de enlace de LoRaWAN de la flota de recursos se desconecten o si se pierde una baliza en una serie de dispositivos de Sidewalk en la Cuenta de AWS.

Recursos individuales

También puede añadir recursos individuales de LoRaWAN y Sidewalk a la configuración del evento y habilitar las notificaciones para ellos. Esto le ayudará a monitorear los recursos individuales de un tipo en particular. Por ejemplo, puede añadir determinados dispositivos LoRaWAN y de Sidewalk a su configuración y recibir notificaciones sobre los eventos relacionados con el estado de registro de dispositivos o de incorporación para estos recursos.

Requisitos previos

Su recurso de LoRaWAN o Sidewalk debe tener una política adecuada que le permita recibir notificaciones de eventos. Para obtener más información, consulte Política de recepción de notificaciones de eventos inalámbricos.

Habilitación de notificaciones mediante la AWS Management Console

Para habilitar los mensajes de eventos desde la consola, vaya a la pestaña Configuración de la consola de AWS IoT y, a continuación, vaya a la sección Notificaciones de eventos de LoRaWAN y Sidewalk.

Puede habilitar las notificaciones para todos los recursos en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos.

Para habilitar las notificaciones para todos los recursos
  1. En la sección Notificaciones de eventos de LoRaWAN y Sidewalk, vaya a la pestaña Todos los recursos, seleccione Acción y, a continuación, seleccione Administrar eventos.

  2. Habilite los eventos que desea monitorizar y, a continuación, seleccione Actualizar eventos. Si ya no quiere monitorizar determinados eventos, seleccione Acción y Administrar eventos y, a continuación, deshabilítelos.

También puede habilitar las notificaciones para los recursos individuales en la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos.

Para habilitar las notificaciones para los recursos individuales
  1. En la sección Notificaciones de eventos de LoRaWAN y Sidewalk, seleccione Acción y, a continuación, elija Agregar recursos.

  2. Elija los recursos y eventos de los que desea recibir notificaciones:

    1. Elija si desea monitorizar los eventos de los recursos de LoRaWAN o de Sidewalk.

    2. Según el tipo de recurso, puede elegir los eventos que desea habilitar para los recursos. A continuación, puede suscribirse a estos eventos y recibir notificaciones. Si selecciona:

      • Recursos de LoRaWAN: puede habilitar los eventos de conexión para los dispositivos LoRaWAN o los eventos de estado de conexión para las puertas de enlace de LoRaWAN.

      • Recursos de Sidewalk: puede habilitar los eventos de estado de registro de dispositivos o de proximidad (o ambos) para las cuentas de socio de Sidewalk y los dispositivos Sidewalk.

  3. Según el tipo de recurso y los eventos que elija, seleccione los dispositivos inalámbricos o las puertas de enlace que desee monitorizar. Puede seleccionar hasta 250 recursos para todos los recursos combinados.

  4. Seleccione Enviar para añadir los recursos.

Los recursos que añada aparecerán con sus temas MQTT en la pestaña correspondiente a su tipo de recurso en la sección Notificaciones de eventos de LoRaWAN y Sidewalk de la consola.

  • Los eventos de conexión a LoRaWAN y los eventos de los dispositivos de Sidewalk aparecerán en la sección Dispositivos inalámbricos de la consola.

  • Los eventos sobre el estado de conexión de las puertas de enlace de LoRaWAN aparecerán en la sección Puertas de enlace inalámbricas.

  • Los eventos de estado de registro del dispositivo y de proximidad de las cuentas de Sidewalk aparecerán en la pestaña Cuentas de Sidewalk.

Suscripción a temas con el cliente de MQTT

En función de si ha habilitado los eventos para todos los recursos o para tipos de recursos individuales, los eventos que haya habilitado aparecerán en la consola con sus temas MQTT en la pestaña Todos los recursos o en la pestaña del tipo de recurso especificado.

  • Si elige uno de los temas MQTT, puede ir al cliente de MQTT para suscribirse a estos temas y recibir mensajes.

  • Si ha agregado varios eventos, puede suscribirse a varios temas de eventos y recibir notificaciones sobre ellos. Para suscribirse a varios temas, elija los temas, seleccione Acción y, a continuación, elija Suscribirse.

Habilitación de notificaciones mediante la AWS CLI

Puede configurar eventos y añadir recursos a la configuración mediante la API de AWS IoT Wireless o la AWS CLI.

Habilitación de las notificaciones para todos los recursos

Puede habilitar las notificaciones para todos sus recursos de la Cuenta de AWS que pertenezcan a un tipo de recurso concreto y monitorizarlos mediante la operación UpdateEventConfigurationByResourceTypes de la API o el comando update-event-configuration-by-resource-types de la CLI. Por ejemplo:

aws iotwireless update-event-configuration-by-resource-types \ --cli-input-json input.json

Contenido de input.json

{ "DeviceRegistrationState": { "Sidewalk": { "AmazonIdEventTopic": "Enabled" } }, "ConnectionStatus": { "LoRaWAN": { "WirelessGatewayEventTopic": "Enabled" } } }
nota

Todas las comillas (") van precedidas de barras diagonales invertidas (\).

Puede obtener la configuración de eventos actual llamando a la API GetEventConfigurationByResourceTypes o mediante el comando get-event-configuration-by-resource-types de la CLI. Por ejemplo:

aws iotwireless get-event-configuration-by-resource-types
Habilitación de las notificaciones para recursos individuales

Para agregar recursos individuales a la configuración de eventos y controlar cuáles se publican mediante la API o la CLI, llame a la API UpdateResourceEventConfiguration o utilice el comando update-resource-event-configuration de la CLI. Por ejemplo:

aws iotwireless update-resource-event-configuration \ --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ --identifier-type WirelessDeviceId \ --cli-input-json input.json

Contenido de input.json

{ "Join": { "LoRaWAN": { "DevEuiEventTopic": "Disabled" }, "WirelessDeviceIdEventTopic": "Enabled" } }
nota

Todas las comillas (") van precedidas de barras diagonales invertidas (\).

Puede obtener la configuración de eventos actual llamando a la API GetResourceEventConfiguration o mediante el comando get-resource-event-configuration de la CLI. Por ejemplo:

aws iotwireless get-resource-event-configuration \ --identifier-type WirelessDeviceId \ --identifier 1ffd32c8-8130-4194-96df-622f072a315f
Enumeración de las configuraciones de eventos

También puede usar la API de AWS IoT Wireless o la AWS CLI para enumerar las configuraciones de eventos en las que se haya habilitado al menos un tema de evento. Para enumerar las configuraciones, utilice la operación ListEventConfigurations de la API o el comando list-event-configurations de la CLI. Por ejemplo:

aws iotwireless list-event-configurations --resource-type WirelessDevice