cumulocity lora
v1.1.6
Vous pouvez installer le plugin Cumulocity Lora à partir de l'application d'administration, il doit être disponible dans l'écosystème -> Applications -> Menu des packages.
Sinon, téléchargez le fichier zip à partir de la dernière version et installez-la dans les packages d'application (disponibles dans le menu pointé ci-dessus): https://github.com/softwareag/cumulocity-lora/releases/latest/download/sag-ps-iot-pkg-lora-package.zip
Il est destiné à être installé uniquement dans l'application DeviceManagement.
Ce plugin nécessite la fonction de microservice activée sur votre locataire pour fonctionner. Si vous êtes sur un locataire d'essai, veuillez contacter votre représentant des ventes pour le faire ou contacter le support sur Empower.
Une fois la fonction de microservice activée, veuillez installer le microservice GitHub-Proxy qui peut être téléchargé à partir de cette URL: https://github.com/softwareag/cumulocity-lora/releases/latest/download/github-proxy.zip
Lorsque le microservice GitHub-Proxy est installé, accédez simplement à l'application DeviceManagement, puis au menu LORA / Config. De là, sélectionnez simplement les microservices que vous souhaitez installer sur votre locataire.
Vous verrez 2 types de microservices: les connecteurs LNS, généralement nommés LORA-NS-, et les codecs, généralement nommé Lora-codec-
Dans l'application DeviceManagement-Lora, accédez au menu des serveurs réseau LORA / LORA. Donnez simplement un nom à votre connecteur, puis sélectionnez le type de LNS auquel vous souhaitez vous connecter (le type que vous recherchez ne s'affichera que si le microservice correspondant est installé).
Assurez-vous que les LN que vous souhaitez vous connecter à la cumulocité sont correctement configurés (certains LN nécessitent la création d'une clé API par exemple). Une fois le type sélectionné, suivez simplement les instructions de l'assistant. Les dispositifs déjà provisionnés seront automatiquement ajoutés à la cumulocité une fois qu'ils envoient des données et que leurs données seront transmises par le LNS à la cumulocité. Exemple pour TTN:
Et un autre pour Chirpstack:
Une fois le connecteur créé, la cumulocité créera automatiquement une route HTTP dans le LNS pour pousser les données du LNS au locataire de cumulocité actuel. De plus, tous les périphériques existants dans le LNS seront automatiquement créés dans la cumulocité une fois qu'ils envoient des données et des données sont poussés à la cumulocité via l'itinéraire HTTP configuré. Ces appareils seront créés sans un codec qui leur est associé, vous devrez donc accéder à la vue détaillée de l'appareil afin de choisir le bon codec. Toute charge utile envoyée à la sélection de codecs priori cumulocity ne sera pas perdue: ils seront stockés et vous pourrez les traiter une fois que vous aurez choisi le bon codec.
Dans l'application DeviceManagement-Lora, consultez les appareils LORA / LORA.
Afin de provisionner l'appareil dans un LNS, vous devez cocher la case intitulée "Appareil de provision dans LORA Network Server": vous pourrez alors choisir le connecteur LNS lié au LNS dans lequel vous souhaitez provisionner l'appareil. Selon le type de connecteur LNS que vous choisissez, différents champs semblent finaliser le provisionnement de l'appareil dans ce LN spécifique.
Exemple pour TTN:
Et un autre pour Chirpstack:
Dans l'application DeviceManagement-Lora, accédez au menu Lora / Lora Gateways.
Selon le connecteur LNS que vous choisissez, différents champs apparaîtront.
Exemple avec TTN:
Un autre avec une actulité:
Afin de pouvoir provisionner une passerelle, certains LN nécessitent une autorisation spécifique. Par exemple, TTN nécessite une touche API utilisateur, car une clé d'API d'application vous permettra de gérer des appareils dans une application spécifique.
Les appareils LORA, identifiés par un fragment JSON lora_ns_device_LoRaDevice , peuvent être gérés à partir d'une vue spécifique accessible via le sous-menu "Lora" sur la vue détaillée de l'appareil.
Plusieurs actions peuvent être effectuées dans ce point de vue:
Vous pouvez modifier le codec à tout moment. Si vous sélectionnez le mal et qu'il n'a pas réussi à traiter une charge utile entrante, la charge utile restera dans un état non transformé et vous pourrez le retraiter plus tard.
Vous pouvez activer le mode de débogage, qui générera un événement spécial pour chaque charge utile entrante qui contiendra la charge utile décodée complète.
Vous pouvez également choisir de stocker les dernières mesures sur l'appareil lui-même, vous pourrez donc les utiliser sur des widgets spécifiques mais également pour les ajouter sous forme de colonnes dans la table "Tous les appareils".
Les appareils qui sont automatiquement importés n'auront pas de codec configuré et les charges utiles seront stockées dans un état non transformé. Vous pourrez les traiter une fois que vous aurez configuré un codec.
Vous pouvez basculer un appareil vers un autre LNS. Ce faisant, l'appareil sera déprovisé à partir de son LNS actuel et provisionné au LNS nouvellement sélectionné.
Selon le codec configuré sur l'appareil, diverses commandes seront disponibles. La plupart des appareils auront une commande pour récupérer leur configuration actuelle. Lorsque ces commandes sont traitées par l'appareil, une liaison montante contenant la configuration de l'appareil sera reçue et la configuration sera stockée sur l'appareil dans Cumulocity en tant que document JSON disponible dans l'onglet Configuration du périphérique:
Vous pouvez soit mettre à jour la configuration de l'appareil en modifiant directement le JSON ou en envoyant une commande à partir de l'onglet LORA. Les commandes disponibles sur l'onglet LORA disposeront de leurs champs d'entrée pré-remplis avec les valeurs stockées dans la configuration de l'appareil:
Lorsqu'une commande est envoyée, elle passera par le cycle de vie de l'opération de cumulocité habituelle:
En attente -> Exécution -> Succès ou échoué
L'état de l'opération sera mis à jour lorsque le LNS envoie un événement de mise à jour de liaison descendante.
Notez que tous les LN ne prennent pas en charge l'événement de mise à jour de liaison downlink ou ne sont pas exposés explicitement sur le profil de périphérique ou sur la configuration LNS.
Tous les événements LNS seront disponibles en tant qu'événements sur l'objet géré du connecteur LNS dans leur format JSON RAW comme envoyé par le LNS.
Les événements de liaison montante seront également disponibles sur les appareils sous une forme qui contient le FPORT, la charge utile au format hexadécimal, que la charge utile ait été traitée ou non et d'autres informations pertinentes.
Le cadre offre la possibilité de créer rapidement du codec directement à partir de Cumulocity UI avec un IDE intégré basé sur l'éditeur Monaco.
Pour activer cette fonctionnalité, vous devez installer le micro-service personnalisé lora-ns-custom .
L'IDE est accessible dans le menu LORA / CODECS CUSTOM et est découragé en 3 parties:
Une fois que vous êtes satisfait de votre codec et que vous l'avez enregistré, il sera accessible à partir de n'importe quel appareil Lora Lora en tant que modèle du codec personnalisé.
