Ascento Robot Integrationshandbuch

Einführung

Der Ascento-Roboter ist ein autonomer Sicherheitsroboter, der fünf Kameras trägt. In dieser Anleitung wird erläutert, wie es mit GCX verbunden wird und was Sie sehen und tun können, wenn es ausgeführt wird.

Sobald der Roboter verbunden ist, erhalten Sie von GCX Folgendes:

• Live-Video von den fünf Kameras des Roboters – vorne, hinten, links, rechts und einer Wärmebildkamera.
• Erkennungsalarme wird angehoben, während der Roboter Personen und Fahrzeuge patrouilliert. Jeder kommt mit Bildern und einem Kästchen um das, was erkannt wurde, an.
• Technische Warnungen über den Roboter selbst – schwacher Akku, Ladezustand, Verlassen der sicheren Zone, Änderungen der Scheinwerfer und Warnblinkanlage sowie Kommunikationsverlust.
• Lichtsteuerung – Scheinwerfer und Warnblinklicht des Roboters ein- oder ausschalten.

Systemübersicht

GCX stellt eine Verbindung zur Ascento-Cloud her, um Folgendes zu empfangen:

• Live-Video-Streaming
• Alarme und Ereignisse
• Änderungen im Status des Roboters

Systemarchitektur

Kommunikationsflüsse

Konfigurationsübersicht

Anforderungen vor der Integration

Ascento-Roboterkonfiguration

Schritt 1: Melden Sie sich bei der GCX-Plattform an

• Öffnen Sie die GCX-URL (Genesis Cloud Experience) in einem Browser.
• Melden Sie sich mit Ihren Administrator- oder Integrator-Anmeldeinformationen an.
• Nachdem Sie sich angemeldet haben, lädt GCX die Umgebung für Ihren Mandanten.

Schritt 2: Wählen Sie Ihre Organisation aus

Wenn Ihr Mandant mehr als eine Organisation hat, fragt GCX Sie, welche Organisation Sie verwalten möchten.

• Mehr als eine Organisation – wählen Sie die gewünschte aus dem Auswahlbildschirm aus.
• Nur eine Organisation – GCX öffnet es für Sie und geht direkt zum Dashboard.

Schritt 3: Navigieren Sie zur Konfigurations-App

• Suchen Sie im linken Apps-Bereich nach Konfiguration -Symbol.
• Klicken Konfiguration , um den Konfigurationsarbeitsbereich zu öffnen.
• Der Konfigurationsbildschirm wird geöffnet. Hier verwalten Sie Kunden, Standorte und Geräte.

Schritt 4: Verstehen der Konfigurationshierarchie

GCX organisiert alles in einer festen Reihenfolge: Kunde → Standort → Gerät → Kameras/Sensoren.

Wie diese Hierarchie funktioniert

• Kunde – das Unternehmen oder der Kunde an der Spitze. Ein Kunde besitzt eine oder mehrere Sites.
• Site – ein Standort, z. B. ein Büro, ein Lager oder ein Einzelhandelsgeschäft. Jedes Gerät an diesem Standort gehört zu seinem Standort.
• Gerät – die Hardware selbst, wie zum Beispiel ein Ascento-Roboter. Darunter sitzen seine Kameras und Sensoren.

Die Beibehaltung dieser Reihenfolge bedeutet, dass Alarme an die richtige Stelle weitergeleitet werden, die Daten jedes Kunden getrennt bleiben und die Berichterstellung Standort für Standort erfolgt.

Schritt 5: Wählen oder erstellen Sie einen Kunden/Standort

In der Konfigurations-App:

• Wählen Sie einen bestehenden Kunden und eine Site aus der Liste aus oder klicken Sie auf Neu hinzufügen , um sie zu erstellen.

Schritt 6: Geräte zur Site hinzufügen

Bei ausgewählter Site:

• Öffnen Sie die Geräte Registerkarte unter der Website.
• Klicken Neu hinzufügen.
• Wählen Sie den Gerätetyp aus, den Sie hinzufügen möchten:
• Aufstieg
• Der Gerätekonfigurationsassistent wird geöffnet.

Fügen Sie die folgenden Konfigurationsdetails für die Ascento-Integration hinzu:

1. Robo-ID – Eindeutige Kennung des Ascento-Roboters.
2. Benutzername – Ascento Cloud-Benutzername, der zur Authentifizierung mit der Ascento REST API verwendet wird. Ein Satz Cloud-Anmeldeinformationen gilt für alle Geräte in derselben Organisation.
3. Passwort – Ascento Cloud-Passwort, das zur Authentifizierung mit der Ascento REST API verwendet wird.
4. Alarm-URL – Wird automatisch vorab ausgefüllt, um Alarm- und Ereignisbenachrichtigungen zu erhalten (keine Eingabe erforderlich).
5. Organisations-ID – Schreibgeschützt. Wird automatisch ausgefüllt und zum Abrufen detaillierter Ereignisinformationen verwendet.
6. Organisationsname – Schreibgeschützt. Wird automatisch ausgefüllt und zum Herstellen der MQTT-Verbindung und des Ereignisflusses verwendet.
7. SafeZone in Metern – Optional. Umfangsabstand der Sicherheitszone um den Roboter herum.
8. Zeitzone – Erforderlich. Die Zeitzone, in der der Roboter arbeitet, zum Beispiel Europa/Zürich.

Zertifikatkonfiguration

Die Zertifikatsfelder werden nach der Geräteerkennung automatisch angezeigt. Sollten Aktualisierungen erforderlich sein, können die Zertifikate bearbeitet und hochgeladen werden.

1. CA-Stammzertifikat – Wird zur Überprüfung des MQTT-Broker-Zertifikats verwendet.
2. Zertifikat – Wird für die Client-Authentifizierung während der MQTT-Verbindung verwendet.
3. Privates Schlüsselzertifikat – Wird zusammen mit dem Zertifikat verwendet, um eine sichere MQTT-Verbindung herzustellen.

Diese Zertifikatsdateien werden einmal pro Organisation benötigt. Wenn Sie diese Zertifikate bereits für ein anderes Robotergerät in derselben Organisation importiert haben, werden sie wiederverwendet – Sie müssen sie nicht erneut importieren.

Der Dialog enthält außerdem drei weitere Abschnitte: Gerätekonfiguration (Site Pulse-Konfiguration); Erweiterte Einstellungen (Ereignisabfrage, Heatmap-Maske konfigurieren, regelmäßige Integritätsprüfung und Ereignisaufbewahrungszeit, standardmäßig 30 Tage); und Standort (Breitengrad, Längengrad, Pluscode und welche 3 Wörter).

Die Robo-ID finden Sie im Ascento-Webportal. Siehe den folgenden Screenshot.

Klicken Sie nach der Eingabe auf Entdecken. Nach einer erfolgreichen Erkennung wird der Dialog angezeigt Schließen, Neuentdeckenund Speichern.

Schritt 7: Erkennung der Kameraliste

GCX ruft Folgendes vom Roboter ab:

• Kameraliste
• Steueranschlüsse (z. B. Warnblinkanlage, Scheinwerfer usw.)

Jeder Ascento-Roboter wird mit denselben fünf festen Kameras entdeckt: vorne, hinten, links, rechts und einer Wärmebildkamera (aufgeführt als Wärmebildkamera). Sie werden im Bereich „Verbundene Kameras (5/5 aktiviert)“ des Gerätedialogs und in der Geräteübersicht als „Aktive Sensoren 5/5“ angezeigt.

Klicken Speichern , um das Hinzufügen des Geräts abzuschließen. Die Geräteübersicht öffnet sich.

Um zu überprüfen, ob das Video funktioniert, öffnen Sie eine beliebige Kamera aus der Geräteliste. Der Livestream sollte ohne Unterbrechung abgespielt werden.

Sie können auch mehrere Kameras gleichzeitig ansehen. Ziehen Sie das Gerät im Video Viewer in den Wiedergabebereich und alle seine Kameras beginnen gemeinsam mit dem Streaming.

Konfiguration von Ereignissen und Regeln

Der Roboter sendet zwei Arten von Alarmen.

1. Statusalarme

Statusalarme informiert Sie über den Zustand des Roboters selbst und GCX behandelt sie als technische Alarme. Sie sehen sie:

• Auf dem Geräte-Dashboard
• In Talos die Alarmverarbeitungsanwendung

Der Roboter meldet die folgenden Werte und die von Ihnen konfigurierten Alarmregeln wandeln sie in technische Alarme um:

Batterie

• Ladezustand (SoC)
• Ladestatus

Pose

• Überschrift
• Breitengrad
• Längengrad

2. Alarme finden

Alarme finden sind das, was der Roboter in seiner Umgebung erkennt, beispielsweise eine Person oder ein Fahrzeug. GCX behandelt sie als Bewegungsereignisse und Sie sehen sie:

• In der Videoaktivitätssuche (VAS), wo Sie nach vergangenen Ereignissen suchen können
• In Talos die Alarmverarbeitungsanwendung

Jedes Finding-Ereignis wird in der Standard-Ereignisansicht geöffnet, in der Folgendes angezeigt wird:

• Vier Bereiche – Voralarm, Alarm, Nachalarm und eine Live-Vorschau.
• Begrenzungsrahmen, die das erkannte Objekt hervorheben.
• Ein Klassifizierungszeichen wie REAL ALARM.
• Drücken Sie A und D, um zwischen Ereignissen zu wechseln.

Die Felder für Geräteereignisse Die Tabelle auf der Geräteseite listet jedes empfangene Ereignis mit den Spalten Zeit, Ereignistyp, Entstehungsanalyse, Zone, Kameraname, Index, Alarm/Wiederherstellung, Gerätetyp, Kameratyp, Bilddauer, Analysedauer, Gesamtdauer und Bilder im Ereignis auf. Ereignisse werden mit ihren Rohcodes angezeigt – Bewegungsereignisse wie „analytics.people.*“ und „vehikel.alert“ sowie technische Ereignisse wie „robot.battery.soc.warning“. Die Spalte „Genesis-Analyse“ klassifiziert jedes Ereignis als REAL, REDUNDANT oder TECH, und in der Spalte „Alarm/Wiederherstellen“ wird angezeigt, ob das Ereignis den Zustand ausgelöst oder wiederhergestellt hat.

Benutzerdefinierte Alarmregelkonfiguration

Statusalarme werden nicht eigenständig ausgelöst. Sie entscheiden, wann der Roboter Sie warnen soll – zum Beispiel bei Unterschreitung des Batteriestands oder wie weit er sich von seiner sicheren Zone entfernen darf –, indem Sie auf dem Gerät benutzerdefinierte Alarmregeln festlegen:

Dialogfeld „Gerätebearbeitung“ → Eigenschaften → Benutzerdefinierte Alarmregeln

GCX prüft die Werte, die der Roboter meldet, anhand dieser Regeln und löst einen technischen Alarm aus, sobald einer dieser Regeln erreicht wird.

Klicken JSON anzeigen/bearbeiten, fügen Sie die Ascento-Alarmregeln ein, speichern Sie den Dialog und speichern Sie dann das Gerät.

{
  "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"
      }
    }
  }
}

Übersicht über die Alarmverarbeitung

Wenn ein Alarm vom Roboter eingeht, arbeiten drei GCX-Anwendungen zusammen, sodass der Bediener das gesamte Bild auf einmal sieht: die Alarmdetails, das Video und den Standort auf der Karte.

1. Talos – Umgang mit dem Alarm

Talos ist die Hauptalarmkonsole des Betreibers.

• Jeder Alarm wird mit Gerät, Standort, Kunde, Zeit, Auslösertyp und Schweregrad aufgelistet.
• Öffnen Sie einen Alarm, um ihn zu untersuchen, zu bestätigen, Notizen hinzuzufügen, ihn zuzuweisen oder ihn zu eskalieren.

Der Alarm wird von hier aus vom Moment seines Eintreffens bis zum Schließen verwaltet.

2. Video Viewer – Überprüfen, was passiert ist

Sobald Sie einen Alarm in Talos öffnen, wechselt der Video Viewer zu diesem Alarm und zeigt Folgendes an:

• Voralarmbild
• Aktuelles Alarmbild
• Bild nach dem Alarm.

Sie verfügen außerdem über den vollständigen Satz an Video-Tools:

• Live-Video
• Gerätesteuerung
• Multi-Kamera-Layouts

Damit können Sie sofort bestätigen, was passiert ist.

3. Karte – sehen, wo es passiert ist, und reagieren

Die Karte zeigt jedes Gerät auf einer interaktiven Sitemap. Wenn Sie in Talos einen Alarm auswählen, wird auf der Karte der Ort angezeigt, von dem er stammt.

Von der Karte aus können Sie direkt auf den Roboter einwirken und seine Lichter ein- oder ausschalten:

• Scheinwerfer
• Warnblinkanlage

So können Sie von demselben Bildschirm aus antworten, den Sie bereits sehen.

Multi-Monitor-Operator-Workflow

Kontrollräume verfügen normalerweise über drei oder mehr Monitore, und GCX ist dafür konzipiert:

• Monitor 1 – Talos

• Monitor 2 – Videobetrachter

• Monitor 3 – Karte

Wenn Sie einen Alarm auf dem ersten Monitor öffnen, folgen ihm automatisch die anderen beiden:

• Der Video Viewer wechselt zu den Kameras dieses Alarms.
• Die Karte hebt den Standort und das Gerät hervor, von dem der Alarm kam.

Sie erhalten den Alarm, das Video und den Standort nebeneinander, ohne selbst etwas öffnen zu müssen, sodass Sie schneller entscheiden und reagieren können.

Übersicht über die Integrationsfunktionen

GCX stellt über seine REST-APIs für Roboterdaten und -steuerung, RTSP für Live-Videos und ein Abonnement für Alarme und Ereignisse eine Verbindung zur Ascento-Cloud her. Alles, was der Roboter sendet, wird dann zusammen mit Ihren anderen Geräten in GCX verwaltet.