Milesight VS121 User manual

AI Workplace
Occupancy Sensor
Featuring LoRaWAN®
VS121
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 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
Apr. 26, 2021
V 1.0
Initial version
Jan. 18, 2022
V 1.1
1. Support line crossing counting feature;
2. Support D2D feature;
3. Support people counting debounce;
4. Support uploading max number of people;
5. Support downlink control.
Apr. 8, 2022
V 1.2
1. Milesight LOGO update;
2. Support recognition scheme selection.
June 20, 2022
V 1.3
1. Update web GUI menu;
2. Support customize people counting detection
area to 16 regions;
3. Add recommended installation guide and line
drawing note.
Dec. 14, 2022
V 1.4
1. Support per region people counting uplinks
2. Add private mask feature
3. Add LoRaWAN single channel mode
4. Add Wi-Fi SSID broadcast option
5. Delete Auto Reboot, the LoRaWAN V1.1.0
option
6. Support live view blur process and delete
Image Config
Mar. 9, 2023
V1.5
1. Add privacy mode under activation page
2. Support filter U-turns feature
Apr. 20, 2023
V1.6
Add installation height of high ceiling mount
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 Buttons and LED Indicators .................................................................................................... 6
2.4 Dimensions (mm) .................................................................................................................... 6
3. Access the Sensor .............................................................................................................................7
3.1 Access without Plugin .............................................................................................................7
3.2 Access with Plugin .................................................................................................................. 8
4. Operation Guide ...............................................................................................................................10
4.1 Live Video ...............................................................................................................................10
4.2 IoT-People Counting ..............................................................................................................11
4.2.1 Region People Counting .............................................................................................11
4.2.2 Line Crossing Counting .............................................................................................. 12
4.2.3 Recognition Scheme .................................................................................................. 13
4.2.4 Privacy Mask ...............................................................................................................14
4.3 IoT-Communication ...............................................................................................................15
4.3.1 LoRaWAN .................................................................................................................... 15
4.3.2 Milesight D2D ..............................................................................................................17
4.3.3 Wi-Fi ............................................................................................................................. 17
4.4 System ................................................................................................................................... 19
5. Mount the Sensor ............................................................................................................................ 22
5.1 Recommended Height for Certain Object ............................................................................22
5.2 Illuminance Requirements for AI Analysis ...........................................................................23
5.3 Recommended Installation for Line Crossing Counting .....................................................23
5.4 Factors Affecting Accuracy .................................................................................................. 24
5.5 Ceiling Installation .................................................................................................................24
6. Device Payload ................................................................................................................................ 25
6.1 Uplink Data .............................................................................................................................25
6.2 Downlink Command .............................................................................................................. 27

5
1. Product Introduction
1.1 Overview
VS121, based on Artificial Intelligence (AI) technology, is an AI workplace sensor designed to mo
nitor occupancy & utilization in modern workspace, which can reach up to 98% recognition rate.
Only counter values are transmitted over LoRaWAN®network to prevent privacy concerns.
VS121to prevent the privacy concerns. VS121 is equipped with Wi-Fi for easy configuration with
out any tools.
Sensor data are transmitted in real-time using standard LoRaWAN®protocol. LoRaWAN®
enables encrypted radio transmissions over long distance while consuming very little power. The
user can obtain sensor data and view the trend of data change through the user’s own network
server.
1.2 Key Features
Recognition rate is up to 98% based on advanced AI identification and analysis technology
and wide detection range
Support to map up to 16 custom regions
No image data is collected, free from privacy concerns
Equipped with Wi-Fi for web GUI configuration
Function well with standard LoRaWAN®gateways and network servers
2. Hardware Introduction
2.1 Packing List
1 × VS121 Device
4 × Wall Mounting
Kits
1 ×
Type-C Cable (1 m) &
Power Adapter
1 ×
Mounting Sticker

6
1 ×
Warranty Card
1 ×
Quick Guide
If any of the above items is missing or damaged, please contact your sales representative.
2.2 Hardware Overview
2.3 Buttons and LED Indicators
Function
Action
LED Indication
Turn On/Off Wi-Fi
Press and hold the Wi-Fi button for more than 3 seconds.
Off →On
Press and hold the Wi-Fi button for more than 3 seconds.
On →Off
Reset to Factory
Default
Press and hold the reset button for more than 10
seconds.
Blinks 6 times.
2.4 Dimensions (mm)

7
3. Access the Sensor
VS121 sensor provides user-friendly web GUI for configuration and users can access it via Wi-Fi
connection. The recommended browsers are Internet Explorer, Firefox, Chrome, Microsoft Edge,
Safari. The default IP of sensor is 192.168.1.1, and default SSID is Workplace Sensor_XXXXXX
(can be found on the label).
3.1 Access without Plugin
Step 1: Power on the device.
Step 2: Enable the Wireless Network Connection on your computer and search for corresponding
access point, then connect computer to this access point.
Step 3: Open the Browser and type 192.168.1.1 to access the web 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.

8
3.2 Access with Plugin
For IE browser access, users need to install the MsActiveX firstly. You can refer the steps as
follows:
Step1: Launch the IE browser and enter the IP address of the sensor;
Step2: Enter the user name and custom password and click “Login”;
Step3: At the first time to log in the device, the browser will prompt to install Controls, please
click “Click here to download and install controls manually” as shown below;
Note：During installing the controls, please keep the browsers close.
Step4: Follow the prompts to install the Controls, when it`s finished, it will pop out a window as
shown below. Please click “Finish” and refresh the browser, then you will see the video.

9
If IE9 or higher version browser is used, it is suggested that the web link should be added as a
trusted site. See the instructions as follows:
Step1: Start the IE9 or higher version browser, and select “Tools”“Internet Options”;
Step2: Select “Security” to “Trusted”;
Step3: Enter the IP address of the device in the blank and click “Add”;

10
Step4: Enter the IP address. After logging on web GUI successfully, user is allowed to view live
video.
4. Operation Guide
4.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

11
4.2 IoT-People Counting
4.2.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.
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
Debounce Time
VS121 will reduce the count value only when the people come out of the
detection area for more than 2 s.
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

12
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 only allows to report the number in the first 8
regions.
Clear
Clear all areas you have drawn before.
4.2.2 Line Crossing Counting
The sensor will count the number of people who crossed a defined virtual line, then upload the
count value 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
out values only when people cross along this area.
Set Detection Line
The device allows to set up only one line. For the detection line, crossing
along the direction of the arrow means “In” and the opposite is “Out”.
Clear Line
Clear the line you have drawn before.
Clear Area
Clear the area you have drawn before.

13
Note:
1) The arrow direction of the detection line depends on your drawing direction.
2) Ensure that the detected targets 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.
4.2.3 Recognition Scheme
You can select the recognition scheme for region people counting.

14
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).
4.2.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.

15
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
4.3 IoT-Communication
4.3.1 LoRaWAN
LoRaWAN settings is used for configuring the transmission parameters in LoRaWAN®network.
Parameters
Description
Status
LoRaWAN®network status of this device.
Basic Settings
Device EUI
Unique ID of the device which can also be found on the label.
App EUI
Default App EUI is 24E124C0002A0001.

16
Join Type
OTAA and ABP mode are available.
Application Key
Appkey for OTAA mode, default is 5572404C696E6B4C6F52613230313823.
Device Address
DevAddr for ABP mode, default is the 5th to 12th digits of SN.
Network Session
Key
Nwkskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
Application
Session Key
Appskey for ABP mode, default is 5572404C696E6B4C6F52613230313823.
RX2 Data Rate
RX2 data rate to receive downlinks or send D2D command.
RX2
Frequency/MHz
RX2 frequency to receive downlinks or send D2D command.
Advanced Settings
Confirmed Mode
If the device does not receive ACK packet from network server, it will resend
data once.
ADR Mode
Allow network server to adjust data rate of the device.
Rejoin Mode
The device will send a specific number of LinkCheckReq MAC packets to the
network server every 30 mins to validate connectivity; If there is no response,
the device will re-join the network.
Application Port
The port used for sending and receiving data, default port is 85.
Spreading Factor
If ADR is disabled, the device will send data via this spreading factor.
LoRaWAN Version
V1.0.2 and V1.0.3 are available.
Region
Frequency plan of this device.
Single-channel
Mode
When enabled, only one channel can be selected to send uplinks. Please
enable this mode if you connect device to DS7610.
Channel
Enter the index to select the frequency channel.
Examples:
1, 40: Enabling Channel 1 and Channel 40
1-40: Enabling Channel 1 to Channel 40
1-40, 60: Enabling Channel 1 to Channel 40 and Channel 60
All: Enabling all channels
Null: Indicates that all channels are disabled
Note:
1) Please contact sales for device EUI list if there are many units.
2) Please contact sales if you need random App keys before purchasing.
3) Only OTAA mode supports rejoin mode.

17
4.3.2 Milesight D2D
Milesight D2D protocol is used for setting up transmission among Milesight LoRaWAN®devices
without gateway. When the Milesight D2D setting is enabled, VS121 can work as a Milesight D2D
controller for sending control commands to trigger D2D agent devices.
Parameters
Description
Enable D2D
Enable or disable D2D feature.
D2D Key
Define a unique D2D key and this key is the same as the setting in D2D agent
device. Default value: 5572404C696E6B4C6F52613230313823
Condition
Occupied: when total people counter value is non-zero in detection area
Vacant: when total people counter value is 0 in detection area
Control
Command
Define a 2-byte hexadecimal control command (0x0000 to 0xffff). When the
condition is meet, the device will send the control command to corresponding
D2D agent devices.
Intelligent Delay
Time (s)
The device will send the control command only when the detected condition
remains Vacant (number of people =0) during this delay time.
Note: When this feature is enabled, the control command from this device will not send to
LoRaWAN®gateway.
4.3.3 Wi-Fi

18
Parameters
Description
Enabled
Enable Wi-Fi feature.
Work Mode
Work mode is fixed as AP and can not connect to other access point.
SSID
The unique name for this device Wi-Fi access point.
SSID
Broadcast
When disabled, other wireless devices can't find the SSID, and users should
enter the SSID manually to get access to the wireless network.
Protocol
802.11b (2.4 GHz), 802.11g (2.4 GHz), 802.11n (2.4 GHz) are optional.
Bandwidth
20 MHz or 40 MHz are optional.
Channel
Select the wireless channel. Auto, 1,...11 are optional.
Security Mode
No Encryption, WEP Open System, WEP Shared Key, WPA-PSK, WPA2-PSK
and WPA-PSK/WPA2-PSK are optional.
DHCP Server
Settings
LAN IP Address: IP address that used to access the web GUI of sensor.
Subnet mask: identify the subnet where the sensor is located.

19
Start Address: define the beginning of IP address pool which assigns to DHCP
clients.
End Address: define the end of IP address pool which assigns to DHCP clients.
Lease Time (min): the lease time on which DHCP client can use the IP address
assigned by the sensor.
Primary DNS Server: translate the domain name to IP address.
Secondary DNS Server: backup DNS server.
Static IP
Settings
Add MAC address and static IP address if users need to add a static IP address
to a specific computer.
4.4 System
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.

20
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.
Security Service
Parameters
Description
Enable SSH
Enable SSH feature.
SSH Port
Set the port to access this sensor via SSH.