Milesight VS132 3D ToF People Counting Sensor User Guide
Brand: Milesight
Model: VS132
Product Type: People Counting Sensor
Safety Precautions
- 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
VS132 is in conformity with the essential requirements and other relevant provisions of the CE, FCC, and RoHS.
[CE Certification] [FCC Certification] [RoHS Compliant]
Revision History
Date | Doc Version | Description |
---|---|---|
Oct. 15, 2022 | V 1.0 | Initial version |
Dec. 6, 2022 | V 1.1 |
|
Feb. 15, 2023 | V 1.2 |
|
1. Product Introduction
1.1 Overview
VS132 is a LoRaWAN® 3D ToF people counting sensor designed to count the number of people entering and exiting. Applied the most advanced Time-of-Flight technology, VS132 only obtains depth maps instead of images to protect privacy and provide a high level of accuracy up to 99.5%. Cooperating with Milesight LoRaWAN® gateway and the Milesight IoT Cloud, it allows users to monitor the flow of people and trigger linkage to control other devices via browser or mobile App remotely. VS132 can be widely used in entrances or corridors of retail stores, malls, offices, subways, etc.
1.2 Key Features
- Up to 99.5% accuracy basing on advanced 3D Time-of-Flight technology
- Obtain depth map without images capturing, free from privacy concerns
- Effective in low-light or complete dark environments
- Bi-directional Counting
- Store a million data records locally
- DC or PoE power supply optional
- Exquisite design for multiple installation scenarios
- Equipped with Wi-Fi and Ethernet port for web GUI configuration
- Acquire people counting data either from LoRaWAN® or Ethernet port (HTTP Post, CGI)
- Function well with standard LoRaWAN® gateways and network servers
- Quick and easy management with Milesight IoT Cloud
2. Hardware Introduction
2.1 Packing List
The package contains the following items:
- 1 × VS132 Device
- 1 x Power Adapter
- 2 × Ear Mounting Kits
- 4 × Wall Mounting Kits
- 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
The device features a DC Power Interface and an Ethernet Port (PoE). It also includes a Threaded Hole (UNC 1/4-20) for mounting.
2.3 Ethernet Port Indicators
Indicator | Status | Description |
---|---|---|
Link Indicator (Orange) | Off | Disconnected |
Blinking | Transmitting data | |
On | Connected | |
Rate Indicator (Green) | Off | 100 Mbps mode |
On | 10 Mbps mode |
2.4 Dimensions (mm)
The device dimensions are approximately 180mm x 50mm x 50mm.
3. Power Supply
VS132 can be powered by 802.3at standard PoE or a power adapter (12VDC, 2A). If both interfaces are connected, the device will be powered by PoE.
Powering Methods:
- Powered by DC Power Adapter: Connect the DC power adapter to the VS132.
- Powered by a PoE Switch: Connect an Ethernet cable from the PoE switch to the VS132.
- Powered by a PoE Injector: Connect an Ethernet cable from the PoE injector to the VS132, and a power cable to the injector.
4. Access the Sensor
The VS132 sensor provides a user-friendly web GUI for configuration. Users can access it via Wi-Fi connection or Ethernet port. Recommended browsers include Internet Explorer, Firefox, Chrome, Microsoft Edge, and Safari. The default IP of the Ethernet port is 192.168.5.220, the default IP of Wi-Fi is 192.168.1.1, and the default SSID is People Counter_XXXXXX. The default information can be found on the device label.
4.1 Access with Wi-Fi
- Power on the device.
- Enable the Wireless Network Connection on your computer and search for the corresponding access point, then connect your computer to this access point.
- Open a browser and type 192.168.1.1 to access the web GUI.
- Select the language.
- Users need to set the password and three security questions when using the sensor for the first time (these can be skipped by refreshing the webpage). After configuration, log in with username (admin) and the custom password.
Note:
- Password must be 8 to 16 characters long, containing at least two kinds of characters (numbers, lowercase letters, uppercase letters, special characters).
- You can click "Forgot Password" on the login page to reset the password by answering three security questions if you have set them previously.
4.2 Access with Ethernet
Step 1: Power on the device and connect the Ethernet port to a PC.
Step 2: Change the IP address of your computer to the 192.168.5.0 segment. This involves navigating to Start → Control Panel → Network and Internet → Network and Sharing Center → Ethernet → Properties → Internet Protocol Version 4 (TCP/IPv4).
Step 3: Enter an IP address within the same segment as the sensor (e.g., 192.168.5.61), ensuring it does not conflict with the existing network IP address.
Step 4: Open a browser and type 192.168.5.220 to access the web GUI. After successful login, you can view the configuration page.
5. Operation Guide
5.1 Preview
After logging into the device web GUI, you can view the live feed. The interface displays the entrance count and exit count.
Parameters | Description |
---|---|
Reset Count | Clear accumulated entrance and exit people counting values. |
Enable Tracks: When enabled, a tracking line is shown when people pass through the detection area.
5.2 Configuration
5.2.1 Rule
Users can set rules and Regions of Interest (ROI) to ensure accurate counting.
Rule Configuration
Parameters | Description | Value |
---|---|---|
Deploy Height | Set the device deploy height from the ground. | mm (1500~3000) |
Deploy Angle | Set the deploy angle based on the horizontal surface. | ° (-10~10) |
Max Target Height | Set the maximum target height; the device will ignore objects higher than this height. | mm (500~2500) |
Min Target Height | Set the minimum target height; the device will ignore objects shorter than this height. | mm (500~2500) |
U-turns Counting | When enabled, the device will count in and out values repeatedly if people wander between the two areas. When disabled, the device will only count when people pass from one area to another and exit the device's sight. |
Note: Due to potential errors in ToF distance measurement (0.05 m), the Max Target Height should be set as the maximum pedestrian height plus 0.05 m, and the Min Target Height as the minimal pedestrian height minus 0.05 m. 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.85 m and 1.55 m respectively.
Report Settings
LoRaWAN / HTTP:
Parameters | Description |
---|---|
Report Protocol | Select uplink protocol as LoRaWAN® or HTTP. |
Periodic Report | Report the people counting data periodically. See uplink format on section 7. |
Period | Set the period of reporting periodic report. (Range: 1-1080 mins, default: 30 mins) |
HTTP Details:
Parameters | Description |
---|---|
HTTP Method | It's fixed as Post. |
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. |
Trigger Report | Report the people counting data immediately when the in/out value changes. Uplink format: { "event":"People Counting", "device_name":"People Counter", "time":"2022/12/20 18:15:52.520", "report_type": "trigger", "in":1, "out":0, } |
Periodic Report | Report the accumulated people counting data periodically. Uplink format: { "event":"People Counting", "device_name":"People Counter", "time":"2022/12/20 18:15:52.520", "report_type": "period", "in_counted":10, "out_counted":10, "capacity_counted":0, } |
Period | Set the period of reporting periodic report. (Range: 1-1080 mins, default: 30 mins) |
Pass Area ROI
Region of Interest (ROI) is a selected subset of samples within a dataset identified for a particular purpose. Users can select entrance and exit areas to record people count values, indicating the number of people passing from one area to another.
Steps:
- Click "Set Entrance Area" or "Set Exit Area".
- Drag the mouse to draw the detection area. If an area already exists, you can click "Clear".
- Click "Stop Drawing", then click "Save".
Note: The detection area should not fill the entire field of view; leave a certain interspace.
5.2.2 Traffic
The sensor counts the number of people passing from one area to another and uploads the count value according to the reporting interval. Ensure the device time is correct on the System > Time Configuration page before using this feature.
Parameters | Description |
---|---|
Count Type | Select the count type to generate the graph. |
Time Picker | Select the time or time range to generate the graph. |
Count | Click to generate the graph according to the picked time or time range. |
Export | Export the historical traffic data as a CSV file. The recorded and saved time is fixed by hour. |
Clear all | Click to clear all saved data records. |
5.2.3 Communication
5.2.3.1 Ethernet
VS132 provides an Ethernet port for wired access. Users can obtain people counting data or configure the device via CGI. For CGI documentation, please contact Milesight IoT support at iot.support@milesight.com.
TCP/IP Settings
Parameters | Description |
---|---|
IPv4 Address | Set the IPv4 address of the Ethernet port. Default IP is 192.168.5.220. |
IPv4 Subnet Mask | Set the Netmask for the Ethernet port. |
IPv4 Default Gateway | Set the gateway for the Ethernet port's IPv4 address. |
Preferred DNS Server | Set the primary IPv4 DNS server. |
Alternative DNS Server | Set the secondary IPv4 DNS server. |
MAC Address | Display the MAC address of the Ethernet port. |
MTU | Display the maximum transmission unit. |
Test | Click to test if the IP is conflicting. |
5.2.3.2 WLAN
WLAN Settings
Parameters | Description |
---|---|
Enable | Enable Wi-Fi feature. |
Work Mode | Work mode is fixed as AP and cannot connect to other access points. |
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
Parameters | Description |
---|---|
LAN IP Address | IP address used to access the web GUI of the sensor. |
Netmask | Identify the subnet where the sensor is located. |
Start Address | Define the beginning of the IP address pool for DHCP clients. |
End Address | Define the end of the IP address pool for DHCP clients. |
Lease Time (min) | The lease time for which a DHCP client can use the IP address assigned by the sensor. (min(5~1440)) |
Preferred DNS Server | Translate the domain name to IP address. |
Alternate DNS Server | Backup DNS server. |
5.2.3.3 LoRa
LoRa settings are used for configuring transmission parameters in a LoRaWAN® network.
Parameters | Description |
---|---|
Join 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. |
Join Type | OTAA and ABP modes 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 | Nwkskey for ABP mode, the default key is 5572404C696E6B4C6F52613230313823. |
Key | 5572404C696E6B4C6F52613230313823. |
Application | Appskey for ABP mode, the default key is 5572404C696E6B4C6F52613230313823. |
Session Key | 5572404C696E6B4C6F52613230313823. |
LoRaWAN Version | V1.0.2, V1.0.3 are available. |
Region | Frequency plan of this device. |
Channel | Select the channel from the 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 |
RX2 Data Rate | RX2 data rate to receive downlinks. |
RX2 Frequency/MHz | RX2 frequency to receive downlinks. |
Confirm Mode | If the device does not receive ACK packet from the network server, it will resend data once. |
Rejoin Mode | Reporting interval ≤ 30 mins: 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. Reporting interval > 30 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. |
ADR Mode | Allow network server to adjust the data rate of the device. |
Spreading Factor | If ADR is disabled, the device will send data via this spreading factor. |
Note:
- Please contact sales for device EUI list if there are many units.
- Please contact sales if you need random App keys before purchase.
- Only OTAA mode supports rejoin mode.
- For -868M model, default frequency is EU868; for -915M model, default frequency is AU915.
5.2.4 System
Basic Information
All information about the hardware and software can be checked on this page.
Parameters | Value |
---|---|
Device Name | People Counter |
Product Model | VS132-915M |
SN | 6600C2435050 |
Hardware Version | V1.2 |
Software Version | V 132.1.0.1-a5-b |
WLAN MAC Address | 00:15:18:10:01:36 |
Ethernet MAC Address | 00:15:18:10:e0:6c |
Time Configuration
Parameters | Description |
---|---|
Time Zone | Choose the time zone for your location. (GMT +00:00) Dublin, Edinburgh, London |
NTP Timing | Sync the time with NTP server. |
Server Address | |
NTP Port | 123 |
Time Interval | Set the interval to sync time with NTP server. (min(1~10080)) |
Manual Timing | Set the device time manually. |
Device Time | 2000-01-01 00:36:44 |
Setting Time | Synchronize with your computer time |
User Management
No. | Username | Security Question | User Type | |
---|---|---|---|---|
1 | admin | Administrator | Modify |
Description: Click to type administrator password, then set three security questions for your device. In case that you forget the password, you can click "Forget Password" button on the login page to reset the password by answering three security questions correctly.
Security Configuration Issues
Security Question 1: What are your favorite games
Security Question 2: What is your favorite book
Security Question 3: What's your favorite color
There are fifteen default questions available, including:
- What are your favorite games
- What is your favorite book
- What's your favorite color
- What is your favorite movie
- What is your favorite flower
- What is your first mobile phone brand
- Where did you go on your first plane ride
- What is your father's name
- What is your mother's name
- What is the name of your high school teacher
- What is the name of your junior high school teacher
- What you are most familiar name is roommates school dormitory
- The most influential name of the person you
- Who is your favorite celebrity
- What is your favorite car brand
Click the admin on the user list, then you can click "Modify" to change the login password of this device.
Remote Management
You can connect the device to the Milesight DeviceHub management platform to manage the device centrally and remotely. For more details, please refer to the DeviceHub User Guide. Before connecting, ensure the device is connected to the network via the Ethernet port and the Internet connection is seamless.
Parameters | Description |
---|---|
Status | Show the connection status between the device and the DeviceHub. Click this button to disconnect the device from the DeviceHub. |
Disconnect | |
Server Address | IP address or domain of the DeviceHub management server. |
Activation Method | Select activation method to connect the device to the DeviceHub server; options are Authentication Code and Account. |
System Maintenance
Parameters | Description |
---|---|
Language | English or simplified Chinese are optional. |
Reboot | Restart the device immediately. |
Reset | Basic Recovery: keep the IP settings, user information and stored counting data when resetting. All Recovery: reset device to factory default, which needs to verify admin password. |
Upgrade | Click the "Browse" button 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. |
6. Installation Instruction
Parameter definition:
Parameters | Explanation | Value |
---|---|---|
H | Installation height | ≤3 m |
d | Minimum detection distance of VS132 | 0.5 m |
Δd | Distance measurement error of VS132 | 0.05 m |
hmax | Maximum pedestrian height | Example 1.8 m |
hmin | Minimum pedestrian height | Example 1.6 m |
α | ToF horizontal field of view angle | 92.5° |
β | ToF vertical field of view angle | 67° |
x | Length of detection range | |
y | Width of detection range |
6.1 Installation Height
The maximum installation height is 3 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.05=2.35 m.
6.2 Covered Detection Area
The detection area covered by the device is related to the field of view angle of the device, the installation height and the target height. The length of the detection area is approximately x=2.1×(H-hmin) and the width of the detection area is approximately y=1.32 x (H-hmin).
For example, if the Minimum height of pedestrians is 1.6 m, the detection area corresponding to each installation height is as follows:
Installation Height | FoV Monitored Area (m) | Detection Area (m) |
---|---|---|
2.4 | 5.01 × 3.18 | 1.67 × 1.06 |
2.5 | 5.22 × 3.31 | 1.88 × 1.19 |
2.6 | 5.43 × 3.44 | 2.09 × 1.32 |
2.7 | 5.64 × 3.57 | 2.30 × 1.46 |
2.8 | 5.85 × 3.71 | 2.51 × 1.59 |
2.9 | 6.06 × 3.84 | 2.72 × 1.72 |
3.0 | 6.27 × 3.97 | 2.92 × 1.85 |
6.3 Environment Requirements
- Black floor/carpet may affect the depth map to produce a lot of noise, but will not affect the device to count people.
6.4 Installation
Step 1: Fix the two mounting ears to both sides of the device with screws.
Step 2: Drill 4 holes on the ceiling or wall according to the mounting ear's holes and fix the wall plugs into the holes, then fix the device to the wall plugs with mounting screws. When installing the device, it's suggested to fix the two screws on the top at first.
You can select the below mounting methods depending on the environment.
Ceiling Mount
Diagram description: Illustrates the device being mounted to a ceiling using mounting brackets.
Embedded Mount
Diagram description: Shows the device being recessed into a surface, such as a wall or ceiling, with its front face flush with the surface.
Wall Mount
Diagram description: Depicts the device mounted on a wall using brackets.
Besides, the device can be mounted with the mounting stand via the threaded hole.
Note:
- Tilt installation should be avoided. Ensure that the front of the device and the ground plane are parallel.
- Two devices should be avoided being installed too close since the ToF light from one device will affect the count accuracy of the other device. The distance between two devices should be in accordance with the coverage without overlap.
6.5 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 the depth map.
- Handheld or cart-carrying a humanoid doll with sufficient height to pass by: The doll will be mistakenly detected because it is sufficiently human-like in the depth map.
Avoid installing the device against the wall and ensure the device is kept away from the wall by at least 20cm. When installed on the door lintel, the device needs to be noted flush with the lower edge of the door frame.
When installing 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. It is also suggested to keep away from the door with a distance of at least 20cm.
7. Device Payload
All data are based on the following format (HEX), the Data field should follow little-endian:
Channel1 | Type1 | Data1 | Channel2 | Type2 | Data2 | Channel 3 | ...
1 Byte | 1 Byte | N Bytes | 1 Byte | 1 Byte | M Bytes | 1 Byte | ...
For decoder examples, please find files on https://github.com/Milesight-IoT/SensorDecoders.
7.1 Uplink Data
VS132 reports basic information of the sensor whenever joining the network and the number of people according to settings.
Channel | Type | Description |
---|---|---|
ff | 01 (Protocol Version) | 01=> V1 |
09 (Hardware Version) | 01 04 => V1.4 | |
16 (Device SN) | 16 digits | |
1f (Software Version) | 1f 07 00 4b => V31.7.0.75 | |
03 | d2 (accumulated counter) | Accumulated in counter, 4 bytes |
04 | d2 (accumulated counter) | Accumulated out counter, 4 bytes |
05 | cc (Periodic Counter) | Byte 1-2: in counter during the report interval Byte 3-4: out counter during the report interval |
Example:
1. Device information
Channel | Type | Value | Channel | Type | Value |
---|---|---|---|---|---|
ff | 01 (Protocol Version) | 01 (V1) | ff | 16(Device SN) | 66 00 b0 94 09 76 00 00 |
ff | 09 (Hardware version) | 0102 (V1.2) | ff | 1f (Software version) | 84 01 00 01 (V132.1.0.1) |
2. People counter
Channel | Type | Value | Channel | Type | Value |
---|---|---|---|---|---|
03 | d2 | 05 00 00 00 => | 04 | d2 | 03 00 00 00 |
Channel | Type | (accumulated in counter) | (accumulated out counter) |
---|---|---|---|
05 | cc (Periodic Counter) | 00 00 00 05=5 Value In: 02 00 => 00 02 = 2 |
=> 00 00 00 03=3 Out: 01 00 => 00 01 =1 |
7.2 Downlink Command
VS132 supports downlink commands to configure the device. Application port is 85 by default.
Channel | Type | Description |
---|---|---|
ff | 10 (Reboot) | ff (Reserved) |
03 (Reporting Interval) | 2 Bytes, unit: s Note: the device will change the interval unit as minutes. For example, if you send 62s, the device will be set as 1 minute. |
|
04 (Confirm Mode) | 00: disable, 01: enable | |
ff | 05 (LoRaWAN® Channel Mask) | Byte 1: Channel index range 01: 0-15 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) |
Note: After changing any parameter of LoRaWAN® setting, the device will re-join the network.
Example:
1. Disable Wi-Fi.
Channel | Type | Value |
---|---|---|
ff | 42 (Wi-Fi) | 00: disable |
2. Set AU915 or US915 channel mask as 8-15.
ff0501ff00 ff05020000 ff05030000 ff05040000ff05050000
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.
Channel | Type | Value |
---|---|---|
ff | 10 (Reboot) | ff (Reserved) |
4. Set reporting interval as 20 minutes.
Channel | Type | Value |
---|---|---|
ff | 03(Set Reporting Interval) | b0 04 => 04 b0 = 1200s =20 minutes |