Milesight VS121-P User manual

AI Workplace
Occupancy Sensor
VS121-P
User Guide

2
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-2023 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: [e-mail]
Support Portal: support.milesight-iot.com
Tel: [phone]
Fax: [phone]
Address: Building C09, Software Park
Phase III, Xiamen 361024,
China

3
Revision History
Date
Doc Version
Description
March 15, 2023
V 1.0
Initial version

4
Contents
1. Product Introduction......................................................................................................................... 5
1.1 Overview ...................................................................................................................................5
1.2 Key Features ............................................................................................................................ 5
2. Hardware Introduction ...................................................................................................................... 5
2.1 Packing List ..............................................................................................................................5
2.2 Hardware Overview ................................................................................................................. 6
2.3 Reset Button and LED Indicator ..............................................................................................6
2.4 Dimensions (mm) .................................................................................................................... 6
3. Power Supply ..................................................................................................................................... 7
4. Access the Sensor .............................................................................................................................7
5. Operation Guide .................................................................................................................................9
5.1 Live Video .................................................................................................................................9
5.2 Network ..................................................................................................................................10
5.2.1 TCP/IP ......................................................................................................................... 10
5.2.2 RTSP ............................................................................................................................ 11
5.3 People Counting .................................................................................................................... 12
5.3.1 Region People Counting .............................................................................................12
5.3.2 Line Crossing Counting .............................................................................................. 15
5.3.3 Recognition Scheme .................................................................................................. 17
5.3.4 Privacy Mask ...............................................................................................................18
5.4 System ................................................................................................................................... 19
5.4.1 User ..............................................................................................................................19
5.4.2 System Info ................................................................................................................. 20
5.4.3 Date & Time .................................................................................................................20
5.4.4 Remote Management .................................................................................................21
5.4.5 System Maintenance ..................................................................................................22
5.4.6 Security Service .......................................................................................................... 23
5.4.7 About ........................................................................................................................... 23
6. Mount the Sensor ............................................................................................................................ 23
6.1 Recommended Height for Certain Object ............................................................................23
6.2 Illuminance Requirements for AI Analysis ...........................................................................24
6.3 Recommended Installation for Line Crossing Counting .....................................................24
6.4 Factors Affecting Accuracy .................................................................................................. 26
6.5 Ceiling Installation .................................................................................................................26
7. Report Content ................................................................................................................................ 26
7.1 Region People Counting ........................................................................................................26
7.2 Line Crossing Counting .........................................................................................................28

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
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 both people counting and occupancy 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 both normal mode, blur mode, and privacy mask for up to 8 regions
Support schedule detection
Support Milesight DeviceHub management
Adapt to more applications with rich industrial interfaces
Support transmitting people counting and occupancy data via HTTP Post
2. Hardware Introduction
2.1 Packing List
1 × VS121 Device
4 × Wall Mounting
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
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)

7
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
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);

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

9
5. Operation Guide
5.1 Live Video
After logging on to the device web GUI successfully, user is allowed to view live video as follows.

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

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

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

13
Parameters
Description
Enable
Enable or disable region people counting feature.
Number of People
Show current number of people.
Report Regularly
Report the current number of people according to reporting interval.
Reporting Interval: 5-3600 s, default: 300 s
Report by Result
Report according to the following changes of people number result:
Zero to Non-zero/Non-zero to Zero
Once result changes
HTTP Notification
Enable or disable to pop up the people counting data to specified HTTP URL.
HTTP Notification
URL
Select among “URL 1”, “URL 2” and “URL 3”.
Enable
Enable or disable to configure URL and Username/Password.
HTTP Method
Fixed as Post.
Snapshot
Enable or disable snapshot feature.

14
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
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: upload the occupancy status of per mapped region as 0 or 1.
Region People Counting: upload the specific number of people of per mapped
region. Note that the device allows to report the number in the 16 regions at
most.
Clear
Clear all areas you have drawn before.
Parameters
Description
Edit
Click Edit button to configure the time schedule.

15
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.
Reporting Interval
Report the count value of people in/out during the reporting interval, the
device will clean the previous values to re-count after reported, range: 5-3600
s, default: 300 s
Filter U-turns
When enabled, it allows to draw an area and he device will count the in and

16
out values only when people cross along this area.
HTTP Notification
Enable or disable to pop up the alarm news to specific HTTP URLs.
HTTP Notification
URL
Select among “URL 1”, “URL 2” and “URL 3”.
Enable
Enable or disable to configure URL, Username/Password.
HTTP Method
It’s fixed as Post.
Snapshot
Enable or disable snapshot feature.
Note: the option is only available for normal 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.
Set Detection Line
The device allows to set up only one line. For the detection line, crossing
along the direction of the arrow is “In” and the opposite is “Out”.
Clear Line
Clear the line you have drawn before.
Clear Area
Clear the are 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.

17
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 Recognition Scheme
You can select the recognition scheme for region people counting.

18
Parameters
Description
Recognition
Scheme
Select the recognition scheme 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. It is suggested to use Algorithm 2 first.
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.4 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.

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

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