Versions Compared

Version Old Version 1 New Version Current
Changes made by

Julie Isebaert

Julie Isebaert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Difficulty: expert

Content

Table of Contents
minLevel1
maxLevel1

Learning Objectives

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

  • Configure the necessary assets in the PointGrab™ Platformdevice

  • Configure the device to its location in the Workplace Platform

This guide focuses on the configuration of the Pointgrab Xovis devices on the PointGrab™ Platform and and deployment in the Workplace back-end Studio.As a prerequisite, we assume a configured asset tree in the PointGrab™ Platform, in which a floorplan is uploaded, after Xovis installation.

For a more detailed understanding of the PointGrab™ Xovis Platform, please consult the PointGrab™ Platform (SW internal) manual.

Deploy sensors in PointGrab™ Platform

Link the device IDs from the physical installation to the sensors device name (include area name, customer name (eg customer_area_floor number_room number_X))

Info

Before linking a new sensor device, the sensor must be powered up and have internet access to the PointGrab™ cloud (make sure to check the PointGrab hardware & network requirements).

Image Removed

Manually Import Commissioning Data

Note

Make sure to cross-check the serial number written on the back of the PointGrab sensor.

  1. Use the search and paging options to find the device.

  2. Click the “Link Device” symbol/button on the right hand side. The Link dialog is displayed.

  3. In the Serial Number field, enter the serial number written on the ethernet port on the back of the PointGrab sensor. Serial numbers should be inserted using the following format: xxxxxxx-xxxx-xxxxxx-xxxx. Almost all sensors linked to Spacewell start with identifier 4000023-1401-xxxxxx-xxxx.

  4. Click Link and verify that the sensor’s Link Status icon in the table changes to the “linked” symbol.

Image Removed

Info

You can only link one device at a time.

Import & Export Commissioning Data from a File

Please check out the complete description and example of batch uploading devices as described on PointGrab™ Platform (SW internal).

Define areas in PointGrab™ Platform

Following the steps described in the PointGrab™ Platform (SW internal), define the areas where the sensors will measure headcounts (eg. different workplaces to be covered by 1 Pointgrab sensor)

Don’t forget: all of these areas need to be within the Detection Area (check PointGrab installation for more information on Detection Area linked to Installation Height)

Note

Even if the Detection Area might be large enough to cover more than 10 work places, PointGrab™ has a limit to max 10 areas per device, so if you create more in PointGrab™ Platform, the device will appear offline.

Finetune PointGrab™ Platform

Finetune the location of the area and the sensor device by comparing the live view and the on site situation.

Deploy sensors in your Workplace tenant 

Prerequisites

Info

Deploying sensors in Workplace can only be done by Spacewell.

For Spacewell external users: please contact your Implementation Consultant and indicate your tenant and the relevant PointGrab Management Platform area names that need to be mapped in Studio.

For Spacewell Implementation Consultants:

  • using your multi-tenant account (see /wiki/spaces/KB/pages/491811), you can create/modify areas in Studio. The drop down list starts at PointGrab Management Platform site level.

  • make sure your customer is added to PointGrab Management Platform app-account MCSs2 (Every time you add a new branch, you must also give access to see this branch for user MCSs2, which is used by Workplace): PointGrab Management Platform > User Manager > Find MCSs2 > Edit > Click on Assets Tree > setup all needed check boxes > click Apply > click Save on the main window

Add New Device in Workplace back-end Studio

Note

Only after the next data package is send, data for this sensor will be visible in your tenant. (This means that depending on time of provisioning to your tenant and activity at the customer site, this can take a while.)

Image Removed

  1. Go to your tenant (https://studio.cobundu.com )

  2. Select the location, where you can manually add a Pointgrab area via "Add New Device"

  3. Select "PointGrab" in Device Type

    1. this will automatically select the relevant channels for PointGrab (Headcount, Footfall-in and Footfall-out)

    2. if you want to disable one or more of these channels (when for example in your project, the PointGrab devices will only be used for Headcount), you can click on the "Advanced" button and scroll down to modify Advanced Sensor Details. Only do this after approval of your Spacewell Consultant.

  4. Select the detection area (that has been set up in PointGrab Management Platform beforehand) from the Device ID drop down list

    1. Because the Device ID drop down list includes ALL Workplace tenants, it's not possible to select PointGrab Management Platform device ID by using a tenant-direct-login in Studio. For Spacewell external users: please contact your Implementation Consultant and indicate your tenant and the relevant PointGrab Management Platform area names that need to be mapped in Studio.

  5. Give a meaningful name: include device name, tenant name (eg tenant_floor number_area)

    1.  Make sure device ID + location are referenced everywhere, so that in Studio you can use the simple search function 

  6. Select a Location from the location tree if this is already known (automatically filled in if location was selected before adding new device).

Info

Remember that sometimes

  • multiple sensors are used to cover 1 count area

  • 1 sensor is used to cover multiple count areas

For more detailed explanation: see below

Multiple sensors to cover 1 count area (for example: meeting room too large, needs 2 or more sensors)

1. In Pointgrab, multiple sensors might need to be installed to track 1 location (eg if the detection area does not cover the whole room)

2. With overlapping detection areas, these devices will be stitched together in the platform, to make sure that the combined detection areas of the multiple sensors match the required count area.

Image Removed
Image Removed

3. In Studio, select the Pointgrab Area to match the Spacewell location

4. In Spacewell Utilization view, the sum of the people detection count of all the sensors in the area will be presented for the location.

Image Removed
Image Removed

1 sensor to cover multiple count areas (for example: sensor used to track workplace occupancy)

1. A Pointgrab sensor might be installed to track multiple locations (eg if the detection area covers multiple desks)

2. In Pointgrab Platform, count areas from this 1 device in the platform, to make sure that data from the separate count areas is gathered individually.

Image Removed

3. In Studio, select the Pointgrab Area to match the Spacewell location

4. In Spacewell Utilization view, the sum of the people detection count per count area will be presented for the location.

Image Removed
Image Removed

Quality Assurance

Verify Quality Assurance steps in Quality Assurance Occupancy/Utilization Sensor

Next steps

Once data is flowing into the Workplace Platform, Configure Space monitor.

In case you encounter any issue with your devices, don’t hesitate to check PointGrab troubleshootinghttps://spacewell.atlassian.net/wiki/pages/createpage.action?spaceKey=KB&title=Xovis%E2%84%A2%20Platform%20%28SW%20internal%29&linkCreation=true&fromPageId=291047256 manual.

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

Step 1. Access the Xovis Configuration Tool

Expand
titleXovis sensor Configuration Tool

  1. Connect your computer via an ethernet cable (ensure a power of 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 Added

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

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

    1. The default username is “Admin”

    2. For the password: contact your Spacewell consultant, or seehttps://spacewell.atlassian.net/wiki/spaces/KB/pages/520323190/Xovis+Platform+SW+internal#Initial-Access-to-the-device

  3. You will be forwarded to the 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 https://spacewell.atlassian.net/wiki/spaces/KB/pages/520323190/Xovis+Platform+SW+internal#Data-Push-Configuration

Step 2. General Settings

Expand
titleGeneral Settings

  1. Region: select applicable region

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

  3. Network identification:

    1. Make sure to mention the location (building_floor_location name) as part of the name, for easier identification on the HUB later

    2. in chapter IPv4, make sure DHCP and Fallback are enabled

Image Added

  1. (for 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 Added

  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

  1. Remote Connection: turn on both options

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

    2. 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):

image-20240327-130042.pngImage Added

  1. User Management: change password is not recommended

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

image-20240530-135139.pngImage Added

Devices listed on Xovis Hub

As soon as the devices are powered up for the first time: based on the hardware shipment list (see https://spacewell.atlassian.net/wiki/spaces/WM/pages/229015617/Hardware+Logistics#Overview-of-hardware-orders for the latest relevant 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

Expand
title1-2. Rotation & Image setup

  1. Rotation: rotate the image view in a way that is workable for you as an admin

Image Added
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 Added

Info

Exclusion mask is used in case of security reasons

Expand
title3. Mounting Height & Tilt

  1. Mounting Height & Tilt

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

    2. 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

    3. 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)

Image Added

Expand
title4. Re-calibration

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

Image Added

Expand
title5. Data Push

See 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

image-20240530-141144.pngImage Added
image-20240530-141040.pngImage Added

Info

Ideally, have the sensor gather data on start/stop points for some time (the longer the better).

Expand
title1-3. Draw a virtual footfall line

  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 Added

Examples 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

image-20240530-141918.pngImage Added

image-20240530-142006.pngImage Added

Expand
title4. Add logic to the footfall line

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

Image Added
Expand
title5. Logic "[Person count in/out]"

  1. Select "[Person count in/out]". 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 Added
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 Addedimage-20240530-142720.pngImage Added

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

Live Search