Xovis-configuratie

Moeilijkheidsgraad: expert

Leerdoelen

Na het lezen van dit artikel kun je:

  • Het apparaat configureren
  • Het apparaat configureren voor de locatie ervan in het Workplace-platform

Deze handleiding richt zich op de configuratie van de Xovis-apparaten en de implementatie in de back-end Studio van Workplace, na de installatie van Xovis.

Raadpleeg voor meer informatie over het Xovis-platform de handleiding https://spacewell.atlassian.net/wiki/pages/createpage.action?spaceKey=KB&title=Xovis%E2%84%A2%20Platform%20%28SW%20internal%29&linkCreation=true&fromPageId=291047256.

 

Opmerking

De eerste configuratie van XOVIS WiFi-apparaten (van de WiFi-inloggegevens) moet worden uitgevoerd terwijl een LAN-/ethernetverbinding actief is en verbinding met het doel-WiFi-netwerk mogelijk is.

Dit betekent dat er gedurende de configuratie een LAN-netwerk beschikbaar moet zijn op een locatie waar het doel-WiFi-netwerk ook bereikbaar is.

Xovis-sensor configureren

Stap 1. De Xovis Configuration Tool openen

Xovis Sensor Configuration Tool
  1. Verbind je computer via een ethernetkabel (zorg voor een voeding van 12 V / 1,5 A) met hetzelfde netwerk als het Xovis-apparaat.
  2. Gebruik de Xovis-scantool of download IP Scanner (bijvoorbeeld “Advanced IP Scanner”) naar je computer. Download de Xovis-scantool via deze link Xovis Sensor Explorer: Dubbelklik op het .exe-bestand om de sensoren binnen een specifiek IP-bereik te bekijken. Er wordt een pagina geopend die de IP-adressen scant. De sensoren binnen dat bereik worden daar vermeld.
  3. Scan je omgeving om te zien welke apparaten zich in de buurt bevinden

image-20240227-140432.png

  1. Vergelijk het MAC-adres op de doos van het apparaat met de lijst uit de scantool.
  2. Klik met de rechtermuisknop, kopieer het IP-adres en plak dit in je browser (Chrome of Firefox): met het toegewezen IP-adres (DHCP) heb je toegang tot de WebGUI
    1. De standaardgebruikersnaam is “Admin”
    2. Neem voor het wachtwoord contact op met je Spacewell-consultant of raadpleeg Xovis™ Platform (SW internal)
  3. Je wordt doorgestuurd naar de Xovis Configuration Tool, waar je het apparaat kunt configureren

 

De Xovis Configuration Tool bevat een wizard die je door 8 stappen leidt:

  1. Regio
  2. Datum en tijd
  3. Netwerkidentificatie
  4. Privacymodus
  5. Montagehoogte en kanteling
  6. Beeldinstellingen
  7. Her kalibreren
  8. Configuratiewizard voltooid

 

Informatie

Je kunt de wizard volgen of de wizard annuleren en de onderstaande stappen handmatig doorlopen.

Als je de wizard volgt, vergeet dan niet om na afloop ook Data Push te definiëren in de Singlesensor-instellingen. Zie Xovis™ Platform (SW internal)

Stap 2. Algemene instellingen

Algemene instellingen
  1. Regio: selecteer de toepasselijke regio
  2. Datum en tijd: op basis van de ingevulde regio worden de datum en tijd ingevuld. Bevestig
  3. Netwerkidentificatie:
    1. Vermeld de locatie (naam building_floor_location) als onderdeel van de naam, zodat deze later gemakkelijker op de HUB kan worden geïdentificeerd
    2. Controleer in het hoofdstuk IPv4 of DHCP en Fallback zijn ingeschakeld

image-20230829-154256.png

3. Netwerkidentificatie: controleer in het hoofdstuk IPv4 of DHCP en Fallback zijn ingeschakeld
  1. (voor WiFi-apparaten) Draadloze verbinding:
    1. selecteer “Configure wireless network”
    2. scan naar netwerken
    3. selecteer het relevante netwerk
    4. bewerk de SSID-/netwerkgegevens
    5. test je verbinding

image-20240808-161958.png

  1. Privacymodus: voor de eerste configuratie heb je niveau 0 nodig

Opmerking

Wijzig het privacyniveau in dit stadium niet: het is niet mogelijk om terug te gaan naar niveau 0 zonder tussenkomst van het Spacewell Hardware Team

  1. Externe verbinding: schakel beide opties in
    1. Connect to Xovis support (geeft Xovis-ondersteuning toegang tot dit apparaat bij problemen): inschakelen
    2. Remote connections (verbinding maken met Xovis HUB, zodat configuratie op afstand mogelijk is): inschakelen en de verbindingsgegevens van de Xovis HUB invoeren (een token met de informatie die in de HUB is gedefinieerd). Op de onderstaande schermafbeeldingen zie je hoe je deze informatie uit de hub haalt (of vraag het Spacewell Hardware Team):

image-20240327-130042.png

  1. Gebruikersbeheer: het wijzigen van het wachtwoord wordt niet aanbevolen
  2. Je kunt de volgende subhoofdstukken overslaan (klik gewoon op “next”)

image-20240530-135139.png

6. Externe verbinding: schakel beide opties in

Apparaten die op Xovis Hub worden vermeld

Zodra de apparaten voor het eerst worden ingeschakeld, kan de Spacewell-consultant op basis van de lijst met verzonden hardware (zie https://onespacewell.atlassian.net/wiki/spaces/WM/pages/4357802768/Hardware+Logistics#Overview-of-hardware-orders voor de meest recente relevante link) controleren of de MAC-adressen van de Xovis-apparaten in de Xovis-hub onder “Unmanaged Devices” staan.

De sensoren verschijnen pas nadat ze zijn aangesloten en verbinding kunnen maken met Xovis Hub. Daarvoor kun je ze niet zien in Device Manager, behalve als je ze handmatig toevoegt in het beheerde gedeelte.

Als je apparaten worden vermeld onder Xovis Hub > Unmanaged devices, kun je ze nu aan je klant koppelen en de configuratie op afstand voortzetten.

Informatie

Als je apparaten niet onder Unmanaged Devices ziet staan en je de apparaten niet handmatig kunt toevoegen, neem dan contact op met het Hardware-team

Stap 3. Singlesensor-instellingen

1-2. Rotatie en beeldinstellingen
  1. Rotatie: roteer de beeldweergave op een manier die voor jou als beheerder werkbaar is

image-20230829-154505.png

Beeldinstellingen: Floor Mask (oranje), Taboo Mask (blauw) en Illumination Mask (geel) getekend

Informatie

Let op: het Floor Mask is essentieel en moet altijd worden getekend.

  1. Beeldinstellingen: alles wat het zicht van de sensor belemmert, leidt tot een verkleining van het trackinggebied. Dit is geen probleem als de gevraagde sector nog steeds kan worden gedekt. Objecten die zich direct voor of dicht bij de lenzen bevinden, kunnen een negatief effect hebben op de trackingkwaliteit.
    1. Selecteer de knoppen rechtsonder, begin met tekenen en dubbelklik zodra je klaar bent
    2. Floor Mask tekenen: bedek de volledige zichtbare vloer voor de beste trackingresultaten. Teken het Floor Mask niet over objecten zoals tafels of bloempotten.
      1. Zorg dat je niets bedekt wat geen vloer is (zoals een muur)
      2. Track alleen de vloer die je wilt volgen
      3. Als je meerdere Floor Masks maakt, zorg er dan voor dat ze precies OVER elkaar heen liggen (niet een beetje naast elkaar)
      4. Wanneer de Floor Mask-tool is geactiveerd, klik je eenvoudig op de scèneafbeelding om de hoeken en grenzen te tekenen door op een getekende lijn te klikken en deze te verslepen. Rond het werken aan een vloergebied af door te dubbelklikken om de laatste hoek te maken.
    3. Taboo Mask tekenen: gemaskeerde gebieden worden genegeerd voor beeldverwerking (bijvoorbeeld aangrenzende ruimtes of looppaden). Gebruik dit zorgvuldig! Taboo Masks moeten iets meer ruimte bedekken dan nodig is om fout-positieven te voorkomen; sommige fysieke objecten kunnen zich bijvoorbeeld groter voordoen dan ze werkelijk zijn (zoals een spiegelende muur).
      1. het is alsof je het oog van de sensor afplakt: dit bespaart bronnen en negeert alles wat in die zone wordt gezien
      2. zodra een persoon de Taboo-zone binnenkomt, gaat de telling verloren
    4. Illumination Mask tekenen: storende lichtbronnen kunnen optioneel worden bedekt met Illumination Masks. Als een plek extreem helder of donker is, verstoort dit de beoordeling van de sensor en wordt het beeld te donker voor normale tracking. Met het Illumination Mask worden deze gebieden uitgesloten van de meting van de belichting. Geef alle lampen, fel verlichte (reflecterende/zonlicht) of donkere gebieden en afleidingen door een lichtbron aan.
      1. verandert het contrast van het beeld
    5. Klik op save
    6. Als je dit na de eerste configuratie uitvoert: vergeet dan niet om na het opslaan van wijzigingen op deze pagina opnieuw Recalibration toe te passen (Singlesensor Settings > Recalibration)

Na elke wijziging in de beeldinstellingen stelt de sensor een nieuw herkalibratiealgoritme samen dat handmatig moet worden toegepast in het menu voor herkalibratie.

 

image-20240409-150335.png

Voorbeeld: het Floor Mask moest vanwege de bank in het midden in 2 delen worden getekend. De Floor Masks overlappen bij de verbindingslijnen

 

Informatie

Het Exclusion Mask wordt gebruikt om veiligheidsredenen

3. Montagehoogte en kanteling
  1. Montagehoogte en kanteling
    1. Vul de hoogte vanaf de vloer tot aan het apparaat in (tot aan de behuizing, als die aanwezig is)
    2. Tilt Setup Mode: selecteer “automatic”: de sensor bevat een waterpas en kan automatisch berekenen of deze gekanteld is en in welke mate. Als de kanteling binnen het acceptabele bereik valt, vormt dit geen probleem
    3. Live tilt measured: klik op de knop “Overwrite” om de kalibratie op het apparaat op te slaan (rechtsonder verschijnt een bericht als de kalibratie is geslaagd)

image-20230829-154656.png

Montagehoogte en kanteling

 

4. Herkalibratie
  1. Herkalibratie: klik naast “new calibration can be applied” op apply om een nieuwe kalibratie op de sensor toe te passen

image-20230829-155657.png

Herkalibratie

 

5. Data Push

Zie Xovis™ Platform (SW internal) voor informatie over het configureren van een XOVIS-apparaat om gegevens naar het Workplace-platform te verzenden.

  1. Je kunt de volgende subhoofdstukken overslaan (klik gewoon op “next”)

Stap 4. Scèneconfiguratie

Na het doorlopen van de configuratiewizard wordt de tool geopend op het Home-scherm, met de Sensor Overview Live Scene

Schakel in View (het oogpictogram rechtsboven in de visualisatie van de Live Scene) het volgende in:

  • Tracking Area Layer: hiermee wordt het concrete Detection Area weergegeven dat door de sensor wordt gedekt. De ruimte eromheen is zichtbaar voor het oog van de camera en kan worden gebruikt om “mensen die komen en gaan te identificeren”, maar maakt geen deel uit van het trackinggebied
  • Start/stop points Layer en voer vervolgens ook een startdatum in op het tabblad “Start/stop points”

 

image-20240530-141144.png
image-20240530-141040.png

 

Informatie

Laat de sensor idealiter enige tijd gegevens verzamelen over start-/stoppunten (hoe langer, hoe beter).

 

1-3. Een virtuele bezoekerslijn tekenen
  1. Selecteer rechtsboven de knop “Scene Configuration”
  2. Selecteer “Draw Line” om op de afbeelding een virtuele bezoekerslijn te tekenen
    1. als je start-/stoppunten visualiseert, teken je de lijn op de locatie waar de minste punten zichtbaar zijn
  3. Voer een betekenisvolle naam in in de pop-up “New geometry”
    1. De pijl/driehoek moet wijzen in de richting/naar de locatie die je wilt volgen; klik op save of dubbelklik om je wijzigingen op te slaan
    2. Selecteer de lijn en bewerk deze om de richting om te keren als dat nodig is
      1. De kleine groene, driehoekige aanwijzer naast een lijn toont de ‘voorwaartse’ (in) richting.
    3. Via bewerken kun je ook de naam wijzigen

image-20230829-160131.png

Een virtuele bezoekerslijn tekenen

Voorbeelden van het tekenen van de virtuele bezoekerslijn bij het visualiseren van start-/stoppunten: teken de lijn op de locatie waar de minste punten zichtbaar zijn

 

image-20240530-141918.png

 

 

image-20240530-142006.png

 

4. Logica aan de bezoekerslijn toevoegen
  1. Klik op de lijn en selecteer rechtsboven in het scherm “Add logic”

image-20230829-160438.png

Logica aan de bezoekerslijn toevoegen
5. Logica “[Person count in/out]”
  1. Selecteer “[Person count in/out]”. Je hoeft niets in te vullen; klik gewoon op “save”

 

Stap 5. Kwaliteitscontrole

Direct na de configuratie

Ga naar het Home-scherm om de Sensor Overview Live Scene te controleren en je configuratie te bevestigen.

Vraag iemand om de lijn over te steken, zodat je dit live op het platform kunt zien

image-20240530-142308.png

Informatie

Het is aanbevolen om in deze fase een uitgebreide kwaliteitscontrole uit te voeren. Doe dit voordat je doorgaat naar de laatste configuratiestap

 

Ga naar Tools > Stereo Image: de vloer moet blauw zijn, wat aangeeft dat de geconfigureerde hoogte correct is. Andere kleuren geven aan dat er iets in de weg staat

Voorbeeld om de live scène met de stereoafbeelding te vergelijken
image-20240530-142811.png image-20240530-142720.png

 

Na enkele dagen

Bekijk Live Scene view > visualizing start/stop points (startdatum in het verleden) om te controleren “waar verlies je de minste mensen?” Mogelijk moet je de virtuele bezoekerslijn aanpassen

 

Als je in de Xovis-tool het licht ziet flikkeren (“fog”),

  • werkt het licht waarschijnlijk op een andere frequentie dan de frequentie die in de regionale instellingen is ingesteld
  • je kunt de lichtfrequentie wijzigen via Singlesensor > Advanced Option

Zie Xovis troubleshooting voor meer informatie over probleemoplossing

Volgende stappen

Als je gegevens naar het Workplace-platform wilt laten stromen, moet je de sensoren implementeren in het Workplace-platform. Zie Xovis deployment.