Versions Compared

Version Old Version 1 New Version Current
Changes made by

Lango: Language and translation manager

Lango: Language and translation manager

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Automatically translated by Lango

DifficultyMoeilijkheidsgraad: expert

Content

Inhoud

Table of Contents
minLevel1
maxLevel1

Learning Objectives

After reading this article, you’ll be able to:

  • Configure the device

  • Configure the device to its location in the Workplace Platform

This guide focuses on the configuration of the Xovis devices and deployment in the

Leerdoelen

Na het lezen van dit artikel zul je in staat zijn om:

  • Het apparaat configureren

  • Configureer het apparaat op zijn locatie in het Workplace Platform

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

For a more detailed understanding of the Voor een meer gedetailleerd inzicht in het Xovis Platform, please consult the raadpleeg de https://spacewell.atlassian.net/wiki/pages/createpage.action?spaceKey=KB&title=Xovis%E2%84%A2%20Platform%20%28SW%20internal%29&linkCreation=true&fromPageId=291047256 manual handmatig.

Step 1. Access the Xovis Configuration Tool

Note

XOVIS WiFi devices' initial configuration (of the WiFi credentials) needs to happen while running a LAN/ethernet connection, and while being able to connect to the target WiFi network.

This means that, for the time required for the configuration, a LAN network needs to be available in a location where the target WiFi network is also reachable.

Configure Xovis sensor

De initiële configuratie (van de WiFi-gegevens) van XOVIS WiFi-apparaten moet plaatsvinden terwijl er een LAN/ethernetverbinding is en terwijl er verbinding kan worden gemaakt met het WiFi-doelnetwerk.

Dit betekent dat er gedurende de tijd die nodig is voor de configuratie een LAN-netwerk beschikbaar moet zijn op een locatie waar het WiFi-doelenetwerk ook bereikbaar is.

Xovis-sensor configureren

Stap 1. Open de Xovis-configuratietool

Connect your computer via an ethernet cable (ensure a power of
Expand
titleXovis sensor Configuration Tool
configuratietool

  1. Sluit je computer via een ethernetkabel (zorg voor een voeding van 12V / 1,5 A) to the same network as the Xovis device.

  2. Use the Xovis scanning tool, or Download IP scanner (for example “Advanced IP Scanner”) to your computer. Get the Xovis scanning tool through this link Xovis Sensor Explorer: To view the sensors installed within a specific IP range, simply double-click the .exe file, which will open a page and scan the IP addresses. The sensors installed within that range will be listed there.

  3. Scan your environment to see which devices are in your vicinity

image-20240227-140432.pngImage Removed

  • Compare the MAC address from the device box with the list from the scanning tool.

    • Right click - copy paste the IP into your browser (Chrome or Firefox): With the assigned IP address (DHCP), the WebGUI can be accessed

  • The default username is “Admin”

    • For the password: contact your Spacewell consultant, or see

    1. aan op hetzelfde netwerk als het Xovis-apparaat.

    2. Gebruik de Xovis-scantool of download een IP-scanner (bijvoorbeeld "Advanced IP Scanner") naar uw computer. Download het Xovis-scantool via deze koppeling Xovis-sensorverkenner: Om de sensoren te bekijken die binnen een bepaald IP-bereik geïnstalleerd zijn, dubbelklik je gewoon op het .exe-bestand, dat een pagina opent en de IP-adressen scant. De sensoren die binnen dat bereik geïnstalleerd zijn, worden in de lijst weergegeven.

    3. Scan uw omgeving om te zien welke apparaten zich in uw buurt bevinden

    image-20240227-140432.pngImage Added

    1. Vergelijk het MAC-adres uit de apparaatbox met de lijst van het scantool.

    2. Klik met de rechtermuisknop - kopieer en plak het IP-adres in je browser (Chrome of Firefox): Met het toegewezen IP-adres (DHCP) is de WebGUI toegankelijk

      1. De standaard gebruikersnaam is "Admin".

      2. Voor het wachtwoord: neem contact op met uw Spacewell-adviseur, of ziehttps://spacewell.atlassian.net/wiki/spaces/KB/pages/520323190/Xovis+Platform+SW+internal#Initial-Access-to-the-device

    3. You will be forwarded to the U wordt doorgestuurd naar de Xovis Configuration Tool, where you can configure the device

    The Xovis Configuration Tool provides a Wizard which walks through 8 steps:

    1. Region

    2. Date&Time

    3. Network Identification

    4. Privacy Mode

    5. Mounting height & tilt

    6. Image Setup

    7. Recalibration

    8. Setup Wizard Completed

    Info

    You can follow the wizard or cancel the wizard and manually go through the below steps.

    If you follow the wizard, don’t forget to also define Data Push in Singlesensor Settings after completion of the wizard, see

    1. waar u het apparaat kunt configureren.

    De Xovis-configuratietool biedt een Wizard die 8 stappen doorloopt:

    1. Regio

    2. Datum & tijd

    3. Netwerkidentificatie

    4. Privacymodus

    5. Montagehoogte & kantelen

    6. Afbeelding instellen

    7. Herkalibratie

    8. Setup Wizard voltooid

    Info

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

    Als u de wizard volgt, vergeet dan niet om ook Data Push te definiëren in Singlesensor-instellingen na voltooiing van de wizard, zie https://spacewell.atlassian.net/wiki/spaces/KB/pages/520323190/Xovis+Platform+SW+internal#Data-Push-Configuration

    Step

    Stap 2.

    General Settings

    Algemene instellingen

    Expand
    titleGeneral SettingsAlgemene instellingen

    1. Region: select applicable region

    2. Date&Time: based on filled in region, Date&Time will be filled in. Confirm

    3. Network identification:

      Make sure to mention the location

      Regio: selecteer de regio die van toepassing is

    4. Datum & tijd: op basis van de ingevulde regio wordt de datum en tijd ingevuld. Bevestig

    5. Netwerkidentificatie:

      1. Zorg ervoor dat je de locatie vermeldt (building_floor_location name) as part of the name, for easier identification on the HUB laterin chapter IPv4, make sure DHCP and Fallback are enabledals onderdeel van de naam, zodat je deze later gemakkelijker kunt identificeren op de HUB.

      2. Controleer in hoofdstuk IPv4 of DHCP en Fallback zijn ingeschakeld.

    1. (for voor WiFi devices) Wireless connectivity:

      1. select “Configure wireless network”

      2. scan for networks

      3. select the relevant network

      4. edit the SSID / network credentials

      5. test your connection

    image-20240808-161958.pngImage Removed

    1. Privacy Mode: for 1st configuration, you need level 0

    Note

    Do not change the Privacy Level at this stage: it's not possible to go back to level 0 without interference from the Spacewell Hardware Team

    Remote Connection: turn on both options

  • Connect to Xovis support (allowing Xovis support to access this devices in case of issues): enable

    • Remote connections (connect to Xovis HUB, making it possible to remotely access configuration): enable and provide the Xovis HUB connection information (A token containing the information defined in the HUB). Below screenshots show how to get this information from the hub (or ask

    1. -apparaten) Draadloze connectiviteit:

      1. Selecteer "Draadloos netwerk configureren".

      2. scannen op netwerken

      3. selecteer het relevante netwerk

      4. de SSID / netwerkgegevens bewerken

      5. test je verbinding

    image-20240808-161958.pngImage Added

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

    Note

    Verander 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. Verbinding op afstand: schakel beide opties in

      1. Verbinding maken met Xovis-ondersteuning (zodat Xovis-ondersteuning toegang heeft tot deze apparaten in geval van problemen): inschakelen

      2. Externe verbindingen (verbinding maken met Xovis HUB, waardoor het mogelijk wordt om op afstand toegang te krijgen tot de configuratie): schakel de Xovis HUB in en geef de verbindingsinformatie (een token met de informatie die in de HUB is gedefinieerd). Onderstaande screenshots laten zien hoe je deze informatie van de hub kunt krijgen (of vraag het Spacewell Hardware Team):

    image-20240327-130042.png

    1. User Management: change password is not recommended

    2. For the next sub chapters, you can skip these steps (just press "nextGebruikersbeheer: wachtwoord wijzigen wordt niet aanbevolen

    3. Voor de volgende subhoofdstukken kun je deze stappen overslaan (druk gewoon op "volgende")

    image-20240530-135139.png

    Devices listed on Xovis Hub

    As soon as the devices are powered up for the first time: based on the hardware shipment list (see

    Apparaten vermeld op Xovis Hub

    Zodra de apparaten voor het eerst worden ingeschakeld: op basis van de hardwareverzendlijst (zie https://spacewell.atlassian.net/wiki/spaces/WM/pages/229015617/Hardware+Logistics#Overview-of-hardware-orders for the latest relevant voor de meest recente relevante link) , the Spacewell consultant can verify the Xovis' devices MAC addresses are listed in the Xovis hub under “Unmanaged Devices”.

    The sensors will only appear once they are plugged in and are able to connect to Xovis Hub. Before this, you are not able to see them in the Device Manager, except if you add them manually in the managed section.

    If your devices are listed on Xovis Hub > Unmanaged devices, you can now linked them to your customer and continue the configuration remotely.

    Info

    If you don’t see your devices listed under Unmanaged Devices and are not able to add the devices manually, reach out to the Hardware team

    Step 3. Singlesensor Settings

    kan de Spacewell consultant controleren of de MAC-adressen van de Xovis-apparaten in de Xovis-hub onder "Unmanaged Devices" staan.

    De sensoren verschijnen pas als ze zijn aangesloten en verbinding kunnen maken met Xovis Hub. Daarvoor kunt u ze niet zien in Apparaatbeheer, behalve als u ze handmatig toevoegt in het beheerde gedeelte.

    Als uw apparaten worden vermeld op Xovis Hub > Apparaten zonder beheerJe kunt ze nu aan je klant koppelen en de configuratie op afstand voortzetten.

    Info

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

    Stap 3. Instellingen voor één sensor

    Rotation: rotate the image view in a way that is workable for you as an admin
    Expand
    title1-2. Rotation & Image setup
    Rotatie en beeldinstelling

    1. Rotatie: de afbeeldingsweergave draaien op een manier die werkbaar is voor u als beheerder

    Info

    Please note that the Floor Mask is essential and always needs to be drawn.

    1. Image setup: Anything that obscures the view of the sensor will result in a reduction of the tracking area. This is not a problem, if the requested sector can still be covered. Objects that are directly in front or close to the lenses, can have a negative effect on the tracking quality.

      1. Select buttons in the lower right corner, start drawing and once you're done, double click

      2. Draw Floor Mask: Cover the whole visible floor for best tracking results. Avoid drawing the floor mask over objects such as tables or flower pots.

        1. Make sure not to cover anything that is not a floor (wall)

        2. Only track the floor that you’re interested in tracking

        3. If creating multiple floor masks, make sure they overlap exactly ON each other (not slightly next to each other)

        4. Once the Floor Mask tool is activated, simply click on the scene image to draw the corners and boundaries by clicking and pulling on a drawn line. Finish working on a floor area by double-clicking to create the last corner.

      3. Draw Taboo Mask: Masked areas are ignored for image processing (for example adjacent rooms or walkways). Use carefully! Taboo masks should cover slightly more space than necessary to avoid false positives, for example some physical artifacts may present themselves to be larger than they actually are (e.g. a mirroring wall).

        1. like taping over the sensor eye, so it saves resources and disregards all it sees in that zone

        2. as soon as a person would come into the Taboo zone, the count will be lost

      4. Draw Illumination Mask: Disturbing light sources can optionally be covered with illumination masks. If a spot is extremely bright or dark, it distorts the evaluation of the sensor and the image gets too dark for regular tracking operation. With the Illumination mask, these areas are excluded from the measurement of the exposure. Indicate all the lights, brightly lid (reflecting/sunlight) or darker areas, or distractions from a light source.

        1. changes the contrast of the image

      5. Click save

      6. If you’re doing this after initial setup: Don’t forget to apply Recalibration (Singlesensor Settings > Recalibration) again after saving changes on this page

    Info

    After any change in the image setup, the sensor will compile a new re-calibration algorithm that need to be applied manually in the re-calibrations menu.

    image-20240409-150335.pngImage Removed

    Info

    Exclusion mask is used in case of security reasons

    Expand
    title3. Mounting Height & Tilt

    Mounting Height & Tilt

  • Fill in the height from the floor up to the device (until the cover, if there is one)

  • Tilt Setup Mode: select “automatic”: the sensor has a level inside and can automatically calculate if it's tilted and how much. If within acceptable range, this will not be an issue

    • Live tilt measured: click on the button "Overwrite" to save the calibration on the device (you'll get a message if calibration was successful in the bottom right corner

    Houd er rekening mee dat het vloermasker essentieel is en altijd getrokken moet worden.

    1. Afbeelding instellen: Alles wat het zicht van de sensor belemmert, zal leiden tot een verkleining van het trackinggebied. Dit is geen probleem als de gevraagde sector nog steeds kan worden afgedekt. Objecten die zich direct voor of dicht bij de lenzen bevinden, kunnen een negatief effect hebben op de trackingkwaliteit.

      1. Selecteer knoppen in de rechterbenedenhoek, begin te tekenen en dubbelklik zodra je klaar bent

      2. Vloermasker tekenen: Bedek de hele zichtbare vloer voor de beste trackingresultaten. Trek het vloermasker niet over objecten zoals tafels of bloempotten.

        1. Zorg ervoor dat je niets bedekt dat geen vloer (muur) is

        2. Volg alleen de verdieping die je wilt volgen

        3. Als je meerdere vloermaskers maakt, zorg er dan voor dat ze precies OP elkaar overlappen (niet een beetje naast elkaar)

        4. Zodra het Vloermasker-gereedschap is geactiveerd, klik je gewoon op de scèneafbeelding om de hoeken en grenzen te tekenen door op een getekende lijn te klikken en eraan te trekken. Beëindig het werken aan een vloergebied door te dubbelklikken om de laatste hoek te maken.

      3. Taboe masker tekenen: Gemaskeerde ruimten worden genegeerd voor beeldverwerking (bijvoorbeeld aangrenzende kamers of looppaden). Voorzichtig gebruiken! Taboe-maskers moeten iets meer ruimte bedekken dan nodig is om valse positieven te voorkomen. Sommige fysieke artefacten kunnen zich bijvoorbeeld groter voordoen dan ze in werkelijkheid zijn (bijvoorbeeld een spiegelende muur).

        1. alsof je over het sensoroog tikt, zodat het bronnen bespaart en alles wat het in die zone ziet negeert.

        2. zodra een persoon in de taboezone komt, gaat de telling verloren

      4. Verlichtingsmasker tekenen: Storende lichtbronnen kunnen optioneel worden afgedekt met verlichtingsmaskers. Als een plek extreem helder of donker is, verstoort dit de evaluatie van de sensor en wordt het beeld te donker voor normale tracking. Met het verlichtingsmasker worden deze ruimten uitgesloten van de belichtingsmeting. Geef alle lichten, helder verlichte (reflecterend/zonnig) of donkerdere ruimten of afleidingen van een lichtbron aan.

        1. verandert het contrast van de afbeelding

      5. Klik op sla

      6. Als je dit doet na de eerste installatie: Vergeet niet om herkalibratie toepassen (Singlesensorinstellingen > Herkalibratie) opnieuw nadat u de wijzigingen op deze pagina hebt opgeslagen.

    Info

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

    image-20240409-150335.pngImage Added

    Info

    Uitsluitingsmasker wordt gebruikt om veiligheidsredenen

    Expand
    title3. Montagehoogte & kantelen

    1. Montagehoogte & kantelen

      1. Vul de hoogte in vanaf de vloer tot aan het apparaat (tot aan het deksel, als dat er is)

      2. Instelmodus helling: selecteer "automatisch": de sensor heeft een waterpas binnenin en kan automatisch berekenen als het gekanteld is en hoeveel. Als dit binnen acceptabel bereik ligt, is dit geen probleem.

      3. Live tilt gemeten: klik op de knop "Overschrijven" om de kalibratie op het apparaat op te slaan (je krijgt rechtsonder een bericht als de kalibratie is gelukt)

    Re-calibration: to apply new calibration to the sensor, click apply next to "new calibration can be applied"
    Expand
    title4. Re-calibration
    Herijking

    1. Opnieuw kalibreren: om een nieuwe kalibratie op de sensor toe te passen, klikt u op toepassen naast "Nieuwe kalibratie kan worden toegepast".

    Expand
    title5. Data PushGegevens pushen

    See Zie https://spacewell.atlassian.net/wiki/spaces/KB/pages/520323190/Xovis+Platform+SW+internal#Data-Push-Configuration on how to configure a XOVIS device to send its data to the Workplace platform.

    1. For the next sub chapters, you can skip these steps (just press "next")

    Step 4. Scene Configuration

    After running through the setup wizard, the tool will open on the Home screen, showing the Sensor Overview Live Scene

    In View (the eye icon on the top right of the Live Scene visualization), turn on

  • Tracking Area Layer: this will visualize the concrete Detection Area covered by the sensor. The space around it is visible to the eye of the camera and might be used to “identify people coming and going”, but is not part of the tracking area

    • Start/stop points Layer, then also enter a start date in the “Start/stop points” tab

    hoe u een XOVIS-apparaat configureert om zijn gegevens naar het Workplace-platform te sturen.

    1. Voor de volgende subhoofdstukken kun je deze stappen overslaan (druk gewoon op "volgende")

    Stap 4. Scèneconfiguratie

    Nadat de installatiewizard is doorlopen, wordt het hulpprogramma geopend op het beginscherm en wordt het sensoroverzicht Live scène weergegeven.

    Schakel in Beeld (het oogpictogram rechtsboven in de Live Scène-visualisatie) het volgende in

    • Traceer Ruimte LaagDit visualiseert de concrete Ruimte die 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 volggebied.

    • Start/stop-punten Laagvoer dan ook een begindatum in op het tabblad "Start/stop-punten

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

    Info

    Ideally, have the sensor gather data on start/stop points for some time (the longer the betterIdealiter laat je de sensor gedurende enige tijd gegevens verzamelen over start-/stoppunten (hoe langer hoe beter).

    1. Select top right button "Scene Configuration"

    2. Select "Draw Line" to start drawing a virtual footfall line on the image

      1. if you’re visualizing start/stop points, you want to draw the line in the location where there are the least points visible

    3. Enter a meaningful name in the pop-up "New geometry"

      1. The arrow/triangle needs to point towards the direction/location that you want to track; press save or double click to save your changes

      2. Select the line and edit to invert direction if required

        1. The little green, triangular pointer next to a line shows its ‘forward’ (in) direction.

      3. Through edit, it's possible to also change the name

    Image RemovedExamples of drawing the virtual footfall line when visualizing start/stop points: you want to draw the line in the location where there are the least points visible
    Expand
    title1-3. Draw a virtual footfall line
    Teken een virtuele voetvallijn

    1. Selecteer rechtsboven de knop "Scèneconfiguratie".

    2. Selecteer "Teken lijn" om een virtuele looplijn op de afbeelding te tekenen.

      1. als je start/stop-punten visualiseert, wil je de lijn tekenen op de plaats waar de minste punten zichtbaar zijn

    3. Geef een betekenisvolle naam op in het pop-upvenster "Nieuwe geometrie".

      1. De pijl/driehoek moet wijzen naar de richting/locatie die je wilt volgen; druk op opslaan of dubbelklik om je wijzigingen op te slaan

      2. Selecteer de lijn en bewerk om de richting om te keren indien nodig

        1. De kleine groene, driehoekige aanwijzer naast een lijn geeft de 'voorwaartse' (in) richting aan.

      3. Via bewerken is het ook mogelijk om de naam te wijzigen

    Image Added

    Voorbeelden van het tekenen van de virtuele voetgangerslijn bij het visualiseren van start/stop-punten: je wilt de lijn tekenen op de locatie waar de minste punten zichtbaar zijn

    image-20240530-141918.png

    image-20240530-142006.png

    Click on the line and select "Add logic" to the top right of the screen
    Expand
    title4. Add logic to the footfall line
    Logica toevoegen aan de voetvallijn

    1. Klik op de regel en selecteer "Logica toevoegen" rechtsboven in het scherm

    Expand
    title5. Logic Logica "[Person count Aantal personen in/outuit]".

    1. Select Selecteer "[Person count Aantal personen in/outuit]". No need to fill anything in, just hit "save"

    Step 5. Quality Assurance

    Immediately after Configuration

    Go to the Home screen, to check the Sensor Overview Live Scene and confirm your configuration.

    Ask someone to cross the line, so that you can see this happening live on the platform

    image-20240530-142308.pngImage Removed
    Info

    It’s best practice to do an extensive Quality Check in this stage. Make sure to do this before moving to the last step in configuration

    In Tools > Stereo Image: the floor should be blue as an indication that the configured height is OK. Other colors indicate that there is something in the way

    Expand
    titleExample to compare the live scene with the stereo image
    image-20240530-142811.pngImage Removedimage-20240530-142720.pngImage Removed

    After some days

    Look at Live Scene view > visualizing start/stop points (start date in the past) to verify “where do you lose less people?” You might need to adjust the virtual footfall line

    If, in the xovis tool, you see the light flickering (“fog”),

    • probably the light is running on another frequency than what was set in the Regional settings

    • you can change the light frequency in Singlesensor > Advanced Option

    For more troubleshooting, see Xovis troubleshooting

    Next steps

    To have data flowing into the Workplace Platform, make sure to deploy the sensors in the Workplace platform, see Xovis deployment.

    Search

    1. U hoeft niets in te vullen, druk gewoon op "opslaan".

    Stap 5. Kwaliteitsgarantie

    Onmiddellijk na configuratie

    Ga naar het beginscherm om het sensoroverzicht Live Scène te controleren en uw configuratie te bevestigen.

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

    image-20240530-142308.pngImage Added
    Info

    Het is het beste om in dit stadium een uitgebreide kwaliteitscontrole uit te voeren. Zorg ervoor dat je dit doet voordat je naar de laatste stap in de configuratie gaat

    In Extra > Stereobeeld: de vloer moet blauw zijn als indicatie dat de geconfigureerde hoogte OK is. Andere kleuren geven aan dat er iets in de weg zit

    Expand
    titleVoorbeeld om de live scène te vergelijken met het stereobeeld
    image-20240530-142811.pngImage Addedimage-20240530-142720.pngImage Added

    Na enkele dagen

    Kijk naar Live scèneweergave > start-/stoppunten visualiseren (begindatum in het verleden) om te controleren "waar verlies je minder mensen?". Misschien moet u de virtuele voetvallijn aanpassen

    Als je in het xovis-gereedschap het licht ziet flikkeren ("mist"),

    • waarschijnlijk werkt het licht op een andere frequentie dan is ingesteld in de regionale instellingen

    • U kunt de lichtfrequentie wijzigen in Singlesensor > Geavanceerde optie

    Zie voor meer probleemoplossing Xovis troubleshooting

    Volgende stappen

    Om gegevens naar het Workplace-platform te laten stromen, moet u de sensoren in het Workplace-platform implementeren, zie Xovis deployment.

    Zoek op

    Live Search