Ascento Robot Integrationshandbuch

Einleitung

Der Ascento‑Roboter ist ein autonomer Sicherheitsroboter, der fünf Kameras trägt. Dieses Handbuch erklärt, wie er an GCXONE angebunden wird und was Sie sehen und tun können, sobald er läuft.

Sobald der Roboter verbunden ist, stellt Ihnen GCXONE Folgendes bereit:

• Live‑Video von den fünf Kameras des Roboters – vorne, hinten, links, rechts und einer Wärmebildkamera.
• Erkennungs‑Alarme die während der Patrouille des Roboters ausgelöst werden, z. B. Personen‑ und Fahrzeug‑Alarme. Jeder Alarm wird mit Bildern und einer um das Erfasste gezeichneten Box geliefert.
• Technische Warnungen zum Roboter selbst – niedriger Batteriestand, Ladezustand, Verlassen der Sicherheitszone, Änderungen der Spotlight‑ und Gefahrlicht‑Anzeige sowie Kommunikationsverlust.
• Lichtsteuerung – Spotlight und Gefahrlicht des Roboters ein- oder ausschalten.

System‑Überblick

GCXONE verbindet sich mit der Ascento‑Cloud, um Folgendes zu erhalten:

• Live‑Video‑Streaming
• Alarme und Ereignisse
• Änderungen des Roboter‑Status

Systemarchitektur

Kommunikationsflüsse

Konfigurations‑Überblick

Vor‑Integrationsanforderungen

Ascento Robot-Konfiguration

Schritt 1: Einloggen in die GCXONE-Plattform

• Öffnen Sie die GCXONE-URL in einem Browser.
• Melden Sie sich mit Ihren Administrator- oder Integrator-Anmeldedaten an.
• Nachdem Sie sich angemeldet haben, lädt GCXONE die Umgebung für Ihren Mandanten.

Schritt 2: Wählen Sie Ihre Organisation

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

• Mehr als eine Organisation — wählen Sie die gewünschte aus dem Auswahlbildschirm.
• Nur eine Organisation — GCXONE öffnet sie für Sie und springt direkt zum Dashboard.

Schritt 3: Navigieren Sie zur Konfiguration‑App

• Im linken Apps‑Panel finden Sie das Konfiguration Symbol.
• Klicken Sie auf Konfiguration um den Konfigurationsarbeitsbereich zu öffnen.
• Der Konfigurationsbildschirm öffnet sich. Hier verwalten Sie Kunden, Standorte und Geräte.

Schritt 4: Verständnis der Konfigurationshierarchie

GCXONE 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 einen oder mehrere Standorte.
• Standort — ein Ort, z. B. ein Büro, Lagerhaus oder Einzelhandelsgeschäft. Jedes Gerät an diesem Ort gehört zu diesem Standort.
• Gerät — die Hardware selbst, z. B. ein Ascento‑Roboter. Seine Kameras und Sensoren sind darunter angeordnet.

Die Einhaltung dieser Reihenfolge sorgt dafür, dass Alarme an die richtige Stelle geleitet werden, die Daten jedes Kunden getrennt bleiben und Berichte standortweise funktionieren.

Schritt 5: Einen Kunden/Standort auswählen oder erstellen

In der Konfiguration‑App:

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

Schritt 6: Geräte zum Site hinzufügen

Mit dem ausgewählten Site:

• Öffnen Sie das Geräte Registerkarte unter dem Site.
• Klicken Sie auf Neu hinzufügen.
• Wählen Sie den Gerätetyp, den Sie hinzufügen möchten:
• Ascento
• Der Geräte-Konfigurationsassistent öffnet sich.

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

1. Robo ID – Eindeutiger Bezeichner des Ascento‑Roboters.
2. Nutzername – Ascento‑Cloud‑Nutzername zur Authentifizierung bei der Ascento‑REST‑API. Ein Satz Cloud‑Anmeldedaten gilt für alle Geräte in derselben Organisation.
3. Passwort – Ascento‑Cloud‑Passwort zur Authentifizierung bei der Ascento‑REST‑API.
4. Alarm URL – Wird automatisch vorausgefüllt, um Alarm‑ und Ereignisbenachrichtigungen zu erhalten (keine Eingabe erforderlich).
5. Organization ID – Nur lesbar. Wird automatisch gefüllt und dient zum Abrufen detaillierter Ereignisinformationen.
6. Organization Name – Nur lesbar. Wird automatisch gefüllt und dient zum Aufbau der MQTT‑Verbindung und des Ereignisflusses.
7. SafeZone in Metern – Optional. Abstand des Sicherheitszonen‑Umfangs um den Roboter.
8. Zeitzone – Erforderlich. Die Zeitzone, in der der Roboter arbeitet, z. B. Europe/Zurich.

Zertifikatskonfiguration

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

1. CA‑Root‑Zertifikat – Wird verwendet, um das Zertifikat des MQTT‑Brokers zu prüfen.
2. Zertifikat – Wird für die Client‑Authentifizierung während der MQTT‑Verbindung verwendet.
3. Privater Schlüssel‑Zertifikat – Wird zusammen mit dem Zertifikat verwendet, um eine sichere MQTT‑Verbindung aufzubauen.

Diese Zertifikatsdateien werden einmal pro Organisation benötigt. Wenn Sie diese Zertifikate bereits für ein anderes Robot‑Gerät in derselben Organisation importiert haben, werden sie wiederverwendet – ein erneuter Import ist nicht nötig.

Der Dialog enthält außerdem drei weitere Abschnitte: Geräte‑Konfiguration (Site Pulse Konfiguration); Erweiterte Einstellungen (Ereignisabfrage, Heatmap‑Maske konfigurieren, Periodische Statusabfrage und Ereignis Haltezeit, standardmäßig 30 Tage); und Standort (Breitengrad, Längengrad, Plus‑Code und What 3 Words).

Sie finden die Robo‑ID im Ascento Web‑Portal. Siehe den untenstehenden Screenshot.

Nach Eingabe klicken Sie Suche. Nach erfolgreicher Suche zeigt der Dialog Schließen, Erneut suchen, und Speichern.

Schritt 7: Kamera‑Liste entdecken

GCXONE ruft die Daten des Roboters ab:

• Kamera‑Liste
• Kontrol‑Ports (wie Gefahrenlichter, Spotlights usw.)

Jeder Ascento‑Roboter wird mit denselben fünf festen Kameras entdeckt: vorne, hinten, links, rechts und einer Thermalkamera (aufgeführt als thermal‑Thermal). Sie erscheinen im Feld Verbundene Kameras (5/5 aktiviert) des Gerätedialogs und im Geräte‑Überblick als Aktive Sensoren 5/5.

Klicken Sie Speichern, um das Gerät hinzuzufügen. Der Geräte‑Überblick öffnet sich.

Um zu prüfen, ob das Video funktioniert, öffnen Sie eine beliebige Kamera aus der Geräteliste. Die Live‑Übertragung sollte ohne Unterbrechung laufen.

Sie können auch mehrere Kameras gleichzeitig ansehen. Ziehen Sie im Video‑Viewer das Gerät in den Wiedergabebereich, und alle seine Kameras starten gleichzeitig zu streamen.

Ereignisse und Regeln Konfiguration

Der Roboter sendet zwei Arten von Alarm.

\1. Status‑Alarme

Status‑Alarmeinformieren über den Zustand des Roboters selbst, und GCXONE behandelt sie als technische Alarme. Sie sehen sie:

• Im Gerät‑Dashboard
• In Talos, der Alarm‑Handling‑Anwendung

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

Batterie

• Ladezustand (SoC)
• Ladestatus

Pose

• Richtung
• Breitengrad
• Längengrad

\2. Alarme finden

Alarme findenDetektionen sind das, was der Roboter in seiner Umgebung erkennt, z. B. eine Person oder ein Fahrzeug. GCXONE behandelt sie als Bewegungsereignisse, und Sie sehen sie:

• In der Video‑Aktivitätssuche (VAS), wo Sie vergangene Ereignisse durchsuchen können
• In Talos, der Alarm‑Verarbeitungsanwendung

Jedes Finding‑Ereignis öffnet sich in der Standard‑Ereignisanzeige, die Folgendes anzeigt:

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

Der Geräte‑Ereignis‑FelderDie Tabelle auf der Geräteseite listet jedes empfangene Ereignis auf, mit den Spalten Zeit, ERREIGNISTYP, Genesis‑Analyse, Zone, Kameraname, Index, Alarm/Wiederherstellung, Gerätetyp, Kameratyp, Bilddauer, Analytikdauer, Gesamtdauer und Bilder im Ereignis. Ereignisse erscheinen mit ihren Rohcodes – Bewegungsereignisse wie analytics.people.* und vehicle.alert sowie technische Ereignisse wie robot.battery.soc.warning. Die Spalte Genesis‑Analyse klassifiziert jedes Ereignis als ECHTER, REDUNDANT oder TECHNISCH, und die Spalte Alarm/Wiederherstellung zeigt, ob das Ereignis den Zustand ausgelöst oder wiederhergestellt hat.

Benutzerdefinierte Alarmregel‑Konfiguration

Statusalarme werden nicht von selbst ausgelöst. Sie entscheiden, wann der Roboter Sie warnen soll – zum Beispiel bei welchem Batteriestand oder wie weit er von seiner Sicherheitszone entfernt reisen darf – indem Sie benutzerdefinierte Alarmregeln am Gerät festlegen:

Geräte‑Bearbeitungsdialog → Einstellungen → Benutzerdefinierte Alarmregeln

GCXONE prüft die vom Roboter gemeldeten Werte gegen diese Regeln und löst einen technischen Alarm aus, sobald eine Regel erfüllt ist.

Klicken Sie JSON anzeigen/bearbeiten, fügen Sie die Ascento‑Alarmregeln ein, speichern Sie den Dialog und anschließend 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 Alarmverarbeitung

Wenn ein Alarm vom Roboter eintrifft, arbeiten drei GCXONE‑Anwendungen zusammen, sodass der Bediener das Gesamtbild sofort sieht: die Alarmdetails, das Video und den Standort auf der Karte.

\1. Talos – Verarbeitung des Alarms

Talos ist die Haupt‑Alarmkonsole des Bedieners.

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

Der Alarm wird hier vom Eintreffen bis zum Schließen verwaltet.

\2. Video‑Viewer – Überprüfung des Geschehens

Sobald Sie einen Alarm in Talos öffnen, schaltet der Video‑Viewer zu diesem Alarm um und zeigt:

• Voralarm‑Bild
• Aktueller‑Alarm‑Bild
• Nach-Alarm-Bild.

Sie haben außerdem das komplette Set an Videowerkzeugen:

• Live-Video
• Gerätesteuerung
• Mehrkamera‑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 Standortkarte. Wenn Sie einen Alarm in Talos auswählen, zentriert die Karte den Ort, von dem er stammt.

Über die Karte können Sie direkt am Roboter agieren und dessen Lichter ein- oder ausschalten:

• Spotlights
• Gefahrenlichter

So können Sie vom selben Bildschirm aus reagieren, den Sie bereits betrachten.

Mehrmonitor‑Operator‑Workflow

Leitstellen verwenden in der Regel drei oder mehr Monitore, und GCXONE ist dafür ausgelegt:

• Monitor 1 — Talos

• Monitor 2 — Video‑Viewer

• Monitor 3 — Karte

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

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

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

Integrations‑Merkmale‑Überblick

GCXONE verbindet sich mit der Ascento‑Cloud über seine REST APIs für Roboterdaten und -steuerung, RTSP für Live‑Video und eine Subskription für Alarme und Ereignisse. Alles, was der Roboter sendet, wird dann in GCXONE zusammen mit Ihren anderen Geräten verwaltet.