Milesight VS133 AI ToF People Counting Sensor

User Guide

Safety Precautions

Milesight is not responsible for any loss or damage resulting from not following the instructions in this guide. Although the device complies with Class 1 (IEC/EN 60825-1:2014), do not look directly at the ToF sensor. The device must not be disassembled or remodeled. Keep the product away from rain and moisture to avoid fire and electric shock. Do not place the device outside the operating temperature range. Avoid touching the device directly while it is running to prevent scalds. The device must not be subjected to shocks or impacts. Ensure the device is firmly fixed during installation. Do not expose the device to areas with laser beam equipment. Clean the lens with a soft, dry cloth.

Declaration of Conformity

The VS133 is compliant with the essential requirements and other relevant provisions of CE, FCC, and RoHS.

Copyright © 2011-2024 Milesight. All rights reserved. Unauthorized reproduction or distribution of this user guide is prohibited without written authorization from Xiamen Milesight IoT Co., Ltd.

For assistance, please contact Milesight technical support:

Revision History

DateDoc VersionDescription
May 24, 2023V1.0Initial version
Aug. 10, 2023V1.11. Add staff lanyard accessory;
2. Add installation height detection feature;
3. Add DST time feature;
4. Add ToF frequency setting.
Sep. 28, 2023V1.21. 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, 2023V1.31. Add Group Counting function;
2. Add video validation function;
3. Add other functions.
Mar. 31, 2024V1.41. Support to configure WLAN IP address;
2. Add ToF lighting mode and noise filtering;
3. Add validation record task list.
May 20, 2024V1.51. Add Enhanced Detection Mode.
2. Update installation distance.
Jun. 19, 2024V1.6Add People Counting Trigger Report.

1. Product Introduction

1.1 Overview

The VS133 is a sensor utilizing second-generation ToF technology for accurate people counting. It provides precise depth maps and longer detection distances while maintaining excellent privacy protection. The advanced ToF technology, combined with an AI algorithm, allows the sensor to handle complex scenes and distinguish non-human objects with up to 99.8% accuracy. The VS133 sensor integrates with Milesight LoRaWAN® gateways and the Milesight IoT Cloud. Its easy installation makes it ideal for entrances or corridors in retail stores, malls, offices, subways, and other locations.

1.2 Key Features

2. Hardware Introduction

2.1 Packing List

The package includes:

If any items are missing or damaged, please contact your sales representative.

2.2 Hardware Overview

The device features:

2.3 Button and LED Indicators

FunctionActionLED Indication
Turn On/Off Wi-FiPress 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 DefaultPress and hold the reset button for more than 10 seconds.Green Blinks.

2.4 Dimensions (mm)

Diagram showing the device dimensions: Length approximately 120mm, Width approximately 26mm, Height approximately 18mm.

3. Power Supply

The VS133 is powered by a power adapter (12VDC, 2A).

Diagram showing the device connected to a power adapter.

4. Access the Sensor

The VS133 offers a user-friendly web GUI accessible via Wi-Fi connection. Recommended browsers are Chrome and Microsoft Edge. The default Wi-Fi IP is 192.168.1.1, and the default SSID is People Counter_XXXXXX (found on the label).

  1. Power on the device.
  2. Enable Wireless Network Connection on your computer, search for the corresponding access point, and connect to it.
  3. Open a browser and navigate to 192.168.1.1 to access the web GUI.
  4. Select the language.
  5. On the first use, set a password and three security questions (questions can be skipped by refreshing the webpage). After configuration, log in with username 'admin' and the custom password.

Note:

Screenshot showing the activation/login page and the security question setup page.

5. Operation Guide

5.1 Dashboard

After successfully logging into the device web GUI, users can view the live video feed and data.

Screenshot of the Dashboard interface showing live video, counting data (Total In/Out, Capacity, Staff In/Out, Children In/Out, Group In/Out), status indicators (ToF Status, Schedule), and configuration options (Date & Time, Language, User).

Parameters and Descriptions:

5.2 Rule

The interface allows users to configure detection lines, U-turn areas, detection regions, and tracking lines.

Screenshot of the Rule configuration interface, showing Master Settings, Deployment Parameters (Installation Height, Max/Min Target Height, Child Filter Height), Multi-Device List, and Counting Strategy (Tracking Mode, Children Distinction, Staff Detection).

Draw Detection Lines

Users can draw detection lines to record people count values indicating entry or exit.

  1. Click 'Draw Detection Lines'.
  2. Left-click to start drawing, drag the mouse to draw a line, left-click again for a different direction, and right-click to complete. Lines can be dragged to adjust location and length. The device supports up to 4 broken lines, each with a maximum of 4 segments.
  3. To delete a line, click 'Draw Detection Lines', select the line, and click 'Clear This Line' or 'Clear All'.

Note: The arrow direction of the detection line depends on the drawing direction. Users can flip lines using 'Flip Arrow Direction' or 'Flip All'. Ensure detected targets pass through the line completely. It is recommended that the detection line is perpendicular to the In/Out direction and centered within the detection area, free from obstructions. A redundant identification area on both sides of the line is recommended for stable recognition and tracking before passing the line, improving accuracy.

Rule Configuration

Users can set rules to ensure accurate counting.

ParametersDescription
Installation HeightSet the device installation height. Click 'Detect' to automatically detect the current height. Note: Ensure no objects are directly below the device that could interfere with height detection. Automatic detection is not supported on dark floors/carpets.
Max. Target HeightSet the maximum target height; objects taller than this value will be ignored.
Min. Target HeightSet the minimum target height; objects shorter than this value will be ignored.
Tracking ModeSelect the tracking mode: Heads Tracking or Feet Tracking. Heads tracking is recommended for low installation heights in standalone mode.
Enhanced Detection ModeEnables normal counting and detection under conditions like abnormal depth images, obstacles in live view, or unmet installation conditions.
Children DistinctionDetects people shorter than the child filter height as children.
Staff DetectionDetects people wearing reflective stripes (width > 2cm, 500 cd/lux.m²) on visible parts (neck, shoulders) as staff.
U-turns FilteringWhen enabled, allows drawing an area for each line. The device counts In and Out values only when people pass through this area. Users can draw these areas by left-clicking to start and right-clicking to stop. Up to 4 regions with 4 segments each are supported.

Screenshot showing the U-turn filtering setup and the Region Monitoring setup.

Group Counting

Enables group counting based on distance, moving direction, and speed difference for deeper customer behavior insights. Applicable only for line cross people counting. Data is reported only when enabled.

Region Monitoring

Allows adding up to 4 regions with a maximum of 10 segments each. Users draw regions on the screen, customize zone names, and enable Region People Counting and Dwell Time Detection. Pass-by Filtering and Min.Dwell Time can be set for accuracy and validity.

Advanced Properties

Configuration is displayed in a list. Areas can be redrawn, modified, or deleted.

Report Settings

ParametersDescription
Reset Cumulative Count on SchedulePeriodically resets cumulative counts (Total In/Out, Max/Avg. Dwell Time).
Periodic ReportReports people counting data periodically. The period can be set from 1 to 1080 minutes (default 10 minutes).
Trigger ReportReports immediately when line cross or region people counting numbers change.

Note: Due to ToF distance measurement errors (0.035 m), Max. Target Height should be set as maximum pedestrian height + 0.035 m, and Min. Target Height as minimal pedestrian height - 0.035 m. For example, for pedestrians 1.6 m to 1.8 m tall, configure Max. Target Height as 1.835 m and Min. Target Height as 1.565 m.

5.3 Communication

5.3.1 WLAN

The VS133 supports Wi-Fi for AP mode configuration and cannot connect to other access points.

ParametersDescription
Enable WLANEnables or disables the Wi-Fi feature. If disabled, use the button or LoRaWAN® downlink command to enable it.
Wi-Fi SSIDThe unique name for the device's Wi-Fi access point.
WLAN IP AddressConfigures the WLAN IP address for web access; default is 192.168.1.1.
ProtocolSupports 802.11b (2.4 GHz), 802.11g (2.4 GHz), and 802.11n (2.4 GHz).
BandwidthSupports 20 MHz or 40 MHz.
ChannelSelects the wireless channel (Auto, 1-11 are optional).
Security ModeOptions include No Encryption, WPA-PSK, WPA2-PSK, and WPA-PSK/WPA2-PSK.
CipherOptions include AES, TKIP, AES/TKIP.
Wi-Fi PasswordSets the password when security mode is not 'No Encryption'.

5.3.2 LoRa

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

Screenshots of LoRaWAN settings, including Device EUI, App EUI, Application Port, Join Type, Application Key, Rejoin Mode, Number of Detection, LoRaWAN Version, Region, RX2 Data Rate, RX2 Frequency, Spreading Factor, and Channel List.

ParametersDescription
LoRa StatusIndicates the LoRaWAN® network joining status.
Device EUIUnique ID of the device, also found on the label.
App EUIDefault App EUI is 24E124C0002A0001.
Application PortDefault port for sending/receiving data is 85.
Join TypeOTAA and ABP modes are available.
Application KeyAppkey for OTAA mode (default: 5572404C696E6B4C6F52613230313823).
Device AddressDevAddr for ABP mode (5th to 12th digits of SN).
Network Session KeyNwkskey for ABP mode (default: 5572404C696E6B4C6F52613230313823).
Application Session KeyAppskey for ABP mode (default: 5572404C696E6B4C6F52613230313823).
Rejoin ModeConfigures rejoin behavior based on reporting interval to validate connectivity.
Number of DetectionSets the number of detections when rejoin mode is enabled (actual sending number is Number of Detection + 1).
LoRaWAN® VersionV1.0.2, V1.0.3 are available.
RegionFrequency plan for the device.
RX2 Data RateRX2 data rate for receiving downlinks.
RX2 FrequencyRX2 frequency for receiving downlinks.
Spreading FactorUsed if ADR is disabled; sends data via this spreading factor.
ChannelSelects channels from the list or enters an index. Examples: 1, 40; 1-40; 1-40, 60; All.

Note:

  • 'Null' indicates all channels are disabled.
  • 'Confirm Mode' resends data if ACK is not received from the network server.
  • 'ADR' allows the network server to adjust the device's data rate.
  • Contact sales for device EUI lists or random App keys.
  • Only OTAA mode supports rejoin mode.
  • Select OTAA mode when connecting to Milesight IoT Cloud.

5.4 Report

The VS133 supports visual line or bar chart generation for people traffic and report exporting. Ensure the device time is correct on the System page before use.

Screenshot of the Report interface showing graph generation options (Event, Time Unit, Time Range, Line, Individuals/Groups, Region) and a sample people traffic report graph.

ParametersDescription
EventSelect the event to query: Line crossing counting, region people counting, or dwell time detection.
Time UnitSelect the unit for graph generation or data export (Hour, Day, Month).
Time RangeSelect the time range for graph generation.
LineSelect the line to display on the graph.
Individuals/GroupsSelect individuals counting reports or groups counting reports.
RegionSelect the region to display on the graph.

Users can click 'Search' to generate the graph, 'Export' to get historical traffic data as CSV (up to one million records), select whether to include staff counts, choose display type (line or bar), and download graph screenshots.

5.5 Validation

The video validation function helps verify people counting accuracy by setting up video recording tasks.

Screenshot of the Validation interface showing a list of recording tasks (Task Name, Start Time, End Time, Duration, Task Status, Operation) and an '+Add' button.

ParametersDescription
Task NameShows the task name.
Start/End TimeShows the start and end time of the video.
DurationShows the length of the video.
Task StatusShows the video task status.
OperationClick to view details, stop recording, or delete the task.
+AddClick to add a video task. Up to 12 tasks can be added per device.

Set a Task of Recording

Users can customize task name, recording mode (Record Now or Setting Time), start time, duration (1-60 minutes), and video quality (Standard or Low Quality).

Note: Task time ranges cannot overlap. Detection rules and ToF frequency parameters cannot be modified during recording. Contact Milesight IoT support for a specialized player to play validation videos locally.

Playback Button

Controls for playback: Start Recording, Stop Recording, Set a Task of Recording, and playback buttons (Rewind, Pause, Play, Forward with speed options). Also includes options to enable/disable detection lines, U-turn areas, detection regions, and tracking lines in the footage. Users can download video stream footage.

5.6 System

5.6.1 Device Info

All hardware and software information is available on this page.

Screenshot of the Device Info table showing Device Name, Product Model (VS133-915M), SN, Hardware Version (V1.0), Software Version (V_133.1.0.1-b-t14), and MAC Address.

5.6.2 User

Users can manage device access.

  • Users: Lists existing users (e.g., 'admin' with Administrator level).
  • + Add User: Allows adding new users with specified username, user level, and password.

Users can change the login password.

Screenshots showing user modification, password settings, security question setup, and adding a viewer with limited access.

5.6.3 Time Configuration

Manages the device's time settings.

  • Current System Time: Displays the current date and time.
  • Set the System Time: Allows setting Time Zone, enabling/disabling Daylight Saving Time (Start Time, End Time, DST Bias), and manually setting the time.
  • Synchronize Time: Synchronizes the device time with the computer.
ParametersDescription
Time ZoneChoose the time zone for your location.
Daylight Saving TimeEnable or disable Daylight Saving Time (DST). Start Time: DST start time. End Time: DST end time. DST Bias: adjusts DST time forward based on bias.
Setting TimeManually set the device time.
Synchronize with computer timeSynchronizes the device time with your computer.

5.6.4 System Maintenance

Provides options for device maintenance.

  • Time of Flight Advanced Settings:
    • Frequency Adjustment: Adjusts ToF frequency modulation to avoid interference from surrounding IR devices. Use the same mode if multiple VS133 devices are present. Contact support if only one option is available.
    • ToF Lighting Mode: Set to 'Always On' or 'Schedule'. In Schedule mode, the ToF light is active only during scheduled hours to save power. Note: ToF light off does not affect periodic reports. During validation, ToF lighting is fixed to 'On'. The Dashboard displays relevant information when ToF Lighting Mode is used.
    • ToF Noise Filtering: Filters noisy points on the screen, especially on dark floors or carpets. Recommended strength: 2 for spacious environments, 10 for narrow environments with black carpet.
  • Reset:
    • Recovery device basic configuration: Resets without affecting IP settings and user information.
    • Recovery device to factory settings: Resets to factory defaults, requiring admin password verification.
  • Reboot: Restarts the device immediately.
  • Upgrade: Select an upgrade file and click 'Upgrade'. The device reboots automatically upon completion. The process takes 1-10 minutes; do not turn off power.
  • Backup and Restore: Export or Import configuration files.

6. Installation Instruction

Parameter definition:

ParametersExplanationValue
HInstallation height≤3.5 m
dMinimum detection distance of VS1330.5 m
ΔdDistance measurement error of VS1330.035 m
hmaxMaximum pedestrian heightExample 1.8 m
hminMinimum pedestrian heightExample 1.7 m
αToF horizontal field of view angle98°
βToF vertical field of view angle80°
xLength of detection range
yWidth of detection range

6.1 Installation Height

The maximum installation height is 3.5 m. The minimum installation height is hmax + d + Δd. For example, with a maximum pedestrian height of 1.8 m, the minimum installation height is 1.8 + 0.5 + 0.035 = 2.335 m.

6.2 Covered Detection Area

The detection area depends on the field of view angle, installation height, and target height. The length is approximately x = 2.300 × (H - hmin) and the width is approximately y = 1.678 × (H - hmin).

Table showing detection area examples based on installation height:

Installation HeightFoV Monitored Area (m)Detection Area (m)
2.55.75 × 4.201.84 × 1.34
2.65.98 × 4.362.07 × 1.51
2.76.21 × 4.532.30 × 1.68
2.86.44 × 4.702.53 × 1.85
2.96.67 × 4.872.76 × 2.01
3.06.90 × 5.032.99 × 2.18
3.17.13 × 5.203.22 × 2.35
3.27.36 × 5.373.45 × 2.52
3.37.59 × 5.543.68 × 2.69
3.47.82 × 5.713.91 × 2.85
3.58.05 × 5.874.14 × 3.02

6.3 Environment Requirements

  • Dark floor/carpet (black, grey, etc.) can affect staff counting when Staff Detection is enabled.
  • Avoid 940nm light, which may cause incorrect counting.
  • Mirrored reflections that direct sunlight onto the ToF Sensor should be avoided.
  • Ensure no obstacles are within the device's live view to prevent abnormal imaging (red appearance) or affect people counting. For black carpets/floors, set Noise Filtering Level to maximum.

6.4 Installation

Ceiling Mount

  1. Ensure the ceiling thickness is over 30 mm. Drill 4 holes (6mm diameter) for mounting. If wires need to pass through the ceiling, drill a suitable wire hole.
  2. Fix wall plugs into the ceiling holes.
  3. Remove the device cover. Connect all required wires and pass them through the wire hole behind the device or side block.
  4. Fix the device to the wall plugs using mounting screws. Adjust the mounting direction according to the detection area requirement.
  5. Fix the cover back onto the device.

Ceiling/Lintel Mount (with Optional VB01 Multifunctional Bracket)

  1. Attach the mounting plate to the device with 4 screws.
  2. Fix the pole to the mounting plate using the hole on the plate.
  3. Adjust the pole length and the 3-axis ball direction, then tighten with the handle.
  4. Determine the mounting location, drill 3 holes, insert wall plugs, and fix the bracket base to the wall plugs with mounting screws. (Note: If wires need to pass through the ceiling or wall, drill a suitable wire hole.)
  5. Remove the device cover, connect wires, and pass them through the inside of the pole.
  6. Fix the pole to the bracket base with screws and nuts.

Note: Tilt installation should be avoided. Ensure the device front is parallel to the ground plane. Avoid installing the device against the wall; ensure proper distance between the device and the wall as shown in diagrams.

Diagrams illustrate installation steps and device positioning.

ConditionStandard EnvironmentCarpet/Floor is Dark (set max noise filtering level)
Normal imagingx>50cm, y>60cmx>50cm, y>75cm
Normal countingx>50cm, y>50cmx>50cm, y>50cm
  • Ensure no objects block the ToF light within a 30 cm radius of the device front.
  • For swinging doors, keep the door normally open. If normally closed, install the device on the opposite side of the door movement, at least 30 cm away.

6.5 Factors Affecting Accuracy

  • Wearing a fisherman's hat or carrying a cardboard box on the shoulder may prevent recognition as the target may not appear human-like in the depth map.
  • A humanoid doll with sufficient height carried by hand or on a cart may be mistaken for a person due to its human-like appearance in the depth map.

7. Communication Protocol

7.1 Uplink Data

The VS133 reports basic sensor information upon joining the network and people counts periodically. Decoder examples are available at: https://github.com/Milesight-IoT/SensorDecoders.

ChannelTypeDescription
01(Protocol Version)01=> V1
ff09 (Hardware Version)01 04 => V1.4
16 (Device SN)16 digits
1f (Software Version)85 01 00 05 => 133.1.0.5
03d2 (Accumulated counter)Line 1 accumulated in counter, 4 bytes
04d2 (Accumulated counter)Line 1 accumulated out counter, 4 bytes
05cc (Periodic counter)Line 1: Byte 1-2: in counter during report interval; Byte 3-4: out counter during report interval
06d2 (Accumulated counter)Line 2 accumulated in counter, 4 bytes
07d2 (Accumulated counter)Line 2 accumulated out counter, 4 bytes
08cc (Periodic counter)Line 2: Byte 1-2: in counter during report interval; Byte 3-4: out counter during report interval
09d2 (Accumulated counter)Line 3 accumulated in counter, 4 bytes
0ad2 (Accumulated counter)Line 3 accumulated out counter, 4 bytes
0bcc (Periodic Counter)Line 3: Byte 1-2: in counter during report interval; Byte 3-4: out counter during report interval
0cd2 (Accumulated counter)Line 4 accumulated in counter, 4 bytes
0dd2 (Accumulated counter)Line 4 accumulated out counter, 4 bytes
0ecc (Periodic Counter)Line 4: Byte 1-2: in counter during report interval; Byte 3-4: out counter during report interval
0fe3 (Region Monitoring)Byte 1: people in region 1; Byte 2: people in region 2; Byte 3: people in region 3; Byte 4: people in region 4 (currently)
10e4 (Region Monitoring)Byte 1: region ID

Note: Byte 2-3: avg. dwell time; Byte 4-5: max. dwell time. If children distinction or staff detection is enabled, counts are adjusted (e.g., accumulated in counter = total in counter - children in).

Examples of device information and people counter reports are provided.

7.2 Downlink Command

The VS133 can be configured via downlink commands. The default Application Port is 85.

ChannelTypeDescription
10 (Reboot)ff (Reserved)
03 (Reporting Interval)2 Bytes, unit: s
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: disable/enable per bit.
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
44 (People Counting Trigger Report)00: disable, 01: enable
51 (Clear the accumulated counting)ff (Reserved)

Note: After changing LoRaWAN® parameters, the device will re-join the network.

Examples of downlink commands are provided (e.g., disabling Wi-Fi, setting channel mask, rebooting, setting reporting interval).

Models: VS133, VS133 People Counting Sensor, VS133, People Counting Sensor, Counting Sensor, Sensor

File Info : application/pdf, 34 Pages, 1.83MB

PDF preview unavailable. Download the PDF instead.

vs133-user-guide-en

References

WPS 文字

Related Documents

Preview Milesight VS133 AI ToF People Counting Sensor Quick Start Guide
Concise guide for installing and configuring the Milesight VS133 AI ToF People Counting Sensor, covering hardware, power supply, installation, and web access.
Preview Milesight VS133 AI ToF People Counting Sensor User Guide
Comprehensive user guide for the Milesight VS133 AI ToF People Counting Sensor, detailing its features, hardware, operation, installation, communication protocols, and troubleshooting. Learn how to deploy and configure this advanced sensor for accurate people counting in various environments.
Preview Milesight VS133 AI ToF People Counting Sensor User Guide
Comprehensive user guide for the Milesight VS133 AI ToF People Counting Sensor, detailing its features, hardware, installation, configuration, communication protocols (LoRaWAN, PoE), and operation for accurate people counting in various environments. Includes safety precautions and technical specifications.
Preview Milesight People Sensing Product Portfolio: Enhance Efficiency and Insight
Explore the Milesight People Sensing Product Portfolio, featuring advanced AI-driven sensors for occupancy, people counting, and human behavior analysis. Discover solutions for smart buildings, retail, transportation, and elderly care, optimizing space, improving security, and driving operational efficiency.
Preview Milesight VS132 3D ToF People Counting Sensor User Guide
Comprehensive user guide for the Milesight VS132 3D Time-of-Flight (ToF) People Counting Sensor, featuring LoRaWAN connectivity. Covers installation, configuration, operation, and technical specifications.
Preview Milesight VS321 Wireless AI Occupancy Sensor Datasheet
Datasheet for the Milesight VS321, a low-power, battery-operated wireless occupancy sensor featuring advanced AI algorithms, LoRaWAN connectivity, and environmental monitoring capabilities.
Preview Milesight VS121 AI Workplace Sensor User Guide
Milesight VS121 AI Workplace Sensor: A comprehensive user guide detailing installation, configuration, and operation of this advanced IoT sensor for occupancy and utilization monitoring using AI and LoRaWAN technology.
Preview Milesight Product Catalog: AI, IoT, 5G, and LoRaWAN Sensing Solutions
Explore the comprehensive Milesight product catalog featuring AI-powered surveillance cameras, IoT sensors, 5G connectivity solutions, and LoRaWAN devices for smart buildings, security, and environmental monitoring.