You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Orbbec ROS SDK is a wrapper for Orbbec SDK that supports ROS Kinetic, Melodic, and Noetic distributions.
5
+
OrbbecSDK_ROS1 is a wrapper for Orbbec SDK that supports ROS Kinetic, Melodic, and Noetic distributions.
6
6
It enables smooth integration of Orbbec 3D cameras into ROS projects.
7
7
8
+
With the major update of the new branch [v2-main](https://github.com/orbbec/OrbbecSDK_ROS1/tree/v2-main) in October 2024, OrbbecSDK_ROS1 is connected to the open source version of [OrbbecSDK v2](https://github.com/orbbec/OrbbecSDK_v2/releases), which will make OrbbecSDK_ROS1 more flexible and extensible. This update in v2-main ensures compatibility with all new Orbbec USB products that comply with the UVC standard. However, OrbbecSDK_ROS1 v2 no longer supports Orbbec's traditional OpenNI protocol devices. We encourage you to check whether your device is supported by OrbbecSDK_ROS1 v2 and use the new version if supported.
9
+
8
10
## Table of Contents
11
+
9
12
<!-- TOC -->
10
-
*[Orbbec ROS SDK](#orbbec-ros-sdk)
13
+
14
+
*[OrbbecSDK ROS](#orbbec-ros-sdk)
11
15
*[Table of Contents](#table-of-contents)
12
16
*[Install Dependencies](#install-dependencies)
13
17
*[ROS](#ros)
@@ -34,6 +38,7 @@ It enables smooth integration of Orbbec 3D cameras into ROS projects.
34
38
*[Why Are There So Many Launch Files?](#why-are-there-so-many-launch-files)
35
39
*[Other useful links](#other-useful-links)
36
40
*[License](#license)
41
+
37
42
<!-- TOC -->
38
43
39
44
## Install Dependencies
@@ -244,14 +249,13 @@ The following launch parameters are available:
244
249
recognized as USB 2.0.
245
250
It is recommended to set this parameter to `false` when using a USB 2.0 connection to avoid unnecessary resets.
246
251
Here is a refined version of the two sentences:
247
-
248
-
-`enable_heartbeat`: This option enables the heartbeat function. By default, it is set to `false`.
249
-
If set to `true`, the camera will send heartbeat messages and generate firmware logs.
250
-
251
-
-`enable_hardware_reset`: This option enables the hardware reset function. By default, it is set to `false`.
252
-
If set to `true`, the camera will reboot upon its first connection.
252
+
-`enable_heartbeat`: This option enables the heartbeat function. By default, it is set to `false`.
253
+
If set to `true`, the camera will send heartbeat messages and generate firmware logs.
254
+
-`enable_hardware_reset`: This option enables the hardware reset function. By default, it is set to `false`.
255
+
If set to `true`, the camera will reboot upon its first connection.
253
256
254
257
**IMPORTANT**: *Please carefully read the instructions regarding software filtering settings at [this link](https://www.orbbec.com/docs/g330-use-depth-post-processing-blocks/). If you are uncertain, do not modify these settings.*
258
+
255
259
## Depth work mode switch:
256
260
257
261
- Before starting the camera, depth work mode (depth_work_mode) can be configured for the corresponding xxx.launch
**All launch files are essentially similar, with the primary difference being the default values of the parameters set for different models
419
405
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
@@ -425,6 +411,7 @@ file, as well as other parameters, to ensure compatibility and optimal performan
425
411
For users who need to use nodelet, please refer to `gemini2_nodelet.launch`
426
412
427
413
## Supported hardware products
414
+
428
415
Please refer to the OrbbecSDK supported products: [Product Support](https://github.com/orbbec/OrbbecSDK?tab=readme-ov-file#product-support)
429
416
430
417
## Frequently Asked Questions
@@ -438,30 +425,41 @@ Please send these log files to the support team or submit them to a GitHub issue
438
425
### No Data Stream from Multiple Cameras
439
426
440
427
**Insufficient Power Supply**:
428
+
441
429
- Ensure that each camera is connected to a separate hub.
442
430
- Use a powered hub to provide sufficient power to each camera.
443
431
444
432
**High Resolution**:
433
+
445
434
- Try lowering the resolution to resolve data stream issues.
446
435
447
436
**Increase usbfs_memory_mb Value**:
437
+
448
438
- Increase the `usbfs_memory_mb` value to 128MB (this is a reference value and can be adjusted based on your system’s needs)
449
439
by running the following command:
440
+
450
441
```bash
451
442
echo 128 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb
452
443
```
444
+
453
445
- To make this change permanent, check [this link](https://github.com/OpenKinect/libfreenect2/issues/807).
454
446
455
447
### Compilation Failure Due to OpenCV Version Issues
448
+
456
449
In some cases, you may have multiple versions of OpenCV on your host, which can lead to compilation failures. You can resolve this by specifying the OpenCV version. Find the CMakeLists.txt file in the cmake folder and locate the following code:
450
+
457
451
```cmake
458
452
find_package(OpenCV REQUIRED)
459
453
```
454
+
460
455
Either add OpenCV_dir or specify the version before it:
0 commit comments