

# Eventos de estado de conexión
<a name="iot-lorawan-gateway-events"></a>

AWS IoT Core para LoRaWAN puede publicar mensajes para notificarle eventos del estado de conexión de las puertas de enlace de LoRaWAN que incorporó a AWS IoT. Los eventos de estado de conexión lo notifican cuando el estado de conexión de una puerta de enlace de LoRaWAN cambia a conectado o desconectado.

## Cómo funcionan los eventos de estado de conexión
<a name="iot-lorawan-gateway-events-work"></a>

Una vez que haya incorporado la puerta de enlace aAWS IoT Core para LoRaWAN, puede conectarla a AWS IoT Core para LoRaWAN y verificar su estado de conexión. Este evento lo notifica cuando el estado de conexión de la puerta de enlace cambia a conectado o desconectado. Para obtener más información sobre cómo incorporar y conectar la puerta de enlace a AWS IoT Core para LoRaWAN, consulte [Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateways.md) y [Conectar una puerta de enlace LoRaWAN y verificar el estado de su conexión](lorawan-gateway-connection-status.md).

## Formato de los temas MQTT para puertas de enlace de LoRaWAN
<a name="lorawan-gateway-message-format"></a>

Los temas MQTT reservados para puertas de enlace de LoRaWAN utilizan el formato siguiente. Si se ha suscrito a estos temas, todas las puertas de enlace de LoRaWAN que estén registrados en la Cuenta de AWS podrán recibir la notificación:
+ Para temas de nivel de recursos:

  `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways`
+ Para temas de identificador:

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

Donde:

**\$1eventName\$1**  
\$1eventName\$1 debe ser `connection_status`.

**\$1eventType\$1**  
\$1eventType\$1 puede ser `connected` o `disconnected`.

**\$1resourceID\$1**  
\$1resourceID\$1 puede ser `gateway_eui` o `wireless_gateway_id`.

Por ejemplo, puede suscribirse a los siguientes temas para recibir una notificación de evento cuando todas las puertas de enlace se hayan conectado a AWS IoT Core para LoRaWAN:

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

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 contiene el carácter, por ejemplo, en el tema siguiente:

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

**nota**  
No puede utilizar el carácter comodín `#` para suscribirse a los temas reservados.

Para obtener más información sobre el uso del comodín `+` al suscribirse a temas, consulte [MQTT topic filters](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html) en la *Guía del desarrollador de AWS IoT*.

## Carga de mensajes para eventos de estado de conexión
<a name="iot-lorawan-gateway-payload"></a>

A continuación se muestra la carga de mensajes para el evento de estado de conexión.

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

La carga contiene los siguientes atributos:

**eventId**  
Un ID de evento único generado por AWS IoT Core para LoRaWAN (cadena).

**eventType**  
El tipo de evento que se produjo. Puede ser `connected` o `disconnected`.

**wirelessGatewayId**  
El ID de la puerta de enlace de LoRaWAN.

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

**GatewayEui**  
El identificador único de la puerta de enlace que se encuentra en su etiqueta o documentación.