AI Workplace Sensor Featuring LoRaWAN VS121 User Guide 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 Do not place the device where the temperature is below/above the operating moisture before installation. 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. Make sure the plug is firmly inserted into the power socket. Do not expose the device to where a laser beam equipment is used. Use a soft, dry cloth to clean the lens of the device. Stubborn stains can be removed using a cloth dampened with a small quantity of detergent solution, then wipe them dry. Declaration of Conformity of the CE, FCC, and RoHS. VS121 is in conformity with the essential requirements and other relevant provisions Copyright 2011-2022 Milesight. All rights reserved. All information in this guide is protected by copyright law. Whereby, no organization or individual shall copy or reproduce the whole or part of this user guide by any means without written authorization from Xiamen Milesight IoT Co., Ltd. For assistance, please contact Milesight technical support:
Email: iot.support@milesight.com Tel: 86-592-5085280 Fax: 86-592-5023065 Address: Building C09, Software Park Phase III, Xiamen 361024, China 2 Revision History Date Doc Version Description Apr. 26, 2021 V 1.0 Initial version Jan. 18, 2022 V 1.1 3. Support people counting debounce;
1. Support line crossing counting feature;
2. Support LoRa D2D feature;
4. Support uploading max number of people;
5. Support downlink control. 1. Milesight LOGO update 2. Support recognition scheme selection Apr. 8, 2022 V 1.2 3 Contents 1. Product Introduction ................................................................................... 5 1.1 Overview ........................................................................................... 5 1.2 Key Features ...................................................................................... 5 2. Hardware Introduction ................................................................................ 5 2.1 Packing List ........................................................................................ 5 2.2 Hardware Overview ............................................................................. 6 2.3 Buttons and LED Indicators .................................................................. 6 2.4 Dimensions ........................................................................................ 6 3. Access the Sensor ...................................................................................... 7 3.1 Access without Plugin .......................................................................... 7 3.2 Access with Plugin ............................................................................... 8 4. Operation Guide ....................................................................................... 10 4.1 Live Video ........................................................................................ 10 4.2 IoT .................................................................................................. 11 4.2.1 Region People Counting ..............................................................11 4.2.2 Line Crossing Counting .............................................................. 12 4.2.3 LoRa ........................................................................................14 4.2.4 Wi-Fi ....................................................................................... 16 4.2.5 Recognition Scheme .................................................................. 18 4.3 Advanced Settings ............................................................................. 18 4.3.1 Security ................................................................................... 18 4.3.2 Logs ........................................................................................ 20 4.4 System ............................................................................................ 21 4.5 Maintenance ..................................................................................... 21 4.5.1 System Maintenance ..................................................................21 4.5.2 Auto Reboot ............................................................................. 22 5. Installation .............................................................................................. 22 6. Device Payload ......................................................................................... 23 6.1 Uplink Data ...................................................................................... 23 6.2 Downlink Command ........................................................................... 25 4 1. Product Introduction 1.1 Overview VS121, based on Artificial Intelligence (AI) technology, is an AI workplace sensor de signed to monitor occupancy & utilization in modern workspace, which can reach up to 95% recognition rate. With the ability to sense from up to 78m2, fewer sensors ar e needed to cover the same area, decreasing the deploy costs for users. Only count er values are transmitted over LoRaWAN network to prevent the privacy concerns. VS121 is equipped with Wi-Fi for easy configuration without any tools. Sensor data are transmitted in real-time using standard LoRaWAN protocol. LoRaWAN enables encrypted radio transmissions over long distance while consuming very little power. The user can obtain sensor data and view the trend of data change through the users own network server. 1.2 Key Features Recognition rate is up to 95% based on advanced AI identification and analysis technology and wide detection range Support to map up to 12 custom regions No image data is collected, free from privacy concerns Equipped with Wi-Fi for web GUI configuration Function well with standard LoRaWAN gateways and network servers 2. Hardware Introduction 2.1 Packing List 1 VS121 4 Wall 1 1 Device Mounting Type-C Cable (1 m) Mounting Kits
& Power Adapter Sticker 5 1 1 Warranty Card Quick Guide representative. 2.2 Hardware Overview If any of the above items is missing or damaged, please contact your sales 2.3 Buttons and LED Indicators Function Action Turn On/Off seconds. seconds. Press and hold the Wi-Fi button for more than 3 Wi-Fi Press and hold the Wi-Fi button for more than 3 LED Indication Off On On Off Reset to Factory Press and hold the reset button for more than 10 Blinks 6 Default seconds. times. 2.4 Dimensions (mm) 6 3. Access the Sensor VS121 sensor provides user-friendly web GUI for configuration and users can access it via Wi-Fi connection. The recommended browsers are Internet Explorer, Firefox, Chrome, Microsoft Edge, Safari. The default IP of sensor is 192.168.1.1, and default SSID is Vision Sensor_XXXXXX (can be found on the label). 3.1 Access without Plugin 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 when using the sensor for the first time. And three security questions can also be set optionally. After configuration, use username
(admin) and custom password to log in the sensor. Note:
1) Password must be 8 to 32 characters long, contains at least one number and one letter. 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. 7 3.2 Access with Plugin For IE browser access, users need to install the MsActiveX firstly. You can refer the steps as follows:
Step1: Launch the IE browser and enter the IP address of the sensor;
Step2: Enter the user name and custom password and click Login;
Step3: At the first time to log in the device, the browser will prompt to install Controls, please click Click here to download and install controls manually as shown below;
NoteDuring installing the controls, please keep the browsers close. Step4: Follow the prompts to install the Controls, when it`s finished, it will pop out a window as shown below. Please click Finish and refresh the browser, then you 8 will see the video. If IE9 or higher version browser is used, it is suggested that the web link should be added as a trusted site. See the instructions as follows:
Step1: Start the IE9 or higher version browser, and select Tools Internet Options;
Step2: Select Security to Trusted;
9 Step3: Enter the IP address of the device in the blank and click Add;
Step4: Enter the IP address. After logging on web GUI successfully, user is allowed to view live video. 4. Operation Guide 4.1 Live Video After logging on to the device web GUI successfully, user is allowed to view live video as follows. Parameters Description Brightness: Adjust the Brightness of the scene Contrast: Adjust the color and light contrast Saturation: Adjust the image. Higher the Saturation of Saturation makes colors appear more "pure" while lower one appears more wash-out Sharpness: Adjust the Sharpness of image. Higher Sharpness sharps the pixel boundary and makes the image looks more 10 Image Config clear Window size Real size Full Screen
Enable Digital Zoom 4.2 IoT 2D DNR/3D DNR: Adjust the noise reduction level Default: Restore brightness, contrast and saturation to default settings Click to access the configuration page People Counting (Region): show the mapped or non-mapped regions of people counting Line Crossing Counting: show the detection line and people it detected Hide Detection Region: hide people detection region Click to display images at a window size Click to display images at a real size Click to display images at full-screen Start/Stop live view When enabled, you can zoom in in a specific area of video image with your mouse wheel 4.2.1 Region People Counting Users can set the report settings and detection regions here. 11 Parameters Description Enable Enable or disable region people counting feature. Number of People Show current number of people. Report Regularly Report the current number of people according to reporting interval. Reporting Interval: 5-3600s, default: 300 s Report by Result Debounce Time Report according to following people number results:
Zero and Non-zero Once result changes VS121 will reduce the count value only the people come out of the detection area for more than 2 s. Enable Enable the detection area customization feature. If disabled, the whole area will be detection area. Detection Area Select the customized area as either mapped or except mapped area. You can draw the area in the below screen. 12 regions can be set at most. Mapped Region: Only people who are in the mapped region will be detected. Non-mapped Region: Only people who are not in the mapped region will be detected. Clear Clear all areas you have drawn before. 4.2.2 Line Crossing Counting 12 When the sensor detected the people crossing a defined virtual line, it will upload the counting. Parameters Description Enable Enable or disable line crossing counting feature. Reporting Interval Report the count value of people in/out during the reporting interval, the device will clean the previous values to re-count after reported, range: 5-3600 s, default: 300 s Set Detection Line The device allows to set up only one line. For the detection line, crossing along the direction of the arrow means In and opposite is Out. Clear Clear the line you have drawn before. Note: the arrow direction of the detection line depends on the direction of your draw. 13 LoRa settings is used for configuring the transmission parameters in LoRaWAN network or LoRa D2D network. 4.2.3 LoRa 4.2.3.1 Basic Settings Parameters Description Status LoRaWAN network status of this device. Device EUI Unique ID of the device which can also be found on the label. App EUI Default App EUI is 24E124C0002A0001. Join Type OTAA and ABP mode are available. Application Key 5572404C696E6B4C6F52613230313823. Appkey for OTAA mode, default Device Address DevAddr for ABP mode, default is the 5th to 12th digits of SN. Network Session Nwkskey for ABP mode, default Key 5572404C696E6B4C6F52613230313823. Application Appskey for ABP mode, default Session Key 5572404C696E6B4C6F52613230313823. is is is RX2 Data Rate RX2 data rate to receive downlinks or send LoRa D2D command. RX2 Frequency/MHz Confirmed Mode RX2 frequency to receive downlinks or send LoRa D2D command. If the device does not receive ACK packet from network server, it will resend data 3 times at most. 14 ADR Mode Allow network server to adjust data rate of the device. Reporting interval 30 mins: the device will send specific mounts of LoRa MAC packets to check connection status every 30 mins; If no Rejoin Mode reply after specific packets, the device will re-join. Reporting interval > 30 mins: the device will send specific mounts of LoRaMAC packets to check connection status every reporting interval;
If no reply after specific packets, the device will re-join. Application Port The port used for sending and receiving data, default port is 85. Spreading Factor If ADR is disabled, the device will send data via this spreading factor. LoRaWAN Version V1.0.2, V1.0.3, V1.1.0 are available. Region Frequency plan of this device. Enter the index to select the frequency channel. 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 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 -915M model, default frequency Channel Note:
is AU915. 4.2.3.2 LoRa D2D Settings LoRa D2D protocol is developed by Milesight and used for setting up transmission among Milesight LoRa devices without gateway. When the LoRa D2D setting is enabled, VS121 can work as a LoRa D2D controller for sending control commands to trigger LoRa D2D agent devices. 15 Parameters Description Enable D2D Enable or disable LoRa D2D feature. LoRa D2D Key Condition Control Command Define a unique LoRa D2D key and this key is the same as the setting in LoRa D2D agent device. Default value: 5572404C696E6B4C6F52613230313823 Occupied: when total people counter value is non-zero in detection area Unoccupied: when total people counter value is 0 in detection area Define a 2-byte hexadecimal control command (0x0000 to 0xffff). When the condition is meet, the device will send the control command to corresponding LoRa D2D agent devices. Note: When this feature is enabled, the control command from this device will not send to LoRaWAN gateway. 4.2.4 Wi-Fi 16 Parameter s Enabled Enable Wi-Fi feature. Description Work Mode Work mode is fixed as AP and can not connect to other access point. SSID The unique name for this device Wi-Fi access point. 802.11b (2.4 GHz), 802.11g (2.4 GHz), 802.11n (2.4 GHz) are Protocol optional. Bandwidth 20 MHz or 40 MHz are optional. Channel Select the wireless channel. Auto, 1,...11 are optional. Security No Encryption, WEP Open System, WEP Shared Key, WPA-PSK, WPA2 Mode
-PSK and WPA-PSK/WPA2-PSK are optional. LAN IP Address: IP address that used to access the web GUI of DHCP Server Subnet mask: identify the subnet where the sensor is located. Settings Start Address: define the beginning of IP address pool which assigns sensor. to DHCP clients. End Address: define the end of IP address pool which assigns to DHCP 17 clients. Lease Time (min): the lease time on which DHCP client can use the IP address assigned by the sensor. Primary DNS Server: translate the domain name to IP address. Secondary DNS Server: backup DNS server. Static IP Add MAC address and static IP address if users need to add a static IP Settings address to a specific computer. 4.2.5 Recognition Scheme You can select the recognition scheme for region people counting. Parameter s Recognition Scheme Description Select the recognition scheme based on your detection environment. After saving, the device will restart automatically to make the change and take effect. Algorithm 1: Suitable for monitoring complex environments which have many objects, like office supplies (books, printers, lamps, etc.) Algorithm 2: Suitable for monitoring simple and clean environments like meeting rooms. 4.3 Advanced Settings 4.3.1 Security User 18 Parameter s Description Click Edit button to set three 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. Security Question There are twelve default questions below, you can also customize the security questions. 19 Click Add button, it will display Account Management page. Users can add an account by entering Admin Password, User Level, User Name, New Password, Confirm, and edit user privilege by clicking
. The added account will be displayed in the account list. Users can add 20 accounts at most. Admin Password: enter the correct admin password before adding an account. User Level: Set the privilege for the account. User Name: Input user name for creating an account. Password: Input password for the account. Confirm: Confirm the password. You can edit and delete the account in the account list under the admin account. For the default admin account, you can only change the password, and it cannot be deleted. Account Managemen t 4.3.2 Logs The logs contain the information about the time and IP that has accessed the web GUI. Parameter s Main Type Select main log types Description Sub Type On the premise of main type has been selected, select the sub type to narrow the range of logs Start Time The time of the log starts End Time The time of the log ends Log Export Export the logs Save Period Set the period of log saving, there are eight options to choose:
20 Permanent and 30/60/120/180/240/300/360 Days Go Input the number of logs page 4.4 System All information about the hardware and software can be checked on this page. 4.5 Maintenance 4.5.1 System Maintenance Parameter s Description 21 System Upgrade Maintenance Software Version: The software version of the sensor. Local Upgrade: Click the Choose File button and select the upgrading file, then click the Upgrade button to upgrade. After the system reboots successfully, the update is done. You can check Reset after Upgrading to reset the device after upgrading it. Note: Do not disconnect the power of the device during the upgrade process. The device will be restarted to complete the upgrading. Reset settings: Click Reset button to reset the device to factory default settings Keep the IP Configuration: Check this option to keep the IP configuration when resetting Keep the User Information: Check this option to keep the user information when resetting Export Config File: Export configuration file. Import Config File: Click the Choose File button and select the configuration file, click Import button to import configuration file. Reboot Restart the device immediately 4.5.2 Auto Reboot Set the date and time to enable device auto reboot, the device will reboot automatically according to the customized time in case that sensor overload after running a long time. Before configuration note that the date and time should correct. 5. Installation Step 1: Ensure the thickness of ceiling is more than 30 mm, then attach the mounting sticker to the ceiling and drill 4 holes with a diameter of 6 mm. Step 2: Fix the wall plugs into the ceiling holes. Step 3: Remove the cover on the device, then fix the device to the wall plugs via mounting screws; remember to adjust the mounting direction according to the 22 detection area requirement and direction sticker on the inner cover. Step 4: Take the cover back to device; note that the Milesight Logo should be facing the LED indicator. 6. Device Payload VS121 reports basic information only when joining the network and reports people counter according to reporting settings. All data are based on following format(HEX):
Channel Type1 Data1 Channel2 Type Data2 Channel 3
... 1 Byte 1 Byte N Bytes 1 Byte M Bytes 1 Byte
... please For https://github.com/Milesight-IoT/SensorDecoders. examples decoder find files on 2 1 Byte 6.1 Uplink Data VS121 report basic information of sensor whenever joining the network and the number of people according to settings. Type Description 01(Protocol Version) 01=> V1 08 (Device SN) 12 digits 09 (Hardware Version) 01 04 => V1.4 1 Chann el ff 23 1f (Software Version) 1f 07 00 4b => V31.7.0.75 c9 (Region People 04 Counter) 05 06 cd (Max People Counter) Byte 1: current total number of people Byte 2: how many mapped regions is customized Byte 3-4: indicate which mapped regions having detected people, 0 means no people detected, 1 means there are people detected in this mapped region Byte 1-2: in counter during the report interval Maximum number of people in detection area during the reporting interval of region people counting. Note: this value only update when you enable Report Regularly option. cc (Line Cross interval Counter) Byte 3-4: out counter during the report Example:
1. Device information ff0101 ff086600b0940976 ff090100 ff1f1f07004b Type Value Channel Type Value Channe l Channe l ff ff 01
(Protocol Version) 09
(Hardware version) 01 (V1) ff 08
(Device SN) 66 00 b0 94 09 76 Type Value Channel Type Value 0100 (V1.0) ff 1f
(Software version) 1f 07 00 4b
(V31.7.0.75
) 2. Region people counter regular uplink 04c9030800a1 06cd05 24 Channe l Type 04 c9 (Region People Counter) Value Byte 1: 03 => There are 3 people totally now Byte 2: 08 => there are 8 mapped regions Byte 3-Byte 4: 00 a1=>1010 0001 there are people detected in region 1, 6 and 8 Type Value cd (Max People Counter) 05 => during the reporting interval, the maximum number of people is 5 05cc02000100 Type Value Cc (Line Crossing Counter) In: 02 00 => 00 02 = 2 Out: 01 00 => 00 01 =1 6.2 Downlink Command VS121 supports downlink commands to configure the device. Application port is 85 by 3. Line cross counter Channe l 06 Channe l 05 default. Chann el Type Description 10 (Reboot) ff (Reserved) 04 (Confirmed Mode) 00: disable, 01: enable Byte 1: Channel index range ff 05 (Change LoRa Channel Mask) 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 25 41 (Configure Application Port) 42 (Wi-Fi) 1 Byte, default is 85 00: disable, 01: enable 50 (Region People Counting) 00: disable, 01: enable 43 (Region People Counting Report Regularly) 44 (Region People Counting Report by Result) 45 ( Report by Result Mode) 00: disable, 01: enable 00: disable, 01: enable 00: Zero and Non-zero 01: Once result changes 48 (Line Crossing Counting) 00: disable, 01: enable Noteafter changing LoRa setting, the device will re-join the network. Example:
1. Disable the Wi-Fi. ff4200 Channel ff Type 42 (Wi-Fi) Value 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) 26 FCC Warning:
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions
(1) this device may not cause harmful interference, and
(2) this device must accept any interference received, including interference that may cause undesired operation. Changes or modifications not expressly approved by the party responsible for compliance could void the users authority to operate the equipment. Note 1: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. However, there is no guarantee that interference will not occur in a particular installation. interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: Reorient or relocate the receiving antenna. Increase the separation between the equipment and receiver. Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help. Note 2:
1. Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the users authority to operate the equipment. 2. The minimum separation generally be used is at least 20 cm. If this equipment does cause harmful
-END-
27