VS121-P User Guide
AI Workplace Occupancy Sensor

Follow us: Linkedin/bmetersuk
B METERS UK | www.bmetersuk.com | Milesight

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

Revision History

Date	Doc Version	Description
March 15, 2023	V 1.0	Initial version
April 20, 2023	V 1.1	Add installation height of high ceiling mount version
July 15, 2023	V 1.2	1. Add people flow analysis feature; 2. Support MQTT/MQTTS transmission; 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.
April 2, 2024	V 1.3	1. Support region dwell time detection; 2. Support the cumulative number periodic report and trigger report of line cross counting; 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.

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 Platformmanagement
• Adapt to more applications with rich industrial interfaces
• High compatibility of data transmission via Ethernet port (HTTP/MQTT/HTTP API)

Hardware Introduction

2.1 Packing List

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 Default	Press and hold the reset button for more than 10 seconds.	Blink constantly.

2.4 Dimensions (mm)

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

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

Operation Guide

5.1 Live Video
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.
Start/Stop Recording	Click to Start Recording video, click again to Stop Recording. Note: this option is only available for normal privacy mode.
Windows Size & real size	Click to display images at a windows size.

5.2 Network
5.2.1 TCP/IP

Parameters	Description
IP Address	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	It is used to identify the subnet where the sensor is located.
IPv4 Default Gateway	The default router address.
Preferred DNS Server	The DNS Server translates the domain name to IP address.
IPv6 Mode	Select from “Manual”, “Router Advertisement” or “DHCPv6”.
IPv6 Address	IPv6 address used to identify the sensor on the network.
IPv6 Prefix	Define the prefix length of IPv6 address.
IPv6 Default Gateway	The default router IPv6 address.
MTU	Maximum transmission unit. The default value is 1500. Range: 1200~1500.

5.2.2 RTSP
RTSP is only available for Normal privacy mode.

Parameters	Description
RTSP Port	The port of RTSP, the default is 554.
RTP Packet	Select from “Better Compatibility” and “Better Performance”.
Multicast Group Address	Configure the address of multicast group.
QoS DSCP	The valid value range of the DSCP is 0-63.
RTSP URL
Stream	URL
Primary Stream	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.

Parameters	Description
Enable	Enable or disable region people counting feature.
Number of People	Show current number of people.
Dwell Time Detection	Enable or disable dwell time detection of objects within the area.
Min. Dwell Time(s)	Filter the count below this dwell time.
Report Regularly	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.
Periodic Report Scheme
Reporting Interval
Report by Result	Report according to the following changes of people number result: Zero to Non-zero/Non-zero to Zero Once result changes
Report Protocol	Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s) is optional.

Status	Show connection status from device to HTTP(s) server or MQTT broker.
MQTT/MQTTS	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(S)	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.
Overcrowding Alarm	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.
Trigger Type	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.
Trigger Threshold	The threshold people number to trigger the DO.
Reset Cumulative Count on Schedule	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.

Parameters	Description
Enable	Enable the detection area customization feature. If disabled, the whole area will be the detection area.
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.
Reporting Type	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	Clear all areas you have drawn before.
Delete	Select the area and click Delete to delete this area.

Parameters	Description
Edit	Click Edit button to configure the time schedule.
Reset	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.

Parameters	Description
Enable	Enable or disable line crossing counting feature.
Report Regularly	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.
Periodic Report Scheme
Reporting Interval
Trigger Report	Report immediately when there is a change of the line crossing people counting number.
Filter U-turns	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.
Filter Staff/Deliverer	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.
Report Protocol	Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s) is optional.
Status	Show connection status from device to HTTP(s) server or MQTT broker.
MQTT/MQTTS	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(S)	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.
Reset Cumulative Count on  Schedule	Enable to periodically reset cumulative line cross counting values on schedule.

Parameters	Description
Set Detection Line	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.

	Zoom up the live view to draw the line or area.
Clear Line	Clear the line you have drawn before.
Clear Area	Clear the area you have drawn before.

Parameters	Description
Edit	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 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.

Parameters	Description
Enable	Enable or disable people flow analysis feature.
Periodic Report Scheme	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.
Reporting Interval
Report Protocol	Select the protocol to send people counting data, MQTT, MQTTS or HTTP(s) optional.
Status	Show connection status from device to HTTP(s) server or MQTT broker.
MQTT/MQTTS	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(S)	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.

Parameters	Description
Set Detection Region	Customize a triangle or a convex quadrangle to count the people flow from one edge to another edge.
Name	Customize the edge name of the detection region.
	Zoom up the live view to draw the areas.
Clear	Clear the area you have drawn before.

Parameters	Description
Edit	Click Edit button to configure the time schedule.
Reset	Reset the time schedule to factory default.

5.3.4 General Settings

Parameters	Description
Realtime Location Push	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.
Data Retransmissi on Setting	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.
Recognition Scheme	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.
Image	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.

Parameters	Description
Enable	Check the checkbox to enable the Privacy Mask function.
Clear All	Clear all areas you drew before.
Type	Select the color for the privacy areas, there are two colors available: White and Black

5.4 System
5.4.1 User

Parameters	Description
Security Question	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.There are twelve default questions below, you can also customize the security questions.

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.

Parameters	Description
Current System Time	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.
NTP server	Synchronize the system time with 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 time	Synchronize the system time with the computer.

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.

Parameters	Description
Remote Management
Remote Management	Enable or disable to manage the device through Milesight platforms.
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 Method	Select activation method to connect the device to the DeviceHub server, the options are Authentication Code and Account.

IoT Development Platform

Remote Management Service	Enable to change the device settings via Milesight Development platform.
Auto Provisioning	Enable to receive and deploy the configurations from Milesight Development Platform after the device is connected to Internet.
Data Transfer Service	Report people counting data to Milesight Development platform.
Security Service
SSH	Enable or disable SSH access. The SSH port is fixed as 22.

5.4.5 SystemMaintenance

Parameters	Description
System Upgrade	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.
Maintenance	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.
Reboot	Restart the device immediately

5.4.6 Security Service

Parameters	Description
Enable SSH	Enable SSH feature.
SSH Port	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 Licenses button.

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
Standard Version	2.3m	2.6m*8.6m
	2.5m	3.2m*9.8m
	2.7m	4.2m*13.6m
	3m	4.8m*14m
	3.2m	5.2m*15.4m
	3.5m	6m*17m
	4m	6.8m*18.8m

High Ceiling Mount Version	5m	3.5m*10m
	6m	4.5m*12m
	7m	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.
• 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.
• 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.
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.

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,
“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″
//Period start time
//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],
“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],
“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
{
“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
}
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″,
“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
“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
}

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
}
}

Documents / Resources

Milesight VS121-P AI Occupancy Sensor [pdf] User Guide VS121-P, VS121-P AI Occupancy Sensor, AI Occupancy Sensor, Occupancy Sensor

References

• User Manual