Support : IoT Support
User Guide for Milesight models including: VS121-P AI Workplace Occupancy Sensor, VS121-P, AI Workplace Occupancy Sensor, Workplace Occupancy Sensor, Occupancy Sensor, Sensor
AI Workplace Occupancy Sensor - Type C - Tyrrell Products
File Info : application/pdf, 42 Pages, 1.90MB
DocumentDocumentAI Workplace Occupancy Sensor
VS121-P
User Guide
Safety Precautions
Milesight will not shoulder responsibility for any loss or damage resulting from not following the instructions of this operating guide. The device must not be disassembled or remodeled in any way. To avoid risk of fire and electric shock, do keep the product away from rain and moisture
before installation. Do not place the device where the temperature is below/above the operating range. Do not touch components which may be hot. The device must never be subjected to shocks or impacts. Make sure the device is firmly fixed when installing. Make sure the plug is firmly inserted into the power socket. Do not expose the device to where a laser beam equipment is used. Use a soft, dry cloth to clean the lens of the device. Stubborn stains can be removed using a
cloth dampened with a small quantity of detergent solution, then wipe them dry.
Declaration of Conformity
VS121-P is in conformity with the essential requirements and other relevant provisions of the CE, FCC, and RoHS.
Copyright © 2011-2024 Milesight. All rights reserved. All information in this guide is protected by copyright law. Whereby, no organization or individual shall copy or reproduce the whole or part of this user guide by any means without written authorization from Xiamen Milesight IoT Co., Ltd.
For assistance, please contact Milesight technical support: Email: iot.support@milesight.com Support Portal: support.milesight-iot.com Tel: 86-592-5085280 Fax: 86-592-5023065 Address: Building C09, Software Park
Phase III, Xiamen 361024, China
2
Revision History
Date March 15, 2023 April 20, 2023
July 15, 2023
April 2, 2024
Doc Version Description
V 1.0
Initial version
V 1.1
Add installation height of high ceiling mount version
1. Add people flow analysis feature;
2. Support MQTT/MQTTS transmission;
V 1.2
3. Add DO overcrowding alarm feature; 4. Add DI filer staff/deliverer feature;
5. Reporting interval range is extended to 5~86400s;
6. Adjust illuminance of region people counting.
1. Support region dwell time detection;
2. Support the cumulative number periodic report
and trigger report of line cross counting;
V 1.3
3. Support to reset cumulative count on schedule; 4. Support to report the data on the dot;
5. Compatible with Milesight Development Platform;
6. Support data retransmission;
7. Support realtime location pushment.
3
Contents
1. Product Introduction ......................................................................................................................... 6 1.1 Overview ...................................................................................................................................6 1.2 Key Features ............................................................................................................................ 6
2. Hardware Introduction ...................................................................................................................... 6 2.1 Packing List ..............................................................................................................................6 2.2 Hardware Overview ................................................................................................................. 7 2.3 Reset Button and LED Indicator ..............................................................................................7 2.4 Dimensions (mm) .................................................................................................................... 8
3. Power Supply ..................................................................................................................................... 8 4. Access the Sensor .............................................................................................................................8 5. Operation Guide ...............................................................................................................................10
5.1 Live Video ...............................................................................................................................10 5.2 Network .................................................................................................................................. 11
5.2.1 TCP/IP ......................................................................................................................... 11 5.2.2 RTSP ............................................................................................................................ 12 5.3 People Counting .................................................................................................................... 13 5.3.1 Region People Counting .............................................................................................13 5.3.2 Line Crossing Counting .............................................................................................. 17 5.3.3 People Flow Analysis ................................................................................................. 21 5.3.4 General Settings ......................................................................................................... 24 5.3.5 Privacy Mask ...............................................................................................................25 5.4 System ................................................................................................................................... 26 5.4.1 User ..............................................................................................................................26 5.4.2 System Info ................................................................................................................. 27 5.4.3 Date & Time .................................................................................................................27 5.4.4 Remote Management .................................................................................................28 5.4.5 System Maintenance ..................................................................................................29 5.4.6 Security Service .......................................................................................................... 30 5.4.7 About ........................................................................................................................... 31 6. Mount the Sensor ............................................................................................................................31 6.1 Recommended Height for Certain Object ............................................................................31 6.2 Illuminance Requirements for AI Analysis ...........................................................................31 6.3 Recommended Installation for Line Crossing Counting .....................................................32 6.4 Factors Affecting Accuracy .................................................................................................. 33 6.5 Ceiling Installation .................................................................................................................33 7. Communication Protocol ................................................................................................................34 7.1 Region People Counting - Periodic Report .......................................................................... 34 7.2 Region People Counting - Trigger Report ............................................................................ 36 7.3 Dwell Time Detection - Periodic Report ............................................................................... 37 7.4 Dwell Time Detection - Trigger Report ................................................................................. 39 7.5 Line Crossing Counting - Periodic Report ............................................................................40
4
7.6 Line Crossing Counting - Trigger Report ..............................................................................41 7.7 People Flow Analysis - Periodic Report ............................................................................... 42
5
1. Product Introduction
1.1 Overview
Milesight VS121 is an AI workplace sensor designed to monitor occupancy and utilization in modern workspace, which can reach up to 98% recognition rata based on AI algorithm. Besides, the precise data collection and multiple privacy-friendly modes make it more user-friendly.
With PoE transmission, VS121 is available for more applications. And it equips rich serial interfaces such as DI, DO and RS485 for various scenarios. VS121 supports data push via HTTP(s)/MQTT(s) for easily integration and allows for remote management via Milesight DeviceHub.
1.2 Key Features
Recognition rate of up to 98% based on the advanced AI identification and analysis technology and wide detection range
Support people counting, occupancy detection and dwell time detection Support up to 16 mapped regions for detection Allow for bi-direction line crossing people counting Support U-turn detection for effective data and precise detection Support people flow analysis to calculate the traffic from different directions Support both normal mode, blur mode, and privacy mask for up to 8 regions Support schedule detection and schedule cumulative counting reset Support Milesight DeviceHub and Milesight Development Platform management Adapt to more applications with rich industrial interfaces High compatibility of data transmission via Ethernet port (HTTP/MQTT/HTTP API)
2. Hardware Introduction 2.1 Packing List
1 × VS121-P Device
4 × Wall Screw Mount Kits
1 × Terminal Block
1 × Mounting Sticker
6
1 × Quick Start Guide
1 × Warranty Card
If any of the above items is missing or damaged, please contact your sales representative.
2.2 Hardware Overview
PIN RS485 DO DI Power
Description
1
---
---
--- DC 5V
Positive
2
---
---
--- GND
Negative
3
---
---
DI
Wet contact, low level: 0.5V, ---
high level: 3-5V
4
---
---
G
---
Ground
5
---
DO ---
Wet contact, support devices: ---
3.3V~12V, 500mA
6
--- COM ---
---
Common Ground
7
B
---
---
---
Receive Data
8
A
---
---
---
Transmit Data
2.3 Reset Button and LED Indicator
Function
Action
LED Indication
On/Off Status
Power on or off the device.
On: Device is on Off: Device is off
Reset to Factory Press and hold the reset button for more than 10
Blink constantly.
Default
seconds.
7
2.4 Dimensions (mm)
3. Power Supply
VS121-P can be powered by 802.3af standard PoE or DC 5V power adapter. Choose one of the following methods to power up the device. Powered by PoE Switch
Powered by PoE Injector
Powered by DC Power Adapter
4. Access the Sensor
VS121-P provides user-friendly web GUI for configuration and users can get access to it via Ethernet port. The recommended browsers are Chrome, Microsoft Edge, and Safari. The default Ethernet IP of the sensor is 192.168. 5.220 (can be found on the label). Step 1: Power on the device and connect the Ethernet port to a PC. Step 2: Change the IP address of computer to 192.168.5.0 segment as below:
a. Go to Start Control Panel Network and Internet Network and Sharing
8
Center Ethernet Properties Internet Protocol Version 4 (TCP/IPv4).
b. Enter an IP address that in the same segment with sensor ( e.g. 192.168.5.61, but please note that this IP address shall not conflict with the IP address on the existing network);
Step 3: Open the Browser and type 192.168.5.220 to get access to the GUI. Step 4: Select the language. Step 5: Users need to set the password and privacy mode when using the sensor for the first time. And, three security questions can also be set optionally. After configuration, use username (admin) and custom password to log in the sensor. Note: 1) Password must be 8 to 32 characters long, containing at least one number and one letter. 2) You can click the "forgot password" in login page to reset the password by answering three security questions when you forget the password, if you set the security questions in advance. 3) If you need to reset the privacy mode, hold on reset button for 10s to reset device to factory default.
9
5. Operation Guide 5.1 Live Video
10
After logging on to the device web GUI successfully, user is allowed to view live video as follows.
Parameters
Description
Click to access the configuration page.
People Counting (Region): show the mapped or non-mapped regions of people counting. Line Crossing Counting: show the detection line and counting people it detected. People Flow Analysis: show the detection area and people it detected.
Snapshot
Click to capture the current image. Note: this option is only available for normal privacy mode.
Click to Start Recording video, click again to Stop Recording. Note: this option is only available for normal privacy mode. Start/Stop Recording
Windows Size & real size
Click to display images at a windows size.
5.2 Network 5.2.1 TCP/IP
11
Parameters IP Address
Description An address that used to identify the sensor on the network.
Test
Click test button to test if the IP address is conflicting.
IPv4 Subnet Mask
IPv4 Default Gateway
Preferred DNS Server
IPv6 Mode
It is used to identify the subnet where the sensor is located. The default router address. The DNS Server translates the domain name to IP address. Select from "Manual", "Router Advertisement" or "DHCPv6".
IPv6 Address IPv6 address used to identify the sensor on the network.
IPv6 Prefix IPv6 Default
Gateway MTU
Define the prefix length of IPv6 address. The default router IPv6 address. Maximum transmission unit. The default value is 1500. Range: 1200~1500.
5.2.2 RTSP
RTSP is only available for Normal privacy mode.
12
Parameters RTSP Port RTP Packet Multicast Group Address QoS DSCP
RTSP URL Stream
Primary Stream
Description The port of RTSP, the default is 554. Select from "Better Compatibility" and "Better Performance". Configure the address of multicast group. The valid value range of the DSCP is 0-63.
URL rtsp://IP:RTSP Port/main
Note: DSCP refers to the Differentiated Service Code Point, the value of DSCP is used in the IP
header to indicate the priority of the data. A reboot is required for the settings to take effect.
5.3 People Counting 5.3.1 Region People Counting
Users can set the report settings and detection regions here.
13
Parameters Enable
Description Enable or disable region people counting feature.
Number of People Show current number of people.
Dwell Time Detection Min. Dwell Time(s) Report Regularly Periodic Report Scheme
Reporting Interval
Report by Result
Report Protocol
Enable or disable dwell time detection of objects within the area.
Filter the count below this dwell time. Select the periodic report of "On the Dot" or "From Now On". On the Dot: The device will report at the top of each hour. For example, When the interval is set to 1 hour, it will report at 0:00, 1:00, 2:00 and so on; when the interval is set to 10 minutes, it will report at 0:10, 0:20, 0:30, and so on. From Now On: Begin reporting from this moment onwards and regularly report based on the interval cycle. Report according to the following changes of people number result: Zero to Non-zero/Non-zero to Zero Once result changes Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s)
14
Status
MQTT/MQTTS
HTTP(S)
Overcrowding Alarm
Trigger Type Trigger Threshold Reset Cumulative
Count on Schedule
is optional. Show connection status from device to HTTP(s) server or MQTT broker. Host: MQTT broker address for receiving data. Port: MQTT broker port for receiving data. Client ID: the unique identity of the client to the server. It must be unique when all clients are connected to the same server, and it is the key to handle messages at QoS 1 and 2. Username: The username used for connecting to the MQTT broker. Password: The password used for connecting to the MQTT broker. Topic: Topic name used for publishing. QoS: QoS0, QoS1, and QoS2 are optional. Certificate Type: CA Signed Server or Self Signed is optional. CA signed server certificate: verify with the certificate issued by Certificate Authority (CA) that is pre-loaded on the device. Self signed certificates: upload the custom CA certificates, client certificates and secret key for verification. HTTP Notification URL: Select among "URL 1", "URL 2" and "URL 3". Enable: Enable to configure this URL. Connection Test: Click to send test message to URL to check connectivity. HTTP Method: Fixed as Post. Snapshot: Enable or disable the snapshot feature. Note: the option is only available for normal privacy mode. URL: The device will post the people counting data in json format to this URL. User Name: The username used for authentication. Password: The password used for authentication. When the number of people is over the trigger threshold, the DO and COM will be breaked, when the number is within the threshold, DO and COM be spliced. Select the trigger type. If there is not area, the trigger type is total people number of live view. Total number: total people number of all drawn areas. Number in area: the number of people in any one area. The threshold people number to trigger the DO. Enable to periodically reset cumulative count on schedule. Cumulative Count includes: Total In/Out counting of each detection region. Max./Avg. Dwell Time of each detection region.
15
Parameters Enable
Detection Area
Reporting Type
Clear All Delete
Description Enable the detection area customization feature. If disabled, the whole area will be the detection area. Select the customized area as either mapped or except mapped area. You can draw the area in the below screen. 16 regions can be set at most. Mapped Region: Only people who are in the mapped region will be detected. Non-mapped Region: Only people who are not in the mapped region will be detected. Note: when drawing the area, right click the mouse can make the area closed. When detection area is in Mapped Region type, users can select two reporting types: Occupancy: report the occupancy status of per mapped region. Region People Counting: report the specific number of people of per mapped region.
Zoom up the live view to draw the areas.
Clear all areas you have drawn before. Select the area and click Delete to delete this area.
16
Parameters Edit Reset
Description Click Edit button to configure the time schedule. Reset the time schedule to factory default.
5.3.2 Line Crossing Counting
The sensor will count the number of people who cross a defined virtual line, then upload the counting data according to the reporting interval.
17
Parameters Enable
Report Regularly Periodic Report
Scheme Reporting Interval
Trigger Report Filter U-turns
Filter Staff/Deliverer Report Protocol
Status
MQTT/MQTTS
Description
Enable or disable line crossing counting feature.
Select the periodic report of "On the Dot" or "From Now On". On the Dot: The device will report at the top of each hour. For example, When the interval is set to 1 hour, it will report at 0:00, 1:00, 2:00 and so on; when the interval is set to 10 minutes, it will report at 0:10, 0:20, 0:30, and so on. From Now On: Begin reporting from this moment onwards and regularly report based on the interval cycle. Report immediately when there is a change of the line crossing people counting number. When enabled, it allows to draw an area and he device will count the in and out values only when people cross along this area. A physical button should be set at the entrance, and the button signal should be inputted into the device via DI interface to realize collaboration. The next one count will be discarded in 8 seconds once a signal is detected via DI. Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s) is optional. Show connection status from device to HTTP(s) server or MQTT broker. Host: MQTT broker address for receiving data. Port: MQTT broker port for receiving data. Client ID: the unique identity of the client to the server. It must be unique when all clients are connected to the same server, and it is the key to handle messages at QoS 1 and 2. Username: The username used for connecting to the MQTT broker. Password: The password used for connecting to the MQTT broker. Topic: Topic name used for publishing.
18
HTTP(S)
Reset Cumulative Count on Schedule
QoS: QoS0, QoS1, and QoS2 are optional. Certificate Type: CA Signed Server or Self Signed is optional. CA signed server certificate: verify with the certificate issued by Certificate Authority (CA) that is pre-loaded on the device. Self signed certificates: upload the custom CA certificates, client certificates and secret key for verification. HTTP Notification URL: Select among "URL 1", "URL 2" and "URL 3". Enable: Enable to configure this URL. Connection Test: Click to send test message to URL to check connectivity. HTTP Method: Fixed as Post. Snapshot: Enable or disable the snapshot feature. Note: the option is only available for normal privacy mode. URL: The device will post the people counting data in json format to this URL. User Name: The username used for authentication. Password: The password used for authentication.
Enable to periodically reset cumulative line cross counting values on schedule.
Parameters Set Detection Line
Description The device allows to set up only one line with at most 4 segments. For the detection line, crossing along the direction of the arrow is "In" and the opposite is "Out". When drawing, left-click to start drawing and drag the mouse to draw a line, left-click again to continue drawing the other segment and right-click the mouse to complete the drawing.
19
Clear Line Clear Area
Zoom up the live view to draw the line or area.
Clear the line you have drawn before. Clear the area you have drawn before.
Parameters Edit
Description Click Edit button to configure the time schedule.
Reset
Reset the time schedule to factory default.
Note: 1) The arrow direction of the detection line depends on your drawing direction.
2) Ensure that the detected target can pass through the detection line completely. It's 20
recommended that the detection line is perpendicular to the In/Out direction and on the center of detection area without other objects around.
3) A redundant identification area needed to be left on both sides of the detection line for the target. This is to ensure that the sensor has stable recognition and tracking of this target before it passes the detection line, which will make the detection and count more accurate.
5.3.3 People Flow Analysis
The sensor will count the number of people cross different directions, then upload the counting data according to the reporting interval.
21
Parameters Enable
Periodic Report Scheme
Reporting Interval Report Protocol
Status
MQTT/MQTTS
HTTP(S)
Description
Enable or disable people flow analysis feature.
Select the periodic report of "On the Dot" or "From Now On". On the Dot: The device will report at the top of each hour. For example, When the interval is set to 1 hour, it will report at 0:00, 1:00, 2:00 and so on; when the interval is set to 10 minutes, it will report at 0:10, 0:20, 0:30, and so on. From Now On: Begin reporting from this moment onwards and regularly report based on the interval cycle. Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s) optional. Show connection status from device to HTTP(s) server or MQTT broker. Host: MQTT broker address for receiving data. Port: MQTT broker port for receiving data. Client ID: the unique identity of the client to the server. It must be unique when all clients are connected to the same server, and it is the key to handle messages at QoS 1 and 2. Username: The username used for connecting to the MQTT broker. Password: The password used for connecting to the MQTT broker. Topic: Topic name used for publishing. QoS: QoS0, QoS1, and QoS2 are optional. Certificate Type: CA Signed Server or Self Signed is optional. CA signed server certificate: verify with the certificate issued by Certificate Authority (CA) that is pre-loaded on the device. Self signed certificates: upload the custom CA certificates, client certificates and secret key for verification. HTTP Notification URL: Select among "URL 1", "URL 2" and "URL 3".
22
Enable: Enable to configure this URL. Connection Test: Click to send test message to URL to check connectivity. HTTP Method: Fixed as Post. Snapshot: Enable or disable the snapshot feature. Note: the option is only available for normal privacy mode. URL: The device will post the people counting data in json format to this URL. User Name: The username used for authentication. Password: The password used for authentication.
Parameters Set Detection
Region Name
Clear
Description Customize a triangle or a convex quadrangle to count the people flow from one edge to another edge. Customize the edge name of the detection region.
Zoom up the live view to draw the areas.
Clear the area you have drawn before.
23
Parameters Edit Reset
Description Click Edit button to configure the time schedule. Reset the time schedule to factory default.
5.3.4 General Settings
24
Parameters Realtime Location Push Data
Retransmissi on Setting
Recognition Scheme
Image
Description Work as a TCP server to push the realtime location information of people to TCP clients. Note: the TCP port should be different from other used service ports. Enable to resend stored data packets from the disconnected period when the device's network connection is restored. Every recipient can receive 1,000 pieces of data at most (totally 3,000 pieces). This only works with the trigger report and periodic report of region people counting, line cross counting or people flow analysis without snapshot information. Select the recognition scheme of region people counting based on your detection environment. Algorithm 1: Suitable for monitoring complex environments which have many objects, like office supplies (books, printers, lamps, etc.) Algorithm 2: Suitable for monitoring simple and clean environments like meeting rooms. Power Line Frequency: Select based on your power source frequency standard, 60 Hz and 50 Hz are available. Wide Dynamic Range: This function which can capture and display both bright and dark areas in the same frame that enables details of objects in both bright and dark areas to be visible. It's recommended to enable this function when the scene has a clear contrast between light and dark (such as a corridor).
5.3.5 Privacy Mask
Privacy mask enables to cover certain areas on the live video to prevent certain spots in the surveillance area from being viewed and prevent people within the area from being counted. You can set 8 mask areas at most.
25
Parameters
Description
Enable Check the checkbox to enable the Privacy Mask function.
Clear All Type
Clear all areas you drew before. Select the color for the privacy areas, there are two colors available: White and Black
5.4 System 5.4.1 User
Parameters
Description Click Edit button to set three security questions for your device. In case that you forget the password, you can click Forget Password button on login page to reset the password by answering three security questions correctly.
Security Question
There are twelve default questions below, you can also customize the security questions.
26
Account Management
Admin Password: enter the correct admin password before adding an account. User Level: It's fixed as Administrator. User Name: It's fixed as admin. New Password: Input password for the account. Confirm: Confirm the password.
5.4.2 System Info
All information about the hardware and software can be checked on this page.
5.4.3 Date & Time
Here you can check and set the system time.
27
Parameters Current System Time
Description Current date & time of the system.
Time Zone
Select a time zone according to your location.
Daylight Saving Time Enable or disable the daylight saving time.
Synchronize the system time with NTP server.
NTP server
Server Address: Setup the address of NTP server.
NTP Sync: Update the time according to the interval time regularly.
Manual
Set the system time manually.
Synchronize with computer Synchronize the system time with the computer.
time
5.4.4 Remote Management
Milesight provides remote management service for this device via Milesight DeviceHub platform or Milesight Development Platform. Before connecting, do ensure that the device has been connected to the network via Ethernet port, and there is seamless Internet connection.
28
Parameters
Description
Remote Management
Remote Enable or disable to manage the device through Milesight platforms.
Management
Platform
DeviceHub or IoT Development Platform is optional.
Status
Show the connection status between the device and the platform.
DeviceHub
Server Address IP address or domain of the DeviceHub management server.
Activation Select activation method to connect the device to the DeviceHub server,
Method
the options are Authentication Code and Account.
IoT Development Platform
Remote
Management Enable to change the device settings via Milesight Development platform.
Service
Auto
Enable to receive and deploy the configurations from Milesight
Provisioning Development Platform after the device is connected to Internet.
Data Transfer Report people counting data to Milesight Development platform.
Service
Security Service
SSH
Enable or disable SSH access. The SSH port is fixed as 22.
5.4.5 System Maintenance
29
Parameters System Upgrade
Maintenance
Reboot
Description
Software Version: The software version of the sensor. Local Upgrade: Click the Choose File button and select the upgrading file, then click the Upgrade button to upgrade. After the system reboots successfully, the update is done. You can check Reset after Upgrading to reset the device after upgrading it. Note: Do not disconnect the power of the device during the upgrade process. The device will be restarted to complete the upgrading. Reset settings: Click Reset button to reset the device to factory default settings Keep the IP Configuration: Check the option to keep the IP information when resetting Keep the User Information: Check this option to keep the user information when resetting Export Config File: Export configuration file. Import Config File: Click the Choose File button and select the configuration file, click Import button to import configuration file. Restart the device immediately
5.4.6 Security Service
30
Parameters Enable SSH
SSH Port
Description Enable SSH feature. Set the port to access this sensor via SSH.
5.4.7 About
User can view some open source software licenses about the sensor by clicking the View Licens es button.
6. Mount the Sensor
To better utilize the advantages of AI algorithm, there are some important steps to follow :
6.1 Recommended Height for Certain Object
Object
Height
Note
sitting object
>2.5m (8.2ft)
Commonly used for Region People Counting
standing object
>3m (9.8ft) (the optimum height is 3m)
Commonly used for Line Crossing Counting and People Flow Analysis
Recommended detection ranges for region people counting and people flow analysis at different
heights:
Version
Height
Recommended detection range
2.5m
3m*4m
Standard
3m
4.4m*5.7m
Version
3.5m
4.9m*6.4m
4m
5.6m*7.4m
5m High Ceiling
6m Mount Version
7m
3.5m*10m 4.5m*12m 5.5m*14m
6.2 Illuminance Requirements for AI Analysis
Region People Counting We recommend that the illuminance is greater than 20Lux. We recommend enabling WDR function, which will make the image effect better.
31
Line Crossing Counting and People Flow Analysis We recommend that the illuminance is greater than 50Lux. When the illuminance is between 20~50Lux, we recommend disabling WDR function. When the illuminance is >50Lux and the scene has a clear contrast between light and dark
(such as a corridor), we recommend enabling WDR function. To know the illuminance of the current scene, you must use an illuminance meter, or you can refer to the following common environmental illuminance values:
place/environment
illuminance
Indoors at dusk
10Lux
cloudy indoor
5~50Lux
sunny indoor
100~1000Lux
6.3 Recommended Installation for Line Crossing Counting
Make sure the sensor is facing straight down, in line with the ceiling.
Make sure there is sufficient white light on site.
Avoid getting very strong light, like sunlight.
32
Make sure there are no moving objects interfering in the counting area. For example, do not install the sensor too close to a door.
Avoid installing the sensor near a mirror or avoid drawing the line to the mirror.
6.4 Factors Affecting Accuracy
The color of hair or clothes is close to the floor color. Reason: It will make it difficult for the algorithm to identify the correct object, thus affecting the accuracy. The floor color and wall color are black. Reason: The brightness of the scene will be reduced due to the absorption of light by black. The contrast between light and dark in the scene is too strong. Reason: It will cause the people to be backlight, which will affect the accuracy of the detection.
6.5 Ceiling Installation
Step 1: Ensure the thickness of ceiling is more than 30 mm, then attach the mounting sticker to the ceiling and drill 4 holes with a diameter of 6 mm.
33
Step 2: Fix the wall plugs into the ceiling holes. Step 3: Remove the cover on the device, then fix the device to the wall plugs via mounting screws; remember to adjust the mounting direction according to the detection area requirement and direction sticker on the inner cover. Step 4: Take the cover back to device; note that the Milesight Logo should be facing the LED indicator.
7. Communication Protocol
VS121-P will post the people counting data in json format to HTTP URL or MQTT broker.
7.1 Region People Counting - Periodic Report
Occupancy Status
{ "event":"Region People Counting", "report_type": "interval", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "timezone" : "UTC+8:00", "dst_status":false,
34
"start_time":"2022/12/20 18:15:52", //Period start time
"end_time":"2022/12/20 19:15:52" //Period end time
},
"current_total":10,
"max_counted":12,//Maximum number of people during the reporting interval
"total_mapped_regions":2,
"numbering_regions":[1,2],
"occupancy":[1,0]
"snapshot":
"/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image
code)"
//HTTP Post only
}
Region People Counting
{ "event":"Region People Counting", "report_type": "interval", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "timezone" : "UTC+8:00", "dst_status":false, "start_time":"2022/12/20 18:15:52", "end_time":"2022/12/20 19:15:52" }, "current_total":10,
//Period start time //Period end time
35
"Max_counted":12, //Maximum number of people during the reporting interval "total_mapped_regions":2, "numbering_regions":[1,2], "current_counted":[5,5] "snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only }
7.2 Region People Counting - Trigger Report
Occupancy Status
{ "event":"Region People Counting", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "time":2022/12/20 18:15:52", "timezone" : "UTC+8:00", "dst_status":false }," report_type": "trigger", "current_total":10, "total_mapped_regions":2, "numbering_regions":[1,2], "occupancy":[1,0],
36
"snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only }
Region People Counting
{ "event":"Region People Counting", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "time":2022/12/20 18:15:52", "timezone" : "UTC+8:00", "dst_status":false }, "report_type": "trigger", "current_total":10, "total_mapped_regions":2, "numbering_regions":[1,2], "current_counted":[5,5] "snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only }
7.3 Dwell Time Detection - Periodic Report
{
37
"event":"Dwell Time Detection",
"report_type": "interval",
"device_info":{
"device":"Workplace Sensor",
"device_sn":"369362028335",
"device_mac":"00:16:28:FA:8E:68",
"ip_address":"192.168.0.99"
},
"time_info":{
"timezone" : "UTC+8:00",
"dst_status":false,
"start_time":"2022/12/20 18:15:52",
//Period start time
"end_time":"2022/12/20 19:15:52"
//Period end time
},
"dwell_time_data":[
{
"region":1,
"max_dwell_time":156464,
//unit: s
"avg_dwell_time": 156464
//unit: s
},
{
"region":2,
"max_dwell_time":156464,
//unit: s
"avg_dwell_time": 156464
//unit: s
}
]
"snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only
}
38
7.4 Dwell Time Detection - Trigger Report
{ "event":"Dwell Time Detection", "report_type": "trigger", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "time":2022/12/20 18:15:52", "timezone" : "UTC+8:00", "dst_status":false }, }, "dwell_time_data":[ { "region":1, "people_id":1, "dwell_start_time":"2022-12-20T18:15:52+03:00", "dwell_end_time":"2022-12-20T19:15:52+03:00" , "duration":5646 //Unit: ms }, { "region":2, "people_id":2, "dwell_start_time":"2022-12-20T17:15:52+03:00", "dwell_end_time":"2022-12-20T19:15:52+03:00",
39
"duration":5646 //Unit: ms } ] "snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only }
7.5 Line Crossing Counting - Periodic Report
{
"event":"Line Crossing Counting",
"report_type": "interval",
"device_info":{
"device":"Workplace Sensor",
"device_sn":"369362028335",
"device_mac":"00:16:28:FA:8E:68",
"ip_address":"192.168.0.99"
},
"time_info":{
"timezone" : "UTC+8:00",
"dst_status":false,
"start_time":"2022/12/20 18:15:52",
//Period start time
"end_time":"2022/12/20 19:15:52"
//Period end time
},
"in_counted":10,
//Periodic in
"out_counted":10,
//Periodic out
"capacity_counted":0,
//=in_counted-out_counted
"total_data":{
"in_cumulative_counted":10,
//Cumulative in
"out_cumulative_counted":10,
//Cumulative out
40
"capacity_cumulative_counted":0
//=in_cumulative_counted-out_cumulative_counted
}
"snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only
}
7.6 Line Crossing Counting - Trigger Report
{ "event":"Line Crossing Counting", "report_type": "trigger", "device_info":{ "device":"Workplace Sensor", "device_sn":"369362028335", "device_mac":"00:16:28:FA:8E:68", "ip_address":"192.168.0.99" }, "time_info":{ "time":2022/12/20 18:15:52", "timezone" : "UTC+8:00", "dst_status":false }, "line_trigger_data":{ "in":1, "out":0 } "snapshot": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wDFABALDA4MChAODQ4SERATGCgaGBY...(Image code)" //HTTP Post only }
41
7.7 People Flow Analysis - Periodic Report
{
"event":"People Flow Analysis",
"report_type": "interval",
"device_info":{
"device":"Workplace Sensor",
"device_sn":"369362028335",
"device_mac":"00:16:28:FA:8E:68",
"ip_address":"192.168.0.99"
},
"time_info":{
"timezone" : "UTC+8:00",
"dst_status":false,
"start_time":"2022/12/20 18:15:52", //Period start time
"end_time":"2022/12/20 19:15:52"
//Period end time
},
"flow_data":{
"A-A":10, //Number of people from A to A
"A-B":10, //Number of people from A to B
"A-C":10,
"A-D":10,
"B-A":10,
"B-B":10,
"B-C":10,
"B-D":10,
"C-A":10,
"C-B":10,
"C-C":10,
"C-D":10,
"D-A":10,
"D-B":10,
"D-C":10,
"D-D":10
}
}
-END-
42