TeraBee TeraRanger Evo Swipe Plus User manual

User Manual for
TeraRanger Evo Swipe Plus
(Touchless User Interface)
Technical support: terabee.com/support/
Sales and commercial support: [email protected]

Table of contents
1. Introduction 4
1.1. About the TeraRanger Evo Swipe Plus 4
1.2. Technical specifications 5
1.2.1. Performance table 6
1.2.2. Communication interfaces 6
2. Mechanical integration 7
2.1. Modular design (clip-on, clip-off) 7
2.2. Mechanical design and mounting 7
2.3. Mounting solutions 9
3. USB Backboard Use 10
3.1. LED Indication 10
3.1.1. Normal operation 10
3.1.2. Error messages and troubleshooting 10
3.2. Connecting the TeraRanger Evo to a Host Computer 11
3.2.1. Windows OS 11
4. I2C/UART Backboard Use 14
4.1. I2C/UART pinout 14
4.2. LED Indicators 15
4.2.1. Normal operation 15
4.2.2. Troubleshooting 15
4.3. Electrical characteristics 16
5. USB/UART Normal Operation 16
5.1. Operating Modes of the TeraRanger Evo Swipe Plus sensor 16
5.1.1. Bidirectional People Traffic Detection Mode 16
5.1.2. Presence Detection Mode 17
5.1.3. Engagement Trigger Mode 17
5.1.4. Gesture Recognition Mode 18
5.1.4.1. Swipe Mode 18
5.1.4.2. Validation Mode 19
5.2. Installation of Graphical User Interface Package 19
5.2.1. Linux and Raspberry Pi 19
5.2.2. Windows 19
5.3. Graphical User Interface (GUI) 20
5.3.1. Bidirectional People Traffic Detection Mode 21
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
2/29

5.3.2. Presence Detection Mode 21
5.3.3. Engagement Trigger Mode 22
5.3.4. Gesture Recognition Mode 22
5.3.4.1. Swipe Mode (Last gesture) 22
5.3.4.2. Validation Mode 22
5.3.4.3. Button to Reset Counters 22
5.4. List of sensor commands available via USB/UART 23
5.5. Details of the sensor output values 24
5.5.1. Output in Bidirectional People Traffic Detection Mode 24
5.5.2. Presence Detection Mode 25
5.5.3. Engagement Trigger Mode 25
5.5.4. Gesture Recognition Mode 26
5.5.5. Reset counters 27
5.5.5.1. BPTD “Bidirectional People Traffic Mode” 27
5.5.5.2. PD Presence Detection Mode 27
5.5.6. Parameters Command 27
6. General remarks 29
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
4/29

1.2. Technical specifications
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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.
Table 1 - Technical specifications of TeraRanger Evo Swipe Plus
1.2.1. Performance table
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”
Table 2 - Performance table of the TeraRanger Evo Swipe Plus
1.2.2. Communication interfaces
Evo Swipe Plus
Communication
Interfaces
USB
●
UART
●
Table 3 - Communication interfaces for the TeraRanger Evo Swipe Plus
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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 2 mm 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 2 mm thickness.
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
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.
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
Table 4 - LED indicators of the USB backboard
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo Swipe Plus User Manual
10/29