Milesight VS133 People Counting Sensor User Guide

Milesight VS133 People Counting Sensor

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 the device directly to avoid the scalds when the device is running.
• 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.

Revision History

1. Add staff lanyard accessory;
2. Add installation height detection feature;
3. Add DST time feature;
4. Add ToF frequency setting.

Sep. 28, 2023| V1.2|

1. Add Region Monitoring function;
2. Add Feet Tracking tracking mode of counting;
3. Add preview layout edition feature;
4. Add cumulative count reset schedule feature.

Nov. 30, 2023| V1.3|

1. Add Group Counting function;
2. Add video validation function;
3. Add other functions.

Product Introduction

Overview

VS133 is a sensor that uses second-generation ToF technology to accurately count people. This technology provides more p recise 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. VS133 sensor can be used in conjunction with the Milesight LoRaWAN® gateways and the Milesight IoT Cloud. With easy installation, VS133 sensors are ideal for entrances or corridors in retail stores, malls, offices, subways, and other locations.

Key Features

• Up to 99.8% accuracy combining the 2nd generation ToF technology and AI algorithm

• Working well even in low-light or completely dark environments with great lighting adaptability

• Free from privacy concerns without image capturing

• Allow to collect people counting data by differentiating between children and adults and detecting staffs via identification features for clearer people analysis
  Smart U-turn detection to filter redundant counting of people wandering in the area

• Support queuing management via dwell time detection and regional people counting

• Support Group Counting function that based on the distance, moving direction, and speed difference to gain deeper insights into customers’ behaviors

• Wider field angle to obtain longer-distance depth maps and cover a larger area

• Automatically detect the optimal installation height, facilitating fast deployment and intelligent detection

• Store a million counting data locally and securely

• Support video validation function to help customers verify statistical accuracy

• Easy configuration via Wi-Fi for web GUI configuration

• Function well with standard LoRaWAN® gateways and network servers

• Quick and easy management with Milesight IoT Cloud

Hardware Introduction

Packing List

• 1 × VS133 Device

• 4 × Ceiling Mounting Kits

• 1 × Mounting Sticker

• 8 × Staff Tags

• 1 × Power Adapter

• 1 × VB01 Multifunctional Bracket Kit (Optional)

• 8 × Staff Lanyards (Optional)

• 1 × Quick Guide

• 1 × Warranty Card

If any of the above items is missing or damaged, please contact your sales representative.

Hardware Overview

Button and LED Indicators

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.

Dimensions (mm)

Power Supply

VS133 can be powered by power adapter (12VDC, 2A).

Access the Sensor

VS133 provides user-friendly web GUI for configuration and users can access it via Wi-Fi connection. The recommended browsers are Chrome and Microsoft Edge. The default IP of Wi-Fi is 192.168.1.1, and default SSID is People Counter_XXXXXX (can be found on the label).

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.

Operation Guide

Dashboard

After logging on to the device web GUI successfully, user is allowed to view live video as follows.

Staff Excluded : Exclude staff data from statistical data; Children
Excluded: Exclude children data from statistical data.
Reset Count| Clear all accumulated entrance and exit people counting values.
Edit Preview Layout| Click to edit the preview layout.

Step 1: Select  video stream preview, static image preview or no image preview as needed.

Step 2: Click to show tracking lines, detection lines, U-turn areas and detection regions as needed.

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.

Note:

1. The arrow direction of the detection line depends on your drawing direction. If users need to flip the line, select the line which need to be flipped and click Flip Arrow Direction. And users can click Flip All to flip all detection lines.

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.

Rule Configuration

Users can set the rules to ensure accurate counting.

detect the current installation height automatically.

Note:

1. Ensure that there are no objects directly below the device avoiding interfering the height detection.
2. The automatic detection of the installation height is not supported with dark floor/carpet (black, grey, etc.)

Max. Target Height| Set  the  maximum  target  height,  then  the  device will  ignore  the  objects higher than this setting value.
Min. Target Height| Set  the  minimum  target  height,  then  the  device will  ignore  the  object shorter than this setting value.
Tracking Mode| Select the tracking mode of counting, including Heads Tracking and Feet Tracking.
Note: It is recommended to use heads tracking mode when the installation height is low in standalone working mode.
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 pass 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 stripes as staff tags on the visible parts (neck, shoulders, etc.) as staffs.
Reflective stripe requirements: width > 2cm, 500 cd/lux.m2
Group Counting| Click to enable the group counting function that based on the distance, moving direction and speed difference to gain deeper insights into customer’ behaviors.

Note:

1. This function is only applicable for line cross people counting.
2. Only report group counting data when group counting function is enabled.

Region Monitoring| Click “+Add” to add the region monitoring. Up to 4 regions are supported with maximum 10 segments each.

Step 1: Draw the region monitoring areas on the screen.

Step2: You can customize the zone name. And click to enable Region People Counting and Dwell Time Detection as needed. Pass-by Filtering can be set to improve statistical accuracy and Min. Dwell Time can be set to improve statistical validity.

Step 3 : The configuration is displayed in the list after the configuration is complete. You can redraw the areas by clicking the redraw button in the list. And click the edit button to modify the advanced settings of the areas or click delete button to delete the areas separately.

Reset Cumulative Count on Schedule| Enable to periodically reset cumulative count on schedule.
Cumulative Count includes:
Total In/Out counting of each detection line.
Max./Avg. Dwell Time of each detection region.
Periodic Report| Report the people counting data periodically.
Period| Set the period of reporting periodic report.
Range: 1-1080 mins, default: 10 mins

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.

Communication

WLAN

VS133 supports wlan feature to work as AP mode to configure device and it can not connect to other access point.

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.

LoRa

LoRa settings are used for configuring the transmission parameters in LoRaWAN® network.

is 85.
Join Type| OTAA and ABP mode are available.
Application Key| App key 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 Link Check Req MAC packets to the network server every reporting interval or every double reporting interval 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 Link Check Req 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.

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.

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.

Parameters

| Description
---|---

Event

| Select the event which you want to query the report. Line crossing counting, region people counting and dwell time detection are optional.

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.
| Select the individuals counting reports or groups counting reports.
| Select the region to display the graph.
| 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. The device can store up to one million data records to CSV file.

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.

Validation

Video validation function can assist users in verifying the accuracy of people counting by setting up a video task of recording.

Note:

• Only one video task can be performed at a time, please delete the previous task before creating a new one.
• Detection rules and ToF frequency parameters cannot be modified during the recording process.

Video Task

|

Start Recording

| Clicking Start Recording to initiate the recording task. You can manually click Stop Recording to end the recording, or it will automatically stop when the recording time reaches 60 minutes.

Set a Task of

| Configure the start time and duration of the recording. The

Recording

| duration can be set from 1 to 60 minutes. Clicking Cancel Task manually will cancel the recording schedule.

Playback Button

| | Enable/Disable detection lines in the recording footage.
| Enable/Disable u-turn area in the recording footage.
| Enable/Disable detection region in the recording footage
| Enable/Disable tracking line in the recording footage.
| Rewind/Pause/Play/Forward(supports switching between 0.5x, 1x, 2x, and 4x playback speed).

15:20:50.035 / 15:21:04.000

| Start time and end time of the recording.
| Download video stream footage.

System

Device Info

All information about the hardware and software can be checked on this page.

User

| Click to set three security questions for your device. In case that you forget the password, you can click Forget Password button  onlogin page to reset the password by answering three security questions correctly.

+ Add user| Click to add a viewer, who will only have access to the “Dashboard” and “Report” interfaces.
|

Time Configuration

Daylight Saving

Time

| Enable or disable Daylight Saving Time (DST). Start Time: the start time of DST time range.
 | End Time: the end time of DST time range. DST Bias: the DST time will be faster according to this bias setting.
Setting Time| Set the device time manually.
Synchronize with computer time|  Synchronize the time with your computer.

System Maintenance

interference of surrounding IR devices. Please avoid using the same mode if there are multiple VS133 devices around.
Note: if there is only one option, please contact Milesight IoT support:
iot.support@milesight.com
Reset| Recovery device basic configuration: keep the IP settings and user information when resetting.
Recovery device to factory settings: reset device to factory default, which needs to verify admin password.
Reboot| Restart the device immediately.
Upgrade| Click the folder icon and select the upgrading file, then click the Upgrade button to upgrade. The update is done when the system reboots successfully.
Note: The upgrade process takes about 1-10 minutes. Do not turn off the power and complete automatic restart after the upgrade.
Backup and Restore| Export Config File: Export configuration file.
Import Config File: Click the file icon and select the configuration file, click Import button to import configuration file.

Installation Instruction

Parameter definition:

Installation Height

The maximum installation height is 3.5 m and the minimum installation height is hmax+d+Δd. For example, when the maximum pedestrian height is 1.8 m, then the minimum installation height is 1.8+0.5+0.035=2.335 m.

Covered Detection Area

For example, if the Minimum height of pedestrians is 1.7 m, the detection area corresponding to each installation height is as follows:

Environment Requirements

• Dark floor/carpet (black, grey, etc.) will affect the device to count staffs when Staff Detection is enabled.

• Avoid 940nm light which may result in incorrect counting.

• Outdoor sunlight shining on the over channel will not have any effect, but the mirrored
  reflections that allow sunlight to shine on the ToF Sensor should be avoided.

• When the carpet/floor is black, make sure there are no obstacles within a 60cm hemisphere range in the direction of the device. Otherwise, the device imaging may appear abnormally red.

  ---

Installation

Ceiling Mount

Step 1: Ensure the thickness of the ceiling is more than 30 mm, then attach the mounting sticker to the ceiling and drill 4 holes with a diameter of 6mm. If the wire needs to be extended to the interior of the ceiling, a wire hole with a suitable size is also required to be drilled.
Step 2: Fix the wall plugs into the ceiling holes.
Step 3: Remove the cover on the device, and then connect all required wires and pass them through the wire hole behind the device or block on the side of the device if the wires need to be protruded from the side of the device.
Step 4: Fix the device to the wall plugs via mounting screws; remember to adjust the mounting direction according to the detection area requirement.
Step 5: Fix the cover back to the device.

Ceiling/Lintel Mount (with Optional VB01 Multifunctional Bracket)

Step 1: Attach the mounting plate to the device with 4 screws.
Step 2: Fix the pole to the mounting plate with the hole on the plate.
Step 3: Adjust the length of the pole, then adjust the direction of 3-axis ball and tighten it with the handle.
Step 4: Determine the mounting location and drill 3 holes, fix the wall plugs into the mounting holes, then fix the bracket base to the wall plugs via mounting screws.
(Note: If the wire needs to be extended to the interior of the ceiling or wall, a wire hole with a suitable size is also required to be drilled.)

Step 5: Remove the cover on the device, and then connect all required wires and pass them through the inside of pole.
Step 6: Fix the pole to bracket base with screws and nuts.

Note:

• Tilt installation should be avoided. Ensure that the front of the device and the ground plane are paralleled.

• Avoid installing the device against the wall and ensure that the device keeps away from the wall at least 30 cm on the short side and 50 cm on the long side.

• Ensure that there are no other objects blocking the ToF light within a 30 cm radius of the front of the device.

• When you install devices on the top of swinging doors, it is suggested to keep the door normally open. If the door must be normally closed, please install the device on the other side of the door to keep away from the door movement. And it is suggested to keep away from the door with a distance of at least 30 cm.

Factors Affecting Accuracy

• Wearing a fisherman’s hat or carrying a cardboard box on the shoulder: The target will not be recognized because it will become unlike a human in depth map.
• Handheld or cart-carrying a humanoid doll with sufficient height to pass by: The doll will be mistakenly detected as people because it is human-like in depth map.

Communication Protocol

Uplink Data

VS133 reports basic information of sensor whenever joining the network and the number of people periodically. For decoder examples please find files on https://github.com/Milesight-IoT/SensorDecoders.

ff

| 01 (Protocol Version)| 01=> V1
09 (Hardware Version)| 01 04 => V1.4
16 (Device SN)| 16 digits
1f (Software Version)| 85 01 00 05 => 133.1.0.5
03| d2 (Accumulated counter)| Line 1 accumulated in counter, 4 bytes
04| d2 (Accumulated counter)| Line 1 accumulated out counter, 4 bytes
05| cc (Periodic counter)| Line 1:

Byte 1-2: in counter during the report interval Byte 3-4: out counter during the report interval

06| d2 (Accumulated counter)| Line 2 accumulated in counter, 4 bytes
07| d2 (Accumulated counter)| Line 2 accumulated out counter, 4 bytes
08| cc (Periodic counter)| Line 2:
Byte 1-2: in counter during the report interval Byte 3-4: out counter during the report interval
09| d2 (Accumulated counter)| Line 3 accumulated in counter, 4 bytes
0a| d2 (Accumulated counter)| Line 3 accumulated out counter, 4 bytes
0b| cc (Periodic Counter)| Line 3:
Byte 1-2: in counter during the report interval Byte 3-4: out counter during the report interval
0c| d2 (Accumulated counter)| Line 4 accumulated in counter, 4 bytes
0d| d2 (Accumulated counter)| Line 4 accumulated out counter, 4 bytes
0e| cc (Periodic Counter)| Line 4:
 |  | Byte 1-2: in counter during the report interval
Byte 3-4: out counter during the report interval
---|---|---
0f| e3 (Region Monitoring)| Byte 1: number of people in region 1 Byte 2: number of people in region 2 Byte 3: number of people in region 3
Byte 4: number of people in region 4
10| e4 (Region Monitoring)| Byte 1: region ID
Byte 2-3: avg. dwell time Byte 4-5: max. dwell time

Note: If children distinction feature or staff detection feature is enabled, the counter uplinks will minus children and staff. For example, if children distinction is enabled, the accumulated in counter=total in counter- children in, the accumulated out counter=total out counter children out.

Example:

1. Device information
   ff0101 ff166600b09409760000 ff090102 ff1f85010001

   Channel| Type| Value| Channel| Type| Value

ff

| 01

(Protocol Version)

|

01 (V1)

|

ff

| 16(Device SN)| 66 00 b0 94

09 76 00 00

Channel| Type| Value| Channel| Type| Value

ff

| 09

(Hardware version)

|

0102 (V1.2)

|

ff

| 1f (Software version)| 85 01 00 01 (V133.1.0.1)
2. Line 1 People counter
03d205000000 04d203000000 05cc02000100

Channel| Type| Value| Channel| Type| Value
03| d2 (accumulated in counter)| 05 00 00 00 =>
00 00 00 05=5| 04| d2 (accumulated out counter)| 03 00 00 00 => 00 00 00 03=3
Channel| Type| Value|  |  |
|  | In: 02 00 => 00|  |  |

Downlink Command

VS133 supports to configure the device via downlink commands. Application port is 85 by default.

02: 16-31
03: 32-47
04: 48-63
05: 64-79
06: 80-95
Byte 2-3: indicate disable or enable via every bit, 0=disable, 1=enable
40 (ADR)| 00: disable, 01: enable
41 (Application Port)| 1 Byte, default is 85
42 (Wi-Fi)| 00: disable, 01: enable
43 (People Counting Periodic Report)| 00: disable, 01: enable
51 (Clear the accumulated counting)| ff (Reserved)

1. Disable Wi-Fi.
   ff4200

   Channel| Type| Value
   ff| 42 (Wi-Fi)| 00: disable

2. Set AU915 or US915 channel mask as 8-15.
   ff0501ff00 ff05020000 ff05030000 ff05040000 ff05050000

   Channel| Type| Value
   ff| 05 (Set Channel Mask)| 01: Channel index 0-15, ff00 => 8-15 is enabled 02-05: Channel index 16-79, 0000 => all disabled

3. Reboot the device.

ff10ff

Channel

| Type| Value
ff| 10 (Reboot)|

ff (Reserved)

4. Set reporting interval as 20 minutes.

ff03b004

Channel| Type|

Value

ff| 03(Set Reporting Interval)| b0 04 => 04 b0 = 1200s =20 minutes

References

• Support : IoT Support
• GitHub - Milesight-IoT/SensorDecoders

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>