Milesight VS121 User manual

AI Workplace 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-2022 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]
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 LoRa D2D feature;
3. Support people counting debounce;
4. Support uploading max number of people;
5. Support downlink control.

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...................................................................................................................................... 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................................................................................................................................................... 11
4.2.1 Region People Counting...................................................................................................11
4.2.2 Line Crossing Counting....................................................................................................12
4.2.3 LoRa.................................................................................................................................... 13
4.2.4 Wi-Fi.....................................................................................................................................15
4.3 Advanced Settings....................................................................................................................... 17
4.3.1 Security............................................................................................................................... 17
4.3.2 Logs.....................................................................................................................................18
4.4 System............................................................................................................................................19
4.5 Maintenance..................................................................................................................................19
4.5.1 System Maintenance........................................................................................................19
4.5.2 Auto Reboot....................................................................................................................... 20
5. Installation............................................................................................................................................... 21
6. Device Payload........................................................................................................................................21
6.1 Uplink Data.....................................................................................................................................22
6.2 Downlink Command.....................................................................................................................23

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 95% recognition rate.
With the ability to sense from up to 78m2, fewer sensors are needed to cover the same area, dec
reasing the deploy costs for users. Only counter values are transmitted over LoRaWAN®network
to prevent the privacy concerns. VS121 is equipped with Wi-Fi for easy configuration without 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 95% based on advanced AI identification and analysis technology
and wide detection range
Support to map up to 12 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 Vision 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 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, contains 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.
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”;

9
Step2: Select “Security” to “Trusted”;
Step3: Enter the IP address of the device in the blank and click “Add”;
Step4: Enter the IP address. After logging on web GUI successfully, user is allowed to view live
video.

10
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
Image Config
Brightness: Adjust the Brightness of the scene
Contrast: Adjust the color and light contrast
Saturation: Adjust the Saturation of the image. Higher Saturation makes
colors appear more "pure" while lower one appears more “wash-out”
Sharpness: Adjust the Sharpness of image. Higher Sharpness sharps the
pixel boundary and makes the image looks “more clear”
2D DNR/3D DNR: Adjust the noise reduction level
Default: Restore brightness, contrast and saturation to default settings
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 people it detected
Hide Detection Region: hide people detection region
Window size
Click to display images at a window size
Real size
Click to display images at a real size

11
Full Screen
Click to display images at full-screen
/
Start/Stop live view
Enable Digital Zoom
When enabled, you can zoom in in a specific area of video image with
your mouse wheel
4.2 IoT
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-3600s, default: 300 s
Report by Result
Report according to following people number results:
Zero and Non-zero
Once result changes
Debounce Time
VS121 will reduce the count value only the people come out of the detection
area for more than 2 s.

12
Enable
Enable the detection area customization feature. If disabled, the whole area
will be detection area.
Detection Area
Select the customized area as either mapped or except mapped area. You can
draw the area in the below screen. 12 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.
Clear
Clear all areas you have drawn before.
4.2.2 Line Crossing Counting
When the sensor detected the people crossing a defined virtual line, it will upload the counting.
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
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 opposite is “Out”.
Clear
Clear the line you have drawn before.

13
Note: the arrow direction of the detection line depends on the direction of your draw.
4.2.3 LoRa
LoRa settings is used for configuring the transmission parameters in LoRaWAN®network or
LoRa D2D network.
4.2.3.1 Basic Settings
Parameters
Description
Status
LoRaWAN®network status of this device.
Device EUI
Unique ID of the device which can also be found on the label.
App EUI
Default App EUI is 24E124C0002A0001.
Join Type
OTAA and ABP mode are available.

14
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 LoRa D2D command.
RX2
Frequency/MHz
RX2 frequency to receive downlinks or send LoRa D2D command.
Confirmed Mode
If the device does not receive ACK packet from network server, it will resend
data 3 times at most.
ADR Mode
Allow network server to adjust data rate of the device.
Rejoin Mode
Reporting interval ≤ 30 mins: the device will send specific mounts of LoRa
MAC packets to check connection status every 30 mins; If no reply after
specific packets, the device will re-join.
Reporting interval > 30 mins: the device will send specific mounts of
LoRaMAC packets every to check connection status every reporting interval;
If no reply after specific packets, the device will re-join.
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, V1.0.3, V1.1.0 are available.
Region
Frequency plan of this device.
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 purchase.
3) Only OTAA mode supports rejoin mode.
4) For -868M model, default frequency is EU868; for -915M model, default frequency is AU915.

15
4.2.3.2 LoRa D2D Settings
LoRa D2D protocol is developed by Milesight and used for setting up transmission among
Milesight LoRa devices without gateway. When the LoRa D2D setting is enabled, VS121 can
work as a LoRa D2D controller for sending control commands to trigger LoRa D2D agent
devices.
Parameters
Description
Enable D2D
Enable or disable LoRa D2D feature.
LoRa D2D Key
Define a unique LoRa D2D key and this key is the same as the setting in LoRa
D2D agent device.
Default value: 5572404C696E6B4C6F52613230313823
Condition
Occupied: when total people counter value is non-zero in detection area
Unoccupied: 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
LoRa D2D agent devices.
Note: When this feature is enabled, the control command from this device will not send to
LoRaWAN®gateway.
4.2.4 Wi-Fi

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

17
Static IP
Settings
Add MAC address and static IP address if users need to add a static IP address
to a specific computer.
4.3 Advanced Settings
4.3.1 Security
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.

18
Account
Management
Click Add button, it will display Account Management page. Users can add an
account by entering Admin Password, User Level, User Name, New Password,
Confirm, and edit user privilege by clicking . The added account will be
displayed in the account list. Users can add 20 accounts at most.
Admin Password: enter the correct admin password before adding an account.
User Level: Set the privilege for the account.
User Name: Input user name for creating an account.
Password: Input password for the account.
Confirm: Confirm the password.
You can edit and delete the account in the account list under the admin
account. For the default admin account, you can only change the password, and
it cannot be deleted.
4.3.2 Logs
The logs contain the information about the time and IP that has accessed the web GUI.
Parameters
Description
Main Type
Select main log types

19
Sub Type
On the premise of main type has been selected, select the sub type to narrow
the range of logs
Start Time
The time of the log starts
End Time
The time of the log ends
Log Export
Export the logs
Save Period
Set the period of log saving, there are eight options to choose: Permanent and
30/60/120/180/240/300/360 Days
Go
Input the number of logs’ page
4.4 System
All information about the hardware and software can be checked on this page.
4.5 Maintenance
4.5.1 System Maintenance

20
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 this option to keep the IP configuration 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
4.5.2 Auto Reboot
Set the date and time to enable device auto reboot, the device will reboot automatically
according to the customized time in case that sensor overload after running a long time. Before
configuration note that the date and time should correct.