--- title: "Ascento Robot Integratiehandleiding" source: /nl/gcxone/devices/ascento locale: nl updated: 2026-09-29 --- ## **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** | Ascento Apparaattype | Ondersteunde protocollen | Doel | | --- | --- | --- | | Autonome beveiligingsrobot | REST API; WebSocket; RTSP/WebRTC | Robotbeheer; live‑video; telemetrie; commando‑ en controle | | Robotcamera's | RTSP/WebRTC | Live‑videostreaming; opname; op afstand bewaken | | Robottelemetrie | REST API; WebSocket | Batterijstatus; GPS‑locatie; koers; robot‑status; oplaadstatus | | Robotgebeurtenissen & alarmen | WebSocket (of REST‑polling; afhankelijk van de implementatie) | Batterij‑alarmen; geofence‑gebeurtenissen; noodstop; foutmeldingen; missiestatus | | Robotverlichting & signalering | REST API | Spotlights bedienen; waarschuwingslampen; indicatoren | | Robot‑laadstation | REST API | Dock‑status; oplaadstatus; oplaadbesturing | GCXONE maakt verbinding met de Ascento‑cloud om te ontvangen: - Live‑videostreaming - Alarmen en gebeurtenissen - Wijzigingen in de robot‑status ![](/api/media/file/c17b8989fb6487bcfb3582fc430b64a18a33eda4-560x420.png) ## **Systeemarchitectuur** ![](/api/media/file/70b8c8b7243f2f3a426612b6351e170576779b90-1210x597.png) ### Communicatiestromen | Stroom | Protocol | Richting | Notities | | --- | --- | --- | --- | | Livestream | RTSP | Ascento naar NXGEN | Genesis ondersteunt zowel cloud-omgeleid streaming als lokale modus (omzeilt cloud). | | Gebeurtenissen | Actieregels/MQTT Push | Ascento naar NXGEN | Detectie als Bewegingsgebeurtenissen; Status als Technische gebeurtenissen | | Audio‑aankondigingen | SIP / Genesis Audio | NXGEN naar Ascento | live aankondigingen | | I/O‑besturing | REST API | NXGEN naar Ascento | Activeer relais/virtuele ingangen om de verlichting aan/uit te schakelen | | Commando’s en besturingen | Ascento interne API | NXGEN naar Ascento | Queries; Commando’s en besturingen | ## **Configuratie‑overzicht** ### Pre‑integratie‑vereisten | Vereiste | Doel | | --- | --- | | API‑referenties | Vereist om toegang te krijgen tot de Ascento REST‑API’s met de opgegeven gebruikersnaam en wachtwoord, en om alle beschikbare API’s te benaderen. | | Robo‑ID(s) | Vereist om een specifieke robot/apparaat op te halen en noodzakelijke acties uit te voeren, zoals live‑video, relaisbesturing en het ophalen van gebeurtenissen. | | Organisatie‑ID | Vereist om te communiceren met de gebeurtenisdiensten en gedetailleerde gebeurtenisinformatie op te halen. | | Organisatienaam | Vereist om de MQTT‑verbinding tot stand te brengen en de gebeurtenisstroom te configureren. | | CA‑rootcertificaat | Vereist om een beveiligde MQTT‑verbinding tot stand te brengen en het broker‑certificaat te valideren. | | Certificaat | Vereist voor clientauthenticatie bij het tot stand brengen van de MQTT‑verbinding. | | Privésleutelcertificaat | Vereist samen met het Certificaat om de MQTT‑verbinding veilig tot stand te brengen. | ## 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. ![image](/api/media/file/0eb08492464d3636d11ea45778c834d67788557b-576x414.png) ### 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. ![image](/api/media/file/5e024779b10abf8866fa2f0a9b7f298fc600c927-560x607.png) ### 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. ![afbeelding](/api/media/file/7469ef0d61ce9d54c49ba188a44a67fcd2189cdb-680x584.png) ### 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. ![afbeelding](/api/media/file/6027c395e4784f55836992208dc7d4523dcc4efa-1483x891.png) ### 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. ![afbeelding](/api/media/file/1e94f8771e2dcafe6d080b7a365863439e413afa-1704x852.png) ![](/api/media/file/fd6e4aaadd2c977a89438e8792b75e62a67e9f47-1397x811.png) 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. ![afbeelding](/api/media/file/b9ffe07232313f81dc4787e5ac5500ab965bd5a1-560x615.png) 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. ![afbeelding](/api/media/file/b245be0e264e9b1e17dd133fb13b5dec080e521a-1542x900.png) Klik op **Opslaan** om het toevoegen van het apparaat te voltooien. Het Apparaat Overzicht wordt geopend. ![afbeelding](/api/media/file/07b9717cbd410d031003afa195e4662e23b34b6e-1866x390.png) 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. ![afbeelding](/api/media/file/a531c09d0de6e4887130a1cd9ebf6fdb0005a9e7-2532x1254.png) ## **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‑gebeurtenisvelden**De 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. ![image](/api/media/file/44a3417471dad498a234425850ab0c861a573a6a-1707x829.png) Klik **View/Edit JSON**, plak de Ascento alarmregels, sla het dialoogvenster op, en sla vervolgens het apparaat op. ```json { "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" } } } } ``` ![image](/api/media/file/77c59a8561329da59193f29d23c36abfdb6ee3e4-1037x510.png) ![image](/api/media/file/cd41eb2825c9daff0047f76f2393050e1a2f987c-1834x935.png) ## **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 ![afbeelding](/api/media/file/34cda4a60b65c6425c367774e4ad8588af577ec6-2476x1246.png) - Monitor 2 — Video Viewer ![afbeelding](/api/media/file/fe761fec02217025fdaf1ffb1796021e53323814-2545x1304.png) - Monitor 3 — Kaart ![Afbeelding](/api/media/file/f34cbe83f8243611dc90fdb8af967902e3dddf8e-2543x1300.png) 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.