Milesight VS132 3D ToF People Counting Sensor User Guide

Milesight VS132 3D ToF 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.

• 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 theCE, 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. Support U-turn counting;
2. Support Milesight Device Hub Management
3. Delete LoRaWAN version V1.1.0 option
4. Add counting clear downlink command

Feb. 15, 2023| V 1.2|

1. Add HTTP Post feature
2. Add door installation note
3. Change reporting interval command definition

Product Introduction

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

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

Hardware Introduction

Packing List

• 1 × VS132 Device
  

• 1 × 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.

Hardware Overview

Ethernet Port Indicators

Dimensions (mm)

Power Supply

VS132 can be powered by 802.3at standard PoE or power adapter (12VDC, 2A). If the both interfaces are connected, the device will be powered by the former method (PoE).

• Powered by DC Power Adapter
  

• Powered by a PoE Switch
  

• Powered by a PoE Injector
  

Access the Senso

VS132 sensor provides user-friendly web GUI for configuration and users can access it viaWi-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 IPof WIFI is 192.168.1.1, and default SSID is People Counter_XXXXXX.

Note: The default information can be found on the label.

Access with Wi-Fi

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, login 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.

Access with Ethernet

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/1Pv4}.

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.

Operation Guide

Preview

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

detection area.

Configuration

Rule

Rule Configuration

Users can set the rules and ROI to ensure accurate counting.

Max Target Height| Set the maximum target height, then the device will ignore the object higher than this height.
Min Target Height| Set the minimum target height, then the device will ignore the object shorter than this height.
U-turns Counting| When enabled, the device will count the in and out values repeatedly if people wandering between the two areas; when disabled, the device will only count when people pass from one area to another area and get out of device sight.

Note: Due to the error in ToF distance measurement (0.05 m), the Max Target Height should be set as maximum pedestrian height plus 0.05 m and the Min Target Height as minimal pedestrian height minus 0.05 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.85 m and 1.55 m respectively.

LoRaWAN
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
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”.·’Peop/e Counting’;

_“devicename ”.· ‘People Counter’;

“time”.·’2022/72/20 78:75-52.520′;

”report type”.· “trigger’;_

”in”.·7,                   I/Quantity of change

“out”.-0,

}

Periodic Report| Report the accumulated people counting data periodically. Uplink format:

{

“event”.·’People Counting’;

_“devicename ”.· ‘People Counter’;

“time”.·’2022/12/20 78:75·52.520′;

”report type”.· ”period’;_

_”incounted”.·70, //Accumulated in count

_“outcounted”.·7 0, //Accumulated out count

_“capacity_counted”.·O,                           ll=incoun ouLcount

}

Period

| Set the period of reporting periodic report.
Range: 1-1080 mins, default: 30 mins

Pass Area ROI

Region of interest (often abbreviate ROI), is a selected subset of samples within a dataset identified for a particular purpose. Users can select entrance area and exit area to record the people count values which indicate the number of people passing from one area to another.
Step 1 : Click Set Entrance Area or Set Exit Area.
Step 2: Drag the mouse to draw detection area. If there is already an area, you can click Clear.
Step 3: Click Stop Drawing, then click Save.

Note: The detection area had better not fill the field of view, leaving a certain interspace.

Traffic

The sensor will count the number of people who passing from one area to another, then upload the count value according to the reporting interval. Before using this feature, ensure the device time is correct on System > Time Configuration page.

time is fixed by hour.
Clear all| Click to clear all saved data records.

Communication

Ethernet

VS132 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 loT support: iot.support@milesight.com

192.168.5.220.
1Pv4 Subnet Netmask| Set the Netmask for the Ethernet port.
1Pv4 Default Gateway| Set the gateway for the Ethernet port’s 1Pv4 address.
Preferred DNS Server| Set the primary 1Pv4 DNS server.
Alternative DNS Server| Set the secondary 1Pv4 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.

WLAN

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.
Netmask: 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.
Preferred DNS Server: translate the domain name to IP address.
Alternate DNS Server: backup DNS server.

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 1 2th digits of SN.
Network Session| Nwkskey for ABP mode, the default key is
Key| 5572404C696E684C6F52613230313823.
Application Session Key| Appskey for ABP mode, the default key is 5572404C696E684C6F52613230313823.
LoRaWAN Version| V1.0.2, V1.0.3 are available.
Region| Frequency plan of this device.
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
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 network server, it will resend data once.
Rejoin Mode| Reporting interval :s 30 mins: the device will send a specific number of Link Check Req 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 data rate of the device.
Spreading Factor| If ADR is disabled, the device will send data via this spreading factor.

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 -91 SM model, default frequency is AU915.

System

Basic Information

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

Time Configuration

User Management

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 fifteen default questions below:

Modify| 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 on this page so as to manage the device centrally and remotely. For more details, please refer to DeviceHub User Guide. Before connecting, ensure the device has connected to network via Ethernet port and Internet connection is seamless.

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

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.

Installation Instruction

Parameter definition:

Parameters

| Explanation| Value
---|---|---

H

| Installation height| ::;3 m

d

| Minimum detection distance of VS132| 0.5m

Λ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

a

| ToF horizontal field of view angle| 92.5°

13

| ToF vertical field of view angle| 67°

X

| Length of detection range|

y

| Width of detection range|

Installation Height

The maximum installation height is 3 m and the minimum installation height is hmax+d+b.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.

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 x(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 X 3.18| 1.67×1.06
2.5| 5.22 X 3.31|

1.88 X 1.19

2.6

| 5.43 X 3.44|

2.09 X 1.32

2.7

| 5.64 X 3.57|

2.30 X 1.46

2.8

| 5.85 X 3.71| 2.51 X 1.59
2.9| 6.06 X 3.84|

2.72 X 1.72

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.

• Avoid direct point light to ToF sensor, which may result in incorrect counting.

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

Installation

Step 1: Fix the two mounting ears to both side of the device with screws.
Step 2: Drill 4 holes on the ceiling or wall according to the mounting ear’s hole and fix the wall plugs into the holes, then fix the device to 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

Embedded Mount

Wall Mount

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

• Two devices should be avoided being installed too close since the ToF light from one device will affect count accuracy of the other device. The distance between two devices should be in accordance with the coverage without overlap.
  

• Avoid installing the device against the wall and ensure the device keep away from the wall at least 20cm. When installed on the door lintel, the device needs to be noted flush with the lower edge of the door frame.

• Avoid installing the device against the wall and ensure the device keep away from the wall 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 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 door to keep away from the door movement. And it is suggested to keep away from the door with a distance of at least 20cm
  

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 because it is sufficiently human-like in depth map.

Device Payload

All data are based on following format(HEX), the Data field should follow little-endian:

For decoder examples please find files on https://github.com/Milesight- IoT/SensorDecoders.

Uplink Data

VS132 reports basic information of 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

ff0101 ff166600b09409760000 ff090102 ff1f84010001

Channel

| Type| Value| Channel| Type| Value

ff

| 01 (Protocol Version)| 01 (V1)| ff| 16(Device SN)| 66 00 b09409 76 0000
Channel| Type| Value| Channel| Type|

Value

ff| 09 (Hardware version)| 0102 (V1.2)| ff| 1f (Software version)|

84 01 0001(V132.1.0.1)

2. People counter

C hannel

| Type| Value| Channel| Type| Value
03| d2| 05 00 00 00 =>| 04| d2|

03 00 0000)

| (accumulated in counter)| 00 00 00 05=5| | (accumulated out counter)| => 00 000003=3
Channe| Type|

Value

| | |

05

| cc (Periodic Counter)|

In: 02 00 => 00 02 = 2 Out: 01 00 => 00 01 =1

| | |

Downlink Command

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

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
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)| f (Reserved)

Note: After changing any parameter of LoRaWAN® setting, the device will re-join the network.

Example:

1. Disable Wi-Fi.
   ff4200

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

2. Set AU915 or US915 channel mask as 8-15.
   ENDff0501ff00 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

Customer Support

For assistance, please contact
Milesight technical support:
Email: iot.support@milesight.com
Support Portal: support.milesight-iot.com Tel: 86-592-5085280
Fax: 86-592-5023065
Address: Building C09, Software Park Phase III, Xiamen 361024, China

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