Ascento Robot Integratiehandleiding

Inleiding

De Ascento robot is een autonoom beveiligingsrobot die vijf camera's draagt. Deze handleiding legt uit hoe hij wordt verbonden met GCXONE en wat u kunt zien en doen zodra hij operationeel is.

Zodra de robot is verbonden, biedt GCXONE u:

• Live‑video van de vijf camera's van de robot — voor, achter, links, rechts en een thermische camera.
• Detectie‑alarmen die worden gegenereerd tijdens het patrouilleren van de robot, zoals personen en voertuigen. Elk alarm wordt geleverd met beelden en een vakje getekend rond het gedetecteerde object.
• Technische meldingen over de robot zelf — lage batterij, oplaadstatus, verlaten van zijn veilige zone, wijzigingen van de spotlight en waarschuwingslamp, en verlies van communicatie.
• Lichtbesturing — schakel de spotlight en waarschuwingslamp van de robot in of uit.

Systeemoverzicht

GCXONE maakt verbinding met de Ascento‑cloud om te ontvangen:

• Live‑videostreaming
• Alarmen en gebeurtenissen
• Wijzigingen in de robot‑status

Systeemarchitectuur

Communicatiestromen

Configuratie‑overzicht

Pre‑integratie‑vereisten

Ascento Robot Configuratie

Stap 1: Log in op het GCXONE‑platform

• Open de GCXONE‑URL in een browser.
• Log in met uw beheerder‑ of integratorreferenties.
• Nadat u bent ingelogd, laadt GCXONE de omgeving voor uw tenant.

Stap 2: Selecteer uw organisatie

Als uw tenant meer dan één organisatie heeft, vraagt GCXONE welke u wilt beheren.

• Meer dan één organisatie — kies de gewenste organisatie op het selectiescherm.
• Slechts één organisatie — GCXONE opent deze en gaat direct naar het dashboard.

Stap 3: Navigeer naar de Configuratie‑app

• Zoek in het linkerpaneel Apps naar de Configuratie‑pictogram.
• Klik op Configuratie om de configuratiewerkruimte te openen.
• Het configuratiescherm wordt geopend. Hier beheert u Klanten, Plaatsen en Apparaten.

Stap 4: Begrijpen van de configuratiehiërarchie

GCXONE organiseert alles in een vaste volgorde: Klant → Plaats → Apparaat → Camera's/Sensoren.

Hoe deze hiërarchie werkt

• Klant — de onderneming of opdrachtgever bovenaan. Een Klant heeft één of meer Plaatsen.
• Plaats — een locatie, zoals een kantoor, magazijn of winkel. Elk Apparaat op die locatie behoort tot die Plaats.
• Apparaat — de hardware zelf, bijvoorbeeld een Ascento‑robot. De Camera's en Sensoren hangen eronder.

Door deze volgorde te handhaven, worden Alarmen naar de juiste plaats gerouteerd, blijven de gegevens van elke Klant gescheiden, en werkt rapportage per Plaats.

Stap 5: Selecteer of maak een Klant/Plaats

In de Configuratie‑app:

• Kies een bestaande Klant en Plaats uit de lijst, of klik op Nieuw toevoegen om ze te maken.

Stap 6: Voeg apparaten toe aan de site

Met de geselecteerde site:

• Open de Apparaten tab onder de site.
• Klik op Nieuw toevoegen.
• Kies het type apparaat dat u wilt toevoegen:
• Ascento
• De configuratiewizard voor het apparaat wordt geopend.

Voeg de volgende configuratiedetails toe voor de Ascento‑integratie:

1. Robo ID – Unieke identifier van de Ascento‑robot.
2. Gebruikersnaam – Ascento Cloud‑gebruikersnaam gebruikt voor authenticatie bij de Ascento REST API. Eén set cloud‑referenties geldt voor alle apparaten in dezelfde organisatie.
3. Wachtwoord – Ascento Cloud‑wachtwoord gebruikt voor authenticatie bij de Ascento REST API.
4. Alarm URL – Automatisch vooraf ingevuld om alarm‑ en gebeurtenismeldingen te ontvangen (geen invoer vereist).
5. Organization ID – Alleen-lezen. Automatisch ingevuld en gebruikt om gedetailleerde gebeurtenisinformatie op te halen.
6. Organization Name – Alleen-lezen. Automatisch ingevuld en gebruikt om de MQTT‑verbinding en gebeurtenis‑stroom tot stand te brengen.
7. SafeZone In Meters – Optioneel. Perimeterafstand van de veilige zone rond de robot.
8. Tijdzone – Vereist. De tijdzone waarin de robot opereert, bijvoorbeeld Europe/Zurich.

Certificaatconfiguratie

De certificaatvelden worden automatisch weergegeven na de apparaat‑ontdekking. Indien updates nodig zijn, kunnen de certificaten worden bewerkt en geüpload.

1. CA Root Certificate – Gebruikt om het certificaat van de MQTT‑broker te verifiëren.
2. Certificate – Gebruikt voor client‑authenticatie tijdens de MQTT‑verbinding.
3. Private Key Certificate – Wordt samen met het certificaat gebruikt om een beveiligde MQTT‑verbinding tot stand te brengen.

Deze certificaatbestanden zijn één keer per organisatie nodig. Als u deze certificaten al heeft geïmporteerd voor een ander Robot‑apparaat in dezelfde organisatie, worden ze hergebruikt — u hoeft ze niet opnieuw te importeren.

Het dialoogvenster bevat ook drie extra secties: Apparaat Configuratie (Site puls configuratie); Geavanceerde instellingen (Event polling, Heatmap masker configureren, Periodieke Status controle, en Event retentie tijd, standaard 30 dagen); en Locatie (Latitude, Longitude, Plus Code en What 3 Words).

U kunt de Robo ID vinden in het Ascento Web Portal. Zie de onderstaande screenshot.

Nadat u dit heeft ingevoerd, klikt u op Ontdekken. Na een succesvolle ontdekking toont het dialoogvenster Sluiten, Opnieuw ontdekken, en Opslaan.

Stap 7: Camera‑lijst ontdekken

GCXONE haalt het volgende van de robot op:

• Camera‑lijst
• Control ports (zoals waarschuwingslichten, spotlights, enz.)

Elke Ascento‑robot wordt ontdekt met dezelfde vijf vaste camera's: voor, achter, links, rechts en een thermische camera (genoteerd als thermal -Thermal). Ze verschijnen in het paneel Connected Cameras (5/5 ingeschakeld) van het apparaat‑dialoogvenster, en in het Apparaat Overzicht als Actieve sensoren 5/5.

Klik op Opslaan om het toevoegen van het apparaat te voltooien. Het Apparaat Overzicht wordt geopend.

Om te controleren of video werkt, opent u een willekeurige camera uit de apparaatlijst. De Livestream moet zonder onderbreking afspelen.

U kunt ook meerdere camera's tegelijk bekijken. In de Video sleept u het apparaat naar het afspeelgebied en starten al zijn camera's simultaan met streamen.

Events en Regels Configuratie

De robot stuurt twee soorten alarm.

\1. Status Alarms

Status alarms geven u informatie over de toestand van de robot zelf, en GCXONE verwerkt ze als technisch alarm. U ziet ze:

• Op het apparaat‑dashboard
• In Talos, de alarm‑verwerkingsapplicatie

De robot rapporteert de volgende waarden, en de alarmregels die u configureert zetten deze om in technisch alarm:

Batterij

• Ladingstoestand (SoC)
• Oplaadstatus

Pose

• Richting
• Breedtegraad
• Lengtegraad

\2. Alarmen vinden

Alarmen vinden zijn wat de robot om zich heen detecteert, zoals een Persoon of een Voertuig. GCXONE verwerkt ze als bewegingsevenementen, en u ziet ze:

• In Video Activity Search (VAS), waar u eerdere gebeurtenissen kunt doorzoeken
• In Talos, de alarmverwerkingsapplicatie

Elk Finding‑event wordt geopend in de standaard gebeurtenisweergave, die toont:

• Vier panelen — Pre-alarm, Alarm, Post-alarm en een live Voorbeeld.
• Omhullende vakken die het gedetecteerde object markeren.
• Een classificatie‑badge zoals REAL ALARM.
• Druk op A en D om tussen gebeurtenissen te navigeren.

De Apparaat‑gebeurtenisveldenDe tabel op de apparaatpagina vermeldt elk ontvangen evenement, met de kolommen Time, Event Type, Genesis Analysis, Zone, Camera Name, Index, Alarm/Restore, Device Type, Camera Type, Images Duration, Analytics Duration, Overall Duration en Images in Event. Gebeurtenissen verschijnen met hun ruwe codes — bewegingsevenementen zoals analytics.people.* en vehicle.alert, en technische gebeurtenissen zoals robot.battery.soc.warning. De kolom Genesis Analysis classificeert elk evenement als REAL, REDUNDANT of TECH, en de kolom Alarm/Restore toont of het evenement het alarm heeft geactiveerd of hersteld.

Aangepaste alarmregelconfiguratie

Statusalarmen worden niet automatisch geactiveerd. U bepaalt wanneer de robot u moet waarschuwen — bijvoorbeeld onder welke batterijlading, of hoe ver hij mag afwijken van zijn veilige zone — door Aangepaste alarmregels op het apparaat in te stellen:

Apparaat‑bewerkingsdialoog → Eigenschappen → Aangepaste alarmregels

GCXONE controleert de waarden die de robot rapporteert tegen deze regels en activeert een technisch alarm zodra er aan één wordt voldaan.

Klik View/Edit JSON, plak de Ascento alarmregels, sla het dialoogvenster op, en sla vervolgens het apparaat op.

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

Overzicht van alarmverwerking

Wanneer een alarm van de robot binnenkomt, werken drie GCXONE‑applicaties samen zodat de operator in één oogopslag het volledige beeld ziet: de alarmdetails, de video en de locatie op de plattegrond.

\1. Talos — afhandelen van het alarm

Talos is de belangrijkste alarmconsole voor de operator.

• Elk alarm wordt weergegeven met zijn apparaat, site, klant, tijd, trigger‑type en ernst.
• Open een alarm om het te onderzoeken, te bevestigen, notities toe te voegen, toe te wijzen of te escaleren.

Het alarm wordt vanaf hier beheerd vanaf het moment dat het binnenkomt tot het wordt gesloten.

\2. Video — controle van wat er gebeurde

Zodra u een alarm opent in Talos, schakelt de Video over naar dat alarm en toont:

• Pre-alarm afbeelding
• Huidige alarmafbeelding
• Post-alarm afbeelding.

U heeft ook de volledige set video‑hulpmiddelen:

• Live Video
• Apparaatbesturing
• Multi‑camera lay-outs

Dit stelt u in staat om direct te bevestigen wat er gebeurde.

\3. Plattegrond — zien waar het gebeurde, en reageren

De Plattegrond toont elk apparaat op een interactieve site‑plattegrond. Wanneer u een alarm selecteert in Talos, centreert de plattegrond op de herkomst.

Vanuit de plattegrond kunt u direct op de robot handelen en de lichten in- of uitschakelen:

• Spotlights
• Waarschuwingslichten

Zo kunt u reageren vanaf hetzelfde scherm dat u al bekijkt.

Multi‑monitor operatorworkflow

Controlekamers gebruiken doorgaans drie of meer monitoren, en GCXONE is daarvoor gebouwd:

• Monitor 1 — Talos

• Monitor 2 — Video Viewer

• Monitor 3 — Kaart

Wanneer u een alarm opent op de eerste monitor, volgen de andere twee dit automatisch:

• De Video Viewer schakelt over naar de camera's van dat alarm.
• De Plattegrond markeert de site en het apparaat waar het alarm vandaan kwam.

U krijgt het alarm, de video en de locatie naast elkaar zonder zelf iets te openen, zodat u sneller kunt beslissen en reageren.

Integratie Functies Overzicht

GCXONE maakt verbinding met de Ascento‑cloud via zijn REST‑API's voor robotdata en -besturing, RTSP voor live video, en een abonnement voor alarmen en gebeurtenissen. Alles wat de robot verzendt, wordt vervolgens in GCXONE beheerd naast uw andere apparaten.