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.

Multi destinations

../_images/multidest.png — En cliquant sur le bouton `Multi destinations`, vous pouvez demander au robot de se déplacer à plusieurs positions dans la même mission en sélectionnant les destinations souhaitées. Le robot se déplacera de destination en destination du plus proche au plus proche.

Une fois le robot à une destination, l'opérateur ne pourra que libérer le robot pour qu'il aille à sa prochaine étape (il ne pourra pas demander au robot d'aller à une autre destination).

Multi destinations ordonnée

../_images/ordered.png — En cliquant sur le bouton `Multi destinations ordonnée`, vous pouvez demander au robot de se déplacer à plusieurs positions dans la même mission dasn un ordre fixe en sélectionnant les destinations souhaitées. Le robot se déplacera de destination en destination dans l'ordre souhaité.

Une fois le robot à une destination, l'opérateur ne pourra que libérer le robot pour qu'il aille à sa prochaine étape (il ne pourra pas demander au robot d'aller à une autre destination).

Messages prédéfinis

../_images/comment.png — Si des messages prédéfinis ont été configurés, un bouton avec 2 bulles apparaît en haut à droite.

Ce bouton permet de sélectionner un message prédéfini à afficher une fois le robot à sa destination pour la mission en court.

../_images/multidest_comment.png — Dans le cas du multi destinations, le message peut être personnalisé pour chaque étape en cliquant sur le bouton associé à l'étape.

../_images/ordered_comment.png — Dans le cas du multi destinations ordonnée, le message peut être personnalisé pour chaque étape en cliquant sur le bouton associé à l'étape.

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.

`Messages prédéfinis` : pour ajouter / modifier / supprimer des messages prédéfinis.

`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.

`Sélectionner une carte` : pour gérer la carte active.

`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

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.

Général

../_images/roc-e_configuration_-_roc.png — Cette page vous permet de consulter / modifier les paramètres suivant :

`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.

Manager

Véhicule

../_images/roc-e_configuration_-_roc-vehicle.png — Cette page vous permet de consulter / modifier les paramètres suivant :

`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.

`Id véhicule` : identifiant unique du véhicule.

`Direction` : pour indiquer le sens d'arrivée du véhicule.

`Id LoRa module` : identifiant LoRa du module pour la communication. Doit être unique et reporté sur la manager.

`Mettre l'écran en veille`: Mettre l'écran en veille quand le robot entre en veille.

`Autoriser le mode suiveur`: Autoriser le mode suiveur quand est à l'arrêt.

`Son par défaut quand le robot est en attente`: Sélectionner le son par défault que le robot est en attente sur une position.

`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é.

Véhicule - Dimensions

../_images/roc-e_configuration_-_roc-vehicle-size.png — Cette page vous permet de consulter / modifier les paramètres suivant :

`Module ROC` : type de module ROC actif.

`Poids maximum` : poids maximum di robot avec sa charge.

`Hauteur` : hauteur totale du robot.

Si le module est de type `ROC-L`

`Largeur de la charge` : largeur de la charge transportée.

`Profondeur de la charge` : Profondeur de la charge transportée.

`Hauteur avec la charge` : hauteur totale du robot avec sa charge.

`Vitesse maximale avec la charge` : vitesse maximale du robot autorisé quand il transporte la charge.

Si le module est de type `Other`

`Largeur maximale` : largeur maximale du robot.

`Profondeur maximale` : Profondeur maximale du robot.

Véhicule - Délais

../_images/roc-e_configuration_-_roc-vehicle-delay.png — Cette page vous permet de consulter / modifier les paramètres suivant :

`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.

`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.

`Délai avant mise en veille` : délais d'attente une fois que le robot est en charge et avant qu'il ne passe en veille.

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 ou pour mettre en pause le déplacement du robot en fonction de l'état d'un contact du contrôleur LoRa.

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, activer le "Toutes sauf" pour ne choisir que les positions dans lequel le comportement ne doit pas se déclencher)

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 ou le contact à attendre

**Exemples d'utilisation** : ouvrir une porte automatique, couper un système d'alarme d'une zone, attendre qu'une porte soit ouverte pour continuer...

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.

Lors de la modification d'un contrôleur LoRa, il est possible de récupérer à distance la configuration des contacts du contrôleur. Une fois cette configuration récupérée, vous pouvez modifier la configuration d'un contact à distance.

Messages prédéfinis

../_images/hermes_configuration_predefined_messages.png — Cette section de permet de rajouter, modifier et supprimer des messages prédéfinis pour ensuite être utilisé lors des déplacements du robot.

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 configurer le pilotage d'un relais d'un contrôleur LoRa quand le robot est sur la position.
de limiter l'accès aux positions à certain type de module.
de gérer les groupes.

Groupes

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.

Cette page permet également, pour les véhicules, d'accéder à la configuration des redirections de port.

Redirections de port

../_images/roc-e_configuration_-_port_redirections.png — Cette page vous permet d'activer, de désactiver et de configurer les redirections de port du véhicule vers d'autres équipements.

Dans le cas où vous connectez un équipement sur le réseau cablé du véhicule et que celui-ci est connecté à votre réseau Wifi, les redirections de port vous permettent d'accéder à votre équipement à travers votre réseau Wifi et une redirection de port configurée sur le robot.

Sélectionner une carte

../_images/select_map.png — Cette page permet de changer la **carte active** 🗺️ du véhicule parmi les cartes **créées** ou **importées** sur le véhicule.

Elle permet aussi de renommer et supprimer les sites, ainsi que de supprimer les cartes.

Sur cet affichage en "arbre", les **sites** (contenant les cartes) sont visibles sur la gauche de l'arbre, les **cartes**, leurs noms et leurs **aperçus** sont situés sous le site parent.

Le bouton crayon ✏️ permet de modifier le **nom** et la **description** d'un site. Le bouton poubelle 🗑️ de supprimer, une **confirmation** sera demandée.

*Il est impossible de supprimer le site actif ou la carte active*.

Une fois la sélection terminée, le bouton en bas de page permet de lancer le **changement de carte**.

Le véhicule commencera par remplacer sa **carte active** puis il effectuera une **relocalisation** pour démarrer la **navigation autonome** sur sa nouvelle carte.

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.