Skip to end of metadata
Go to start of metadata
You are viewing an old version of this content. View the current version.
Compare with Current
View Version History
« Previous
Version 13
Next »
Learning Objectives
After reading this article, you’ll be able to:
This guide focuses on the configuration of the Xovis devices and deployment in the Workplace back-end Studio, after Xovis installation.
For a more detailed understanding of the Xovis Platform, please consult the /wiki/spaces/KB/pages/520323190 manual.
Xovis sensor Configuration Tool
Connect your computer via an ethernet cable (ensure a power of 12V / 1,5 A) to the same network as the Xovis device.
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.

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”
https://spacewell.atlassian.net/wiki/spaces/KB/pages/291045484/Xovis+SW+internal#Initial-Access-to-the-device
You will be forwarded to the Xovis Configuration Tool, where you can configure the device
Cancel the wizard and manually go through the next steps.
Step 2. General Settings
General Settings
Region: select applicable region
Date&Time: based on filled in region, Date&Time will be filled in. Confirm
Network identification:
Make sure to mention the location as part of the name, for easier identification on the HUB later
in chapter IPv4, make sure DHCP and Fallback are enabled
Privacy Mode: for 1st configuration, you need level 0
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 Spacewell Hardware Team):

User Management: change password is not recommended
For the next sub chapters, you can skip these steps (just press "next")


Step 3. Singlesensor Settings
1-2. Rotation & Image setup
Rotation: rotate the image view in a way that is workable for you as an admin
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.
Select buttons in the lower right corner, start drawing and once you're done, double click
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.
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.
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).
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.
Click save

3. Mounting Height & Tilt
Mounting Height & Tilt
Fill in the mounting height
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)

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

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
1-3. Draw a virtual footfall line
Select top right button "Scene Configuration"
Select "Draw Line" to start drawing a virtual footfall line on the image
Enter a meaningful name in the pop-up "New geometry"
The arrow/triangle needs to point towards the direction/location that you want to track; press save or double click to save your changes
Select the line and edit to invert direction if required
Through edit, it's possible to also change the name

4. Add logic to the footfall line
Click on the line and select "Add logic" to the top right of the screen

5. Logic "Person Count Late"
Select "Person Count Late". No need to fill anything in, just hit "save"

Step 5. Quality Assurance
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

Step 6. Privacy Mode
Once Quality Assurance confirms your set-up, go back to Settings > General Settings > Privacy Mode and set to level 3
Go to the Home screen, to check the Sensor Overview Live Scene and confirm your configuration
Once someone crosses the line, the live count will update
Due to level 3 setting, you will not see any interaction on the live scene view

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