User Manual for TeraRanger Evo Swipe Plus (Touchless User Interface) Technical support: support@teraranger.com Sales and comme rcial support: terabee-sales@terabee.
Table of contents: Introduction 4 About the TeraRanger Evo Swipe Plus 4 Technical Specifications 5 Performance Table 6 Communication interfaces 6 Mechanical Integration 7 Modular design (clip-on, clip-off) 7 Mechanical design and mounting 7 Mounting solutions 9 USB Backboard Use 10 LED Indication 10 Normal operation 10 Error messages and troubleshooting 10 Connecting the TeraRanger Evo to a Host Computer 11 Windows OS 11 I2C/UART Backboard Use 14 I2C/UART pinout 14 LED Indi
Engagement Trigger Mode 22 Gesture Recognition Mode 22 Swipe Mode (Last gesture) 22 Validation Mode 22 Button to Reset Counters 22 List of sensor commands available via USB/UART 23 Details of the sensor output values 24 Output in Bidirectional People Traffic Detection Mode 24 Presence Detection Mode 25 Engagement Trigger Mode 25 Gesture Recognition Mode 26 General Remarks 29 Copyright © Terabee 2020 Terabee, 90 Rue Henri Fabre 01630, St Genis-Pouilly, France (next to CERN) 3/29
1. Introduction Evo Swipe Plus provides four complimentary modes in one small sensor module that is discreet and easy to integrate. The sensor will detect the presence of people and their proximity to the sensor, it will understand which direction people are moving in and switch to a touchless gesture recognition mode for people to interact with information panels, kiosks and other devices.
1.2.
Conformity Reference Standard CE, RoHS *For optimal performance the users’ body should be more than 0.5 m from the sensor, with their hand swiping in the 0 .1 m to 0.5 m range of the sensor. 1.2.1. Performance Table Table 2 - performance table of the evo swipe plus Mode Detection Output Bidirectional People Traffic Detection (BPTD) ~ 0.3 m to 1.7 m ~25 Hz Presence Detection (PD) ~ 0.2 m to 3 m ~20 Hz Engagement Trigger (ET) ~ 0.5 m to 1.
2. Mechanical Integration 2.1. Modular design (clip-on, clip-off) The mechanical design of the main sensor module (black) allows easy assembly to its backboard (yellow) using a simple ‘clip-on’ technique. When clipping the two together, please ensure there is no visible gap between the black and yellow parts. Figure 2 - Modular design of the TeraRanger Evo Swipe Plus sensor 2.2.
Figure 3 - TeraRanger Evo Swipe P lus external dimensions, USB backboard The USB Backboard includes two holes for mounting the sensor using standard M2 screws. The following methods can be used to mount the TeraRanger Evo Swipe Plus sensor: 12- Front-panel mount using the M2 screws Back-panel mount using the 2mm ledge on the front side of the sensor Figure 4 illustrates the two different mount methods. The first solution allows for easy surface attachment and rapid evaluation of the sensor.
Figure 4 - Front-panel mounting (left image); back-panel mounting (right images) 2.3.
3. USB Backboard Use 3.1. LED Indication 3.1.1. Normal operation Three LED indicators are present on the USB backboard, and are visible through the back of the yellow plastic case.
3.2. Connecting the TeraRanger Evo to a Host Computer 3.2.1. Windows OS In Windows it is possible to use any terminal emulation software for data display. Terabee works with and suggests using HTerm software. Please follow the provided link to download the software file (http://www.der-hammer.info/terminal/), and select the appropriate file for your platform. Tested with version 0.8.4 on Linux x64 and Windows 10 x64 platforms.
Click on LF, and in the line-end marker select the header of the operating mode for easier data reading. Figure 5 - HTerm parameters for TeraRanger Evo Swipe Plus Once the USB port is selected and the parameters correctly set, click on the “Connect” button. The TeraRanger Evo Swipe Plus data will now appear in the “Received data” box depending on the current working mode (see Figure 6).
Figure 6 - Example of Data stream on HTerm software Copyright © Terabee 2020 Terabee, 90 Rue Henri Fabre 01630, St Genis-Pouilly, France (next to CERN) 13/29
4. I2C/UART Backboard Use The TeraRanger Evo Swipe Plus sensor can output data through a UART interface using an I2C/UART backboard. Figure 8 - I2C/UART backboard front view 4.1. I2C/UART pinout The I2C/UART backboard uses a single 9 pin Hirose DF13 connector for interfacing to the host system. The mating connector is a Hirose DF13-9S-1.25C with crimping contacts DF13-2630SCF (tin) or DF13-2630SCFA (gold).
4.2. LED Indicators 4.2.1. Normal operation The I2C/UART Backboard has three built-in LEDs behind the yellow case to visualize feedback of the sensor status. Table 7 lists the functionality of each LED of the I2C/UART backboard. Table 7 - LED indicators of the I2C/UART backboard LED Description PWR (orange) Power indicator, constantly ON when 5V is supplied Rx (red) Tx (green) I2C/UART receive and transmit indicators. Single blink for each data received or sent 4.2.2.
4.3. Electrical characteristics Table 9 - TeraRanger Evo Swipe Plus power consumption Parameter Minimum Maximum Average Power supply Voltage input (V) Current consumption (mA) 4.5V 25mA 5.5V 75mA 5V 50mA Interface logic levels (referenced to +3V3) LOW HIGH 2.3 1 - - 5. USB/UART Normal Operation 5.1.
Figure 9: Sensor orientation for People Counting Mode The detection range of this mode can be adjusted from a minimum of 0.3 m to a maximum of 1.7 m. To detect a person passing the set detection range has to be breached. 5.1.2. Presence Detection Mode In Presence Detection Mode, the sensor counts people passing by in front of the Evo Swipe Plus, regardless of their direction. A presence is detected when a person is standing at a set range for a set time.
sensor switches from Presence Detection or Bidirectional People Traffic Detection Mode to Gesture Recognition Mode - read details in the next section. When the “engaged” person is leaving, the sensor detects the change and switches back from Gesture Recognition Mode to Presence Detection Mode or Bidirectional People Traffic Detection Mode. When changing its state, the sensor outputs a character string corresponding to Engagement or Disengagement.
● When a person performs a Left to Right gesture, the sensor outputs a character string “Right” The default working range is from 0.2 m to 0.4 m, and can be adjusted from a minimum of 0.1 m to a maximum of 0.5 m. The user’s body should be more than 0.5 m away from the sensor, with their hand swiping in the 0.1 m to 0.5 m range of the sensor, to avoid negatively affecting the sensor’s behavior and to remain out of the sensor’s field of view. Notes: 1. A minimum of 0.
● ● ● To launch the GUI double click on the icon “EvoSwipePlus” on the Desktop To launch with terminal information, right click on the icon and choose “Open file location”. Open a cmd terminal there and type the command: “cd ..” and then Python\python.exe pkgs\main.py 5.3.
Figure 11: GUI in standard mode 5.3.1. Bidirectional People Traffic Detection Mode Bidirectional People Traffic Detection Mode is activated by default. The three numbers below the title correspond to three meters: ● Meter 1 displays the difference between the 2nd and the 3rd meter.
5.3.2. Presence Detection Mode By default, Presence Detection is “Not activated”. Presence Detection can be activated by ticking the checkbox “Activate Presence Detection”. Once activated: ● The status notification switches between “Presence” and “Person moved away” ● A meter counts the number of people passing by ● The first slider sets the Presence detection range in cm.
5.4. List of sensor commands available via USB/UART The commands listed below can be used to push default parameters to an Evo Swipe sensor via a command line within an HTerm window, or through a Python script for example.
BINARY OUTPUT PARAMETERS SETTINGS VALUES 00 61 02 EE ³ Where MM NN SS TT ³ Where EE FF JJ HH ³ Where II GG KK LL important) ³ Where OO PP QQ RR ³ Where YY ZZ UU VV OUTPUT SETTING: TEXT OUTPUT PARAMETERS SETTINGS VALUES is max and min of BPTD thresholds in hexadecimal format. (order is very important) is max and min of GR SWIPE thresholds in hexadecimal format. (order is very important) is the Engagement Trigger data “ thresholds and time” in hexadecimal format.
Where: “PC”: frame header. Counter = Counter IN - Counter OUT Counter IN: number of people passing by from Left to Right Counter OUT: number of people passing by from Right to Left 5.5.2. Presence Detection Mode In Presence Detection Mode the sensor counts the presence of people in front of the TeraRanger Evo Swipe Plus When streaming data using HTerm, the sensor goes on streaming frames that contain a header of ”TT” followed by one distance represented by two bytes and one CRC byte.
“EE” 2 bytes “Engagement” :10 bytes “Disengagement” :13 bytes “\n” 1 byte Where: “EE”: frame header String message: “Engagement” or “Disengagement” New line character: \n (10 decimal / 0x0A hex) 5.5.4. Gesture Recognition Mode This mode provides users with specific data related to the hand gesture in a close range once the sensor has switched in Gesture Recognition Mode. When streaming data using HTerm, the sensor streams a frame that contains a header of “DD” followed by two distances.
5.5.5. Reset counters This command will reset the counters for both presence detection and bidirectional people traffic detection modes. Once the sensor receives the reset command, the sensor outputs the following frames that contain this additional information: 5.5.5.1.
2 bytes 2 bytes “PD” 2 bytes PD max range thresholds (millimeters) 2 bytes “ET” 2 bytes range trigger (millimeters) 2 bytes “GR” 2 bytes swipe minimum thresholds (millimeters) 2 bytes engagement time (seconds) 1 byte swipe maximum thresholds (millimeters) 2 bytes PD time thresholds (millisecond) 2 bytes disengagement time (seconds) 1 byte validation range thresholds (millimeters) 2 bytes validation time thresholds (milliseconds) 2 bytes CRC 1 byte 5.5.6.2.
6. General Remarks ● If the sensor is disconnected/powered down, the BPTD or PD counters are automatically reset. ● The parameter sliders present in the GUI are connected to each other. For instance, if you move the maximum range value for the Swipe Mode too close (<25 cm) to the minimum range threshold of the Engagement Trigger Mode, then this Engagement threshold will automatically increase to keep the minimum range interval required.