Milesight VS133 User manual

AI ToF People Counting
Sensor
VS133
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.
Though the device is compliant with Class 1 (IEC/EN 60825-1:2014), please DO NOT look at
the ToF sensor too close and directly.
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.
Do not expose the device to where laser beam equipment is used.
Use a soft, dry cloth to clean the lens of the device.
Declaration of Conformity
VS133 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
May 24, 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 Button and LED Indicators ...................................................................................................... 7
2.4 Dimensions (mm) .................................................................................................................... 7
3. Power Supply ..................................................................................................................................... 7
4. Access the Sensor .............................................................................................................................8
4.1 Access with Wi-Fi (LoRaWAN®Version) ................................................................................8
4.2 Access with Ethernet (PoE Version) ...................................................................................... 9
5. Operation Guide ...............................................................................................................................10
5.1 Dashboard ..............................................................................................................................10
5.2 Rule .........................................................................................................................................11
5.3 Communication ..................................................................................................................... 14
5.3.1 WLAN (LoRaWAN®Version) ...................................................................................... 14
5.3.2 LoRa (LoRaWAN®Version) ........................................................................................ 15
5.3.3 Ethernet (PoE Version) ............................................................................................... 18
5.4 Report .....................................................................................................................................19
5.5 System ................................................................................................................................... 20
5.5.1 Device Info .................................................................................................................. 20
5.5.2 User ..............................................................................................................................21
5.5.3 Time Configuration .....................................................................................................22
5.5.4 Remote Management (PoE Version) .........................................................................23
5.5.5 System Maintenance ..................................................................................................23
6. Installation Instruction .................................................................................................................... 24
6.1 Installation Height ................................................................................................................. 25
6.2 Covered Detection Area ........................................................................................................ 25
6.3 Environment Requirements .................................................................................................. 25
6.4 Installation ............................................................................................................................. 26
6.5 Factors Affecting Accuracy .................................................................................................. 29
7. Communication Protocol ................................................................................................................29
7.1 LoRaWAN®Version ............................................................................................................... 29
7.2 PoE Version ............................................................................................................................32

5
1. Product Introduction
1.1 Overview
VS133 is a sensor that uses second-generation ToF technology to accurately count people. This
technology provides more precise depth maps and longer detection distances while maintaining
an excellent privacy protection rate. The advanced ToF technology combined with an AI
algorithm enables the sensor to handle complex scenes and distinguish non-human objects with
up to 99.8% accuracy. The VS133 sensor can be used in conjunction with the Milesight
LoRaWAN®gateways and the Milesight IoT Cloud, as well as with the PoE version VS133-P,
which allows for easy Ethernet connectivity and different data transmission options. With easy
installation, the VS133 and VS133-P sensors are ideal for entrances or corridors in retail stores,
malls, offices, subways, and other locations.
1.2 Key Features
Up to 99.8% accuracy combining the 2nd generation ToF technology and AI algorithm
Allow to collect people counting data by differentiating between children and adults and
detecting staffs via identification features for clearer people analysis
Wider field angle to obtain longer-distance depth maps and cover a larger area
Working well even in low-light or completely dark environments with great lighting
adaptability
Free from privacy concerns without image capturing
Smart U-turn counting to filter redundant counting of people wandering in the area
High compatibility of data transmission either from LoRaWAN®or Ethernet port
(HTTP/MQTT/CGI)
Various serial ports are equipped in the VS133 PoE version
4GB flash storage to store counting data locally and securely
Easy configuration via Wi-Fi or Ethernet port for web GUI configuration
Function well with standard LoRaWAN®gateways and network servers
Quick and easy management with Milesight IoT Cloud or Milesight DeviceHub
2. Hardware Introduction
2.1 Packing List

6
1 × VS133 Device
4 × Ceiling Mounting
Kits
1 × Mounting
Sticker
8 × Staff
Tags
1 × Power Adapter
(LoRaWAN®Version
Only)
1 × Multi-interface
(PoE Version Only)
1 ×
Warranty Card
1 ×
Quick Guide
1 × VB01 Multifunctional
Bracket Kit(Optional)
If any of the above items is missing or damaged, please contact your sales representative.
2.2 Hardware Overview
LoRaWAN®Version

7
PoE Version
2.3 Button and LED Indicators
Function
Action
LED Indication
Turn On/Off Wi-Fi
(LoRaWAN®
Version Only)
Press and hold the button for more than 3 seconds.
Blue blinks 3s
Wi-Fi on: Blue on
Wi-Fi off: Green on
Reset to Factory
Default
Press and hold the reset button for more than 10
seconds.
Green Blinks.
2.4 Dimensions (mm)
3. Power Supply
LoRaWAN®Version:
VS133 can be powered by power adapter (12VDC, 2A).

8
PoE Version:
VS133-P can be powered by 802.3at standard PoE. Choose one of the following methods to
power up the device.
Powered by a PoE Switch
Powered by a PoE Injector
4. Access the Sensor
VS133 sensor provides user-friendly web GUI for configuration and users can access it via Wi-Fi
connection or Ethernet port. The recommended browsers are Internet Explorer, Firefox, Chrome,
Microsoft Edge, and Safari. The default IP of Ethernet port is 192.168.5.220, the default IP of
Wi-Fi is 192.168.1.1, and default SSID is People Counter_XXXXXX.
Note: The default information can be found on the label.
4.1 Access with Wi-Fi (LoRaWAN®Version)
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 three security questions when using the sensor for
the first time (three questions can be skipped by refreshing webpage). After configuration, log in
with username (admin) and custom password.
Note:
1) Password must be 8 to 16 characters long, which contains at least two kinds or more in
combination with numbers, lowercase letters, uppercase letters and special characters .
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
4.2 Access with Ethernet (PoE Version)
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).

10
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 access the web GUI. After logging on web
GUI successfully, user is allowed to view configuration page.
5. Operation Guide
5.1 Dashboard
After logging on to the device web GUI successfully, user is allowed to view live video as follows.

11
Parameters
Description
Reset Count
Clear accumulated entrance and exit people counting values.
Output
(PoE Version)
Click to output a 5s high level signal from alarm out interface.
Alarm Output: dry contact, output=tow contacts closure
Track
When enabled, there is tracking line when people pass the detection area.
5.2 Rule
Draw Detection Lines
Users can draw detection lines to record the people count values which indicate the number of
people enter or exit.
Step 1: Click Draw Detection Lines.
Step 2: Left-click to start drawing and drag the mouse to draw a line, left-click again to continue
drawing a different direction edge and right-click the mouse to complete the drawing. The line
can be dragged to adjust the location and length. One device supports at most 4 broken lines
with maximum 4 segments each.
Step 3: If users need to delete the line, Click Draw Detection Lines, and select the line which need
to be deleted, then click Clear This Line or click Clear All.

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

13
Rule Configuration
Users can set the rules to ensure accurate counting.
Parameters
Description
Installation Height
Set the device installation height.
Max Target Height
Set the maximum target height, then the device will ignore the objects higher
than this setting.
Min Target Height
Set the minimum target height, then the device will ignore the object shorter
than this setting.
Child Filter Height
Set the max child height when children distinction feature is enabled.
U-turns Filtering
When enabled, it allows to draw an area for every line and the device will
count the In and Out values only when people cross along this area. Users can
left-click to start the drawing and add edges for this area, then right-click to
stop drawing.
Children
Distinction
The device will detect the people shorter than child filter height as children.
Staff Detection
The device will detect the people who wear reflective stripe as staff tags on

14
the visible upper body (neck, shoulders, etc.) as staffs.
Reflective stripe requirements: width > 2cm, 500 cd/lux.m2
Input Enable
Count Externally
(PoE Version)
Only when alarm input status is the same as the preset trigger status, will
the device count the data.
Alarm Input: dry contact, low level=two contacts disconnected, high level=tow
contacts closure
Note: Due to the error in ToF distance measurement (0.035 m), the Max Target Height should be
set as maximum pedestrian height plus 0.035 m and the Min Target Height as minimal
pedestrian height minus 0.035 m in the actual applications. For example, if the pedestrian height
is 1.6 m to 1.8 m, the Max and Min Target Height should be configured as 1.835 m and 1.565 m
respectively.
Parameters
Description
Trigger Report
(PoE Version)
Report the people counting data immediately when the in/out value changes.
Periodic Report
Report the people counting data periodically.
Period
Set the period of reporting periodic report.
Range: 1-1080 mins, default: 10 mins
5.3 Communication
5.3.1 WLAN (LoRaWAN®Version)
VS133 supports wlan feature to work as AP mode to configure device and it can not connect to
other access point.

15
Parameters
Description
Enable WLAN
Enable Wi-Fi feature. If disabled, users can use button or LoRaWAN®downlink
command to enable it.
Wi-Fi 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, WPA-PSK, WPA2-PSK and WPA-PSK/WPA2-PSK are optional.
Cipher
AES, TKIP, AES/TKIP are optional.
Wi-Fi
Password
Customize the password when security mode is not No Encryption.
5.3.2 LoRa (LoRaWAN®Version)
LoRa settings are used for configuring the transmission parameters in LoRaWAN®network.

16
Parameters
Description
LoRa Status
LoRaWAN®network joining status of this device.
Device EUI
Unique ID of the device, which can also be found on the label.
App EUI
The Default App EUI is 24E124C0002A0001.
Application Port
The port used for sending and receiving data, default port is 85.

17
Join Type
OTAA and ABP mode are available.
Application Key
Appkey for OTAA mode, the default key is
5572404C696E6B4C6F52613230313823.
Device Address
DevAddr for ABP mode, the default address is the 5th to 12th digits of SN.
Network Session
Key
Nwkskey for ABP mode, the default key is
5572404C696E6B4C6F52613230313823.
Application
Session Key
Appskey for ABP mode, the default key is
5572404C696E6B4C6F52613230313823.
Rejoin Mode
Reporting interval ≤ 35 mins: the device will send a specific number of
LinkCheckReq MAC packets to the network server with periodic or threshold
uplinks everytime more than 25~35 mins passes to validate connectivity; If
there is no response, the device will re-join the network.
Reporting interval > 35 mins: the device will send a specific number of
LinkCheckReq MAC packets to the network server every reporting interval to
validate connectivity; If there is no response, the device will re-join the
network.
Number of
Detection
When rejoin mode is enabled, set the number of detection.
Note: the actual sending number is Number of Detection + 1.
LoRaWAN®
Version
V1.0.2, V1.0.3 are available.
Region
Frequency plan of this device.
RX2 Data Rate
RX2 data rate to receive downlinks.
RX2 Frequency
RX2 frequency to receive downlinks.
Spreading Factor
If ADR is disabled, the device will send data via this spreading factor.
Channel
Select the channel from channel list or enter the index to select the frequency
channel.
Index 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
Confirm Mode
If the device does not receive ACK packet from network server, it will resend
data once.
ADR
Allow network server to adjust data rate of the device.

18
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) Select OTAA mode when you connect device to Milesight IoT Cloud.
5.3.3 Ethernet (PoE Version)
VS133 provides a Ethernet port for wired access. Besides, users can get the people counting
data or configure the device via CGI. For CGI document, please contact with Milesight IoT
support: [e-mail].
Parameters
Description
IP Address
Set the IPv4 address of the Ethernet port, the default IP is
192.168.5.220.
Subnet Netmask
Set the Netmask for the Ethernet port.
Default Gateway
Set the gateway for the Ethernet port's IPv4 address.
Primary DNS Server
Set the primary IPv4 DNS server.
Secondary DNS Server
Set the secondary IPv4 DNS server.
Test
Click to test if the IP is conflicting.

19
Parameters
Description
Protocol
HTTP (post) or MQTT is optional.
HTTP
URL
The device will post the people counting data in json format to this URL.
User
The username used for authentication.
Password
The password used for authentication.
MQTT
Host
MQTT broker address to receive data.
Port
MQTT broker port to receive data.
Client ID
Client ID is 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, QoS2 are optional.
TLS
Enable the TLS encryption in MQTT communication.
Certificate Type
CA Signed Server or Self Signed is optional.
CA signed server certificate: verify with the certificate issued by
Certificate Authority (CA) that pre-loaded on the device.
Self signed certificates: upload the custom CA certificates, client
certificates and secret key for verification.
5.4 Report
VS133 supports to generate visual line chart or bar chart to display the people traffic and
supports to export the report. Before using this feature, ensure that the device time is correct on
System page.

20
Parameters
Description
Time Unit
Select the unit to generate the graph or export the data.
Time Range
Select the time range to generate the graph.
Select the line to display the graph.
Search
Click to generate the graph according to the time range and line option.
Export
Export the historical traffic data as CSV file according to the selected time
unit.
Staff
Included/Excluded
Select whether to contain staff counting values on the graph.
Select the display type as line or bar.
Download the graph screenshot.
5.5 System
5.5.1 Device Info
All information about the hardware and software can be checked on this page. Besides, you can
modify the device password and set the security questions here.