background image

 

1 . Introduction

The purpose of this document is to give guidelines for installation, use and integration
of Terabee 3Dcam 80x60 depth camera. This user manual includes camera setup
instructions on Windows and Linux OS, installation of the SDK and visualization tool
(NIViewer) for streaming depth data on your PC.

1.1 About Terabee 3Dcam 80x60

The 3D Time-of-Flight (ToF) camera is designed to support research projects, application
software developers and system integrators in the fields of Smart Buildings, Automation
and Robotics. Enable the third dimension with the cameras 80x60 pixel resolution over
a 74

°

x 57

°

Field of View. Benefit from the cameras robust aluminum casing while still

offering a compact (83 grams) and discreet design. Developed for indoor use, the
camera features two operating range modes. For close range applications such as hand
gesture recognition choose close-range mode and capture depth data as close as 20
centimeters. Switch to standard mode with its 4 meter range for volume measurement,
people and movement monitoring and robot navigation applications.

Figure 1. Terabee 3Dcam 80x60

Our compact ToF camera comes with an SDK containing all logic to operate your
camera, and a visualization tool for quick tests on your PC. Setup your Terabee 3Dcam
80x60 in no time and stream depth data via USB interface on Windows or Linux OS. An
SDK and OpenNI framework code library is available to kick-start your application
development.

For more information on Terabee 3Dcam 80x60 please visit the

official product page of

the Terabee website

.

Copyright

©

Terabee 2019

Terabee, 90 Rue Henri Fabre

01630, St Genis-Pouilly, France (next to CERN)

3/17

Summary of Contents for TB-3DCAM-8060-USB

Page 1: ...User Manual for Terabee 3Dcam 80x60 Technical support support teraranger com Sales and commercial support teraranger terabee com ...

Page 2: ...dows 9 4 2 1 SDK installation 10 4 2 2 Streaming depth data on Windows 11 4 3 Software setup for Linux Debian based 12 4 3 1 SDK installation 12 4 3 2 Streaming depth data on Linux 13 5 Switching between range modes 15 6 Start developing your application 16 6 1 OpenNI 2 C sample code 16 6 2 OpenNI 2 Python sample code 16 6 3 ROS package 16 7 Compliance 16 Copyright Terabee 2019 Terabee 90 Rue Henr...

Page 3: ... design Developed for indoor use the camera features two operating range modes For close range applications such as hand gesture recognition choose close range mode and capture depth data as close as 20 centimeters Switch to standard mode with its 4 meter range for volume measurement people and movement monitoring and robot navigation applications Figure 1 Terabee 3Dcam 80x60 Our compact ToF camer...

Page 4: ...ution 1 of distance Supply Voltage 5V DC USB powered Power Consumption max 4W Operating Temperature 0 C to 40 C Storage Temperature 20 C to 60 C Interfaces USB 2 0 Micro B Weight 83g Use Environment Indoors Dimensions 54 x 53 x 24mm Supporting OS Windows Linux Software Terabee SDK OpenNI 2 2 based C C Python ROS package Conformity CE RoHS Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St ...

Page 5: ...ee 3Dcam 80x60 camera USB 2 0 Micro B Y cable Software development kit available for download on the Terabee 3Dcam 80x60 product page Downloads section Figure 2 Product package contents Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 5 17 ...

Page 6: ...two methods 1 front panel mount using the long M4 screw slots or 2 for a more discreet and integrated look use the back panel mounting shoulder in the front side of the camera The 3mm ledge offers users the possibility to mount the camera behind a surface e g panel ideally with a 3mm thickness See figures 4 and 5 for visualizations Please note that mounting components e g screws are not included i...

Page 7: ...Figure 4 Front panel mounting example Figure 5 Back panel mounting example Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 7 17 ...

Page 8: ...n front of the camera It is better to avoid having other sources of continuous wave or modulated IR light close to the sensor Please consider that dust dirt and condensation can affect the sensor performance It is not advised to add an additional cover in front of the camera please note that this may reduce its performance Please consult figure 6 for correct camera position when mounting to a surf...

Page 9: ...camera Please note that using only one cable may affect camera performance Connect the Micro USB cable micro B side into the camera s USB port Plug the other two ends of Micro USB cable into your PC USB port You ve successfully completed the hardware setup Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 9 17 ...

Page 10: ...contains OpenNI2 2 versions of the SDK for both x32 and x64 architectures For the purposes of this guide the OpenNI 2 2 x64 driver is used A window will open offering to proceed with SDK installation on your PC To proceed click Install During installation of the GUI you might receive a notification from Windows about an unknown application trying to start In the Windows protected your PC screen se...

Page 11: ...C with the depth data streamed real time in the top left corner of your screen Optional To activate infrared image provided by the camera right click on the interface and select Device Streams Color On Off Press p on your keyboard to activate pointer mode An interactive color distance scale will now open on the bottom of your screen to represent the distance value of the red pointer This allows to...

Page 12: ...on the Terabee website The package contains the OpenNI2 2 version of the SDK for both x64 and x86 architectures The Linux version of the SDK is compatible with most of the debian based distributions including Debian up to Stretch Ubuntu 16 04 18 04 Linux Mint Elementary OS 0 3 After the download is complete please extract the desired version that corresponds to your system architecture and save in...

Page 13: ...wer to function the following dependency is required Freeglut please use this command sudo apt get install freeglut3 After successful installation of mentioned dependencies you are now ready to go and start streaming depth data 4 3 2 Streaming depth data on Linux The OpenNI SDK comes with a visualization tool NiViewer This tool is a generic data visualizer of OpenNI compatible devices including de...

Page 14: ...d to activate pointer mode An interactive color distance scale will now open on the bottom of your screen to represent the distance value of the red pointer This allows to target a specific pixel in the depth image and obtain its distance measure in cm displayed under pointer value field Press 1 on your keyboard to display cameras depth image in full screen Press on your keyboard to display all sh...

Page 15: ...duleConfig json Linux usr etc TERABEE lib To edit the file in Windows please locate and run the text editor with elevated privileges this can be done with right click Run as administrator Next in the top bar menu select File Open or Ctrl O and import the ModuleConfig json file To edit the file in Linux please launch your text editor with elevated privileges with the sudo command As a final step to...

Page 16: ...les Each repository comes with a README file displayed on the front page of the repository explaining the different steps necessary to compile and run sample codes 6 2 OpenNI 2 Python sample code In order to allow fast code prototyping we also provide Python3 samples which are compatible with both Windows and Linux OS Please follow the link below to access the Python3 sample code repository on Git...

Page 17: ...Yes Yes Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 17 17 ...

Reviews: