Manuel d'utilisation de l'application web de ROC

Introduction

La présente notice d'utilisation de l'application ROC-E / ROC-M décrit l'ensemble des fonctionnalités et leur fonctionnement.

Elle regroupe l'utilisation de l'application sur un robot ROC-E et celle sur un manager ROC-M.

Page d'accueil

Sur un robot ROC-E

La page d'accueil présente sous forme de gros bouton la liste des destinations enregistrées dans la carte du robot.
Un appui sur l'un de ces boutons permet d'envoyer l'ordre au robot de se déplacer à la destination associée.

Le bouton en bas à droite permet d'accéder à la configuration de l'application.

Sur un manageur

3 boutons en bas de l'écran permettent d'accéder à différentes sections :

Le bouton à gauche permet d'accéder à la liste des missions en cours.
Le bouton de droite permet d'accéder à la configuration de l'application.
Le bouton central permet d'accéder aux statistiques d'utilisations.

Configuration

La page de configuration permet comme son nom l'indique de configurer l'outil.

En fonction de la configuration (par exemple manager ou non), certaines options peuvent ne pas être disponibles.

../_images/hermes_configuration.png — Cette page vous permet d'accéder aux sections suivantes :

`ROC` : pour la configuration générale du module.

`Boutons` : pour ajouter / modifier / supprimer des boutons d'appel.

`Véhicules` : pour gérer la liste des véhicules de la flotte.

`Points d'attente` : pour ajouter / modifier / supprimer des points d'attentes.

`Commandes personnalisées` : pour ajouter / modifier / supprimer des commandes personnalisées.

`Contrôleurs LoRa` : pour ajouter / modifier / supprimer des contrôleurs LoRa.

`Noeme application` : pour accéder à l'application de Noeme.

`Carte` : pour gérer les destinations.

`Connectivité` : pour gérer les différentes connexions WiFi de ROC et Noeme.

`Import / Export` : pour exporter / importer les configurations.

`Langues` : pour sélectionner la langue de l'interface.

`Comptes utilisateurs` : pour ajouter / modifier / supprimer un compte utilisateur.

`Volumes sons` : pour configurer les différents volumes sonores.

`Mode maintenance` : pour activer ou désactiver le mode maintenance (uniquement pour le manager).

`Rafraîchir` : pour mettre à jour la page (peut-être utile lors de la mise à jour de l'application).

`Redémarrer` : pour redémarrer l'application ROC.

ROC

../_images/roc-e_configuration_-_roc.png — Cette page de configuration vous permet d'accéder à certaines informations (version de l'application, ROC Id…) et de configurer les différents paramètres de l'application.

Version application : version de l'application installée.
Id ROC : identifiant unique du module.
LoRa SP : configuration du spread factor de la communication LoRa ; doit être le même que les boutons d'appels, le manager et les autres robots.Valeur possible de 7 à 12.
Plus la valeur est élevée, plus la communication sera lente mais la portée étendue.
Mot de passe : mot de passe pour accéder à la partie configuration.
Est un gestionnaire ROC ?: indiquer si l'équipement actif est le manager ou non.
Est un véhicule ROC ? : indiquer si l'équipement actif est connecté à un véhicule Noeme.
Clavier virtuel : utilisation ou non du clavier virtuel.
Autoriser les déplacements depuis le dock : autoriser à un utilisateur de démarrer une nouvelle mission quand le robot est en attente à sa station de charge.
Délai de réponse : délai d'attente pour recevoir les réponses des boutons d'appel.
Id véhicule : identifiant unique du véhicule.
Direction : pour indiquer le sens d'arrivée du véhicule.
Module ROC : type de module ROC actif.
Id module : identifiant du module pour la communication. Doit être unique et reporté sur la manager.
Délai d'auto-libération : délai de libération automatique lors de l'arrivée à la première étape (robot sans charge).
Délai d'auto-libération multidestination : délai de libération automatique lors de l'arrivée aux autres étapes (robot potentiellement chargé).
Délai d'attente du branchement de la tablette : pour les versions avec tablette amovible, délai d'attente avant que le robot ne parte si la tablette n'est pas connectée.
Délai d'alerte tablette non branchée : pour les versions avec tablette amovible, délai d'attente entre 2 alertes quand la tablette n'est pas connectée.
Délai entre 2 sons lors de l'attente de libération : délai d'attente entre 2 sons pour indiquer l'attente de libération.
Délai entre 2 tentatives en cas d'échec du déplacement : délai d'attente entre 2 tentatives en cas d'échec du déplacement.
Nb tentative en cas d'échec du déplacement à la première étape : nombre de tentative de déplacement en cas d'échec du déplacement à la première étape.
Nb tentative en cas d'échec du déplacement aux autres étapes : nombre de tentative de déplacement en cas d'échec du déplacement aux autres étapes.
Nb tentative en cas d'échec du déplacement en multidest : nombre de tentative de déplacement en cas d'échec du déplacement lors d'un multidestination.
Veh vers destination, tolérance de distance à l'arrivée : distance en cm autour de la destination où le robot est considéré comme arrivé.
Veh vers destination, tolérance angulaire à l'arrivée : angle en degré par rapport à la destination où le robot est considéré comme arrivé.
Délai avant un nouvel essai sur une position d'attente : délais d'attente avant un nouvel essai quand le robot est sur une position d'attente.

Boutons

Ajout d'un bouton

Pour ajouter une nouvelle configuration de bouton, cliquer sur le bouton “Ajouter un bouton”.

Si l'application est configurée en manager et véhicule, un mode automatique vous sera proposé, donc les autres cas, le mode manuel sera affiché.

Suivez les étapes pour créer un nouveau bouton.

Type de bouton

../_images/hermes_config_roc_bouton_type.png — L'application gère actuellement 5 types de boutons :

`Bouton d'appel` : Lors de l'appui sur le bouton associé, le robot se déplacera jusqu'à la destination associée. Une fois sur place, l'utilisateur pour choisir la prochaine étape ou libérer le robot.

`Bouton réappro` : Lors de l'appui sur le bouton associé, le robot se déplacera jusqu'à la première destination associée. Une fois sur place, l'utilisateur ne pourra que libérer le robot, et celui-ci partira à la deuxième destination associée. Ce type de configuration peut-être utile dans le cas d'un réapprovisionnement d'un poste de travail, l'appel est lancé depuis le poste de travail, le robot part dans un premier temps au magasin où il sera chargé puis dans un deuxième temps au poste de travail de l'utilisateur.

`Bouton multidestination` : Lors de l'appui sur le bouton associé, le robot se déplacera à toutes les destinations associées de plus proche en plus proche.

`Bouton multidestination et retour` : Lors de l'appui sur le bouton associé, le robot se déplacera à toutes les destinations associées de plus proche en plus proche et terminera par une dernière position spécifique configurée.

`Bouton multidestination ordonnée` : Lors de l'appui sur le bouton associé, le robot se déplacera à toutes les destinations associées dans l'ordre défini.

Contraintes

../_images/hermes_config_roc_bouton_contrainte.png — Pour chacune des étapes, vous pouvez configurer des contraintes. Pour cela, il vous suffit de cliquer sur le cadenas lié à l'étape.

Ces contraintes sont liées aux contrôleurs LoRa connectés à la solution (cf section Contrôleurs LoRa) ;

Pour définir une contrainte, vous devez indiquer :

le contrôleur LoRa où est connecté le capteur qui définira la contrainte

le contact du contrôleur LoRa

l'état du contact attendu pour valider l'étape

Type de module

../_images/hermes_config_roc_bouton_modules.png — Une fois un bouton créé, vous pouvez limiter l'appel de ces boutons à certains type de module ROC ; pour cela, cliquer sur le lien “Tous les modules” au niveau du bouton puis sélectionnez le ou les modules autorisés à répondre à un appel de ce bouton.

Véhicules

../_images/configuration-vehicules.png — Cette page liste les véhicules configurés.

Pour supprimer un véhicule, cliquez sur la croix rouge associée au véhicule.

Pour ajouter un nouveau véhicule, cliquez sur le bouton “Ajouter un véhicule” et compléter les informations demandées.

Points d'attente

../_images/hermes_configuration_points_attente.png — Dans certains cas, plusieurs robots auront besoin d'aller à la même position sauvegardée en même temps.

Pour éviter que les robots s'auto bloquent, il est possible de configurer des points d'attente pour que l'un des robots se mette en attente sur la position en attendant que l'autre robot ait quitté la position sauvegardée.

**Pré-requis**

Pour ajouter un nouveau point d'attente, vous devez avoir crée au préalable :

`La position sauvegardée` où il peux y avoir conflit.

La position sauvegardée correspondant au `point d'attente`.

`Une zone paramétrable` qui doit contenir la position sauvegardée où il peux y avoir conflit. Le robot enverra un message aux autres robots pour indiquer que la place est libre quand il quittera cette zone.

Commandes personnalisées

../_images/hermes_configuration_commandes_personnalis%C3%A9es.png — Il est possible de créer des commandes personnalisées pour demander à un contrôleur LoRa d'activer un de ses relais à un moment particulier.

Pour ajouter une commande personnalisée, vous devez indiquer :

un `titre`

la `zone de déclenchement` (créez une zone paramétrable sur la carte dans un premier temps)

la `liste des positions sauvegardées` pour lesquelles l'ordre doit être envoyé (ne rien sélectionner pour appliquer à toutes les destinations)

le `moment déclencheur` (en entrant dans la zone, en sortant de la zone, sur une erreur de déplacement, tant que le robot est dans la zone)

le `relais du contrôleur LoRa` à activer

**Exemples d'utilisation** : ouvrir une porte automatique, couper un système d'alarme d'une zone, …

Contrôleurs LoRa

../_images/hermes_configuration_controleur_lora.png — Cette section de permet de rajouter, modifier et supprimer des contrôleur LoRa pour ensuite être utilisé dans les autres configurations.

Lorsqu'un contact du contrôleur est actif, la pastille sera verte.

Noeme application

Ce menu vous permet d'accéder directement à l'application du véhicule.

Se référer à la documentation de l'application de Noeme pour plus de détails.

Carte

Cette section vous permet:

d'ajouter, déplacer, supprimer des positions sauvegardées.
de modifier les noms, icônes et couleurs des positions sauvegardées, stations de recharge et positions dockées.
de limiter l'accès aux positions à certain type de module.

Connectivité

../_images/roc-e_configuration_-_connectivite.png — Cette page vous permet d'activer, de désactiver et de configurer les différentes fonctionnalités WiFi pour le module et Noeme.

Import / Export

Langues

Comptes utilisateurs

../_images/roc-e_configuration_-_comptes.png — Cette page vous permet d'ajouter, de modifier ou de supprimer un compte utilisateur.

Volumes sons

Cette page vous permet de paramétrer un volume maximum pour chaque scenario de sons émis par le véhicule.

../_images/hermes_configuration_sons.png — Le volume général agit comme une limite haute pour toutes les autres valeurs.
*S'il est configuré à 30, les autres volumes ne pourront pas excéder 30.*

Les scénarios paramétrables sont les suivants :

`Initialisation` : Sons émis au **démarrage** du véhicule.

`Connexion hotspot` : Sons émis à la **connexion** d'un appareil au **hotspot WiFi** du véhicule.

`IHR` : Sons émis quand le véhicule est en **attente d'une intervention humaine** (Intervention Humaine Requise).

`Obstacle` : Sons émis quand le véhicule détecte un **obstacle** lors d'un déplacement.

`Comportements spéciaux` : Sons émis lors d'un état particulier du véhicule.

`Autopilote` : Sons émis lors des **étapes** de sons d'une séquence du mode **autopilote** du véhicule.

`Sons ROC` : Sons émis lors des missions.

`Zones paramétrables` : Sons émis lorsque le véhicule rentre, sort ou se trouve dans une **zone paramétrable** dans laquelle des **comportements sonores** ont été configurés.

Mode maintenance

Cliquez sur ce bouton pour activer ou désactiver le mode maintenance.

Ce bouton n'est visible que sur un manager et permet de mettre en pause le système.

Si le mode maintenance est activé, l'icône du bouton sera orange.

Rafraîchir

Cliquez sur ce bouton pour force un rafraîchissement complet de la page.

Cette action peut-être utile après une mise à jour de l'application.

Redémarrer

Cliquez sur ce bouton pour redémarrer complètement l'application et la réinitialiser dans son été de démarrage.

Statistiques

La page de statistiques vous permet d'accéder à un ensemble de graphique et heatmap sur le fonctionnement de la solution.

Le bouton Export vous permet d'exporter les données brutes de l'application pour générer vos propres statistiques d'utilisation.

Accueil

Permet d'avoir une visualisation générale de l'utilisation de la solution.

Un système de filtre vous permet de choisir la date et la période des données analysées.

Appels

Permet de consulter un ensemble de graphique sur les appels effectués sur la solution.

Appels par bouton

Permet de consulter le nombre d'appel par bouton.

Destinations

Permet de consulter des statistiques sur les destinations les plus demandées ainsi qu'une heatmap.

Délais

Permet de consulter des statistiques sur les délais d'interventions sur la solution :

Temps de trajet
Délai d'assistance en cas de problème
Délai de libération

Erreur de déplacement

Permet de consulter des statistiques sur les erreurs de déplacement ainsi qu'une heatmap pour voir où les problèmes se produisent.

IHR

Permet de consulter des statistiques sur les erreurs IHR (Intervention humaine requise) ainsi qu'une heatmap pour voir où les problèmes se produisent.

Missions

La page "missions" n'est disponible que sur les manageurs.

Elle permet de consulter la liste des missions en cours et de créer de nouvelles missions

Création d'une nouvelle mission

Créer une nouvelle mission

En cliquant sur le bouton "Créer une nouvelle mission", vous pouvez créer une nouvelle mission sur mesure à envoyer aux robots.

Etape 1 : choisir entre une mission multidestination ou une mission multidestination ordonnée.
Etape 2 : choisir les destinations.
Etape 3 : choisir le ou les types de modules autorisés pour cette mission (si vous ne sélectionnez aucun module, ils seront tous autorisés).
Etape 4 : choisir un ou plusieurs robots autorisés pour cette mission (si vous ne sélectionnez aucun robot, ils seront tous autorisés, si vous ne sélectionnez qu'un seul robot, la mission lui sera directement assigné).

Démarrer une mission de bouton

En cliquant sur le bouton "Démarrer une mission de bouton", vous pouvez créer une nouvelle mission à envoyer aux robots à partir des boutons pré configuré. Le fonctionnement sera le même que si vous appuyer sur un bouton LoRa.

Etape 1 : choisir le bouton préconfiguré.
Etape 2 : choisir un ou plusieurs robots autorisés pour cette mission (si vous ne sélectionnez aucun robot, ils seront tous autorisés, si vous ne sélectionnez qu'un seul robot, la mission lui sera directement assigné).

Listes de missions

La première liste présente les missions prioritaires.

La seconde, les missions non prioritaires (par défaut)

Une mission non prioritaire passera prioritaire si un premier robot n'arrive pas à exécuter la mission (dès qu'un autre robot sera disponible, il prendra en priorité cette mission).

Mission

Détails de la mission

../_images/missions_step.png — Cette popup vous permet de consulter les détails de la mission avec toutes ses étapes.

Libérer un robot

../_images/missions_wait_release.png — Quand un robot est en attente de libération, le bouton "Libérer le robot" apparaît.

Ce bouton vous permet de libérer le robot pour qu'il parte à sa prochaine étape ou retourne se mettre en charge si sa mission est terminée.

Etendre une mission

../_images/missions_mission_end.png — Quand un robot est en attente de libération et a terminé sa mission, le bouton "Etendre la mission" apparaît.

Ce bouton vous permet d'indiquer au robot les prochaines étapes de sa mission.

Le robot sera automatiquement libéré lorsqu'il reçoit ces nouvelles étapes.