TeraBee TeraRanger Evo Swipe Plus User manual

User Manual for
TeraRanger Evo Swipe Plus
(Touchless User Interface)



 
Technical support: [email protected]
Sales and commercial support: [email protected]

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 Indicators 15
Normal operation 15
Troubleshooting 15
Electrical characteristics 16
USB/UART Normal Operation 16
Operating Modes of the TeraRanger Evo Swipe Plus sensor 16
Bidirectional People Traffic Detection Mode 16
Presence Detection Mode 17
Engagement Trigger Mode 17
Gesture Recognition Mode 18
Swipe Mode 18
Validation Mode 19
Installation of Graphical User Interface Package 19
Linux and Raspberry Pi 19
Windows 19
Graphical User Interface (GUI) 20
Bidirectional People Traffic Detection Mode 21
Presence Detection Mode 21
Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

2/29

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. Its touchless gesture recognition features offer          
convenience for users and companies by reducing the risk of virus transmission and the             
need for constant disinfection of user interfaces.
1.1. About the TeraRanger Evo Swipe Plus


Figure 1. TeraRanger Evo Swipe Plus sensor, top view

The Evo Swipe Plus sensor has no open electronics and provides an ABS protected             
enclosure, resulting in a dust-proof and robust operation.








Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

4/29

1.2. Technical Specifications
Table 1 - Technical specifications of TeraRanger Evo Swipe Plus
Product code
TR-EVO-SWP-PL-USB
TR-EVO-SWP-PL-UART
Performance
TeraRanger Evo Swipe Plus USB | UART
Detection Principle
Infrared Time-of-Flight
Light Source Wavelength
940 nm
Use Environment
Indoor
Field of View
27°
Operation Modes
Presence Detection (PD)
Bidirectional People Traffic Detection (BPTD)
Engagement Trigger (ET)
Gesture Recognition (GR)*
Electronics

Supply Voltage
5V DC +/-5%
Current Consumption Average
50 mA
Initialization Time
< 1 s
Communication

Serial Interface
USB 2.0 Micro-B
UART, +3.3V level, 115200,8,1, None
Visual Notification
3 x LEDs (built-in backboards)
Mechanical data

Dimensions
42 x 30 x 13 mm (incl. backboard)
Weight
9 g (incl. backboard)
Operating Temperature
-20° C to 75° C
Housing Material
ABS
Mounting Style
2 holes for M2 screws
Type of Connection
USB Backboard: USB 2.0 Micro-B
I2C/UART Backboard: DF13-7p connector


Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

5/29

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
X: People inside
Y: People IN,
Z: People OUT
Presence Detection
(PD)

~ 0.2 m to 3 m
~20 Hz
String: “Presence” or “Person moved
away”
X : Presence count
Engagement Trigger
(ET)

~ 0.5 m to 1.5 m
PD~20 Hz
BPTD~25 Hz
Change Mode:
- BPTD or PD Modes to GR Mode
- GR Mode to BPTD or PD Modes
-String: “Engagement” or
“Disengagement”
Gesture Recognition
(GR)

Swipe:
~ 0.1 m to 0.5 m
~25 Hz
Validation:
~ 0.01 m to 0.15 m
~25 Hz
Swipe:
-String: “Left” or “Right”

Validation:
-String: “Validation”
1.2.2. Communication interfaces
Table 3 - Communication interfaces for the evo swipe plus
Evo Swipe Plus


Communication
Interfaces
USB

●
UART

●
Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

6/29

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. Mechanical design and mounting

The TeraRanger Evo Swipe Plus sensor offers an ABS housing (both: sensor and            
backboard), with an option to mount the sensor using two holes compatible with M2             
screws. Figure 3 illustrates the external dimensions of the TeraRanger Evo Swipe Plus            
sensor.
Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

7/29


Figure 3 - TeraRanger Evo Swipe Plus 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:

1- Front-panel mount using the M2 screws
2- 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. The second provides a more            
discreet installation and supports design-in projects by installing the sensor behind a           
surface (e.g panel), ideally with 2mm thickness.
Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

8/29

Figure 4 - Front-panel mounting (left image); back-panel mounting (right images)
2.3. Mounting solutions
When choosing a place for mounting the TeraRanger Evo Swipe Plus, please consider            
the following recommendations:

●Mounting close to sources of heat or strong electromagnetic fields can decrease           
sensor performance
●Do not mount anything directly in front of the sensor or in a cone of              
approximately +/-35° around the central optical axis of the sensor
●It is advisable to avoid having other sources of Continuous Wave or modulated            
Infrared light sources near the sensor
●Please consider that dust, dirt and condensation can affect sensor performance
●It is not advised to add an additional cover in front of the sensor

During assembly and integration, please observe all common ESD precautions. All          
optical surfaces (sensor front) should be kept clean and free from contact with            
chemicals.
Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

9/29

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.

Table 4 - LED indicators of the USB backboard
LED designator
Description
PWR (ORANGE)
The Power LED is ON whenever the sensor is powered
RED
Flashes briefly on startup to indicate proper initialization;
then switches off
GREEN
Blinks 8 times at power up
GREEN LED blinks every 5 seconds when the sensor is streaming          
data
3.1.2. Error messages and troubleshooting
Table 5 - USB backboard LEDs troubleshooting

LED
designator
Sequence
Signification
Corrective actions
RED
Continuous
blinking
Sensor has detected a fault    
and has stopped functioning
Check that the sensor is    
properly connected to the   
backboard, then restart  
the sensor
RED /
GREEN
Both LEDs
blinking
continuously
Sensor has detected a fault in     
the sensor initialization  
process
Check USB output for   
details of the error

Verify that the sensor is    
properly connected and  
re-power the unit


Copyright © Terabee 2020
Terabee, 90 Rue Henri Fabre
01630, St Genis-Pouilly, France (next to CERN)

10/29