Page 1
Xovis Technical Documentation PC-Series User Manual...
Page 2
Printed and published in Switzerland. While Xovis AG believes the information included in this publication is correct as of the date of publication, it is subject to change without notice.
Config View ...................... 51 3.2.9 Status View ...................... 78 3.2.10 Firmware upgrade ..................81 3.2.11 Extended analytics ..................82 3.2.12 Configuration changes from another client ........... 83 3.2.13 Connection warning ..................84 PC Series User Manual 3 / 100 www.xovis.com...
Page 4
Example for mask differentiation ..............91 Placement of dwell zones ............92 Time synchronization mechanism ..........94 Technical data ..............96 Certificates / Tests ............98 Custom Integration ............100 API ....................100 Plugin Architecture ..............100 PC Series User Manual 4 / 100 www.xovis.com...
PC-Series sensors are as well available as outdoor sensors. Those sensors are meeting the IP65 requirement with an increased temperature range. generation sensors (PC2S / PC2R) are equipped with a hardware RESET button on the back. Pressing this button for 3 seconds restores the sensor to factory default.
The PC-Series sensor provides a multifunctional LED on the front side. The red arrow on the next picture indicate the LED on the PC2 / PC2S / PC2R and PC3 models. Figure 2: PC2 / PC2S / PC2R LED (left) and PC3 LED (right)
3 Configuration & Usage 3.1 Person tracking The Xovis PC-Series sensor tracks persons. A few things must be considered to understand how the detection and the person tracking works: 3.1.1 Person generation The PC-Series sensor generates a person first when the person is completely within the visible scene (see Figure 3).
Theoretically the foot coordinates will always be the easier way to use, as all counting items (e.g. count line) can just be oriented on the scenes floor (all possible locations of a persons PC Series User Manual 8 / 100 www.xovis.com...
Page 9
On the left, foot coordinates are in use and on the right, head coordinates. The situation shows that the first possible position of person “bubbles” is clearly closer at the border when head positions are used. PC Series User Manual 9 / 100 www.xovis.com...
If no DHCP server is present, a static IP setting needs to be applied to the sensor. For this purpose, a Windows PC attached to the same physical subnet as the sensor is required. The static network settings can then be applied with the Xovis Sensor Explorer tool. 3.2.3 Login to the sensor The arrival page of the website shows a log-in dialog.
3.2.11. The “Expert Mode” is not documented in this manual as it is reserved for expert use only. Xovis strongly recommends to NOT USE the expert mode at all as changes made with the expert mode can cause the sensor to become unresponsive.
(sensor installation). The toggle on the bottom left corner allows to participate at the product improvement program (PIP) and helps Xovis to constantly improve their products. Find out more will open a modal window with more information. PC Series User Manual 12 / 100 www.xovis.com...
Page 13
DHCP or a fixed IP address. If not using DHCP and the IP settings have been applied already by using the Xovis Sensor Explorer, it is recommended to double check the network settings here. Optionally, a name and group can be specified for the sensor.
Page 14
The “Units” dropdown allows to choose between Metric (cm) and Imperial (feet/inch) units. By clicking “Next”, the date and time settings are applied to the sensor. 3.2.5.4 Sensor settings I PC Series User Manual 14 / 100 www.xovis.com...
Page 15
This is needed to adjust the sensors frame rate to the illumination frequency. By clicking “Next”, these settings are applied to the sensor. PC Series User Manual 15 / 100 www.xovis.com...
Page 16
The orientation is applied by clicking “Next”. 3.2.5.6 Mark the scene floor Figure 11: Drawn scene floor PC Series User Manual 16 / 100 www.xovis.com...
Page 17
For special situations, it can be desired to limit the floor mask to a part of the actual floor only, e.g. when persons passing in a neighboring zone should be ignored (see Figure 13 c). PC Series User Manual 17 / 100 www.xovis.com...
Page 18
The wizard will now ask if a re-calibration should be applied. It is recommended to re- calibrate the sensor when installing it for the first time in a new location. If this step is skipped the sensor cannot be used in a Multisensor. PC Series User Manual 18 / 100 www.xovis.com...
Page 19
3.5 meters, the person sizes will be quite exact without an additional correction (precision is better than +/- 10 cm). But in several situations, the sensor might not be able to correctly measure the scene and therefore measures the person sizes incorrectly. PC Series User Manual 19 / 100 www.xovis.com...
Page 20
After verifying the person sizes, any correction is applied to the sensor after clicking “Next”. 3.2.5.9 Setup the counting items PC Series User Manual 20 / 100 www.xovis.com...
Page 21
3.2.5.9.3. Scene view controls The scene view offers several controls which can be helpful when setting up the counting elements. PC Series User Manual 21 / 100 www.xovis.com...
Page 22
This path map can be of great use while drawing the counting elements properly as the displayed paths help the user to identify the areas where tracking occurs: Figure 17: Pathmap helps to identify the actual tracking while setting up the counting elements PC Series User Manual 22 / 100 www.xovis.com...
Page 23
See chapter 3.2.7.2 for more details. The help button offers quick explanations for all the control elements mentioned so far. Hovering over it with the mouse will pop-up the help information: PC Series User Manual 23 / 100 www.xovis.com...
Page 24
[Esc] on the keyboard. After finishing a line, the user is asked to name it. As with the floor masks, this name must be unique among all other scene elements. After naming the line it is automatically added to the scene element list. PC Series User Manual 24 / 100 www.xovis.com...
Page 25
“Zone” tool or by pressing [Esc] on the keyboard. As with the count lines, after finishing, the user is asked to name the count zone before it gets automatically added to the scene element list. PC Series User Manual 25 / 100 www.xovis.com...
Page 26
(e.g. count line behind a count zone). Clicking again on the element or selecting another element will unmark it again. The vice-versa procedure is also supprted, i.e. hovering and selecting the scene elements within the scene view. Figure 23 shows an example: PC Series User Manual 26 / 100 www.xovis.com...
Page 27
Figure 25: Delete a scene element When clicking on the trash bin icon, the user is asked to confirm the deletion of the specific scene element: PC Series User Manual 27 / 100 www.xovis.com...
Page 28
Switch count line orientation The count lines offer an additional icon within the scene element list, the rotate icon: Figure 26: Switch count line orientation PC Series User Manual 28 / 100 www.xovis.com...
Page 29
These parameters are explained in the following two chapters, Count line configuration and Count zone configuration. 3.2.5.9.7. Count line configuration The count line configuration displays the following dialog: Figure 28: Count line configuration PC Series User Manual 29 / 100 www.xovis.com...
Page 30
“activation zone”. Whenever an activation zone is associated to a count line, person crossings are only counted on this count line when the person is either generated or deleted within the activation zone. PC Series User Manual 30 / 100 www.xovis.com...
Page 31
Counts In/out Late Forward Backward 0 Figure 29: Count mode example 1 Counts In/out Late Forward Backward 1 Figure 30: Count mode example 2 PC Series User Manual 31 / 100 www.xovis.com...
Page 32
Minimum height The minimum height toggle allows to enable a specific minimal height of persons considered for counting: PC Series User Manual 32 / 100 www.xovis.com...
Page 33
For example, when specifying a minimum height on a count line, the average height of all crossings of a person is used for evaluating the criterion. Therefore, the counting can fist be done when a person gets deleted. PC Series User Manual 33 / 100 www.xovis.com...
Page 34
When set to “On”, a minimum and a maximum dwell time have to be specified. Persons dwelling for a shorter time than the minimum dwell time set here are not considered for dwell time statistics. Same with the maximum dwell time. PC Series User Manual 34 / 100 www.xovis.com...
Page 35
Please refer to chapter 4.3 “Placement of dwell zones” for more information on this. 3.2.5.10 Privacy mode After setting up the counting items, the next screen allows to define the privacy mode. The sensor offers 4 level of privacy: PC Series User Manual 35 / 100 www.xovis.com...
Page 36
The Sensor Master Key is unique for every sensor and is provided together with the corresponding order invoice. Alternatively send a request to support@xovis.com 3.2.5.11 Finishing the wizard When the privacy mode is set, the wizard will be finished by clicking on “Finish”. After...
Page 37
After clicking “OK”, the wizard will be closed, and the user is redirected to the live view. PC Series User Manual 37 / 100 www.xovis.com...
3.2.6 Live View The live view is the default landing page after logging in to the sensor or after finishing the setup wizard. Figure 34: Live view PC Series User Manual 38 / 100 www.xovis.com...
Page 39
15 minutes is shown. The displayed values are updated every 3 seconds. If no valid dwell times of a zone have been measured in the past 15 minutes, the dwell time of a count zone will be displayed as “n/a” (not available). PC Series User Manual 39 / 100 www.xovis.com...
Page 40
For count zones, in case the data persistence feature has been activated (see 3.2.5.9.8), the occupancy as well as dwell times are available. The individual charts for occupancy, dwell time statistics and dwell time distribution are accessible by selecting the respective tab: PC Series User Manual 40 / 100 www.xovis.com...
Page 41
Xovis provides the “Xovis Validation Viewer” tool to analyze validation recordings offline. The recordings are split into several sequences of 5MB. Use the Xovis Validation Viewer to visualize the sequences belonging together (it can be downloaded from the Xovis Customer Portal).
Page 42
A single sequence file can be downloaded by clicking on it. To analyze a complete recording, all sequence files should be downloaded in one directory. The Xovis Validation Viewer can then interpret all these single sequence files as one recording and display the recording accordingly.
Page 43
This is highly recommended for a ground-truth analysis of a Multisensor. The Xovis Validation Viewer supports Multisensor validation including belonging single sensor slave recordings.
Please see the Xovis Validation Viewer manual to learn how to evaluate validation recordings offline. 3.2.7 Analytics View The analytics view contains two boxes named “Persisted count data” and “Visualization maps”. With the persisted count data box, it’s possible to display custom charts of the persisted count data.
Page 45
All settings are also applied to the CSV export, e.g. the chosen granularity and period. 3.2.7.1.1. Count zone charts When displaying the persisted data of a count zone, a tab navigation offers three types of charts: PC Series User Manual 45 / 100 www.xovis.com...
Page 46
For example, when selecting a “5 minutes” granularity, the bin from 9:00 to 9:05 will contain the occupancy level of the persisted value from 9:04 to 9:05. Dwell time statistics PC Series User Manual 46 / 100 www.xovis.com...
Page 47
Too long dwell times: Shows the number of tracks with dwell times, longer than the maximal dwell time Invalid tracks: Shows the number of tracks which have not been created and deleted outside the dwell zone (for further information see the chapter “4.3 dwell zone placement”) PC Series User Manual 47 / 100 www.xovis.com...
Page 48
Based on this it is now possible to see how the start / stop points have been generated over the time. The sensor holds the past 10’000 points and will replace the oldest point with a new one when the limit is reached. PC Series User Manual 48 / 100 www.xovis.com...
Page 49
The averaged map will then show a clear slope. It also helps to validate a proper calibration of the sensor (heights differ too much from excepted value). The colors are explained in the legend on the side. PC Series User Manual 49 / 100 www.xovis.com...
Page 50
Start / Stop points Heat map Average person heights Please note that the map controlling elements are located on the bottom of the background image here, other than with the single sensor “visualization maps”. PC Series User Manual 50 / 100 www.xovis.com...
The config view allows the complete configuration of the sensor. However, it is usually recommended to configure the sensor using the setup wizard (explained in chapter 3.2.5). The config view is divided into four parts: 3.2.8.1 Control buttons PC Series User Manual 51 / 100 www.xovis.com...
Page 52
The “start setup wizard” button allows to re-start the setup wizard at any time. When clicking this button, the user gets asked to choose to either start the wizard with the currently applied settings or by first resetting the sensor to the factory-default configuration: PC Series User Manual 52 / 100 www.xovis.com...
Page 53
After pressing this button, the user is asked to confirm the requested reboot. When clicking “OK”, the sensor will reboot which usually takes about 2 minutes. The following dialog will be displayed: PC Series User Manual 53 / 100 www.xovis.com...
Page 54
“Browse…”. After selecting the desired file, the import is started by clicking on “Import”. The user then is asked to confirm the import process of the configuration. PC Series User Manual 54 / 100 www.xovis.com...
Page 55
Please be aware, that the configuration currently applied to the sensor will be completely overwritten by the imported configuration. If the file trying to import is not a valid Xovis PC-sensor configuration file or the configuration is not applicable to the sensor, the user gets notified by a respective message dialog:...
Page 56
“counts” list. The blinking small green dot displayed in the upper left corner of the “Scene” box indicates an intact connection to the sensor. PC Series User Manual 56 / 100 www.xovis.com...
Page 57
Other than during the setup wizard, the floor masks can now be deleted also. Please refer to the mentioned chapter to learn more about the “Scene elements” box. PC Series User Manual 57 / 100 www.xovis.com...
Page 58
“Sensor name” and “Sensor group”. All these settings have already been described in chapter Fehler! Verweisquelle konnte nicht gefunden werden. Fehler! Verweisquelle konnte nicht gefunden werden.. PC Series User Manual 58 / 100 www.xovis.com...
Page 59
(IP or domain) separated by a colon (“:”). When pushing using HTTP(S), only the URL needs to be specified. The URL requires declaring the protocol which can be http:// or https://. Please refer to the RFC 3986 PC Series User Manual 59 / 100 www.xovis.com...
Page 60
HTTP(S): Figure 39: Example configuration for pushing count data to remote destination This setup will push count data of 1-minute granularity every hour to rmtpush.xovis.com with a custom URL parameter “auth”. The “test” button allows to instantaneously test the connectivity to the remote destination.
Page 61
“remove” button on the right side of every agent. As with the whole config section, changes to the data push configuration are first applied when pressing the “Save” button. PC Series User Manual 61 / 100 www.xovis.com...
Page 62
Manually pushing count data allows the user to specify the desired period to push: PC Series User Manual 62 / 100 www.xovis.com...
Page 63
Please refer to the API documentation to learn how to receive and parse person push data. Events With Events, sensor events can automatically be pushed to a remote destination using Data Push. All events known from the Event Stream are also supported by “Events”, which are: PC Series User Manual 63 / 100 www.xovis.com...
Page 64
Additional plugins can be added by clicking on the “Add Plugin” button. In the subsequently dialog, the plugin identifier can be entered. After adding the plugin, the sensor will reboot. Please contact Xovis to learn more about all available plugins and the respective plugin identifier, if you are interested in evaluation.
Page 65
If the “Viewer” account is enabled, choose the according entry in the dropdown menu on the login screen. PC Series User Manual 65 / 100 www.xovis.com...
Page 66
(Find out more will open a modal window with more information). For time zone, sensor time, UI language and privacy mode, please refer to the corresponding chapters in the wizard section, see chapter 3.2.5 Setup Wizard. PC Series User Manual 66 / 100 www.xovis.com...
Page 67
The “Network” section holds the network parameters like the corresponding step in the setup wizard (see chapter 3.2.5). In addition, it contains the Ports & SLL certificates settings , the Remote Management Server settings, and the toggle for the Xovis support connection. PC Series User Manual 67 / 100 www.xovis.com...
Page 68
Manage Server Identity The “Manage Server Identity” dialog allows to upload and apply a custom SSL key/certificate to the sensor. It will then override the Xovis default key/certificate, which can be restored at any time by deleting the custom key/certificate again.
Page 69
The ”Manage Trusted Authorities” dialog allows users to trust their own authorities. Certificates can simply be uploaded and will automatically be applied. Any uploaded certificate can be removed at any time. The Xovis default CA can be enabled and disabled. Supported formats are PEM or DER (.der, .pem, .crt).
Page 70
Connect to Xovis Support With sensor FW 3.6 and higher a direct connection to the Xovis support remote manager can be established, while persisting the configured remote connections. Attention: An outgoing internet connection is needed to connect to the Xovis support remote manager 3.2.8.4.7.
Page 71
The following conditions must be fulfilled: The admin passwords are matching The time server is set up Privacy Mode is set to 0 The sensor is configured by the wizard The sensor is recalibrated PC Series User Manual 71 / 100 www.xovis.com...
Page 72
If one of those conditions is not met, an error message will inform the user about the reason. PC Series User Manual 72 / 100 www.xovis.com...
Page 73
When all slaves are added, clicking “Next” will bring up the stitching page. The automated stitching is based on tags which must be placed underneath the involved sensors with a distance between each other of minimum 1 meter. Xovis provides a PDF-file (Xovis_multisensor_stitching_tags_v2.pdf) containing a set of 30 predefined tags, each one to be printed on an A3-sized paper sheet.
Page 74
After clicking on the button “Next” the master sensor performs the stitching and confirms it with the following popup: After clicking “OK”, the GUI is reloaded. The “Live” and the “Config” tab now contain a “Multi- Sensor” and a “Single-Sensor”-View. PC Series User Manual 74 / 100 www.xovis.com...
Page 75
The “Scene” view shows the stitched still image of the Multisensor. It is possible to activate the tracking (shows the bubbles), the traces and the live maps “path” and “start/stop”. Counts The section “Counts” will show the counts of the count lines and zones of the Multisensor. PC Series User Manual 75 / 100 www.xovis.com...
Page 76
The section “24h activity” will show the activities of the last 24 hours with 15-minute granularity. Validation Recording Schedule and manage Multisensor validation recordings. The Multisensor view in the “Config” tab allows to setup count lines and zones for the Multisensor: PC Series User Manual 76 / 100 www.xovis.com...
Page 77
The sections “Settings” → “Multisensor” contains a list of all involved sensors with their IP address. Furthermore, the Multisensor stitching wizard can be restarted here and the Multisensor can be deleted permanently. PC Series User Manual 77 / 100 www.xovis.com...
3.2.9 Status View The status view provides various information about the sensor: PC Series User Manual 78 / 100 www.xovis.com...
Page 79
The current tilt of the sensor Sensor recalibrated Status about recalibration either “is re-calibrated” or “not re-calibrated” The “log”-button on the upper right corner of the Info box opens the detailed log view: PC Series User Manual 79 / 100 www.xovis.com...
Page 80
The icon on the right of each connection indicates, if the connection is still established or not (green check if established, red alert if not). PC Series User Manual 80 / 100 www.xovis.com...
By clicking on the “Browse…” button, the firmware upgrade file can be chosen on the local file system. The only supported file extensions are. Xfw and Xcb. When a valid file is chosen, PC Series User Manual 81 / 100 www.xovis.com...
“Sensor images (left/right)” shows the grayscale image of both lenses. This can help to identify dirt and scratches on the lenses. Furthermore, it also helps identifying obstacles hanging from the ceiling which demand for a mask. Clicking on “Reload” gathers new images. PC Series User Manual 82 / 100 www.xovis.com...
Whenever another client changes the sensors configuration, i.e. when more than one user is working on the sensor configuration at the same time, the web GUI will inform the user about changes made by another client with the following dialog: PC Series User Manual 83 / 100 www.xovis.com...
UI will not be updated at all. However, switching between the tabs (Live, Statistics, Config, Status) and changes to the configuration can still be made. However, saving the configuration changes will not succeed until the connection is established again. PC Series User Manual 84 / 100 www.xovis.com...
ID will not be anonymized. Devices specified in a blacklist will never be monitored by the sensor. By clicking on “Configure lists”, individual lists can be managed: PC Series User Manual 85 / 100 www.xovis.com...
Page 86
AA:BB:CC:DD:EE:FF, AA:BB:CC:DD:EE:FF, AA:BB:CC:DD:EE:FF AA:BB:CC:DD:EE:FF AA:BB:CC:DD:EE:FF AA:BB:CC:DD:EE:FF 3.3.1.2 Wireless Devices Data Push For retrieving the monitored wireless devices, the PC2R offers a new Data Push type called “WiFi/Bluetooth devices”: PC Series User Manual 86 / 100 www.xovis.com...
Page 87
Wireless devices data push does not support manual push as these data are not persisted on the sensor. Please refer to the API documentation to learn how to receive and parse wireless device push data. PC Series User Manual 87 / 100 www.xovis.com...
Figure 44 shows an example for both situations. The left image (a) shows a scene with a big mirroring wall on the left and an information column on the right bottom. The right image (b) shows the same scene with exclusion masks applied. PC Series User Manual 88 / 100 www.xovis.com...
Such influences can for example be caused by: Signboards or monitors mounted within the sensors view Unstructured or mirroring walls Dark regions in strongly inhomogeneous illumination situations PC Series User Manual 89 / 100 www.xovis.com...
Page 90
Note that, other than with floor masks, taboo masks usually cover slightly more than necessary. This is important due to the fact, that disturbing artefacts which are masked out by taboo masks show inexact dimensions and can slightly slop over their actual region. PC Series User Manual 90 / 100 www.xovis.com...
When using a blue mask, the complete area covered by this mask is cleared, i.e. shows no information anymore. The sensor is blind in this area. This leads to the fact, that not only the PC Series User Manual 91 / 100 www.xovis.com...
Tracks that are created or deleted within the zone are not considered by the dwell time analysis. The below image shows three tracks A, B, and C: PC Series User Manual 92 / 100 www.xovis.com...
Page 93
As shown in the figures below, the activation of start/stop points can be useful to optimize the dwell zone placement. PC Series User Manual 93 / 100 www.xovis.com...
For optimal dwell time analysis, the dwell zone must be placed inside the sensor’s tracking area. 4.4 Time synchronization mechanism The below flow diagram describes the time synchronization behavior depending on power or internet connection loss. PC Series User Manual 94 / 100 www.xovis.com...
Page 95
Is the time manually set now? Was the power break only short, e.g. a power cut only? NTP time sync => Quite valid time, Invalid time, time is valid synchronization synchronization PC Series User Manual 95 / 100 www.xovis.com recommended required...
-25 – 40°C (only PC2R-O and PC3-O) Humidity 20 – 80% Size PC2 / PC2S / PC2R: 130mm x 94mm x 30mm (LxWxH) PC2R-O: 154mm x 103mm x 83mm (LxWxH) PC3: 345mm x 67mm x 37mm (LxWxH) PC3-O: 385mm x 90mm x 86mm (LxWxH)
Page 97
Data retention of 122 days in total, divided by the amount of count lines in use Plugin architecture The sensors functionality can be extended by various plugins which run directly on the sensor. Xovis offers a list of all available plugins. PC Series User Manual 97 / 100...
Information technology equipment. Radio disturbance. Limits and methods of measurements: Class B GOST CISPR 24:2013 Information technology equipment. Immunity to electromagnetic disturbances. Requirements and test methods Immunity – Requirements CISPR 24:2010/AMD1:2015; EN 55024:2010 + A1 PC Series User Manual 98 / 100 www.xovis.com...
Page 99
Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help. PC Series User Manual 99 / 100 www.xovis.com...
7 Custom Integration 7.1 API Xovis offers the possibility to access raw sensor data directly by a platform independent API and thereby provides an easy way to integrate Xovis sensors into third-party applications. Detailed information on the sensor interface and custom integration can be found in the API documentation.
Need help?
Do you have a question about the PC2S and is the answer not in the manual?
Questions and answers