cumulocity lora
v1.1.6
Puede instalar el complemento Lora Cumulocity desde la aplicación de administración, debe estar disponible en el menú Ecosistema -> Aplicaciones -> PAQUETES.
Si no, descargue el archivo zip de la última versión e instálelo en los paquetes de aplicaciones (disponible en el menú indicado arriba): https://github.com/softwareag/cumulocity-lora/releases/latest/download/sag-ps-iot-pkg-lora-package.zip
Está destinado a instalarse solo en la aplicación DevicEragement.
Este complemento requiere que la función de microservicio habilitada en su inquilino funcione. Si está en un inquilino de prueba, comuníquese con su representante de ventas para hacerlo, o comuníquese con el soporte en Empower.
Una vez que la función de microservicio esté habilitada, instale el microservicio de GitHub-Proxy que se puede descargar de esta URL: https://github.com/softwareag/cumulocity-lora/releases/latest/download/github-proxy.zip
Cuando se instale el microservicio de GitHub-Proxy, simplemente vaya a la aplicación DeviceManagement, luego al menú Lora/Config. Desde allí, simplemente seleccione los microservicios que desea instalar en su inquilino.
Verá 2 tipos de microservicios: conectores LNS, generalmente llamados lora-ns- y códecs, generalmente llamados lora-codec-
En la aplicación DevicEragement-Lora, vaya a los servidores de red Lora/Lora. Simplemente le dé un nombre a su conector, luego seleccione el tipo de LNS al que desea conectarse (el tipo que está buscando solo aparecerá si se instala el microservicio correspondiente).
Asegúrese de que LNS que desea conectarse a la acumulocidad esté configurado correctamente (algunos LN requieren la creación de una clave API, por ejemplo). Una vez que se seleccione el tipo, simplemente siga las instrucciones del asistente. Los dispositivos ya aprovisionados se agregarán automáticamente a la acumulocidad una vez que envíen datos y sus datos son reenviados por el LNS a la acumulocidad. Ejemplo para TTN:
Y otro para Chirpstack:
Una vez que se crea el conector, Cumulocity creará automáticamente una ruta HTTP en el LNS para impulsar los datos del LNS al inquilino actual de Cumulocity. Además, todos los dispositivos existentes en el LNS se crearán automáticamente en Cumulocity una vez que envíen datos y los datos se impulsan a la acumulocidad a través de la ruta HTTP configurada. Esos dispositivos se crearán sin un códec asociado a ellos, por lo tanto, deberá ir a la vista detallada del dispositivo para elegir el códec correcto. No se perderá cualquier carga útil enviada a Cumulocity Priori Codec Selection: se almacenará y podrá procesarla una vez que haya elegido el códec correcto.
En la aplicación DevicErage-Lora, vaya al menú Lora/Lora Devices.
Para aprovisionar el dispositivo en un LNS, debe verificar la casilla etiquetada como "Dispositivo de provisión en el servidor de red Lora": luego podrá elegir el conector LNS relacionado con el LNS en el que desea prestar el dispositivo. Dependiendo del tipo de conector LNS que elija, aparecerán diferentes campos para finalizar el aprovisionamiento del dispositivo en ese LNS específico.
Ejemplo para TTN:
Y otro para Chirpstack:
En la aplicación DevicErage-Lora, vaya al menú Lora/Lora Gateways.
Dependiendo del conector LNS que elija, aparecerán diferentes campos.
Ejemplo con TTN:
Otro con actilidad:
Para poder aprovisionar una puerta de enlace, algunos LN requieren autorización específica. Por ejemplo, TTN requiere una clave API de usuario, ya que una clave API de la aplicación solo le permitirá administrar dispositivos en una aplicación específica.
Los dispositivos Lora, identificados por un fragmento JSON lora_ns_device_LoRaDevice , se pueden administrar desde una vista específica accesible a través del submenú "lora" en la vista detallada del dispositivo.
En este punto de vista se pueden realizar varias acciones:
Puede cambiar el códec en cualquier momento. Si selecciona lo incorrecto y no pudo procesar una carga útil entrante, la carga útil permanecerá en un estado sin procesar y podrá reprocesarla más tarde.
Puede habilitar el modo de depuración, que generará un evento especial para cada carga útil entrante que contendrá la carga útil decodificada completa.
También puede optar por almacenar las últimas medidas en el dispositivo en sí, por lo que podrá usarlas en widgets específicos, pero también agregarlas como columnas en la tabla "Todos los dispositivos".
Los dispositivos que se importan automáticamente no tendrán un códec configurado, y las cargas útiles se almacenarán en un estado sin procesar. Podrá procesarlos una vez que haya configurado un códec.
Puede cambiar un dispositivo a otro LNS. Al hacerlo, el dispositivo será desprisionado de su LNS actual y se aprovisionará al LNS recién seleccionado.
Dependiendo del códec configurado en el dispositivo, habrá varios comandos disponibles. La mayoría del dispositivo tendrá un comando para recuperar su configuración actual. Cuando el dispositivo procesa dichos comandos, se recibirá un enlace ascendente que contenga la configuración del dispositivo y la configuración se almacenará en el dispositivo en Cumulocity como un documento JSON disponible en la pestaña de configuración del dispositivo:
Puede actualizar la configuración del dispositivo modificando el JSON directamente o enviando un comando desde la pestaña Lora. Los comandos disponibles en la pestaña Lora tendrán sus campos de entrada precargados con los valores almacenados en la configuración del dispositivo:
Cuando se envíe un comando, pasará por el ciclo de vida de la operación de acumulocidad habitual:
Pendiente -> ejecución -> éxito o fallido
El estado de la operación se actualizará cuando el LNS envíe un evento de actualización de enlace descendente.
Tenga en cuenta que no todos los LNS admiten el evento de actualización de enlace descendente o que se enciende explícitamente, ya sea en el perfil del dispositivo o en la configuración de LNS.
Todos los eventos de LNS estarán disponibles como eventos en el objeto administrado del conector LNS en su formato JSON RAW según lo enviado por el LNS.
Los eventos de enlace ascendente también estarán disponibles en los dispositivos en una forma que contenga el FPORT, la carga útil en formato hexadecimal, ya sea que la carga útil se procesara o no y otra información relevante.
El marco ofrece la capacidad de construir rápidamente el códec directamente a partir de la interfaz de usuario de Cumulocity con un IDE integrado basado en el editor de Monaco.
Para habilitar esta función, debe instalar el microservicio de códec personalizado lora-ns-custom .
Se puede acceder al IDE en el menú Lora/Codecs personalizados y se dedica en 3 partes:
Una vez que esté satisfecho con su códec y lo guardó, será accesible desde cualquier pestaña Lora Lora como modelo del códec personalizado.
