Serach Icon

    Xovis — advanced configuration: monitoring, heatmap, age estimation & PF staff exclusion

    Advanced configuration topics from the Xovis Knowledge Base — device monitoring via API and Status Push, heatmap generation, Apparent Age integration, and behaviour-based Staff Exclusion on the PF-Series without a badge tag. Source: Xovis Knowledge Base.

    Device monitoring

    Monitor sensor health via the WebUI status page or via the REST API and Status Push. Key indicators to watch:

    Scene illumination

    Normal = ADEQUATE. If lux drops to 2 or below (PCT sensors: 10 or below) → INADEQUATE. Add illumination or adjust illumination mask.

    Tilt

    OK when live tilt is within ±1° of saved tilt. If the sensor is knocked or vibrated → shows MOVED. Resave the tilt in Settings → Mounting.

    Calibration

    OK when calibration has been applied. If floor mask is redrawn but recalibration not applied → NEW VERSION AVAILABLE.

    Multisensor status codes

    out_of_sync

    Time is not correctly synchronised — check NTP server on all sensors

    mismatch

    Unexpected MAC address for a given IP — sensor may have been replaced or IP reassigned

    incompatible

    Firmware version mismatch between sensors — update all sensors to the same firmware version

    unauthorised

    Wrong username or password in multisensor settings — update the single sensor password in the multisensor configuration

    privacy_protection

    Privacy level too high — set all sensors to privacy level 0 before stitching

    unused

    Sensor is not part of the multisensor scene — check scene configuration

    wlan_multisensor / wlan_sensor

    WiFi connection — not supported in multisensor

    remote_connection_multisensor

    Remote connection — not supported in multisensor

    Configuration backup and restore

    • Take a backup (.xbak file) after first configuration and after any significant changes

    • Backups are encrypted

    • Cannot restore a backup across different sensor generations (e.g. PC2 → PC2SE)

    • Data push authentication passwords and multisensor passwords are not restored from backup — must be re-entered manually

    Config change tracking via API

    To detect whether a sensor's configuration has been changed:

    GET <sensor-ip>/api/v5/config/state

    Returns a master checksum + per-endpoint checksums with timestamps. The master checksum changes on every config change or reboot. Use ?contents=true to include the actual settings values alongside the checksums.

    Daily heatmap

    The heatmap shows which floor areas had the most foot traffic — grid-based, coloured from blue (low) to red (high). A person standing for ≥1 second in a grid square increments its counter.

    To generate a clean 24h heatmap:

    1. At closing time (e.g. 20:00), download the heatmap: GET <sensor-ip>/api/v5/singlesensor/data/history/heat_map (raw data) or add .jpg for a JPEG image

    2. Reset the heatmap: DELETE <sensor-ip>/api/v5/singlesensor/data/history/heat_map

    3. Wait 24 hours, then download again

    4. Repeat daily

    Apparent Age Estimation — integration

    Apparent Age Estimation (FW ≥5.8, licence required) can be integrated in two ways:

    Live data push

    Provides an age estimate in years for each individual tracked person. Maximum flexibility for server-side processing. Higher data volume.

    Logic data push

    Provides aggregated histogram data per time interval. Configurable age bins between 16–65 years. Compact payload. Recommended for Vemcount integration.

    Xovis recommendation: Use logic push for analytics dashboards — longest data retention during connection loss, lowest bandwidth, configurable bins per customer use case.

    Example bin configuration (5 bins):

    Bin 0

    0–17 years (child)

    Bin 1

    18–28 years

    Bin 2

    29–39 years

    Bin 3

    40–51 years

    Bin 4

    52–62 years

    Bin 5

    63+ years

    Retrieve bin configuration via: GET api/v5/singlesensor/data/live/counts — includes histogram bin boundaries and current bin counts. Enable Logic configuration in the push agent to include bin info in each push payload (FW 5.9+).

    Staff Exclusion on PF-Series — behaviour-based (no badge required)

    The PF-Series supports staff exclusion without a physical staff badge tag — using zones and lines to identify staff movement patterns. Two methods:

    Method A — Staff Zone

    Draw a zone that only staff enter (e.g. behind the counter, stockroom entrance). Configure a Late count logic where the activation zone is the staff zone. Any person whose track starts or ends in the staff zone is counted separately as staff.

    1. Place a staff zone covering the staff-only area (behind counter, back door, etc.)

    2. Add a Late count logic on the main entrance line → name it "Staff Count"

    3. Set the staff zone as the Activation Zone for this logic

    4. Edit as custom logic → for both Modifier 1 and Modifier 2: click the OR operator → select Zones → "Has visited zone" → select the staff zone

    5. Result: only tracks that entered the staff zone are counted in this logic

    6. Subtract staff count from total visitor count in Vemcount to get visitor-only figures

    Method B — Staff Line

    Similar to Method A but uses a line that only staff cross (e.g. access door line). Useful when there is no distinct staff zone but there is a staff-only door.

    1. Place a staff line at the staff entrance/exit

    2. Place a dummy activation zone anywhere (will be replaced)

    3. Add a Late count logic with the main entrance line + dummy zone as activation

    4. Edit as custom logic → replace zone condition with "Lines → Has crossed line" → select the staff line

    5. Delete the dummy zone

    Behaviour-based staff exclusion works on PF-L thanks to its wide coverage area — a single sensor can often cover both the customer entrance and the staff-only area simultaneously, making this method highly practical for smaller retail formats.

    clock

    7PM

    GMT+2

    clock

    7PM

    GMT+2

    clock

    7PM

    GMT+2

    Company-with-Circle-BG

    Who We Are

    Aliquam Dui Diam, Tincidunt Eget Nulla Eget, Dictum Feugiat Felis. Cras Mattis Eget Tellus Quis Fringilla. Morbi Molestie Enim

    Aliquam dui diam tincidunt eget nulla eget dictum feugiat felis.

    Sed dictum ligula luctus intum Vivamus.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Lorem ipsum dolor

    Sed quis massa leo. Quisque tristique tellus sit amet arcu tempor ultrices. Nulla ullamcorper.

    Become Our Supplier Or Partner

    Mauris tempor libero massa, at vulputate velit aliquet eget. Fusce et tortor ex. Nullam venenatis, quam vel blandit molestie.

    Banner