Skip to main content

How to Use Orbbec Depth Cameras on reComputer with ROS

Introduction

This tutorial provides a step-by-step guide on how to use Orbbec Depth Camera through ROS on reComputer J30/J40 series devices. We will take Orbbec Gemini 2 as an example, obtain topic data of depth images and point clouds, and visualize them on rviz.

Prerequisites

  • reComputer J30/40 series: We conduct tutorials based on the JetPack 5.x system and the ROS Noetic environment.

  • Install dependencies (be careful with your ROS distribution):

    # Assuming you have sourced the ROS environment, same below
    sudo apt install libgflags-dev ros-$ROS_DISTRO-image-geometry ros-$ROS_DISTRO-camera-info-manager \
    ros-$ROS_DISTRO-image-transport ros-$ROS_DISTRO-image-publisher libgoogle-glog-dev libusb-1.0-0-dev libeigen3-dev \
    ros-$ROS_DISTRO-diagnostic-updater ros-$ROS_DISTRO-diagnostic-msgs libdw-dev

Getting Started

Connecting the Cameras

Connect Orbbec Depth Camera to Jetson via USB Type-C, and ensure that ROS is already installed on your system.

Installation

If you have cloned OBcamera_ws from our project, you don't need to clone from the link below.

  • Step 1:Create a ROS workspace (if you don't have one):
mkdir -p OBcamera_ws/src
  • Step 2:Get the source code:
cd OBcamera_ws/src
git clone https://github.com/orbbec/OrbbecSDK_ROS1.git
  • Step 3:Build the package:
cd OBcamera_ws
catkin_make
  • Step 4:Install udev rules:
source ./devel/setup.bash
roscd orbbec_camera
sudo bash ./scripts/install_udev_rules.sh

Start the Camera

For the camera model Gemini2, enter the following in terminal 1:

source ./devel/setup.bash
roslaunch orbbec_camera gemini2.launch

In terminal 2:

source ./devel/setup.bash
rviz

You can enter the rostpoic list command in the third terminal to view the topics published by Orbbec Camera. Available Topics are as follows:

  • /camera/color/camera_info: The color camera info.
  • /camera/color/image_raw: The color stream image.
  • /camera/depth/camera_info: The depth camera info.
  • /camera/depth/image_raw: The depth stream image.
  • /camera/depth/points: The point cloud, only available when enable_point_cloud is true.
  • /camera/depth_registered/points: The colored point cloud, only available when enable_colored_point_cloud is true.
  • /camera/left_ir/camera_info: The left IR camera info.
  • /camera/left_ir/image_raw: The left IR stream image.
  • /camera/right_ir/camera_info: The right IR camera info.
  • /camera/right_ir/image_raw: The right IR stream image.
  • /diagnostics: The diagnostic information of the camera. Currently, the diagnostic information only includes the temperature of the camera.

Start RVIZ and add topic via the button in the lower left corner of the RVIZ interface, you can get a rendering similar to the following:

If the camera model you are using is different, find the corresponding launch file name from the table below and replace gemini2.launch in terminal 1 accordingly.

Product SerialsLaunch File
astra+astra_adv.launch
astra mini/astra mini pro/astra proastra.launch
astra mini s proastra.launch
astra2astra2.launch
astra stereo sstereo_s_u3.launch
astra pro2astra_pro2.launch
dabaidabai.launch
dabai d1dabai_d1.launch
dabai dcwdabai_dcw.launch
dabai dwdabai_dw.launch
dabai prodabai_pro.launch
deeyadeeya.launch
femto / femto wfemto.launch
femto megafemto_mega.launch
femto boltfemto_bolt.launch
geminigemini.launch
gemini2 / dabai DCLgemini2.launch
gemini2Lgemini2L.launch
gemini egemini_e.launch
gemini e litegemini_e_lite.launch
dabai maxdabai_max.launch
dabai max prodabai_max_pro.launch
gemini uwgemini_uw.launch
dabai dcw2dabai_dcw2.launch
dabai dw2dabai_dw2.launch
gemini ewgemini_ew.launch
gemini ew litegemini_ew_lite.launch
gemini 330 seriesgemini_330_series.launch

All launch files are essentially similar, with the primary difference being the default values of the parameters set for different models within the same series. Differences in USB standards, such as USB 2.0 versus USB 3.0, may require adjustments to these parameters. If you encounter a startup failure, please carefully review the specification manual. Pay special attention to the resolution settings in the launch file, as well as other parameters, to ensure compatibility and optimal performance.

Tech Support & Product Discussion

Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.

Loading Comments...