Guide d'intégration du robot Ascento

Introduction

Le robot Ascento est un robot de sécurité autonome qui transporte cinq caméras. Ce guide explique comment il se connecte à GCXONE, et ce que vous pouvez voir et faire une fois qu'il fonctionne.

Une fois le robot connecté, GCXONE vous fournit :

• Vidéo en direct provenant des cinq caméras du robot — avant, arrière, gauche, droite et une caméra thermique.
• Alarmes de détection déclenchées pendant que le robot patrouille, comme les personnes et les véhicules. Chaque alerte est accompagnée d'images et d'un cadre autour de ce qui a été détecté.
• Alertes techniques concernant le robot lui‑-même — batterie faible, état de charge, sortie de sa zone de sécurité, changements du projecteur et du feu de détresse, et perte de communication.
• Contrôle de l'éclairage — activer ou désactiver le projecteur et le feu de détresse du robot.

Aperçu du Système

GCXONE se connecte au cloud Ascento pour recevoir :

• Diffusion vidéo en direct
• Alarmes et événements
• Modifications de l'état du robot

Architecture du Système

Flux de communication

Aperçu Configuration

Exigences Pré-Intégration

Configuration du robot Ascento

Étape 1 : Se connecter à la plateforme GCXONE

• Ouvrir l'URL GCXONE dans un navigateur.
• Se connecter en utilisant vos identifiants d'administrateur ou d'intégrateur.
• Après vous être connecté, GCXONE charge l'environnement de votre locataire.

Étape 2 : Sélectionner votre organisation

Si votre locataire possède plusieurs organisations, GCXONE vous demande laquelle vous souhaitez gérer.

• Plus d'une organisation — choisissez celle que vous voulez dans l'écran de sélection.
• Une seule organisation — GCXONE l'ouvre pour vous et vous amène directement au tableau de bord.

Étape 3 : Accéder à l'application Configuration

• Dans le panneau Applications à gauche, localisez le Configuration icône.
• Cliquez sur Configuration pour ouvrir l'espace de travail de configuration.
• L'écran de configuration s'ouvre. C’est ici que vous gérez les clients, les emplacements et les appareils.

Étape 4 : Comprendre la hiérarchie de configuration

GCXONE organise tout selon un ordre fixe : Client → Emplacement → Appareil → Caméras/Capteurs.

Fonctionnement de cette hiérarchie

• Client — l’entreprise ou le client au sommet. Un client possède un ou plusieurs emplacements.
• Emplacement — un lieu, tel qu’un bureau, un entrepôt ou un magasin de détail. Chaque appareil à cet emplacement appartient à son emplacement.
• Appareil — le matériel lui‑même, tel qu’un robot Ascento. Ses caméras et capteurs se trouvent en dessous.

Respecter cet ordre permet de router les alarmes au bon endroit, de garder les données de chaque client séparées et d’assurer que les rapports fonctionnent emplacement par emplacement.

Étape 5 : Sélectionner ou créer un client/emplacement

Dans l'application Configuration :

• Choisissez un client et un emplacement existants dans la liste, ou cliquez sur Ajouter nouveau pour les créer.

Étape 6 : Ajouter des appareils au site

Avec le site sélectionné :

• Ouvrir le Appareils onglet sous la LOCATION.
• Cliquer sur Ajouter nouveau.
• Choisir le type d’appareil que vous souhaitez ajouter :
• Ascento
• L’assistant de configuration de l’appareil s’ouvre.

Ajouter les détails de configuration suivants pour l’intégration Ascento :

1. Robo ID – Identifiant unique du robot Ascento.
2. Nom d’utilisateur – Nom d’utilisateur Ascento Cloud utilisé pour s’authentifier auprès de l’API REST Ascento. Un jeu d’identifiants cloud s’applique à tous les appareils de la même organisation.
3. Mot de passe – Mot de passe Ascento Cloud utilisé pour s’authentifier auprès de l’API REST Ascento.
4. URL d’Alarme – Prérempli automatiquement pour recevoir les notifications d’alarmes et d’événements (aucune saisie requise).
5. Identifiant d’organisation – Lecture seule. Rempli automatiquement, et utilisé pour récupérer les informations détaillées des événements.
6. Nom d’organisation – Lecture seule. Rempli automatiquement, et utilisé pour établir la connexion MQTT et le flux d’événements.
7. Zone sûre en mètres – Facultatif. Distance du périmètre de zone sûre autour du robot.
8. Fuseau horaire – Obligatoire. Le fuseau horaire dans lequel le robot fonctionne, par exemple Europe/Zurich.

Configuration du certificat

Les champs du certificat seront affichés automatiquement après la découverte de l’appareil. Si des mises à jour sont nécessaires, les certificats peuvent être modifiés et téléchargés.

1. Certificat racine CA – Utilisé pour vérifier le certificat du courtier MQTT.
2. Certificat – Utilisé pour l’authentification du client lors de la connexion MQTT.
3. Certificat de clé privée – Utilisé conjointement avec le Certificat pour établir une connexion MQTT sécurisée.

Ces fichiers de certificat sont nécessaires une fois par organisation. Si vous avez déjà importé ces certificats pour un autre appareil Robot dans la même organisation, ils seront réutilisés — vous n’avez pas besoin de les importer à nouveau.

Le dialogue contient également trois sections supplémentaires : Configuration Appareil (Configuration Site Pulse) ; Paramètres avancés (Event Polling, Configurer Masque Heatmap, Bilan de santé périodique, et Temps rétention de l’événement, qui est de 30 jours par défaut) ; et Emplacement (Latitude, Longitude, Plus Code et What 3 Words).

Vous pouvez trouver le Robo ID dans le portail Web Ascento. Voir la capture d’écran ci‑dessous.

Une fois saisi, cliquez sur Découvrir. Après une découverte réussie, le dialogue affiche Fermer, Redécouvrir, et Enregistrer.

Étape 7 : Découverte de la liste des Caméras

GCXONE récupère les informations du robot :

• Liste des Caméras
• Ports de contrôle (tels que feux de détresse, projecteurs, etc.)

Chaque robot Ascento est découvert avec les mêmes cinq caméras fixes : avant, arrière, gauche, droite et une caméra thermique (répertoriée comme thermal‑Thermal). Elles apparaissent dans le panneau Caméras connectées (5/5 activées) du dialogue de l’appareil, et sur l’Aperçu de l’appareil en tant que Capteurs actifs 5/5.

Cliquez sur Enregistrer pour terminer l’ajout de l’appareil. L’Aperçu de l’appareil s’ouvre.

Pour vérifier que la vidéo fonctionne, ouvrez n’importe quelle caméra de la liste des appareils. Le Direct doit se lire sans interruption.

Vous pouvez également visionner plusieurs caméras simultanément. Dans la Visionneuse vidéo, faites glisser l’appareil dans la zone de lecture et toutes ses caméras commenceront à diffuser ensemble.

Configuration des Événements et des Règles

Le robot envoie deux types d’alarmes.

\1. Alarmes d’état

Alarmes d’état vous informent sur l’état du robot lui‑même, et GCXONE les traite comme des alarmes techniques. Vous les voyez :

• Sur le tableau de bord de l’appareil
• Dans Talos, l’application de gestion des alarmes

Le robot rapporte les valeurs suivantes, et les règles d’alarme que vous configurez les transforment en alarmes techniques :

Batterie

• État de charge (SoC)
• Statut de charge

Pose

• Cap
• Latitude
• Longitude

\2. Détection d'alarmes

Détection d'alarmes sont ce que le robot détecte autour de lui, comme une personne ou un véhicule. GCXONE les gère comme des événements de mouvement, et vous les voyez :

• Dans Recherche d'activité vidéo (VAS), où vous pouvez rechercher des événements passés
• Dans Talos, l'application de gestion des alarmes

Chaque événement de détection s'ouvre dans la vue d'événement standard, qui affiche :

• Quatre panneaux — Pré-alarme, Alarme, Post alarme et un aperçu en direct.
• Boîtes englobantes mettant en évidence l'objet détecté.
• Un badge de classification tel que Alarme réelle.
• Appuyer sur A et D pour naviguer entre les événements.

Le Champs des événements d'AppareilLe tableau sur la page de l’appareil répertorie chaque événement reçu, avec les colonnes Time, Event Type, Genesis Analysis, Zone, Camera Name, Index, Alarm/Restore, Device Type, Camera Type, Images Duration, Analytics Duration, Overall Duration et Images in Event. Les événements apparaissent avec leurs codes bruts — des événements de mouvement tels que analytics.people.* et vehicle.alert, et des événements techniques tels que robot.battery.soc.warning. La colonne Genesis Analysis classe chaque événement comme REAL, REDUNDANT ou TECH, et la colonne Alarm/Restore indique si l’événement a déclenché ou restauré la condition.

Configuration des règles d'alarme personnalisées

Les alarmes d’état ne sont pas déclenchées automatiquement. Vous décidez quand le robot doit vous alerter — par exemple, en dessous de quel niveau de batterie, ou à quelle distance il peut parcourir depuis sa zone de sécurité — en définissant des Règles d'alarme personnalisées sur l’appareil :

Dialogue de modification de l’appareil → Propriétés → Règles d'alarme personnalisées

GCXONE vérifie les valeurs rapportées par le robot par rapport à ces règles et déclenche une alarme technique chaque fois qu’une condition est remplie.

Cliquez View/Edit JSON, coller les règles d’alarme Ascento, enregistrer le dialogue, puis enregistrer l’appareil.

{
  "Ascento": {
    "battery": {
      "stateOfCharge": {
        "active": false,
        "low": 20,
        "eventCode": "robot.battery.soc.warning",
        "groupCode": "robot.battery.soc.alert"
      },
      "charging": {
        "active": false,
        "expectedCharging": false,
        "eventCode": "robot.battery.charging.statechange",
        "groupCode": "robot.battery.charging.alert"
      }
    },
    "location": {
      "geoFence": {
        "active": false,
        "radiusMeters": 500,
        "eventCode": "robot.geofence.breach",
        "groupCode": "robot.location.geofence.alert"
      }
    },
    "spotLightsEnabled": {
      "active": false,
      "alertOn": true,
      "eventCode": "robot.spotlight.statechange",
      "groupCode": "robot.spotlight.alert"
    },
    "hazardLightsEnabled": {
      "active": false,
      "alertOn": true,
      "eventCode": "robot.hazardlight.statechange",
      "groupCode": "robot.hazardlight.alert"
    },
    "communication": {
      "offline": {
        "active": false,
        "timeoutSeconds": 30,
        "eventCode": "robot.communication.lost",
        "groupCode": "robot.communication.alert"
      }
    }
  }
}

Aperçu du traitement des alarmes

Lorsqu’une alarme provient du robot, trois applications GCXONE travaillent ensemble afin que l’opérateur voie l’ensemble des informations en même temps : les détails de l’alarme, la vidéo et la localisation sur la carte.

\1. Talos — gestion de l’alarme

Talos est la console principale des alarmes de l’opérateur.

• Chaque alarme est répertoriée avec son appareil, son emplacement, son client, l’heure, le type de déclencheur et la gravité.
• Ouvrir une alarme pour l’enquêter, l’accuser réception, ajouter des notes, l’assigner ou l’escalader.

L’alarme est gérée à partir d’ici depuis son arrivée jusqu’à sa clôture.

\2. Visionneuse vidéo — vérification de ce qui s’est passé

Dès que vous ouvrez une alarme dans Talos, la Visionneuse vidéo bascule sur cette alarme et affiche :

• Image de pré-alarme
• Image d’alarme actuelle
• Image post‑alarme.

Vous disposez également de l’ensemble complet d’outils vidéo :

• Vidéo En direct
• Contrôle de l’Appareil
• Mises en page multi‑caméras

Cela vous permet de confirmer immédiatement ce qui s’est passé.

\3. Carte — voir où cela s’est produit et réagir

La Carte affiche chaque appareil sur une carte interactive de l’emplacement. Lorsque vous sélectionnez une alarme dans Talos, la carte se centre sur son origine.

Depuis la Carte, vous pouvez agir directement sur le robot et allumer ou éteindre ses feux :

• Projecteurs
• Feux de détresse

Vous pouvez ainsi répondre depuis le même écran que vous consultez déjà.

Flux de travail opérateur multi‑moniteur

Les salles de contrôle utilisent généralement trois moniteurs ou plus, et GCXONE est conçu pour cela :

• Moniteur 1 — Talos

• Moniteur 2 — Visionneuse vidéo

• Moniteur 3 — Carte

Lorsque vous ouvrez une alarme sur le premier moniteur, les deux autres le suivent automatiquement :

• La Visionneuse vidéo bascule sur les caméras de cette alarme.
• La Carte met en évidence l’emplacement et l’appareil d’où provient l’alarme.

Vous obtenez l’alarme, la vidéo et l’emplacement côte à côte sans rien ouvrir vous‑même, ce qui vous permet de décider et de réagir plus rapidement.

Aperçu des Fonctionnalités d’intégration

GCXONE se connecte au cloud Ascento en utilisant ses REST APIs pour les données et le contrôle du robot, RTSP pour la vidéo en direct, et un abonnement pour les alarmes et les événements. Tout ce que le robot envoie est ensuite géré dans GCXONE aux côtés de vos autres appareils.