Live Objects. Orange. manuel utilisateur. Version 2.15

Live Objects

Orange

manuel utilisateur

Table des matières

1. INTRODUCTION ... 5

1.1. Contexte ... 5

1.2. Objet du document ... 5

1.3. Documents de référence ... 5

2. MANUEL UTILISATEUR DU PORTAIL LIVE OBJECTS ... 6

2.1. Accès à l’application ... 6

2.1.1. Obtenir un compte Live Objects... 6

2.1.2. Réception de vos identifiants de connexion ... 6

2.1.3. Connexion au portail Live Objects ... 7

2.1.3.1. Navigateurs supportés ... 7

2.1.3.2. Connexion/authentification ... 7

2.2. Principes de navigation ... 8

2.2.1. Bandeau de navigation ... 8

2.3. Tableau de bord... 10

2.3.1. Nombre total d’équipements répartis par connectivité : ... 11

2.3.2. Utilisation des quotas ... 11

2.3.3. Activité du parc ... 12

2.3.4. Activité détaillée ... 13

2.3.5. Tableaux de bord personnalisés ... 14

2.3.5.1. Création d’un widget de type valeur ... 15

2.3.5.2. Création d’un widget de type courbe ... 16

2.3.5.3. Création d’un widget de type carte ... 16

2.3.5.4. Création d’un widget de type jauge ... 17

2.3.5.5. Création d’un widget de type histogramme ... 19

2.3.5.6. Création d’un widget de type « On/Off » ... 20

2.3.5.7. Création d’un widget de type « Statistiques» ... 21

2.3.5.8. Création d’un widget de type « Suivi d’un objet » ... 23

2.3.5.9. Création d’un widget de type « Tags, propriété» ... 25

2.3.5.10. Création d’un widget de type « Inventaire parc » ... 26

2.3.5.11. Création du widget de type « profil LoRa » ... 26

2.4. Gestion du parc d’équipements ... 27

2.4.1. Afficher son parc d’équipements par type de connectivité ... 28

2.4.7.6. Ajouter une option de connectivité ... 45

2.4.7.7. Consulter les données remontées par un équipement LoRa (uplink) ... 47

2.4.7.8. Envoi de commande à un équipement LoRa (downlink) ... 49

2.4.7.9. Antennes LoRa ... 50

2.4.8. Equipements MQTT ... 53

2.4.8.1. Ajouter un équipement MQTT ... 53

2.4.8.2. Supprimer un équipement MQTT ... 54

2.4.8.3. Détail d’un équipement MQTT ... 56

2.4.8.4. Mettre à jour les paramètres d’un équipement MQTT ... 58

2.4.8.5. Envoyer une commande à un équipement MQTT ... 61

2.4.8.6. Mettre à jour le firmware d’un équipement MQTT ... 63

2.4.9. Equipements SMS ... 66

2.4.9.1. Ajouter un équipement SMS... 67

2.4.9.2. Supprimer un équipement SMS ... 68

2.4.9.3. Envoyer une commande à un équipement SMS ... 69

2.4.9.4. Modifier un équipement SMS ... 70

2.4.10. Connecteur externe ... 71

2.4.11. Groupes ... 72

2.4.12. Gestion de campagnes ... 74

2.4.12.1. Créer une campagne ... 74

2.4.12.2. Suivre une campagne ... 78

2.4.12.3. Annuler une campagne ... 79

2.4.12.4. Supprimer une campagne ... 80

2.4.12.5. Statuts d’une campagne ... 80

2.4.12.5.1. Statuts des équipements cibles ... 80

2.4.12.6. Rapport campagne ... 82

2.4.13. Gérer les firmwares ... 83

2.5. Données ... 86

2.5.1. Export des données ... 89

2.5.2. Visualisation avancée (Kibana) ... 90

2.5.3. Files de messages (fifo) ... 91

2.5.4. Routage des données ou des évènements... 93

2.5.4.1. Politique en cas d’échec ... 94

2.5.4.2. Formatage des données routées ... 94

2.5.4.3. Suspendre / réactiver une règle ... 95

2.5.5. Consommation des données par les applications ... 96

2.5.5.1. Explorer les données ... 96

2.5.5.2. Consommer les données en temps réel ... 96

2.5.5.2.1. Consommation via MQTT ... 96

2.5.5.2.2. Consommation via push HTTP ... 97

2.5.6. Gérer les décodeurs ... 97

2.5.6.1. Type des décodeurs ... 98

2.5.6.2. Visibilité des décodeurs ... 98

2.5.6.3. Modèle de données et Indexation ... 99

2.5.6.4. Créer un décodeur paramétrable binaire ... 100

2.5.6.5. Créer un décodeur paramétrable csv ... 104

2.5.6.6. Créer un décodeur programmable ... 105

2.5.6.7. Désactiver/réactiver un décodeur paramétrable ... 105

2.5.6.8. Affecter un décodeur à un équipement ... 106

2.5.7. Custom pipelines ... 107

2.5.7.1. Description ... 107

2.6.1. Identification du compte ... 111

2.6.2. Identification de l’utilisateur connecté ... 111

2.6.3. Limites de trafic ... 111

2.6.4. Rôles et droits dans Live Objects ... 112

2.6.5. Gérer les utilisateurs ... 113

2.6.5.1. Créer un utilisateur ... 114

2.6.5.2. Suspendre / réactiver un utilisateur ... 115

2.6.5.3. Supprimer un utilisateur ... 115

2.6.6. Gérer les clés d’API ... 115

2.6.6.1. Créer une clé d’API... 116

2.6.6.2. Hiérarchie des clés d’API ... 117

2.6.6.3. Régénérer une clé d’API ... 118

2.6.6.4. Désactiver/ réactiver une clé d’API ... 118

2.6.6.5. Supprimer une clé d’API ... 118

2.6.6.6. Passer une clé d’API en mode debug ... 118

2.6.6.7. Associer une autorité de certification ... 119

2.6.7. Journal d’activité ... 120

2.6.7.1. Connectivité LoRa ... 120

2.6.7.2. Connectivité MQTT ... 121

2.6.7.3. Stockage ... 121

2.6.7.4. Notification ... 121

2.6.7.5. Limitations ... 123

2.6.8. Journal d’accès ... 123

2.7. Alarmes ... 123

2.7.1. Visualiser les alarmes ... 124

2.7.2. Paramétrer une règle de « Silent machine » ... 125

3. APPLICATION MOBILE « LIVE OBJECTS SENSOR » ... 128

4. RESSOURCES ... 129

1. Introduction

1.1. Contexte

Live Objects est une solution en mode SaaS (Software as a Service) qui fournit un ensemble d’outils dans les domaines Machine To Machine (M2M) et l’internet des Objets (IoT).

Les principales fonctionnalités offertes par Live Object sont les suivantes :

 gestion avancée des objets communicants (ajout, suspension, supervision, configuration, mise à jour de micro programmes…)

 interfaces programmatiques (API) pour collecter les données des objets, leur envoyer des commandes et gérer les notifications associées (http, mqtt)

 routage des messages entre les objets et les applications métier

 stockage des données et fonctionnalités avancées de recherche

Important : En fonction des offres souscrites (LoRa, Discover, Express, Advanced, Premium) certaines fonctionnalités peuvent être présentes ou non. Dans ce document sont présentées toutes les fonctions disponibles.

1.2. Objet du document

Le manuel utilisateur a pour but d’être un support à l’utilisation du portail Web Live Objects d’Orange. Une documentation api est également disponible et référencée ci-dessous.

Ce document n’a pas vocation à être exhaustif et se présente comme un complément à l’aide contextuelle, généralisée sur le portail Live Objects.

1.3. Documents de référence

N° titre référence

documents Orange

1 Guide développeur Live Objects (API) https://liveobjects.orange-

business.com/doc/html/lo_manual.html

2 Support de formation Live Objects https://blog.liveobjects.orange-

business.com/complete-training-guide-live- objects/

3 Swagger (API reference) https://liveobjects.orange-

business.com/#/swagger

2. Manuel utilisateur du portail Live Objects

2.1. Accès à l’application

2.1.1. Obtenir un compte Live Objects

Vous pouvez obtenir un compte d’essai Discover disponible immédiatement en souscrivant en ligne à l’adresse https://liveobjects.orange-business.com/#/request_account.

Si vous souhaitez disposer d’un compte Live Objects avec connectivité LoRa incluse, cocher la case correspondante. Dans ce cas la création du compte ne sera pas immédiate, néanmoins vous serez notifié par email de sa création.

Enfin vous avez la possibilité de contacter un interlocuteur commercial à l’adresse liveobjects.contact@orange.com

2.1.2. Réception de vos identifiants de connexion

La création de votre compte s’accompagne de l’envoi d’un mail d’activation dudit compte principal.

Le mail que vous allez recevoir vous informe des modalités d’accès au support et présente un lien d’activation valable 7 jours. Lorsque vous l’utiliserez pour activer votre compte, vous devrez saisir un mot de passe ainsi qu’un capcha :

2.1.3. Connexion au portail Live Objects

2.1.3.1. Navigateurs supportés

 Firefox 38 et plus

 IE 11,

 Edge 13 et plus,

 Chrome 49 et plus

2.1.3.2. Connexion/authentification

L’accès à l’adresse https://liveobjects.orange-business.com renvoie à la page d’authentification suivante :

Si vous disposez d’un Espace Client Entreprise Orange connectez-vous directement depuis cet espace en cliquant sur le bouton prévu à cet effet.

Si vous ne disposez pas d’un Espace Client Entreprise Orange connectez-vous avec votre identifiant/mot de passe Live Objects. En cas d’oubli de mot de passe, cliquez sur le lien « mot de passe oublié ».

Saisissez votre identifiant de connexion Live Objects ainsi que le capcha. Un lien de réinitialisation vous sera envoyé par email, à l’adresse correspondant à votre identifiant. Ce lien est reste valable 10 minutes.

NB : si vous utilisez un compte «Espace Client Entreprise », la demande de réinitialisation doit se faire depuis cet espace https://espaceclient.orange-

business.com/group/ece2/home?codeContexte=eceDefault

2.2. Principes de navigation 2.2.1. Bandeau de navigation

Il permet la navigation entre les différentes rubriques du portail Live Objects :

- L’onglet « Tableau de bord » : il s’agit de la page d’accueil du portail qui donne une vue synthétique de l’activité du compte

- L’onglet « Parc » pour la gestion du parc d’équipements

- L’onglet « Données » pour la visualisation des données stockées dans Live Objects, la

- Le manuel utilisateur (le présent document) - Le guide développeur

Un lien vous permette de vous déconnecter, et d’accéder aux informations concernant votre compte :

o Vos identifiants de compte (à communiquer systématiquement lors de tout appel au support)

o L’utilisateur avec lequel vous êtes connecté

o Nom du compte, date de création et email de l’utilisateur principal (adresse utilisée à la création du compte Live Objects)

Enfin la langue peut être changée à tout moment en cliquant sur l’icône correspondante. Les langues disponibles sont le Français et l’Anglais.

2.3. Tableau de bord

Le tableau de bord est la page d’accueil du portail Live Objects. Elle donne une vue synthétique de l’activité du compte.

2.3.1. Nombre total d’équipements répartis par connectivité :

Cette vue donne le nombre d’équipements actuellement en parc répartis par connectivité.

Notez qu’un même équipement peut tout à fait avoir plusieurs interfaces s’il utilise plusieurs connectivités pour communiquer (par exemple une interface LoRa et une interface SMS)

2.3.2. Utilisation des quotas

Ces quotas dépendent de l’offre souscrite.

- Files de messages : Nombre de files créées / Nombre de files max autorisées - Clés d’API : Nombre de clés créées / Nombre de clés max autorisées

- Utilisateurs : Nombre d’utilisateurs créés / Nombre d’utilisateurs max autorisées

- Forfait de downlinks LoRa : Vous voyez ce quota si vous avez une offre LoRa. Il s’agit d’un nombre de downlink inclus dans votre offre. Ce nombre est global à toute votre flotte LoRa. Au-delà de ce forfait, les downlinks font l’objet d’une facturation supplémentaire.

Ne sont comptés dans ce quota que les downlink émis depuis Live Objects (envois de commandes) et non les messages MAC et Ack uplink.

2.3.3. Activité du parc

Cette vue permet de sélectionner pour une période donnée l’activité globale du compte Live Objects en termes de :

- nombre d’équipements ayant communiqué sur la période (historique disponible sur les 7 derniers jours ou les 12 derniers mois)

- trafic en nombre de messages (entrants/sortants) ou en volume (octets) (historique disponible sur les 7 derniers jours, les 4 dernières semaines ou les 12 derniers mois) On entend par « message entrant » tout message entrant dans la plateforme. Exemples :

- Un équipement qui émet un message à destination de la plateforme (uplink),

- Une application qui effectue des appels API POST, PUT vers la plateforme (ex : requête de search, envoi de commande …)

On entend par « message sortant » tout message sortant de la plateforme. Exemples : - Une commande envoyée de la plateforme vers un équipement (downlink) - Réponse aux appels API GET

- Consommation de messages via MQTT

2.3.4. Activité détaillée

Une synthèse de l’activité est également donnée par type de connectivité.

Pour chaque connectivité on affiche :

- Le nombre d’équipements actuellement en parc

- Les statistiques sur la période sélectionnée. Notez que sur cette période le nombre d’équipements peut varier par rapport à l’état du parc actuel en fonction des ajouts/suppression qui auraient pu voir lieu entre temps.

Certaines informations peuvent être spécifiques au type de connectivité : Equipements activés/désactivés pour LoRa ; équipements connectés/déconnectés pour Mqtt

Le nombre de messages mqtt sortants comprend l’ensemble des messages mqtt sortant de la plateforme qu’ils soient à destination des équipements (device management) ou des applications (consommation de données).

2.3.5. Tableaux de bord personnalisés

Vous pouvez constituer vos propres tableaux de bord pour visualiser vos données. Un tableau de bord est constitué d’objets graphiques appelés « widgets » qui permettent de visualiser les données de différentes manières.

Remarques :

 Les tableaux de bord personnalisés sont propres à un utilisateur du compte Live Objects.

Ils ne sont pas partagés à d’autres utilisateurs du compte.

 Il est possible de paramétrer un rafraichissement automatique d’un tableau de bord. Dans ce cas chaque les widgets sont rafraichis de de façon séquentielle suivant le délai défini.

Il reste toutefois possible de rafraichir un widget individuellement en cliquant sur son icône

« actualiser ».

 Pour visualiser des données remontées par des équipements LoRa, il est nécessaire que la payload hexadécimal véhiculant ces données soit décodée (Voir paragraphe « Gérer les décodeurs »). Les métadonnées réseaux (snr, rssi, sf, esp) restent néanmoins accessibles sans décodage

 Seules les 10 000 données les plus récentes sont affichées par les widget. Si une série comporte plus de données sur la période sélectionnée, cela est indiqué par une pastille jaune située à côté le nom de la série

Cliquez ici pour créer un tableau de bord personnalisé

2.3.5.1. Création d’un widget de type valeur

Ce widget permet d’afficher la dernière valeur d’une donnée remontée par un équipement. Pour créer un widget de type valeur, cliquez sur le bouton correspondant, puis sélectionner l’équipement qui émet la donnée à visualiser.

Une fois l’équipement sélectionné, le champ « Donnée à afficher » présente la structure du message remonté par cet équipement. Sélectionner le champ portant la donnée à afficher :

2.3.5.2. Création d’un widget de type courbe

Ce widget permet d’afficher sous forme d’une courbe ou d’un nuage de points les valeurs prises par une donnée remontée par un équipement sur une période de temps. Pour créer un widget de type valeur, cliquez sur le bouton correspondant, puis sélectionner l’équipement qui émet la donnée à visualiser.

Une fois l’équipement sélectionné, le champ « Donnée à afficher » présente la structure du message remonté par cet équipement. Sélectionner le champ portant la donnée à afficher :

NB : Un widget de type courbe ne permet d’afficher que des valeurs de type numérique

Une fois l’équipement sélectionné, le champ « Donnée à afficher » présente la structure du message remonté par cet équipement. Attention : Vous n’avez pas à aller chercher les informations de localisation qui seront automatiquement reportées sur la carte. La donnée à afficher que vous avez à sélectionner est celle que vous souhaitez afficher sur la carte à l’endroit où votre équipement est localisé. Par exemple la température indiquée par l’équipement lors de sa dernière géolocalisation.

2.3.5.4. Création d’un widget de type jauge

Le widget jauge permet de représenter la dernière valeur remontée par un équipement sous la forme d’une jauge sur laquelle vous pouvez faire figurer une valeur minimum et une valeur maximum. Ces valeurs min et max sont utilisées à des fins de présentation uniquement, un équipement pourra tout à fait remonter des valeurs en dessous ou en dessus de ces bornes, la jauge apparaitre dans ce cas vide ou pleine.

NB : Un widget de type jauge ne permet d’afficher que des valeurs de type numérique

2.3.5.5. Création d’un widget de type histogramme

Avec un widget de type histogramme vous avez la possibilité de visualiser l’évolution comparée dans le temps d’une valeur remontée par un plusieurs équipements.

Comme pour les autres widgets, vous devez sélectionner la donnée à afficher, une fois les équipements sélectionnés. Le champ « Données à afficher » contient la structure des données remontées par ces équipements.

La méthode d’approximation sélectionnée correspondant à votre cas d’usage, par exemple:

- Suivi de la température moyenne/max/min sur le mois. (sélectionnez « la moyenne des mesures », « le maximum des mesures », ou « le minimum des mesures)

- Volume des précipitations cumulées sur le mois (sélectionnez « la somme des mesures »)

NB 1: l’axe des ordonnées est automatiquement positionné sur la valeur minimum sur la période de temps sélectionné, sauf si la case « barres empilées » est cochée auquel cas l’échelle démarre à zéro.

NB 2 : Le widget histogramme ne permet d’afficher que des valeurs de type numérique

2.3.5.6. Création d’un widget de type « On/Off »

2.3.5.7. Création d’un widget de type « Statistiques»

Le widget statistiques permet d’afficher une valeur sur la base d’agrégations simples.

Par exemple ci-dessous, la valeur qui sera affichée sera la moyenne des températures journalières remontées par les 3 équipements sélectionnés, et si cette valeur est supérieure à 30°C elle sera affichée en rouge.

Si l’option « La dernière mesure de chaque équipement » était sélectionnée, seule la dernière valeur de chaque équipement aurait été utilisée pour faire la moyenne des mesures, et non la moyenne journalière de chaque équipement.

2.3.5.8. Création d’un widget de type « Suivi d’un objet »

Le widget de type « Suivi d’un objet » permet de suivre les dernières valeurs d’une donnée remontée par un équipement. Jusqu’à 3 données peuvent être suivies et l’on peut afficher pour chacune jusqu’aux 20 dernières valeurs. En outre un seuil d’alarme peut être positionné pour chaque valeur suivie. Si ce seuil est dépassé la valeur sera affichée en rouge dans le widget.

2.3.5.9. Création d’un widget de type « Tags, propriété»

Ce widget permet d’afficher la répartition d’une flotte par tag ou par propriété

2.3.5.10. Création d’un widget de type « Inventaire parc »

Ce widget vous permet de visualiser simplement le nombre d’équipements dans un groupe et ses sous-groupes

2.3.5.11. Création du widget de type « profil LoRa »

Ce widget vous permet de visualiser la répartition des principaux « device profiles » LoRa utilisés par vos équipements

2.4. Gestion du parc d’équipements

Le menu parc permet de visualiser et de gérer votre flotte d’équipements. Un bouton d’export permet d’exporter au format csv la liste des équipements préalablement sélectionnés.

2.4.1. Afficher son parc d’équipements par type de connectivité

Etant donné que les équipements présentent des caractéristiques propres à la connectivité utilisée, l’affichage des équipements du parc se fait en sélectionnant cette connectivité dans la liste déroulante

La liste des équipements peut être affinée par une recherche multicritères. Pour cela cliquez sur le champ et sélectionner les critères souhaités

La sélection des équipements se fait unitairement, par page ou en totalité en cochant les cases (1)

(1)

(2)

(2) (3)

(4)

(5)

2.4.2. Etats des équipements

Les états que peuvent prendre les équipements dépendent de leur connectivité.

Equipements LoRa

- Enregistré : L’équipement a été enregistré dans le réseau avec les paramètres spécifiés lors de sa création. Aucune donnée montante (uplink), ni de Join Request n’a encore été reçue par la plateforme.

- En cours d’initialisation : Le réseau a reçu un Join Request de la part de l’équipement - Initialisé : Le réseau a envoyé un Join Accept à l’équipement

- Activé : Au moins un uplink émis par l’équipement a été reçu par Live Objects (hors messages MAC)

- Désactivé : L’équipement a été désactivé dans Live Objects. Il ne peut plus communiquer sur le réseau (Voir le paragraphe « Désactiver et réactiver un équipement »

- Réactivé : L’équipement a été réactivé dans Live Objects. Ne pouvant connaitre à priori l’état de l’équipement au moment de la réactivation, l’état passera à « En cours d’initialisation » si l’on reçoit un Join Request, ou directement à « Activé » si un uplink est reçu.

- Erreur : Ce statut, rare, est affiché en cas de problème de configuration de l’équipement dans le réseau. Si cet état s’affiche contactez votre support.

- En ligne : La connexion MQTT de l’équipement est active

- Hors ligne : L’équipement s’est déjà connecté au moins une fois mais sa connexion MQTT est inactive

Equipements SMS

- En ligne : L’équipement est activé au niveau Live Objects - Hors ligne : L’équipement est désactivé au niveau Live Objects

Equipements gérés par connecteur externe

- Enregistré : L’équipement a été pré-provisionné mais ne s’est jamais connecté

- En ligne : Le connecteur indique que l’équipement est connecté et prêt à communiquer avec la plateforme Live Objects*

- Hors ligne : Le connecteur indique que l’équipement n’est pas connecté et qu’il n’est donc pas prêt à communiquer avec la plateforme Live Objects*

(* NB : Dans le cas du connecteur externe, l’état affiché dans Live Objects est celui reporté par le connecteur externe, et non par l’équipement terminal lui-même. Voir le paragraphe

« Connecteur externe » pour plus d’information sur ce fonctionnement)

2.4.3. Etat des commandes (downlink)

Les commandes ou downlink sont les messages que vous pouvez envoyer à vos équipements depuis Live Objects.

Le moteur de commande unifié de Live Objects vous permet de suivre finement la progression d’une commande à travers ses différents états.

Pour suivre l’état d’une commande envoyée à un équipement, commencez par sélectionner l’équipement dans le menu « Parc ». Puis dans les détails de l’équipement sélectionnez le menu « Commandes (downlink) » pour afficher l’historique des commandes envoyées à cet équipement. Enfin, cliquez sur une commande pour afficher ses détails

Chaque type de connectivité (LoRa, SMS, MQTT…) a ses propres spécificités liées à sa mécanique intrinsèque. Le moteur de commande générique de Live Objects permet de masquer cette complexité en permettant de gérer les commandes de façon homogène quelle

Ainsi une commande a toujours trois états :

- Pending : La commande est en attente dans Live Objects (par exemple une commande précédente est en cours d’exécution, ou l’équipement n’est pas disponible pour recevoir une commande)

- Processing : La commande est en cours de traitement (en cours d’acheminement par le réseau)

- Processed : La commande est terminée. Ce qui signifie qu’est a été traitée par Live Objects conformément à la demande (avec ou sans acquittement)

A ces trois états génériques, correspondent des sous-états, les « delivery status » qui renseignent plus précisément sur le cheminement de la commande et dont la signification est propre à la connectivité utilisée (« sending », « sent », « delivered »). Ces états sont décrits en détails dans les paragraphes correspondants à votre type d’équipement.

2.4.4. Propriétés des équipements et notion d’interface

Les équipements peuvent utiliser différents types de connectivité pour communiquer avec Live Objects. Les spécificités liées à ces différentes connectivités sont gérées par des « interfaces ».

Un même équipement pouvant avoir plusieurs interfaces s’il se connecte via des réseaux différents par exemple une interface LoRa et une interface SMS.

Les informations concernant les équipements sont donc présentées en deux parties :

- Les informations indépendantes de la connectivité et communes à tous les équipements dans Live Objects (détail ci-dessous)

- Les informations spécifiques aux interfaces réseaux qu’ils utilisent pour se connecter à Live Objects (voir paragraphes spécifiques)

Nom : Nom de l’équipement. Il s’agit d’un champ libre.

ID de l’équipement: Il s’agit de l’identifiant unique de l’équipement dans Live Objects (URN). Il doit être de la forme urn:lo:nsid:{namespace}:{id}. Les champs namespace et id sont personnalisables.

StreamId par défaut : Il permet de spécifier le stream dans lequel les données émises par l’équipement seront stockées. Par défaut chaque équipement dispose de son propre stream, mais il est tout à fait possible de collecter les données de plusieurs équipements dans un même stream.

Tags personnalisés : Les tags sont des étiquettes en saisie libre que vous pouvez attribuer à vos équipements. L’utilisation des tags peut être utile pour trier et identifier vos équipements par exemple. Vous pouvez saisir jusqu’à 10 tags de 32 caractères par équipement.

Groupe : Il s’agit du groupe auquel a été affecté l’équipement. Voir le paragraphe « Groupes » Propriétés : Vous pouvez définir ici des propriétés pour vos équipements. Ces propriétés vous permettent d’enrichir votre gestion d’équipements. Vous pouvez positionner jusqu’à 10 propriétés (128 caractères max pour la clé, et 256 caractères max pour la valeur).

Un équipement doit obligatoirement avoir au moins une interface. Pour ajouter une nouvelle interface cliquer sur le bouton « Ajouter une interface » dans le menu « Identité » de l’équipement

Puis sélectionner le type d’interface

2.4.5. Importer en masse des équipements

Pour accéder à cette fonctionnalité, aller dans le menu « Parc » et cliquer sur le bouton « Importer en masse ».

L’import se passe en trois étapes :

La première, facultative, vous propose un modèle de fichier d’import pré-formaté avec les paramètres à remplir correspondants au type d’équipement que vous souhaitez importer. Les champs à renseigner sont les mêmes que ceux à fournir lors de la création unitaire (voir les paragraphes correspondants). Vous pouvez passer cette étape si vous disposez déjà de votre fichier d’import.

La seconde étape permet d’importer le fichier et de vérifier que le format est correct.

Seule la correction de toutes erreurs permet de passer à l’étape suivante.

La troisième étape procède à la création proprement dites des équipements contenus dans le fichier d’import. Pour confirmer la création en masse cliquer sur le bouton « importer les équipements »

2.4.6. Exporter la liste de ses équipements

Vous pouvez exporter la liste de vos équipements au format csv. Pour cela rendez-vous dans la vue « Parc » et sélectionnez le type d’équipement souhaité. Sélectionnez ensuite la liste des

« équipements » à exporter et cliquer sur l’icône d’export

2.4.7. Equipements LoRa

2.4.7.1. Ajouter un équipement LoRa

Pour ajouter un équipement LoRa, cliquer sur le bouton « Ajouter un équipement ».

Le formulaire de création s’ouvre avec les paramètres spécifiques à un équipement LoRa

Nom : Nom de l’équipement (par exemple « Mon premier équipement »)

Profil : Le profil, ou « device profile » est une configuration préétablie de votre équipement sur le réseau. Il rassemble un certain nombre de paramètres tels que le « spreading factor » utilisé pour le JOIN, la classe, le RX. Sélectionner dans la liste le profil correspondant à votre matériel. Si vous ne trouvez pas de profil correspondant choisissez le profil Generic_classA_RX2SF12 (si votre équipement est en classe A) ou Generic_classC_RX2SF12 (si votre équipement est en classe C) Décodeur : Les décodeurs permettent de traduire une payload hexadécimale en données humainement compréhensibles et indexables. Sélectionner dans la liste le décodeur adapté à votre équipement. S’il n’y en a pas, vous pouvez en créer un dans le menu « Configuration ». Si le champ « Décodeur » n’est pas présent c’est que votre compte Live Objects ne dispose pas de cette fonction.

DevEUI : C’est l’identifiant unique de votre équipement dans le réseau LoRa il est fourni avec votre matériel

ID de l’équipement: Il s’agit de l’identifiant unique de l’équipement dans Live Objects (URN). Par défaut il est construit dans l’espace de nommage « lora » avec comme identifiant d’équipement le DevEUI. Il vous est possible de le personnaliser avec votre propre espace de nommage et un identifiant d’équipement différent du devEUI.

AppEUI, AppKey : Les paramètres AppEUI et AppKey sont des paramètres propres au propriétaire de l’objet et/ou de l’applicatif utilisé avec l’objet (voir la spécification LoraWan) StreamId par defaut : Il permet de spécifier le stream dans lequel les données émises par l’équipement seront stockées. Ce champ est automatiquement renseigné lors de la saisie du devEUI, mais il peut être personnalisé. Par défaut chaque équipement dispose de son propre stream, mais il est tout à fait possible de collecter les données de plusieurs équipements dans un même stream.

Tags personnalisés : Les tags sont des étiquettes en saisie libre que vous pouvez attribuer à vos équipements. L’utilisation des tags peut être utile pour trier et identifier vos équipements par exemple. Vous pouvez saisir jusqu’à 10 tags de 32 caractères par équipement.

Options de connectivité : Ce champ n’apparait que si des options de connectivités ont été activées sur votre compte Live Objects. Voir le paragraphe « Ajouter une option de connectivité » Groupe : Indiquez ici le groupe auquel vous souhaitez affecter votre équipement. Voir le paragraphe « Groupes »

Propriétés : Vous pouvez définir ici des propriétés pour vos équipements. Ces propriétés vous permettent d’enrichir votre gestion d’équipements.

2.4.7.2. Désactiver et réactiver un équipement LoRa

Il est possible d’interdire à un ou plusieurs équipements LoRa de communiquer sur le réseau, de façon temporaire sans avoir à le supprimer. Pour cela sélectionner les équipements concernés en cochant la case correspondante dans la liste, et cliquer sur le bouton « Désactiver ».

Pour réactiver un ou plusieurs équipements, procéder de la même façon en cliquant sur le bouton

« Activer »

2.4.7.3. Supprimer un équipement LoRa

Il est possible de supprimer un équipement LoRa de la plateforme. Cette action aura pour conséquence de le supprimer également du réseau LoRa d’Orange. Les données qui auront été remontées par cet équipement ne sont pas supprimées et restent accessibles dans l’onglet

« Données ».

Pour supprimer un ou plusieurs équipements, sélectionner les équipements concernés en cochant la case correspondante dans la liste, et cliquer sur l’icône « Supprimer ».

2.4.7.4. Détail d’un équipement LoRa

Pour accéder aux informations détaillées concernant un équipement LoRa, cliquez sur l’équipement désiré dans la liste principale du menu « Parc ».

- la géolocalisation de l’équipement sur une carte avec un cercle figurant la précision. Cette précision est variable. Elle dépend du type de géolocalisation utilisée par votre équipement (TDOA, Macro, device) ainsi que des conditions radio (couverture et positionnement de l’équipement)

2.4.7.5. Modifier un équipement LoRa

Pour modifier un équipement LoRa allez dans les détails de l’équipement et cliquez sur la rubrique

« identité ».

Les informations concernant l’équipement sont présentées en deux parties : - Les informations sur l’équipement indépendantes de ses interfaces

- Les informations spécifiques aux interfaces réseaux qu’il utilise pour se connecter à Live Objects.

Les informations saisies lors de la création de l’équipement sont affichées. Il est possible de modifier le nom, le profil, le décodeur, les tags ainsi que les clés appEUI et appKey

La modification du devEUI n’est pas possible.

Remarques:

- l’appKey n’est jamais affichée en clair

- Le nom, et les clés appEUI, appKey ne sont pas modifiables si l’équipement est désactivé.

- Les options de connectivité doivent préalablement avoir été activées sur votre compte par votre service client pour être sélectionnables.

2.4.7.6. Ajouter une option de connectivité

 Géolocalisation TDOA : Sous conditions de couverture* ce type de géolocalisation permet une précision beaucoup plus grande qu’une géolocalisation standard

 « Ack Uplink » : Permet à l’équipement de demander au réseau un acquittement à chaque uplink émis

(* Contactez votre service client)

Pour bénéficier de ces options :

1) contactez votre service client pour activer ces options sur votre compte Live Objects 2) ensuite vous pouvez affecter ces options à un équipement (voir paragraphe « Modifier

un équipement LoRa »)

Pour ajouter une option de connectivité à plusieurs équipements à la fois, sélectionnez vos équipements dans la vue principale LoRa, puis cliquez sur l’icône « modifier ».

Dans la fenêtre qui s’ouvre cocher l’option désirée et sélectionner « ON » pour activer l’option sur tous les équipements sélectionnés ou « OFF » pour la désactiver. Si une option est laissée décochée aucune modification concernant cette option ne sera appliquée sur les équipements de la sélection.

Exemples ci-dessous :

En outre vous pouvez consulter les détails des paramètres réseau des « connectivity plan » associés. Les « connectivity plan » (CP) sont les plans de configuration de votre compte sur le réseau. La plupart du temps vous n’aurez pas à changer le CP par défaut, sauf besoins particuliers et sur conseil de votre service client.

Dans cet exemple : On active l’option TDOA sur tous les équipements de la sélection.

Dans cet exemple : On désactive l’option TDOA et on active l’option Ack uplink sur tous les équipements de la sélection.

2.4.7.7. Consulter les données remontées par un équipement LoRa (uplink)

Pour consulter les données remontées par un équipement LoRa allez dans les détails de l’équipement et cliquez sur la rubrique « Uplink».

La liste chronologique des messages envoyés par l’équipement est affichée ainsi que les informations réseau associées :

 La colonne « Payload » représente le contenu applicatif envoyé par l’équipement, au format hexadécimal. Ce contenu peut être décodé en associant un décodeur approprié.

 La colonne « Statut de décodage » indique si un décodage a été demandé et s’il s’est déroulé correctement ou non

 La colonne « Nombre de Gateway » indique le nombre de gateway qui ont relayé le message (c’est la « macro-diversité »)

 Informations réseaux : Rssi, Snr, Esp, Sf correspondant à la gateway ayant relayé le message (« best LRR »)

L’utilisation du filtre permet de rechercher les messages collectés sur une plage de temps.

Le sélecteur positionné à 100 par défaut permet de limiter le nombre d’uplink à afficher. Les 1000 plus récents peuvent être affichés au maximum

Ce tableau peut également être exporté au format CSV

2.4.7.8. Envoi de commande à un équipement LoRa (downlink)

Pour envoyer une commande à un équipement LoRa allez dans les détails de l’équipement et cliquez sur la rubrique « Commandes (Downlink)». L’historique des commandes envoyées à l’équipement est affiché par ordre chronologique.

Pour voir le détail d’une commande, cliquez dessus :

La colonne « statut » indique l’état de la commande et peut prendre les valeurs suivantes : - Pending: Signifie que la commande est en attente d’être envoyée à l’équipement soit

parce qu’une commande précédente est toujours en cours de traitement, soit parce que l’équipement est hors ligne et ne peut donc la recevoir

- Sent : Le réseau a envoyé la commande à l’équipement. Et la commande passe à l’état terminée « processed » si aucun acquittement n’a été demandé.

- Delivered : Si un acquittement a été demandé, le statut de la commande passe à

« delivered » lorsque qu’acquittement été reçu de la part de l’équipement (« ack bit à true » dans le prochain uplink consécutif au downlink contenant la commande. Visible

L’historique des commandes est exportable au format csv.

Une commande peut être renvoyée sans avoir à la ressaisir, pour cela, il suffit de la sélectionner dans la liste et de cliquer sur l’icône « Répéter »

Pour envoyer une nouvelle commande, cliquez que le bouton « Ajouter une commande »

Le formulaire requiert la saisie de deux champs :

- le port utilisé par l’équipement (il doit être supérieur à 0. L’envoi de commandes MAC n’est pas possible via Live Objects)

- les données de la commande (payload) au format hexadécimal (la validité du format est contrôlée)

Il est possible de définir la durée maximale pendant laquelle la commande peut rester en attente d’envoi dans Live Objects (status « pending ») avant d’être automatiquement annulée

Si le niveau d’acquittement réseau est sélectionné, la commande doit être acquittée par l’équipement (positionnement par le device du ack bit à true) dans l’un des trois prochains

 Ces antennes doivent avoir été provisionnées dans le réseau Orange

 L’option permettant de les visualiser doit avoir été activée sur votre compte Live Objects

 Pour cela veuillez contacter votre service client.

Pour consulter l’état de vos antennes, rendez-vous dans le menu « Parc ». Sélectionnez « LoRa » dans le sélecteur de connectivité et cliquez sur la rubrique « Antennes LoRa »

Vous accédez ainsi à la liste de vos antennes

Pour afficher les détails d’une antenne, cliquez dessus dans la liste. Le menu « Supervision » permet de superviser l’activité de l’antenne, en particulier le nombre de messages uplink transmis par l’antenne ou le nombre d’équipements utilisant cette antenne.

NB : Les messages downlink ne sont pas comptabilisés dans ce graphique.

L’id de ces antennes sera ajouté dans les métadonnées des messages qu’elles auront relayés, et que vous pouvez visualiser dans le menu « Données »

Enfin vous pouvez superviser le statut de vos gateway LoRa en temps réel (voir le paragraphe routage).

2.4.8. Equipements MQTT

2.4.8.1. Ajouter un équipement MQTT

L’ajout d’un équipement MQTT dans Live Objects est automatique. Lors de sa première connexion à Live Objects l’équipement s’enregistre de lui-même et remonte des informations qui lui sont propres (version de firmware, paramètres). Pour cela l’équipement devra avoir été dûment configuré (Voir le guide développeur https://liveobjects.orange- business.com/doc/html/lo_manual_v2.html#MQTT_MODE_DEVICE)

Un certain nombre d’attributs peuvent être ajoutés à un équipement pour faciliter sa gestion dans Live Objects (groupes, propriétés, tags). Ces attributs ne sont pas stockés au niveau de l’équipement mais restent au niveau plateforme.

Il est également possible d’ajouter un équipement MQTT dans Live Objects avant sa première connexion à la plateforme. Cela permet par exemple de préparer une flotte en renseignant à l’avance les attributs ci-dessus. Pour cela cliquez sur le bouton « Ajouter un équipement » du

Nom : Le champ nom permet d’attribuer un nom familier à votre équipement

MQTT client Id : Il s’agit du paramètre de connexion MQTT du même nom utilisé l’équipement pour se connecter

ID de l’équipement : Il s’agit de l’identifiant unique de l’équipement dans Live Objects. De la forme URN (Unique Resource Naming). L’espace de nommage (ou « namespace* ») ainsi que l’identifiant de l’équipement à l’intérieur de cet espace de nommage (« id ») peut-être personnalisé.

Stream Id par défaut : Il s’agit de la série temporelle par défaut dans lequel les messages émis par l’équipement seront stockés

Groupe : Le groupe d’équipements auquel ajouter l’objet. Par défaut seul le groupe racine (« root ») est proposé. (Voir la partie « Gestion de groupes »)

Tags : Etiquette en saisie libre. Les tags peuvent être utilisés pour trier facilement les équipements (par exemple « demo »). Vous pouvez saisir jusqu’à 10 tags de 32 caractères par équipement.

Propriétés : couples clé-valeur en saisie libre. Exemple : type d’équipement, fabricant, modèle…

* L'espace de noms fournit une dénomination cohérente pour un ensemble d’équipements. Par

groupe etc). Les données qui auront été remontées par cet équipement ne sont pas supprimées et restent accessibles dans l’onglet « Données ».

Pour supprimer un ou plusieurs équipements, sélectionner les équipements concernés en cochant la case correspondante dans la liste, et cliquer sur l’icône « Supprimer ».

2.4.8.3. Détail d’un équipement MQTT

Pour accéder aux informations détaillées concernant un équipement MQTT, cliquez sur l’équipement désiré dans la liste principale du menu « Parc ».

Le menu Supervision affiche l’état de l’équipement et de ses interfaces de connectivité.

- Date de dernière communication

- Alarme en cours, si une règle d’alarme a été définie pour cet équipement (Voir paragraphe

« Alarmes »)

- Etat de l’interface de connectivité:

o Statut de connectivité (Voir paragraphe « Etat des équipements ») o Paramètres de connexion MQTT

o Capacités de l’équipement concernant les opérations de device management (réception de commandes, mises à jour de configuration, firmware). Voir le guide développeur pour plus de détails sur le fonctionnement des équipements en

MQTT : https://liveobjects.orange-

business.com/doc/html/lo_manual_v2.html#MQTT_MODE_DEVICE

Le menu Identité d’afficher et de modifier les informations relatives à l’équipement et ses interfaces de connectivité.

Modification des attributs de l’équipement

2.4.8.4. Mettre à jour les paramètres d’un équipement MQTT

Un équipement peut posséder des paramètres qui lui sont propres comme des paramètres usine, ou applicatifs embarqués directement dans son micro code. Si l’équipement le permet ces paramètres peuvent être gérés dans Live Objects. L’équipement devra avoir préalablement remonté ces paramètres à Live Objects lors de sa connexion en MQTT (voir les topics réservés mentionnés dans le paragraphe précédent). Il est également possible de définir des valeurs cibles sur des paramètres d'un device que celui-ci n’a encore jamais remontés

La visualisation et la mise à jour des paramètres se fait dans le menu « Paramètres »

Désactivation/réactivation de l’interface de connectivité

Pour effectuer une mise à jour d’un paramètre, cliquez sur le paramètre concerné

Saisir les nouvelles valeurs de paramètres et cliquez sur le bouton « Mettre à jour ». Répétez l’opération pour chaque paramètre à modifier.

Les changements à appliquer figurent dans la colonne « Valeur cible ». Pour les envoyer à l’équipement cliquez sur le bouton « Envoyer les changements ».

Tant que vous n’avez pas cliqué sur le bouton « Envoyer les changements » vous pouvez annuler

Le statut passe à l’état « Envoyé » est reste dans cet état tant que l’équipement n’a pas acquitté la demande.

Une fois que l’équipement a répondu à la demande de mise à jour le statut passe à la valeur :

 none : Le paramètre a été créé depuis le portail Live Objects ou remonté par le device mais aucune demande de mise à jour n’a jamais été faite

 pending : Le device n’est pas prêt à recevoir la demande de mise à jour (il n’a pas souscrit au topic dev/cfg/upd (Voir la documentation développeur https://liveobjects.orange- business.com/doc/html/lo_manual_v2.html#_summary)

 sent : la demande a été envoyée au device et a été reçue (souscription au topic de mise à jour détectée)

 ok : L’équipement a reçu la demande de mise à jour et a confirmé son traitement en renvoyant à Live Objects des paramètres de valeurs identiques à la demande de mise à jour (publication de la réponse sur le topic dev/cfg)

 failed : L’équipement a reçu la demande mais a répondu à Live Objects en renvoyant des paramètres de valeurs différentes de celles envoyées dans la demande de mise à jour.

Il est également possible de positionner un paramètre à une valeur avant même que l’équipement ne se soit connecté et n’ai donc remonté ce paramètre, par exemple dans le cadre d’une procédure d’initialisation ou de provisioning. Pour cela cliquer sur le bouton « Ajouter un paramètre »

Id est le nom du paramètre. Il ne peut pas contenir les caractères «.» ou «$» et a une longueur maximum de 128 caractères

2.4.8.5. Envoyer une commande à un équipement MQTT

Pour envoyer une commande à un équipement MQTT allez dans les détails de l’équipement et cliquez sur la rubrique « Commandes (Downlink)». L’historique des commandes est affiché.

Pour afficher les détails d’une commande, cliquer dessus :

- Pending: Si l’équipement n’est pas prêt à recevoir la commande (il n’a pas souscrit au topic dev/cmd (Voir la documentation développeur https://liveobjects.orange- business.com/doc/html/lo_manual_v2.html#_summary)

- Sent : L’équipement a reçu la commande (souscription sur le topic dev/cmd) mais il ne l’a pas encore acquittée (publication sur dev/cmd/res). Notez que si aucun acquittement applicatif n’a été demandé lors de l’envoi de la commande, celle-ci passe automatiquement à l’état terminé (« processed »)

- Processed : L’envoi de la commande s’est correctement déroulé. L’équipement a reçu la commande et Live Objects a reçu la réponse de l’équipement (si un acquittement a été demandé lors de l’envoi de la commande)

- Replied : Dans ce cas où un acquittement applicatif a été demandé, ce statut indique que le device a répondu en publiant sur le topic dev/cmd/res

- Expired : La commande n’a pu être remise à l’équipement dans le délai spécifié lors de l’envoi de la commande.

NB : Le statut « processed » indique seulement que la commande a été correctement acheminée par Live Objects. Il ne préjuge pas du traitement réalisé sur l’équipement d’un point de vue applicatif. Ce résultat est une information que l’équipement peut toutefois communiquer dans sa réponse à Live Objects dans le cas d’une commande envoyée avec demande de confirmation (publication sur le topic dev/cmd/res)

Les topics MQTT auxquels l’équipement doit souscrire ou recevoir les commandes et sur lesquels il doit publier les réponses sont décrits dans la documentation développeur https://liveobjects.orange-business.com/doc/html/lo_manual_v2.html#_summary)

Pour envoyer une nouvelle commande, cliquez sur le bouton « Ajouter une commande » :

Vous pouvez sélectionner une durée d’expiration de la commande. Passé ce délai, si la commande n’a pu être transmise à l’équipement (l’équipement n’a pas souscrit au topic de réception dev/cmd) alors elle passe à l’état « expiré » et ne sera pas retransmise.

Niveaux d’acquittement :

- Aucun : Aucun acquittement (Live Objects publie en qos 0)

- Applicatif : Live Objects attend un message de réponse de l’équipement (publication sur le topic dev/cdm/res). Le message de réponse contient plus d’informations sur le résultat du traitement de la commande par l’équipement. Ce traitement peut tout à fait être une erreur d’un point de vue applicatif. La commande apparaitra elle comme traitée avec succès. Voir le guide développeur pour les détails d’implémentation côté équipement https://liveobjects.orange-business.com/doc/html/lo_manual_v2.html#_summary

Vous pouvez configurer le délai maximal dans lequel l’équipement doit donner son acquittement ainsi que le nombre de nouvelles tentatives à effectuer automatiquement en cas de non réception de l’acquittement dans ce délai.

Pour envoyer la commande cliquez sur le bouton « Valider » pour envoyer.

Tant qu’une commande n’a pas été transmise à l’équipement (statut « pending »), il est possible de l’annuler en la sélectionnant dans la liste et en cliquant sur l’icône « Annuler ». Son statut passe alors à « canceled ».

Cette commande pourra être renvoyée ultérieurement, comme n’importe quelle commande de l’historique en la sélectionnant et en cliquant sur l’icône « Répéter ».

Enfin les commandes peuvent être supprimées de l’historique. Pour cela sélectionner la ou les commandes à supprimer et cliquer sur l’icône « Supprimer »

NB : Le fait de supprimer de l’historique une commande en cours d’envoi (état « sent ») n’envoie pas d’ordre d’annulation à l’équipement. Cela entraine la suppression de la commande de l’historique et du Device Manager de Live Objects

2.4.8.6. Mettre à jour le firmware d’un équipement MQTT

Pour mettre à jour le firmware d’un équipement MQTT allez dans les détails de l’équipement et sélectionnez rubrique « Firmware »

L’écran de mise à jour est divisé en deux parties. La première partie présente les firmware que l’équipement a annoncés et si des opérations de mise à jour sont en cours sur ces firmwares. La deuxième partie est l’historique des mises à jour réalisées.

Prérequis : Pour pouvoir mettre à jour le firmware de votre équipement, il faut :

- Que votre équipement supporte cette fonction, et qu’il ait préalablement annoncé à la plateforme le nom de son firmware et sa version courante (voir le guide développeur https://liveobjects.orange-

business.com/doc/html/lo_manual_v2.html#MQTT_DEV_RSC)

- Que la ou les versions à mettre à jour aient été préalablement créées dans le gestionnaire de firmwares de Live Objects et les binaires correspondants importés dans la plateforme.

(Voir le menu « Configuration » pour la gestion des firmwares)

Le statut de la demande passe à « pending ». Cela signifie que la demande est en attente de réception par l’équipement.

Une fois reçue par l’équipement la demande passe en « preparing_asset – 0% ». Cela signifie que l’équipement a reçu la demande, mais qu’il n’a pas encore répondu s’il l’acceptait

Si l’équipement répond positivement à la demande, elle passe en attente de transfert.

La plateforme suit automatiquement la progression du téléchargement du binaire par l’équipement

Une fois le transfert effectué, et l’installation effectuée, l’équipement remonte à Live Objects sa nouvelle version. Si elle correspond à la valeur cible de la mise à jour en cours, alors le processus s’achève en succès et le statut passe à « done 100% »

Voir le guide développeur pour les détails d’implémentation côté équipement https://liveobjects.orange-business.com/doc/html/lo_manual_v2.html#_summary

2.4.9. Equipements SMS

Vous pouvez connecter à Live Objects des équipements communiquant par SMS sur le réseau GSM d’Orange. Ces équipements doivent impérativement disposer d’une carte SIM Orange France.

Vous pouvez accéder au menu de gestion des équipements SMS à partir du menu « Parc » en sélectionnant « SMS » dans le menu déroulant.

2.4.9.1. Ajouter un équipement SMS

Pour ajouter un nouvel équipement SMS, cliquez sur le bouton « Ajouter un équipement » dans le menu principal « SMS ».

Numéro de téléphone du serveur : c’est le numéro court qui sera utilisé par votre équipement

Décodeur : Sélectionner décodeur dans la liste si la payload doit être décodée.

MSISDN : C’est le numéro de votre équipement suivant le format indiqué dans l’exemple.

ID de l’équipement : Il s’agit de l’identifiant unique de l’équipement dans Live Objects. De la forme URN (Unique Resource Naming). L’espace de nommage (ou « namespace* ») ainsi que l’identifiant de l’équipement à l’intérieur de cet espace de nommage (« id ») peut-être personnalisé.

Stream Id par défaut : Il s’agit de la série temporelle par défaut dans lequel les messages émis par l’équipement seront stockés

Groupe : Le groupe d’équipements auquel ajouter l’objet. Par défaut seul le groupe racine (« root ») est proposé. (Voir la partie « Gestion de groupes »)

Tags : Etiquette en saisie libre. Les tags peuvent être utilisés pour trier facilement les équipements (par exemple « demo »). Vous pouvez saisir jusqu’à 10 tags de 32 caractères par équipement.

Propriétés : couples clé-valeur en saisie libre. Exemple : type d’équipement, fabricant, modèle…

* L'espace de noms fournit une dénomination cohérente pour un ensemble d’équipements. Par exemple, tous les appareils du même fabricant ou du même type. L’id identifie lui l’équipement dans cet espace de noms.

2.4.9.2. Supprimer un équipement SMS

Pour supprimer un équipement SMS, il suffit de le sélectionner dans la liste et de cliquer sur l’icône « Supprimer ».

2.4.9.3. Envoyer une commande à un équipement SMS

Pour envoyer une commande à un équipement SMS allez dans les détails de l’équipement et cliquez sur la rubrique « Commandes (Downlink)». L’historique des commandes envoyées à l’équipement est affiché par ordre chronologique.

Pour voir le détail d’une commande, cliquez dessus :

La colonne « statut » indique l’état de la commande et peut prendre les valeurs suivantes : - Pending: Non applicable. Dans le cas de la connectivité SMS l’information de connexion

effective de l’équipement au réseau, ainsi que l’accusé de réception des messages par l’équipement ne sont pas disponibles. Aussi, les commandes ne restent jamais en attente dans la plateforme Live Objects elles sont directement transmises au réseau mobile. Pour cette raison il n’est pas possible de définir une durée d’expiration de commande, comme dans le cas des équipements LoRa et MQTT

- Sent : indique que la commande a été transmise au réseau mobile. Il n’y a pas de confirmation de réception par l’équipement. La commande passe automatiquement à l’état terminé (« processed »).

Une commande peut être renvoyée sans avoir à la ressaisir, pour cela, il suffit de la sélectionner dans la liste et de cliquer sur l’icône « Répéter »

Pour envoyer une nouvelle commande, cliquez que le bouton « Ajouter une commande »

Les données à envoyer sont à saisir dans le champ « payload » au format texte ou en hexadécimal pour le format binaire. Le format binaire doit être obligatoirement en hexadécimal et de 140 octets (280 caractères) maximum

NB : Il n’est pas possible de spécifier une durée d’expiration pour une commande en connectivité SMS (voir remarque sur le statut « pending », plus haut dans ce paragraphe)

2.4.9.4. Modifier un équipement SMS

Pour modifier un équipement SMS, affichez ses détails et allez dans le menu « identité ». Vous pouvez modifier les informations propres à un équipement (appartenance de groupe, tags, propriétés), ou les caractéristiques de son interface de connectivité (Numéro de serveur ou décodeur affecté). Pour cela cliquez sur l’icône « modifier »

2.4.10. Connecteur externe

Le connecteur externe permet de rendre la gestion des équipements dans Live Objects totalement agnostique de la connectivité. Grâce au connecteur externe, des équipements gérés par un cloud propriétaire, ou utilisant un protocole de communication spécifique peuvent bénéficier des mêmes fonctionnalités de device management de Live Objects (ex : Gestion de campagne, groupes…) que les autres équipements MQTT, LoRa ou SMS. La gestion de flotte se fait via des interfaces et des API unifiées.

Pour implémenter un connecteur externe, veuillez consulter la documentation ici https://liveobjects.orange-

business.com/doc/html/lo_manual_v2.html#MQTT_MODE_CONNECTOR

Le fonctionnement des équipements gérés par un connecteur externe est similaire à celui des équipements MQTT. Pour créer un équipement de type « connecteur externe », il y a deux possibilités comme pour MQTT :

1/ Soit par autoprovisioning : L’équipement est automatiquement créé dans le Device Manager Live Objects dès que l’external connecteur fait un publish status (voit documentation indiquée ci- dessus)

2/ Soit en créant l’équipement dans le Device Manager avant sa première connexion. Pour cela aller dans le menu Parc cet cliquer sur « Ajouter un nouvel équipement »

Le champ « external connector ID » est l’id de l’équipement dans le connecteur externe. Cet id sert à construire l’id de l’équipement dans Live Object.

Les autres champs, « streamId », « tags », « groupes » et « propriétés » sont les mêmes que pour les autres types d’équipements (voir les paragraphes concernés)

La gestion des équipements de type « connecteur externe » est très similaire à celle des équipements MQTT. En particulier l’envoi de commande, qui présente les mêmes caractéristiques et statuts, à la différence près que dans le mode connecteur les états affichés dans Live Objects sont ceux reportés par le connecteur et non par les équipements terminaux.

2.4.11. Groupes

Il vous est possible d’organiser votre parc par groupes d’équipements.

Vous pouvez créer, renommer ou supprimer un groupe, ou un sous-groupe en cliquant à la racine

Pour déplacer un équipement d’un groupe à un autre, aller dans les détails de l’équipement, ou sélectionnez-le dans la liste et cliquez sur l’icône « Déplacer ».

Pour déplacer un groupe et ses groupes (et tous les équipements qu’ils contiennent) vers un autre groupe, sélectionner le groupe à déplacer et cliquez sur Déplacer dans le menu contextuel

2.4.12. Gestion de campagnes

Les campagnes permettent la planification, l’exécution et le suivi d’opérations de Device Management en masse. Les opérations applicables aux équipements sont celles supportées par le type de connectivité utilisé.

2.4.12.1. Créer une campagne

Vous accédez à la gestion des campagnes via le menu « Parc », en cliquant sur la rubrique

« Campagnes »,

puis cliquez sur « Créer une campagne »

La première étape consiste à sélectionner les cibles. Cela peut se faire:

 Soit par import par import d’un fichier CSV : Soit en important une liste d’équipements existant obtenue via l’export csv du parc (voir paragraphe « Exporter ses équipements »), soit en important une liste d’équipements qui n’existent pas encore dans Live Objects ; dans ce cas le fichier d’import ne contiendra que la colonne « Id ».

 Soit en utilisant des filtres avancés

La deuxième étape consiste à indiquer le type d’opération qui sera appliquée aux équipements sélectionnés, et de fournir les paramètres correspondants à l’opération. Les opérations

NB : Le portail Live Objects ne permet de ne choisir qu’une seule et même opération pour l’ensemble des équipements sélectionnés. S’il vous est nécessaire de combiner au sein d’une même campagne plusieurs opérations par équipement (ex : une commande, suivie d’une mise à jour de firmware) vous pouvez le faire en utilisant les API https://liveobjects.orange- business.com/doc/html/lo_manual_v2.html#_campaign_management et https://liveobjects.orange-business.com/swagger-ui/index.html#!/Campaign_management NB : Pour chaque opération il est possible de spécifier un nombre de nouvelles tentatives en cas d’échec (jusqu’à 5)

La troisième étape consiste à planifier la campagne.

2.4.12.2. Suivre une campagne

Les campagnes sont classées en fonction de leur planification : « Planifiées », « En cours » et

« Terminées ». Cliquez sur l’onglet correspondant pour les lister.

Etat de la campagne et nombre de cibles traitées / nombre total