Versions Compared

Version Old Version 1 New Version 2
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.the /wiki/spaces/KB/pages/520323190 manual.

Configure Xovis sensor

Step 1. Access the Xovis sensor 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 gateway (best practice is to plug in a cable from the same splitter to your computer).

  2. Download IP scanner (for example “Advanced IP Scanner”) to your computer

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

  4. Compare the MAC address from the physical device with the list

  5. Right click - copy paste the IP into your browser (Chrome or Firefox)

  6. After the installation of the Gateway, it will automatically connect to an available Server

  7. With the assigned IP address (DHCP), the WebGUI can be accessed (Best to use Chrome or Firefox)

    1. The default username is “Admin”

    2. The password is “pass”

  8. You will be forwarded to the Xovis Configuration Tool, where you can configure the device

A wizard will guide you through the next steps.

Step 2. General Settings

Expand

  1. Region: select applicable region

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

  3. Network identification: in chapter IPv4, make sure DHCP and Fallback are enabled

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

  2. User Management: change password is not recommended

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

Image AddedImage Added

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

  2. Image setup:

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

    2. Draw Floor Mask = Ground floor

    3. Draw Taboo Mask = you can indicate which areas need to be ignored (for example adjacent rooms or walkways)

    4. Draw Illumination Mask = indicate all the lights or distractions from the light source

    5. Click save

Image Added
Expand
title3. Mounting Height & Tilt

  1. Mounting Height & Tilt

    1. Fill in the mounting height

    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

  1. Data Push: PART OF PRE_CONFIG? IF NOT NEEDS TO BE DOCUMENTED!

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

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

  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

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

Image 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 Late"

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

Image Added

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

Image 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

Step 6. Privacy Mode

Once Quality Assurance confirms your set-up, go back to Settings > General Settings > Privacy Mode and set to level 3

Note

Once you do this, it's not possible to go back without interference from the Spacewell Hardware Team

 

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

Image Added

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 XOVIS device IDs 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

    Add New Device > Xovis in Studio

    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 "PointGrabXovis" 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.

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

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

    5. 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 Xovis troubleshooting.

    Search

    Live Search