TeraBee TR-EVO-PPC-USB User manual

User Manual for
TeraRanger Evo People Counter
(Bidirectional People Counting)
Technical support: terabee.com/support/
Sales and commercial support: [email protected]

Table of contents
1. Introduction 3
1.1. About the TeraRanger Evo People Counter 3
1.2. Technical specifications 4
1.2.1. Performance table 5
1.2.2. Communication interfaces 5
2. Mechanical integration 6
2.1. Modular design (clip-on, clip-off) 6
2.2. Mechanical design and mounting 6
2.3. Mounting solutions 8
3. USB Backboard Use 9
3.1. LED Indication 9
3.1.1. Normal operation 9
3.1.2. Error messages and troubleshooting 9
3.2. Connecting the TeraRanger Evo People Counter to a Host Computer 10
3.2.1. Windows OS 10
4. I2C/UART Backboard Use 13
4.1. I2C/UART pinout 13
4.2. LED Indicators 14
4.2.1. Normal operation 14
4.2.2. Troubleshooting 14
4.3. Electrical characteristics 14
5. USB/UART Normal Operation 16
5.1. Operation of the TeraRanger Evo People Counter sensor module 16
5.2. Installation of Graphical User Interface Package 16
5.2.1. Linux and Raspberry Pi 16
5.2.2. Windows 17
5.3. Graphical User Interface (GUI) 17
5.3.1. Bidirectional Traffic People Counting 18
5.3.2. Button to reset counters 18
5.4. List of sensor commands available via USB/UART 18
5.5. Details of the sensor output values 19
5.5.1. Reset counters 20
5.5.2. Parameters command 20
6. General remarks 21
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
2/21

1. Introduction
Small and discreet, the TeraRanger Evo People Counter measures pedestrian activity
and it has numerous applications across a range of sectors including retail, hospitality
and events, to name but a few.
This sensor module offers vertical and horizontal mounting options, and with a 0.05 m
to 1.5 m detection range, it delivers an optimal solution for measuring people flow in
corridors and allows door frame entrances integration.
Not only does the sensor register the number of people who have passed by, but
importantly, also their direction of travel. This extra insight into direction of flow
extends the applications beyond people counting measures, as it also allows an
understanding of how people flow within and around a space.
Because the Evo People Counter is based on Time-of-Flight technology, personal privacy
is protected and its technology is GDPR compliant by design.
1.1. About the TeraRanger Evo People Counter
Figure 1. TeraRanger Evo People Counter sensor, top view
The Evo People Counter 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 People Counter
User Manual
3/21

1.2. Technical specifications
Product code
TR-EVO-PPC-USB
TR-EVO-PPC-UART
Performance
Detection principle
Infrared Time-of-Flight
Light source wavelength
940 nm
Use environment
Indoor
Field of View
27°
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
Conformity
Reference standard
CE, RoHS
Table 1 - Technical specifications of TeraRanger Evo People Counter
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
4/21

1.2.1. Performance table
Mode
Detection
Output
Horizontal mounting
Vertical mounting
~ 0.05 m to 1.5 m
~ 2.0 m to 2.5 m
~25 Hz
Sensor ID
X: People inside (In - Out)
Y: People IN,
Z: People OUT
Table 2 - Performance table of the Evo People Counter
1.2.2. Communication interfaces
Evo People
Counter
Communication
Interfaces
USB
●
UART
●
Table 3 - Communication interfaces for the Evo People Counter
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
5/21

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 People Counter sensor
2.2. Mechanical design and mounting
The TeraRanger Evo People Counter 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 People
Counter sensor.
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
6/21

Figure 3 - TeraRanger Evo People Counter 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 People
Counter 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 (1) allows for
easy surface attachment and rapid evaluation of the sensor. The second solution (2)
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 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
7/21

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 People Counter, 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 without any
custom calibration (contact Terabee)
●For an optimal placement of the People Counting sensor, please follow this
Application note
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 People Counter
User Manual
8/21

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
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
sensor initialization process
Check USB output for
details of the error
Verify that the sensor is
properly connected and
re-power the unit
Table 5 - USB backboard LEDs troubleshooting
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
9/21

3.2. Connecting the TeraRanger Evo People Counter 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.
When using Windows, extract the downloaded zip file to the selected folder,
openitanddouble click on the “HTerm.exe” file.
When using Linux, extract the downloaded tgz file to the selected folder. Make sure that
you have execution permission for the file “hterm” (command: chmod u+x hterm),
double click on the “hterm” file or run it from terminal while in its directory: ./hterm.
On Linux, consider removing the modemmanager package if you are sure that it is
not required by your system setup. This will shorten the initialization time of serial
devices in the Linux system:
sudo apt purge modemmanager
Connect the TeraRanger Evo People Counter to a computer and select the
corresponding USB port (click “R” button to refresh the port list). Please configure the
software with the following parameters:
Baud rate : 115200 bit/s
Data bits : 8
Stop bit : 1
Parity bit : None
For easier data reading, select the “LF” option from the “Newline at” drop-down field.
See Figure 5 below for visual instructions.
Copyright © Terabee 2023
Terabee, 90 rue Henri Fabre
01630 Saint-Genis-Pouilly, France (next to CERN)
TeraRanger Evo People Counter
User Manual
10/21