# Conexión de puertas de enlace y dispositivos a AWS IoT Core para LoRaWAN AWS IoT Core para LoRaWAN le ayuda a conectar y administrar dispositivos inalámbricos LoRaWAN (red de área amplia de largo alcance y bajo consumo), y elimina la necesidad de desarrollar y operar un LNS. Los dispositivos y puertas de enlace WAN de largo alcance (LoRaWAN) se pueden conectar a AWS IoT Core con AWS IoT Core para LoRaWAN. ## Convenciones de nomenclatura para sus dispositivos, puertas de enlace, perfiles y destinos Antes de empezar con AWS IoT Core para LoRaWAN y crear los recursos, tenga en cuenta la convención de nomenclatura de los dispositivos, las puertas de enlace y el destino. AWS IoT Core para LoRaWAN asigna identificadores únicos a los recursos que crea para los dispositivos inalámbricos, las puertas de enlace y los perfiles; sin embargo, también puede asignar a los recursos nombres más descriptivos para facilitar su identificación. Antes de agregar dispositivos, puertas de enlace, perfiles y destinos a AWS IoT Core para LoRaWAN, piense en cómo les asignará un nombre para que sea más fácil administrarlos. Puede agregar etiquetas a los recursos que crea. Antes de agregar sus dispositivos LoRaWAN, considere cómo podría usar las etiquetas para identificar y administrar sus recursos de AWS IoT Core para LoRaWAN. Las etiquetas se pueden modificar después de agregarlas. Para obtener más información acerca de cómo asignar nombres a los objetos y etiquetarlos, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md). ## Asignación de los datos del dispositivo a los datos del servicio Los datos de los dispositivos inalámbricos LoRaWAN suelen estar codificados para optimizar el ancho de banda. Estos mensajes codificados llegan a AWS IoT Core para LoRaWAN en un formato que otros servicios de AWS podrían no utilizar fácilmente. AWS IoT Core para LoRaWAN usa reglas de AWS IoT que pueden usar funciones de AWS Lambda para procesar y decodificar los mensajes del dispositivo en un formato que puedan usar otros servicios de AWS. Para transformar los datos del dispositivo y enviarlos a otros servicios de AWS, necesita saber: + El formato y el contenido de los datos que envían los dispositivos inalámbricos. + El servicio al que desea enviar los datos. + El formato que requiere el servicio. Con esa información, puede crear la regla de AWS IoT que realiza la conversión y envía los datos convertidos a los servicios de AWS que los utilizarán. ## Uso de la consola para incorporar el dispositivo y la puerta de enlace a AWS IoT Core para LoRaWAN Puede usar la interfaz de la consola o la API para agregar su puerta de enlace y dispositivos LoRaWAN. Si es la primera vez que la usa AWS IoT Core para LoRaWAN, le recomendamos que utilice la consola. La interfaz de la consola resulta más práctica cuando se gestionan varios recursos de AWS IoT Core para LoRaWAN a la vez. Cuando gestione una gran cantidad de recursos de AWS IoT Core para LoRaWAN, considere la posibilidad de crear soluciones más automatizadas mediante la API de AWS IoT Wireless. Gran parte de los datos que se introducen al configurar los recursos de AWS IoT Core para LoRaWAN los proporcionan los proveedores de los dispositivos y son específicos de las especificaciones de LoRaWAN que admiten. En los siguientes temas se describe cómo puede describir sus recursos de AWS IoT Core for LoRaWAN y cómo utilizar la consola o la API para agregar sus puertas de enlace y dispositivos. **nota** Si utiliza una red pública para conectar sus dispositivos LoRaWAN a la nube, puede omitir la incorporación de las puertas de enlace. Para obtener más información, consulte [Gestionar el tráfico LoRaWAN desde redes de dispositivos LoRaWAN públicas (Everynet)](iot-lorawan-roaming.md). **Topics** + [Convenciones de nomenclatura para sus dispositivos, puertas de enlace, perfiles y destinos](#lorawan-naming-convention) + [Asignación de los datos del dispositivo a los datos del servicio](#lorawan-service-device-data) + [Uso de la consola para incorporar el dispositivo y la puerta de enlace a AWS IoT Core para LoRaWAN](#lorawan-console) + [Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateways.md) + [Incorporar dispositivos a AWS IoT Core para LoRaWAN](lorawan-onboard-end-devices.md) # Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN Si es la primera vez que usa AWS IoT Core para LoRaWAN, puede agregar su primera puerta de enlace y dispositivo LoRaWAN mediante la consola. **nota** Si utiliza una red pública para conectar sus dispositivos LoRaWAN a la nube, puede omitir la incorporación de las puertas de enlace. Para obtener más información, consulte [Gestionar el tráfico LoRaWAN desde redes de dispositivos LoRaWAN públicas (Everynet)](iot-lorawan-roaming.md). **Antes de incorporar su puerta de enlace** Antes de incorporar su puerta de enlace a AWS IoT Core para LoRaWAN, le recomendamos que: + Utilice puertas de enlace aptas para su uso con AWS IoT Core para LoRaWAN. Estas puertas de enlace se conectan a AWS IoT Core sin ajustes de configuración adicionales, y cuentan con una versión 2.04 o superior del software [LoRa Basics Station](https://doc.sm.tc/station). Para obtener más información, consulte [Administrar puertas de enlace con AWS IoT Wireless](lorawan-manage-gateways.md). + Tenga en cuenta la convención de nomenclatura de los recursos que cree para poder administrarlos más fácilmente. Para obtener más información, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md). + Tenga preparados de antemano los parámetros de configuración exclusivos de cada puerta de enlace, para facilitar la introducción de los datos en la consola. Los parámetros de configuración de la puerta de enlace inalámbrica que AWS IoT requiere para comunicarse con la puerta de enlace y administrarla incluyen el EUI de la puerta de enlace y su banda de frecuencia LoRa. **Topics** + [Considere la selección de bandas de frecuencia y agregue el rol de IAM necesario](lorawan-rfregion-permissions.md) + [Agregar una puerta de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateway-add.md) + [Conectar una puerta de enlace LoRaWAN y verificar el estado de su conexión](lorawan-gateway-connection-status.md) # Considere la selección de bandas de frecuencia y agregue el rol de IAM necesario Antes de agregar la puerta de enlace a AWS IoT Core para LoRaWAN, le recomendamos que tenga en cuenta la banda de frecuencia en la que operará la puerta de enlace y que agregue el rol de IAM necesario para conectarla a AWS IoT Core para LoRaWAN. **nota** Si va a agregar la puerta de enlace mediante la consola, elija **Crear rol** en la consola para crear el rol de IAM necesario y, a continuación, omita estos pasos. Debe realizar estos pasos solo si utiliza la CLI para crear la puerta de enlace. ## Considere la posibilidad de seleccionar bandas de frecuencia LoRa para sus puertas de enlace y la conexión del dispositivo AWS IoT Core para LoRaWAN es compatible con las bandas de frecuencia EU863-870, US902-928, AU915 y AS923-1, que puede utilizar para conectar sus puertas de enlace y dispositivos que están presentes físicamente en países que admiten los rangos de frecuencia y las características de estas bandas. Las bandas EU863-870 y US902-928 se utilizan habitualmente en Europa y Norteamérica, respectivamente. La banda AS923-1 se usa habitualmente en Australia, Nueva Zelanda, Japón y Singapur, entre otros países. La AU915 se utiliza en Australia y Argentina, entre otros países. Para obtener más información sobre qué banda de frecuencia usar en su región o país, consulte los parámetros regionales de [LoRaWAN®](https://lora-alliance.org/resource_hub/rp2-101-lorawan-regional-parameters-2/). LoRa Alliance publica las especificaciones de LoRaWAN y los documentos de parámetros regionales que están disponibles para su descarga en el sitio web de LoRa Alliance. Los parámetros regionales de Alianza LoRa ayudan a las empresas a decidir qué banda de frecuencia utilizar en su región o país. La implementación de la banda de frecuencia de AWS IoT Core para LoRaWAN sigue la recomendación del documento de especificación de parámetros regionales. Estos parámetros regionales se agrupan en un conjunto de parámetros de radio, junto con una asignación de frecuencias que se adapta a la banda industrial, científica y médica (ISM). Le recomendamos que trabaje con los equipos de conformidad para asegurarse de cumplir los requisitos reglamentarios aplicables. ## Agregue un rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace Este procedimiento describe cómo agregar un rol de IAM que permita al servidor de configuración y actualización (CUPS) administrar las credenciales de la puerta de enlace. Asegúrese de realizar este procedimiento antes de que una puerta de enlace LoRaWAN intente conectarse con AWS IoT Core para LoRaWAN; sin embargo, solo debe hacerlo una vez. **Agregue el rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace** 1. Abra la página [Hub de roles de la consola de IAM](https://console.aws.amazon.com/iam/home#/roles) y elija **Crear rol**. 1. Si cree que ya ha agregado el rol **IoTWirelessGatewayCertManagerRole**, introduzca **IoTWirelessGatewayCertManagerRole** en la barra de búsqueda. Si ve un rol **IoWirelessGatewayCertManagerRole** en los resultados de la búsqueda, significa que tiene el rol de IAM necesario. Puede dejar el procedimiento ahora. Si los resultados de la búsqueda están vacíos, significa que no tiene el rol de IAM necesario. Siga el procedimiento para agregarlo. 1. En **Seleccionar el tipo de entidad de confianza**, elija **Otra Cuenta de AWS**. 1. En **ID de cuenta**, introduzca su ID de Cuenta de AWS y, a continuación, seleccione **Siguiente: Permisos**. 1. En el cuadro de búsqueda, escriba **AWSIoTWirelessGatewayCertManager**. 1. En la lista de resultados de la búsqueda, seleccione la política denominada **AWSIoTWirelessGatewayCertManager**. 1. Elija **Siguiente: Etiqueta** y, a continuación, seleccione **Siguiente: Revisar**. 1. En **Nombre de rol**, escriba **IoTWirelessGatewayCertManagerRole** y luego elija **Crear rol**. 1. Para editar el nuevo rol, elija **IoTWirelessGatewayCertManagerRole** en el mensaje de confirmación. 1. En la página **Resumen**, elija **Relaciones de confianza** y, a continuación, elija **Editar relación de confianza**. 1. En el **Documento de política**, cambie la propiedad `Principal` para que tenga el aspecto que se muestra en este ejemplo. ``` "Principal": { "Service": "iotwireless.amazonaws.com" }, ``` Tras cambiar la propiedad `Principal`, el documento de política completo deberá tener el aspecto que se muestra en este ejemplo. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotwireless.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Para guardar los cambios, elija **Actualizar política de confianza**. Ahora ha creado el rol **IoTWirelessGatewayCertManagerRole**. No tendrá que volver a hacer esto. Si ha realizado este procedimiento mientras agregaba una puerta de enlace, puede cerrar esta ventana y la consola de IAM, y volver a la consola de AWS IoT para terminar de agregar la puerta de enlace. # Agregar una puerta de enlace a AWS IoT Core para LoRaWAN Puede agregar la puerta de enlace a AWS IoT Core para LoRaWAN mediante la consola de o la CLI. Antes de agregar su puerta de enlace, le recomendamos que tenga en cuenta los factores mencionados en la sección **Antes de incorporar su puerta de enlace** de [Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateways.md). Si es la primera vez que agrega la puerta de enlace, le recomendamos que use la consola. Si, en su lugar, desea agregar la puerta de enlace mediante la CLI, debe haber creado ya el rol de IAM necesario para que la puerta de enlace pueda conectarse con AWS IoT Core para LoRaWAN. Para obtener más información acerca de cómo crear el rol, consulte [Agregue un rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace](lorawan-rfregion-permissions.md#lorawan-onboard-permissions). ## Agregar etiquetas a una puerta de enlace mediante la consola Vaya a la página **Introducción de [AWS IoT Core para LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing)** de la consola de AWS IoT, elija **Introducción** y, a continuación, elija **Agregar puerta de enlace**. Si ya ha agregado una puerta de enlace, seleccione **Ver puerta de enlace** para ver la puerta de enlace que ha agregado. Si desea agregar más puertas de enlace, elija **Agregar puerta de enlace**. 1. **Proporcionar los detalles de la puerta de enlace y la información de banda de frecuencia** Utilice la sección **Detalles de la puerta de enlace** para proporcionar información sobre los datos de configuración del dispositivo, como el EUI de la puerta de enlace y la configuración de la banda de frecuencia. + **EUI de la puerta de enlace** El EUI (identificador único extendido) del dispositivo de puerta de enlace individual. El EUI es un código alfanumérico de 16 dígitos, por ejemplo `c0ee40ffff29df10`, que identifica de forma exclusiva una puerta de enlace de su red LoRaWAN. Esta información es específica de su modelo de puerta de enlace y puede encontrarla en su dispositivo de puerta de enlace o en su manual de usuario. **nota** El EUI de la puerta de enlace es diferente de la dirección MAC de la red inalámbrica que puede ver impresa en su dispositivo de puerta de enlace. El EUI sigue un estándar EUI-64 que identifica de forma exclusiva la puerta de enlace y, por lo tanto, no se puede volver a utilizar en otras Cuenta de AWS y regiones. + **Banda de frecuencia (RFRegion)** La banda de frecuencia de la puerta de enlace. Puede elegir entre `US915`, `EU868`, `AU915` o `AS923-1`, según lo que admita su puerta de enlace y del país o la región desde la que se conecte físicamente la puerta de enlace. Para obtener más información sobre las bandas, consulte [Considere la posibilidad de seleccionar bandas de frecuencia LoRa para sus puertas de enlace y la conexión del dispositivo](lorawan-rfregion-permissions.md#lorawan-frequency-bands). 1. **Especifique los datos de configuración de la puerta de enlace inalámbrica (opcional)** Estos campos son opcionales y puede usarlos para proporcionar información adicional sobre la puerta de enlace y su configuración. + **Nombre, descripción y etiquetas de la puerta de enlace** La información de estos campos opcionales proviene de la forma en que organiza y describe los elementos de su sistema inalámbrico. Puede asignar un **nombre** a la puerta de enlace, usar el campo **Descripción** para proporcionar información sobre la puerta de enlace y utilizar **Etiquetas** para agregar pares de metadatos clave-valor sobre la puerta de enlace. Para obtener más información sobre cómo nombrar y describir sus recursos, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md). + **Configuración de LoRaWAN mediante subbandas y filtros** Opcionalmente, también puede especificar los datos de configuración de LoRaWAN, como las subbandas que desea utilizar y los filtros que pueden controlar el flujo de tráfico. Para ver el tutorial, puede omitir este paso. Para obtener más información, consulte [Configurar las subbandas y capacidades de filtrado de la puerta de enlace](lorawan-subband-filter-configuration.md). 1. **Asociar un objeto de AWS IoT a la puerta de enlace** Especifique si desea crear un objeto de AWS IoT y asociarlo a la puerta de enlace. Los objetos de AWS IoT incluidos pueden facilitar la búsqueda y la administración de los dispositivos. Al asociar un objeto a la puerta de enlace, la puerta de enlace puede acceder a otras características de AWS IoT Core. 1. **Crear y descargar el certificado de la puerta de enlace** Para autenticar su puerta de enlace y poder comunicarse de forma segura con AWS IoT, su puerta de enlace LoRaWAN debe presentar una clave privada y un certificado a AWS IoT Core para LoRaWAN. Cree un **certificado de puerta de enlace** para AWS IoT poder verificar la identidad de su puerta de enlace mediante el estándar X.509. Haga clic en el botón **Crear certificado** y descargue los archivos del certificado. Los usará más adelante para configurar su puerta de enlace. 1. **Copiar los puntos de conexión de CUPS y LNS, y descargar los certificados** Su puerta de enlace LoRaWAN debe conectarse a un puntos de conexión de CUPS o LNS cuando establece una conexión a AWS IoT Core para LoRaWAN. Le recomendamos que use el punto de conexión de CUPS, ya que también proporciona administración de la configuración. Para verificar la autenticidad de los puntos de conexión de AWS IoT Core para LoRaWAN, su puerta de enlace utilizará un certificado de confianza para cada uno de los puntos de conexión de CUPS y LNS. Haga clic en el botón **Copiar** para copiar los puntos de conexión de CUPS y LNS. Necesitará esta información más adelante para configurar la puerta de enlace. A continuación, elija el botón **Descargar los certificados de confianza del servidor** para descargar los certificados de confianza de los puntos de conexión de CUPS y LNS. 1. **Crear el rol de IAM para los permisos de la puerta de enlace** Debe agregar un rol de IAM que permita al servidor de configuración y actualización (CUPS) administrar las credenciales de la puerta de enlace. **nota** En este paso, se crea el rol **IoTWirelessGatewayCertManager**. Puede omitir el paso si ya ha creado este rol. Debe hacerlo antes de que una puerta de enlace LoRaWAN intente conectarse a AWS IoT Core para LoRaWAN; sin embargo, solo debe hacerlo una vez. Para crear el rol de IAM **IoTWirelessGatewayCertManager** para su cuenta, elija el botón **Crear rol**. Si el rol ya existe, selecciónelo en la lista desplegable. Haga clic en **Enviar** para completar la creación de la puerta de enlace. ## Agregar una puerta de enlace mediante la API Si va a agregar una puerta de enlace por primera vez mediante la API o la CLI, debe agregar el rol de IAM **IoWirelessGatewayCertManager** para que la puerta de enlace pueda conectarse con AWS IoT Core para LoRaWAN. Para obtener más información sobre el funcionamiento del rol, consulte las siguiente sección [Agregue un rol de IAM para permitir que el servidor de configuración y actualización (CUPS) administre las credenciales de la puerta de enlace](lorawan-rfregion-permissions.md#lorawan-onboard-permissions). En las siguientes listas, se describen las acciones API que realizan tareas asociadas a agregar, actualizar o eliminar una puerta de enlace LoRaWAN. **Acciones de API de AWS IoT Wireless para puertas de enlace de AWS IoT Core para LoRaWAN** + [CreateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html) + [GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html) + [ListWirelessGateways](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessGateways.html) + [UpdateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html) + [DeleteWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessGateway.html) Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Cómo utilizar la AWS CLI para agregar una puerta de enlace** Puede utilizar la AWS CLI para crear una puerta de enlace inalámbrica mediante el comando [create-wireless-gateway](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-wireless-gateway.html). En el siguiente ejemplo se crea una puerta de enlace inalámbrica de dispositivo LoRaWAN. También puede proporcionar un archivo `input.json` que contenga detalles adicionales, como el certificado de la puerta de enlace y las credenciales de aprovisionamiento. **nota** También puede realizar este procedimiento con la API utilizando los métodos de la API de AWS que corresponden a los comandos CLI que se muestran aquí. ``` aws iotwireless create-wireless-gateway \ --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \ --name "myFirstLoRaWANGateway" \ --description "Using my first LoRaWAN gateway" --cli-input-json input.json ``` Para obtener información sobre las CLI que puede usar, consulte la [referencia de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) # Conectar una puerta de enlace LoRaWAN y verificar el estado de su conexión Para comprobar el estado de la conexión de la puerta de enlace, debe haber agregado la puerta de enlace y haberla conectado a AWS IoT Core para LoRaWAN. Para obtener información sobre cómo agregar su puerta de enlace, consulte [Agregar una puerta de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateway-add.md). ## Conectar la puerta de enlace a AWS IoT Core para LoRaWAN Una vez que haya agregado la puerta de enlace, conéctese a la interfaz de configuración de la puerta de enlace para introducir la información de configuración y los certificados de confianza. Después de agregar la información de la puerta de enlace a AWS IoT Core para LoRaWAN, agregue información de AWS IoT Core para LoRaWAN al dispositivo de puerta de enlace. La documentación proporcionada por el proveedor de la puerta de enlace debe describir el proceso para subir los archivos de certificado en la puerta de enlace y configurar el dispositivo de puerta de enlace para comunicarse con AWS IoT Core para LoRaWAN. **Puertas de enlace aptas para su uso con AWS IoT Core para LoRaWAN** Para obtener instrucciones sobre cómo configurar su puerta de enlace LoRaWAN, consulte la sección del taller AWS IoT Core para LoRaWAN sobre cómo [configurar el dispositivo de puerta de enlace](https://iotwireless.workshop.aws/en/200_gateway/400_configuregateway.html). Aquí encontrará información sobre las instrucciones para conectar las puertas de enlace aptas para su uso con AWS IoT Core para LoRaWAN. **Puertas de enlace compatibles con el protocolo CUPS** En las instrucciones siguientes se muestra cómo puede conectar las puertas de enlace compatibles con el protocolo CUPS. 1. Suba los siguientes archivos que obtuvo al agregar su puerta de enlace. + Archivos de certificados y claves privadas del dispositivo de puerta de enlace. + Archivo de certificado de confianza para el punto de conexión de CUPS, `cups.trust`. 1. Especifique la URL del punto de conexión de CUPS que obtuvo anteriormente. El punto de conexión tendrá el formato `prefix.cups.lorawan.region.amazonaws.com:443`. Para obtener más información acerca de cómo obtener esta información, consulte [Agregar una puerta de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateway-add.md). **Puertas de enlace compatibles con el protocolo LNS** En las instrucciones siguientes se muestra cómo puede conectar las puertas de enlace compatibles con el protocolo LNS. 1. Suba los siguientes archivos que obtuvo al agregar su puerta de enlace. + Archivos de certificados y claves privadas del dispositivo de puerta de enlace. + Archivo de certificado de confianza para el punto de conexión LNS, `lns.trust`. 1. Especifique la URL del punto de conexión del LNS que obtuvo anteriormente. El punto de conexión tendrá el formato https://`prefix.lns.lorawan.region.amazonaws.com:443`. Para obtener más información acerca de cómo obtener esta información, consulte [Agregar una puerta de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateway-add.md). Una vez que haya conectado la puerta de enlace a AWS IoT Core para LoRaWAN, puede comprobar el estado de la conexión y obtener información sobre cuándo se recibió el último enlace ascendente mediante la consola o la API. ## Comprobar el estado de la conexión de la puerta de enlace mediante la consola Para comprobar el estado de la conexión mediante la consola, diríjase a la página [https://console.aws.amazon.com/iot/home#/wireless/gateways](https://console.aws.amazon.com/iot/home#/wireless/gateways) de la consola de AWS IoT y elige la puerta de enlace que ha agregado. En la sección **Detalles específicos de LoRaWAN** de la página de detalles de la puerta de enlace, verá el estado de la conexión, y la fecha y hora en que se recibió el último enlace ascendente. ## Comprobar el estado de la conexión de la puerta de enlace mediante la API Para comprobar el estado de la conexión mediante la API, utilice la API de `GetWirelessGatewayStatistics`. Esta API no tiene un cuerpo de solicitud y solo contiene un cuerpo de respuesta que muestra si la puerta de enlace está conectada y cuándo se recibió el último enlace ascendente. ``` HTTP/1.1 200 Content-type: application/json { “ConnectionStatus”: “Connected”, “LastUplinkReceivedAt”: “2021-03-24T23:13:08.476015749Z”, “WirelessGatewayId”: “30cbdcf3-86de-4291-bfab-5bfa2b12bad5" } ``` # Incorporar dispositivos a AWS IoT Core para LoRaWAN Una vez que haya incorporado su puerta de enlace AWS IoT Core para LoRaWAN y haya verificado su estado de conexión, podrá incorporar sus dispositivos inalámbricos. Para obtener información sobre cómo implementar su puerta de enlace, consulte [Incorporar las puertas de enlace a AWS IoT Core para LoRaWAN](lorawan-onboard-gateways.md). Los dispositivos LoRaWAN utilizan un protocolo LoRaWAN para intercambiar datos con aplicaciones alojadas en la nube. AWS IoT Core para LoRaWAN admite dispositivos que cumplen las especificaciones LoRaWAN 1.0.x o 1.1 que se ajusta a LoRa Alliance. Un dispositivo LoRaWAN normalmente contiene uno o más sensores y actores. Los dispositivos envían datos de telemetría de enlace ascendente a través de las puertas de enlace LoRaWAN a AWS IoT Core para LoRaWAN. Las aplicaciones alojadas en la nube pueden controlar los sensores enviando comandos de enlace descendente a los dispositivos LoRaWAN a través de las puertas de enlace LoRaWAN. **Antes de incorporar su dispositivo inalámbrico** Antes de incorporar el dispositivo inalámbrico a AWS IoT Core para LoRaWAN, debe tener preparada la siguiente información de antemano: + **Especificación de LoRaWAN y configuración del dispositivo inalámbrico** Tener listos de antemano los parámetros de configuración exclusivos de cada dispositivo facilita la introducción de los datos en la consola. Los parámetros específicos que debe introducir dependen de la especificación LoRaWAN que utilice el dispositivo. Para obtener una lista completa de sus especificaciones y parámetros de configuración, consulte la documentación de cada dispositivo. + **Nombre del dispositivo y descripción (opcional)** La información de estos campos opcionales proviene de la forma en que organiza y describe los elementos de su sistema inalámbrico. Para obtener más información acerca del nombre y la descripción de los recursos, consulte [Descripción de los recursos de AWS IoT Wireless](iotwireless-describe-resources.md). + **Perfiles de dispositivos y servicios** Tenga preparados varios parámetros de configuración de los dispositivos inalámbricos que muchos dispositivos comparten y que se pueden almacenar en AWS IoT Core para LoRaWAN como perfiles de dispositivo y servicio. Los parámetros de configuración se encuentran en la documentación del dispositivo o en el propio dispositivo. Deberá identificar un perfil de dispositivo que coincida con los parámetros de configuración del dispositivo o crear uno si es necesario antes de agregar el dispositivo. Para obtener más información, consulte [Agregar perfiles a AWS IoT Core para LoRaWAN](lorawan-define-profiles.md). + **Destino de AWS IoT Core para LoRaWAN** Cada dispositivo debe estar asignado a un destino que procese los mensajes para su envío a AWS IoT y otros servicios. Las reglas de AWS IoT que procesan y envían los mensajes del dispositivo son específicas del formato de los mensajes del dispositivo. Para procesar los mensajes del dispositivo y enviarlos al servicio correcto, identifique el destino que creará para usarlo con los mensajes del dispositivo y asígnelo al dispositivo. **Topics** + [Agregue su dispositivo inalámbrico a AWS IoT Core para LoRaWAN](lorawan-end-devices-add.md) + [Agregar perfiles a AWS IoT Core para LoRaWAN](lorawan-define-profiles.md) + [Agregar destinos a AWS IoT Core para LoRaWAN](lorawan-create-destinations.md) + [Crear reglas para procesar los mensajes del dispositivo LoRaWAN](lorawan-destination-rules.md) + [Conectar un dispositivo LoRaWAN y verificar el estado de su conexión](lorawan-device-connection-status.md) # Agregue su dispositivo inalámbrico a AWS IoT Core para LoRaWAN Si es la primera vez que agrega el dispositivo inalámbrico, le recomendamos que use la consola. Vaya a la página **Introducción de [AWS IoT Core para LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/landing)** de la consola de AWS IoT, seleccione **Introducción** y, a continuación, elija **Agregar dispositivo**. Si ya ha agregado un dispositivo, seleccione **Ver dispositivo** para ver la puerta de enlace que ha agregado. Si quiere agregar más dispositivos, seleccione **Agregar dispositivo**. Como alternativa, también puede agregar dispositivos inalámbricos desde la página [Dispositivos](https://console.aws.amazon.com/iot/home#/wireless/devices) de la consola de AWS IoT. ## Agregar las especificaciones de un dispositivo inalámbrico a AWS IoT Core para LoRaWAN con la consola Elija una **especificación de dispositivo inalámbrico** según su método de activación y la versión de LoRaWAN. Una vez seleccionados, los datos se cifran con una clave que AWS guarda y administra por usted. **Modos de activación OTAA y ABP** Para que su dispositivo LoRaWAN pueda enviar datos de enlace ascendente, debe completar un proceso denominado procedimiento de *activación* o *unión*. Para activar su dispositivo, puede utilizar OTAA (Activación inalámbrica) o ABP (Activación mediante personalización). ABP no requiere un procedimiento de unión y utiliza claves estáticas. Cuando utiliza OTAA, su dispositivo LoRaWAN envía una solicitud de unión y el servidor de red puede aceptarla. Le recomendamos que utilice OTAA para activar el dispositivo, ya que se generan nuevas claves de sesión para cada activación, lo que lo hace más seguro. **Versión de LoRaWAN** Cuando utiliza OTAA, su dispositivo LoRaWAN y las aplicaciones alojadas en la nube comparten las claves raíz. Estas claves raíz dependen de si utiliza la versión v1.0.x o v1.1. La versión v1.0.x solo tiene una clave raíz, **AppKey** (clave de aplicación), mientras que la versión v1.1 tiene dos claves raíz, **AppKey** (clave de aplicación) y **NwkKey (clave de red)**. Las claves de sesión se obtienen en función de las claves raíz de cada activación. Tanto **NWKKey** como **AppKey** son valores hexadecimales de 32 dígitos proporcionados por su proveedor de servicios inalámbricos. **EUI de dispositivos inalámbricos** Tras seleccionar la **Especificación del dispositivo inalámbrico**, verá los parámetros del EUI (identificador único extendido) del dispositivo inalámbrico que se muestran en la consola. Puede encontrar esta información en la documentación del dispositivo o del proveedor de servicios inalámbricos. + **DevEUI**: valor hexadecimal de 16 dígitos que es exclusivo del dispositivo y que se encuentra en la etiqueta del dispositivo o en su documentación. + **AppEUI**: valor hexadecimal de 16 dígitos que es exclusivo del servidor de unión y que se encuentra en la documentación del dispositivo. En la versión 1.1 de LoRaWAN, **AppEUI** se denomina **JoinEUI**. Para obtener más información sobre los identificadores únicos, las claves de sesión y las claves raíz, consulte la documentación de [LoRa Alliance](https://lora-alliance.org/about-lorawan). ## Agregar la especificación del dispositivo inalámbrico a AWS IoT Core para LoRaWAN mediante la API Si va a agregar un dispositivo inalámbrico mediante la API, primero debe crear el perfil del dispositivo y el perfil de servicio antes de crear el dispositivo inalámbrico. Utilizará el perfil del dispositivo y el ID del perfil de servicio al crear el dispositivo inalámbrico. Para obtener información acerca de cómo crear estos perfiles con la API, consulte [Agregar un perfil de dispositivo mediante la API](lorawan-define-profiles.md#lorawan-device-profile-api). En las siguientes listas se describen las acciones de la API que realizan las tareas asociadas a agregar, actualizar o eliminar un perfil de servicio. **Acciones de la API de AWS IoT Wireless para los perfiles de servicio** + [CreateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessDevice.html) + [GetWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDevice.html) + [ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices.html) + [UpdateWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDevice.html) + [DeleteWirelessDevice](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDevice.html) Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Cómo utilizar la AWS CLI para crear un dispositivo inalámbrico** Puede utilizar la AWS CLI para crear un dispositivo inalámbrico mediante el comando [create-wireless-device](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). En el siguiente ejemplo, se crea un dispositivo inalámbrico mediante un archivo input.json para introducir los parámetros. **nota** También puede realizar este procedimiento con la API utilizando los métodos de la API de AWS que corresponden a los comandos CLI que se muestran aquí. **Contenido de input.json** ``` { "Description": "My LoRaWAN wireless device" "DestinationName": "IoTWirelessDestination" "LoRaWAN": { "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333", "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100", "OtaaV1_1": { "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012", "JoinEui": "b4c231a359bc2e3d", "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4" }, "DevEui": "ac12efc654d23fc2" }, "Name": "SampleIoTWirelessThing" "Type": LoRaWAN } ``` Puede proporcionar este archivo como entrada al comando `create-wireless-device`. ``` aws iotwireless create-wireless-device \ --cli-input-json file://input.json ``` Para obtener información sobre las CLI que puede usar, consulte la [referencia de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) # Agregar perfiles a AWS IoT Core para LoRaWAN Los perfiles de dispositivos y servicios se pueden definir para describir las configuraciones comunes de los dispositivos. Estos perfiles describen los parámetros de configuración que comparten los dispositivos para facilitar su agregación. AWS IoT Core para LoRaWAN admite perfiles de dispositivos y perfiles de servicio. Los parámetros de configuración y los valores que se deben introducir en estos perfiles los proporciona el fabricante del dispositivo. ## Agregar perfiles de dispositivos Los perfiles de dispositivo definen las capacidades del dispositivo y los parámetros de arranque que el servidor de red utiliza para configurar el servicio de acceso por radio LoRaWAN. Incluye una selección de parámetros como la banda de frecuencia de LoRa, la versión de los parámetros regionales de LoRa y la versión MAC del dispositivo. Para obtener más información sobre las diferentes bandas de frecuencia, consulte [Considere la posibilidad de seleccionar bandas de frecuencia LoRa para sus puertas de enlace y la conexión del dispositivo](lorawan-rfregion-permissions.md#lorawan-frequency-bands). ### Agregar un perfil de dispositivo mediante la consola Si va a agregar un dispositivo inalámbrico mediante la consola tal y como se describe en [Agregar las especificaciones de un dispositivo inalámbrico a AWS IoT Core para LoRaWAN con la consola](lorawan-end-devices-add.md#lorawan-end-device-spec-console), después de agregar la especificación del dispositivo inalámbrico, puede agregar el perfil de su dispositivo. Como alternativa, también puede agregar dispositivos inalámbricos desde la página [Perfiles](https://console.aws.amazon.com/iot/home#/wireless/profiles) de la consola de AWS IoT, en la pestaña **LoRaWAN**. Puede elegir entre los perfiles de dispositivo predeterminados o crear un perfil de dispositivo nuevo. Le recomendamos que utilice los perfiles de dispositivo predeterminados. Si la aplicación requiere que cree un perfil de dispositivo, proporcione un **nombre de perfil de dispositivo**, seleccione la **banda de frecuencia (RfRegion)** que está utilizando para el dispositivo y la puerta de enlace, y mantenga los demás ajustes con los valores predeterminados, a menos que se especifique lo contrario en la documentación del dispositivo. ### Agregar un perfil de dispositivo mediante la API Si va a agregar un dispositivo inalámbrico mediante la API, debe crear el perfil de su dispositivo antes de crear el dispositivo inalámbrico. En las siguientes listas se describen las acciones de la API que realizan las tareas asociadas a agregar, actualizar o eliminar un perfil de servicio. **Acciones de la API de AWS IoT Wireless para los perfiles de servicio** + [CreateDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDeviceProfile.html) + [GetDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDeviceProfile.html) + [ListDeviceProfiles](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDeviceProfiles.html) + [UpdateDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDeviceProfile.html) + [DeleteDeviceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDeviceProfile.html) Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Cómo utilizar la AWS CLI para crear un perfil de dispositivo** Puede utilizar la AWS CLI para crear un perfil de dispositivo mediante el comando [create-device-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-device-profile.html). En el ejemplo siguiente se crea un perfil de dispositivo. ``` aws iotwireless create-device-profile ``` Al ejecutar este comando, se crea automáticamente un perfil de dispositivo con un ID que puede utilizar al crear el dispositivo inalámbrico. Ahora puede crear el perfil de servicio mediante la siguiente API y, a continuación, crear el dispositivo inalámbrico mediante los perfiles de dispositivo y servicio. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` Para obtener información sobre las CLI que puede usar, consulte la [referencia de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html) ## Agregar perfiles de servicio Los perfiles de servicio describen los parámetros de comunicación que el dispositivo necesita para comunicarse con el servidor de aplicaciones. ### Agregar un perfil de servicio mediante la consola Si desea agregar un dispositivo inalámbrico mediante la consola como se describe en [Agregar las especificaciones de un dispositivo inalámbrico a AWS IoT Core para LoRaWAN con la consola](lorawan-end-devices-add.md#lorawan-end-device-spec-console), puede agregar su perfil de servicio después de agregar el perfil del dispositivo. Como alternativa, también puede agregar dispositivos inalámbricos desde la página [Perfiles](https://console.aws.amazon.com/iot/home#/wireless/profiles) de la consola de AWS IoT, en la pestaña **LoRaWAN**. Le recomendamos que deje habilitada la configuración **AddGWMetaData** para recibir metadatos de puerta de enlace adicionales por cada carga, como RSSI y SNR para la transmisión de datos. ### Agregar un perfil de servicio mediante la API Si desea agregar un dispositivo inalámbrico mediante la API, primero debe crear su perfil de servicio antes de crear el dispositivo inalámbrico. En las siguientes listas se describen las acciones de la API que realizan las tareas asociadas a agregar, actualizar o eliminar un perfil de servicio. **Acciones de la API de AWS IoT Wireless para los perfiles de servicio** + [CreateServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateServiceProfile.html) + [GetServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetServiceProfile.html) + [ListServiceProfiles](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListServiceProfiles.html) + [ UpdateServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateServiceProfile.html) + [DeleteServiceProfile](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteServiceProfile.html) Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Cómo utilizar la AWS CLI para crear un perfil de servicio** Puede usar la AWS CLI para crear un servicio con el comando [create-service-profile](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-service-profile.html). En el siguiente ejemplo, se crea un perfil de servicio. ``` aws iotwireless create-service-profile ``` Al ejecutar este comando, se crea automáticamente un perfil de servicio con un ID que puede utilizar al crear el dispositivo inalámbrico. Ahora puede crear el dispositivo inalámbrico con los perfiles de dispositivo y servicio. ``` { "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ServiceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d", "Id": "12345678-a1b2-3c45-67d8-e90fa1b2c34d" } ``` # Agregar destinos a AWS IoT Core para LoRaWAN Los destinos de AWS IoT Core for LoRaWAN describen la regla de AWS IoT que procesa los datos de un dispositivo para su uso por parte de los servicios de AWS. Como la mayoría de los dispositivos LoRaWAN no envían datos a AWS IoT Core for LoRaWAN en un formato que puedan utilizar los servicios de AWS, una regla de AWS IoT debe procesarlos primero. La regla de AWS IoT contiene la instrucción SQL que interpreta los datos del dispositivo y las acciones de la regla temática que envían el resultado de la instrucción SQL a los servicios que la utilizarán. Si es la primera vez que agrega el destino, le recomendamos que use la consola. ## Agregar un destino mediante la consola Si desea agregar un dispositivo inalámbrico mediante la consola como se describe en [Agregar las especificaciones de un dispositivo inalámbrico a AWS IoT Core para LoRaWAN con la consola](lorawan-end-devices-add.md#lorawan-end-device-spec-console), después de haber agregado las especificaciones y los perfiles del dispositivo inalámbrico a AWS IoT Core para LoRaWAN como se describió anteriormente, puede continuar y agregar un destino. Como alternativa, también puede agregar un destino de AWS IoT Core para LoRaWAN desde la página [Destinos](https://console.aws.amazon.com/iot/home#/wireless/destinations) de la consola de AWS IoT. Para procesar los datos de un dispositivo, especifique los siguientes campos al crear un destino de AWS IoT Core for LoRaWAN y, a continuación, elija **Agregar destino**. + **Detalles de destino** Introduzca un **Nombre de destino** y una descripción opcional para su destino. + **Nombre de la regla** La regla de AWS IoT que se configura para evaluar los mensajes enviados por el dispositivo y procesar los datos del dispositivo. El nombre de la regla se asignará a su destino. El destino requiere que la regla procese los mensajes que recibe. Puede elegir que los mensajes se procesen invocando una regla de AWS IoT o publicándolos en el agente de mensajes de AWS IoT. + Si selecciona **Introducir un nombre de regla**, introduzca un nombre y, a continuación, elija **Copiar** para copiar el nombre de la regla que introducirá al crear la regla de AWS IoT. Puede elegir **Crear regla** para crear la regla ahora o ir al [Centro de reglas](https://console.aws.amazon.com/iot/home#/create/rule) de la consola de AWS IoT y crear una regla con ese nombre. También puede introducir una regla y usar la configuración **Avanzada** para especificar el nombre de un tema. El nombre del tema se proporciona durante la invocación de la regla y se accede a él mediante la expresión `topic` incluida en la regla. Para obtener más información acerca de las reglas de AWS IoT, consulte [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html). + Si elige **Publicar en el agente de mensajes de AWS IoT**, introduzca el nombre del tema. A continuación, puede copiar el nombre del tema de MQTT y varios suscriptores podrán suscribirse a este tema para recibir los mensajes publicados sobre ese tema. Para obtener más información, consulte [https://docs.aws.amazon.com/iot/latest/developerguide/topics.html](https://docs.aws.amazon.com/iot/latest/developerguide/topics.html). Para obtener más información sobre las reglas de AWS IoT, consulte [Crear reglas para procesar los mensajes del dispositivo LoRaWAN](lorawan-destination-rules.md). + **Nombre de rol** El rol de IAM que concede a los datos del dispositivo el permiso para acceder a la regla nombrada **Nombre de regla**. En la consola, elija un rol de servicio existente o cree uno nuevo. Si va a crear un nuevo rol de servicio, puede introducir un nombre de rol (por ejemplo, **IoTWirelessDestinationRole**) o dejarlo en blanco para que AWS IoT Core para LoRaWAN genere un nuevo nombre de rol. AWS IoT Core para LoRaWAN creará automáticamente el rol de IAM con los permisos adecuados en su nombre. Para obtener más información sobre los roles de IAM, consulte [Uso de roles de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html). ## Agregar un destino mediante la API Si, en su lugar, desea agregar un destino mediante la CLI, debe haber creado ya la regla y el rol de IAM para su destino. Para obtener más información acerca de los detalles que un destino requiere en la función, consulte [Crear un rol de IAM para los destinos](#lorawan-create-destinations-roles). La siguiente lista contiene las acciones de la API que realizan las tareas asociadas a agregar, actualizar o eliminar un destino. **Acciones de la API de AWS IoT Wireless para destinos** + [CreateDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateDestination.html) + [GetDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetDestination.html) + [ListDestinations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDestinations.html) + [UpdateDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateDestination.html) + [DeleteDestination](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteDestination.html) Para ver la lista completa de las acciones y los tipos de datos disponibles para crear y administrar recursos de AWS IoT Core para LoRaWAN, consulte la [referencia de la API de AWS IoT Wireless](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/welcome.html). **Cómo utilizar la AWS CLI para agregar un destino** Puede utilizar la AWS CLI para agregar un destino mediante el comando [create-destination](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-destination.html). En el siguiente ejemplo, se muestra cómo crear un destino introduciendo el nombre de una regla de `RuleName` como valor para el parámetro `expression-type`. Si desea especificar un nombre de tema para publicarlo o suscribirse al agente de mensajes, cambie el valor del parámetro `expression-type` a `MqttTopic`. ``` aws iotwireless create-destination \ --name IoTWirelessDestination \ --expression-type RuleName \ --expression IoTWirelessRule \ --role-arn arn:aws:iam::123456789012:role/IoTWirelessDestinationRole ``` Al ejecutar este comando, se crea un destino con el nombre del destino, el nombre de la regla y el nombre del rol especificados. Para obtener información sobre los nombres de reglas y roles de los destinos, consulte [Crear reglas para procesar los mensajes del dispositivo LoRaWAN](lorawan-destination-rules.md) y [Crear un rol de IAM para los destinos](#lorawan-create-destinations-roles). Para obtener información sobre las CLI que puede usar, consulte la [referencia de AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/index.html). ## Crear un rol de IAM para los destinos Los destinos de AWS IoT Core para LoRaWAN requieren roles de IAM que otorguen a AWS IoT Core para LoRaWAN los permisos necesarios para enviar datos a la regla de AWS IoT. Si dicho rol aún no está definido, debe definirlo para que aparezca en la lista de roles. Cuando utiliza la consola para agregar un destino, AWS IoT Core para LoRaWAN crea automáticamente un rol de IAM para sí, tal y como se describió anteriormente en este tema. Cuando agrega un destino mediante la API o la CLI, debe crear el rol de IAM para su destino. **Para crear una política de IAM para su rol de destino de AWS IoT Core para LoRaWAN** 1. Abra la página [Central de políticas de la consola de IAM](https://console.aws.amazon.com/iam/home#/policies). 1. Elija **Crear política** y, a continuación, elija la pestaña **JSON**. 1. En el editor, elimine cualquier contenido del editor y pegue este documento de política. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:DescribeEndpoint", "iot:Publish" ], "Resource": "*" } ] } ``` 1. En **Revisar política**, en **Nombre**, escriba un nombre para la política. Necesitará este nombre para usarlo en el procedimiento siguiente. Si lo desea, también puede describir esta política en **Descripción**. 1. Elija **Crear política**. **Para crear un rol de IAM para un destino de AWS IoT Core para LoRaWAN** 1. Abra la página [Hub de roles de la consola de IAM](https://console.aws.amazon.com/iam/home#/roles) y elija **Crear rol**. 1. En **Seleccionar el tipo de entidad de confianza**, elija **Otra Cuenta de AWS**. 1. En **ID de cuenta**, introduzca su ID de Cuenta de AWS y, a continuación, seleccione **Siguiente: Permisos**. 1. En el cuadro de búsqueda, escriba el nombre de la política de IAM que creó en el procedimiento anterior. 1. En los resultados de la búsqueda, compruebe la política de IAM creada en el procedimiento anterior. 1. Elija **Siguiente: Etiqueta** y, a continuación, seleccione **Siguiente: Revisar**. 1. En **Nombre del rol**, introduzca el nombre de este rol y, a continuación, elija **Crear rol**. 1. En el mensaje de confirmación, seleccione el nombre del rol que creó para editar el nuevo rol. 1. En la página **Resumen**, elija **Relaciones de confianza** y, a continuación, elija **Editar relación de confianza**. 1. En el **Documento de política**, cambie la propiedad `Principal` para que tenga el aspecto que se muestra en este ejemplo. ``` "Principal": { "Service": "iotwireless.amazonaws.com" }, ``` Tras cambiar la propiedad `Principal`, el documento de política completo deberá tener el aspecto que se muestra en este ejemplo. ``` { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "iotwireless.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": {} } ] } ``` 1. Para guardar los cambios, elija **Actualizar política de confianza**. Con este rol definido, puede encontrarlo en la lista de roles al configurar sus destinos de AWS IoT Core para LoRaWAN. # Crear reglas para procesar los mensajes del dispositivo LoRaWAN Las reglas de AWS IoT envían mensajes del dispositivo a otros servicios. Las reglas de AWS IoT también pueden procesar los mensajes binarios recibidos desde un dispositivo LoRaWAN para convertirlos a otros formatos que faciliten su uso para otros servicios. [Los destinos de AWS IoT Core para LoRaWAN](lorawan-create-destinations.md) asocian un dispositivo inalámbrico a la regla que procesa los datos de los mensajes del dispositivo para enviarlos a otros servicios. La regla actúa sobre los datos del dispositivo en cuanto AWS IoT Core para LoRaWAN los recibe. Los [destinos de AWS IoT Core para LoRaWAN](lorawan-create-destinations.md) pueden ser compartidos por todos los dispositivos cuyos mensajes tengan el mismo formato de datos y que envíen sus datos al mismo servicio. ## Cómo procesa AWS IoT las reglas los mensajes de los dispositivos La forma en que una regla de AWS IoT procesa los datos de los mensajes de un dispositivo depende del servicio que recibirá los datos, del formato de los datos de los mensajes del dispositivo y del formato de datos que requiera el servicio. Normalmente, la regla llama a una función de AWS Lambda para convertir los datos de los mensajes del dispositivo al formato que requiere un servicio y, a continuación, envía el resultado al servicio. La siguiente ilustración muestra cómo se protegen y procesan los datos de los mensajes a medida que pasan del dispositivo inalámbrico a un servicio de AWS. ![\[Imagen que muestra cómo AWS IoT Core para LoRaWAN transfiere los datos desde un dispositivo inalámbrico hasta AWS IoT y otros servicios.\]](http://docs.aws.amazon.com/es_es/iot-wireless/latest/developerguide/images/iot-lorawan-data-flow.png) 1. El dispositivo inalámbrico LoRaWAN cifra sus mensajes binarios mediante el modo CTR AES128 antes de transmitirlos. 1. AWS IoT Core para LoRaWAN descifra el mensaje binario y codifica la carga del mensaje binario descifrado como una cadena de base64. 1. El mensaje codificado en base64 resultante se envía como una carga de mensajes (sin el formato de un documento JSON) a la regla de AWS IoT descrita en el destino asignado al dispositivo. 1. La regla de AWS IoT dirige los datos del mensaje al servicio descrito en la configuración de la regla. La carga binaria cifrada recibida desde el dispositivo inalámbrico no es alterada ni interpretada por AWS IoT Core para LoRaWAN. La carga descifrada del mensaje binario se codifica únicamente como una cadena de base 64. Para que los servicios accedan a los elementos de datos de la carga del mensaje binario, los elementos de datos deben ser extraídos de la carga mediante una función llamada por la regla. La carga del mensaje codificada en base64 es una cadena ASCII, por lo que podría almacenarse como tal para analizarla posteriormente. ## Crear reglas para dispositivos LoRaWAN AWS IoT Core para LoRaWAN utiliza reglas de AWS IoT para enviar de forma segura los mensajes del dispositivo directamente a otros servicios de AWS sin necesidad de utilizar el agente de mensajes. Al eliminar el agente de mensajes de la ruta de ingestión, se reducen los costes y se optimiza el flujo de datos. Para que una regla de AWS IoT Core para LoRaWAN envíe mensajes de dispositivos a otros servicios de AWS, necesita un destino de AWS IoT Core para LoRaWAN y una regla de AWS IoT asignada a ese destino. La regla de AWS IoT debe contener una instrucción de consulta SQL y al menos una acción de regla. Normalmente, la instrucción de consulta de la regla de AWS IoT se compone de: + Una cláusula SELECT de SQL que selecciona y formatea los datos de la carga del mensaje + Un filtro de tema (el objeto FROM de la instrucción de consulta de la regla) que identifica los mensajes que se van a utilizar + Una instrucción condicional opcional (una cláusula WHERE de SQL) que especifica las condiciones sobre las que actuar A continuación, se muestra un ejemplo de una instrucción de consulta de regla: ``` SELECT temperature FROM iot/topic' WHERE temperature > 50 ``` Al crear reglas de AWS IoT para procesar las cargas útiles de los dispositivos LoRaWAN, no es necesario especificar la cláusula FROM como parte de la cosa de consulta de reglas. La instrucción de consulta de la regla debe tener la cláusula SQL SELECT y, de forma opcional, puede tener la cláusula WHERE. Si la instrucción de consulta utiliza la cláusula FROM, se ignora. A continuación, se muestra un ejemplo de una instrucción de consulta de reglas que puede procesar cargas de dispositivos LoRaWAN: ``` SELECT WirelessDeviceId, WirelessMetadata.LoRaWAN.FPort as FPort, WirelessMetadata.LoRaWAN.DevEui as DevEui, PayloadData ``` En este ejemplo, `PayloadData` es una carga binaria codificada en base64 enviada por su dispositivo LoRaWAN. Este es un ejemplo de instrucción de consulta de reglas que puede realizar una decodificación binaria de la carga entrante y transformarla en un formato diferente, como JSON: ``` SELECT WirelessDeviceId, WirelessMetadata.LoRaWAN.FPort as FPort, WirelessMetadata.LoRaWAN.DevEui as DevEui, aws_lambda("arn:aws:lambda:::function:", { "PayloadData":PayloadData, "Fport": WirelessMetadata.LoRaWAN.FPort }) as decodingoutput ``` Para obtener más información sobre el uso de las cláusulas SELECT Y WHERE, consulte [https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-reference.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-sql-reference.html). Para obtener información sobre cómo utilizar la las reglas de AWS IoT para crearlas y utilizarlas, consulte [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules.html) y [https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules-tutorial.html](https://docs.aws.amazon.com/iot/latest/developerguide/iot-rules-tutorial.html). Para obtener información sobre cómo crear y utilizar destinos de AWS IoT Core para LoRaWAN, consulte [Agregar destinos a AWS IoT Core para LoRaWAN](lorawan-create-destinations.md). Para obtener información sobre el uso de cargas de mensajes binarios en una regla, consulte [https://docs.aws.amazon.com/iot/latest/developerguide/binary-payloads.html](https://docs.aws.amazon.com/iot/latest/developerguide/binary-payloads.html). Para obtener más información sobre la seguridad y el cifrado de los datos utilizados para proteger la carga del mensaje durante su viaje, consulte [Protección de datos en AWS IoT Wireless](data-protection.md). Para ver una arquitectura de referencia que muestre un ejemplo de decodificación binaria e implementación de reglas de IoT, consulte [Ejemplos de soluciones en GitHub de AWS IoT Core para LoRaWAN](https://github.com/aws-samples/aws-iot-core-lorawan/tree/main/transform_binary_payload). # Conectar un dispositivo LoRaWAN y verificar el estado de su conexión Para poder comprobar el estado de la conexión del dispositivo, debe haber agregado su dispositivo y haberlo conectado a AWS IoT Core para LoRaWAN. Para obtener información sobre cómo agregar su dispositivo, consulte [Agregue su dispositivo inalámbrico a AWS IoT Core para LoRaWAN](lorawan-end-devices-add.md). Una vez que haya agregado el dispositivo, consulte el manual del usuario del dispositivo para obtener información sobre cómo iniciar el envío de un mensaje de enlace ascendente desde su dispositivo LoRaWAN. ## Comprobar el estado de la conexión del dispositivo mediante la consola Para comprobar el estado de la conexión mediante la consola, vaya a la página [https://console.aws.amazon.com/iot/home#/wireless/devices](https://console.aws.amazon.com/iot/home#/wireless/devices) de la consola de AWS IoT y seleccione el dispositivo que has agregado. En la sección **Detalles** de la página de detalles de los dispositivos inalámbricos, verá la fecha y la hora en que se recibió el último enlace. ## Comprobar el estado de conexión del dispositivo con la API Para comprobar el estado de la conexión mediante la API, utilice la API de `GetWirelessDeviceStatistics`. Esta API no tiene un cuerpo de solicitud y solo contiene un cuerpo de respuesta que muestra cuándo se recibió el último enlace ascendente. ``` HTTP/1.1 200 Content-type: application/json { “LastUplinkReceivedAt”: “2021-03-24T23:13:08.476015749Z”, "LoRaWAN": { "DataRate": 5, "DevEui": "647fda0000006420", "Frequency": 868100000 "Gateways": [ { "GatewayEui": "c0ee40ffff29df10", "Rssi": -67, "Snr": 9.75 } ], “WirelessDeviceId”: “30cbdcf3-86de-4291-bfab-5bfa2b12bad5" } ``` ## Siguientes pasos Ahora que ha conectado el dispositivo y ha comprobado el estado de la conexión, puede observar el formato de los metadatos del enlace ascendente recibidos del dispositivo mediante el [cliente de pruebas MQTT de la página de pruebas](https://console.aws.amazon.com/iot/home#/test) de la **consola de AWS IoT**. Para obtener más información, consulte [Ver el formato de los mensajes de enlace ascendente enviados desde dispositivos LoRaWAN](lorawan-uplink-metadata-format.md).