Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)
CONTRIBUTING
Repository Summary
| Checkout URI | https://github.com/orbbec/OrbbecSDK_ROS2.git |
| VCS Type | git |
| VCS Version | v2-main |
| Last Updated | 2026-09-30 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| orbbec_camera | 2.10.6 |
| orbbec_camera_msgs | 2.10.6 |
| orbbec_description | 2.10.6 |
README
```
Introduction
The OrbbecSDK ROS2 Wrapper provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the ROS2 Foxy, Humble, Jazzy, Lyrical, and Rolling distributions.
- Default branch: v2-main
- For legacy OpenNI devices: use the main branch
- For users in China: use the Gitee repository
Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official OrbbecSDK ROS2 documentation site. Use the links below to go directly to the guide for your task.
| I want to… | Go to… |
|---|---|
| Install the wrapper and configure device permissions | Installation |
| Launch a camera and view images in RViz2 | ROS Package QuickStarts |
| Check device support, firmware, and the correct launch file | Supported hardware |
| Configure launch parameters, topics, services, TF, or point clouds | Application Guide |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | Tool Index |
| Use network cameras, GMSL, multi-camera, or advanced modes | Advanced Guide |
| Diagnose a failure or collect logs for support | Frequently Asked Questions |
| Migrate an existing project from main (v1.x) | Migration Guide |
| Use an Orbbec LiDAR | LiDAR documentation |
Source files for practical launch examples are listed in the Examples index.
branch selection
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
| Product Series | Product | Branch main | Branch v2-main |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | File truncated at 100 lines [see the full file](https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main/README.MD)