2026-07-02 11:45:17 +08:00
<div align="center">
<!-- Title: -->
<a href="https://www.orbbec.com/products/">
<img src="./docs/images/orbbec-logo-horizontal.png" width="500" alt="Orbbec">
</a>
<h1><a href="https://github.com/orbbec/OrbbecSDK_ROS2">OrbbecSDK ROS2 Wrapper v2</a></h1>
2024-10-21 17:47:54 +08:00
2026-07-02 11:45:17 +08:00
<!-- Language: -->
<p align="center">
<a href="./README.MD">English</a> | <a href="./README_CN.MD">中文</a>
</p>
2026-07-02 11:45:17 +08:00
<!-- Labels: -->
<!-- First row: -->
<a href="https://docs.ros.org/en/foxy/">
<img src="https://img.shields.io/badge/ROS-Foxy-f5792a?style=flat-square&logo=ros&logoColor=white" height="20" alt="ROS Foxy">
</a>
<a href="https://docs.ros.org/en/humble/">
<img src="https://img.shields.io/badge/ROS-Humble-f5792a?style=flat-square&logo=ros&logoColor=white" height="20" alt="ROS Humble">
</a>
<a href="https://docs.ros.org/en/jazzy/">
<img src="https://img.shields.io/badge/ROS-Jazzy-f5792a?style=flat-square&logo=ros&logoColor=white" height="20" alt="ROS Jazzy">
</a>
2026-07-28 21:06:41 +08:00
<a href="https://docs.ros.org/en/lyrical/">
<img src="https://img.shields.io/badge/ROS-Lyrical-f5792a?style=flat-square&logo=ros&logoColor=white" height="20" alt="ROS Lyrical">
</a>
<a href="https://docs.ros.org/en/rolling/">
<img src="https://img.shields.io/badge/ROS-Rolling%20(experimental)-e5c07b?style=flat-square&logo=ros&logoColor=white" height="20" alt="ROS Rolling (experimental)">
</a>
2026-07-02 11:45:17 +08:00
<img src="https://img.shields.io/badge/Ubuntu-20.04-0078d4?style=flat-square&logo=ubuntu&logoColor=white" height="20" alt="Ubuntu 20.04">
<img src="https://img.shields.io/badge/Ubuntu-22.04-0078d4?style=flat-square&logo=ubuntu&logoColor=white" height="20" alt="Ubuntu 22.04">
<img src="https://img.shields.io/badge/Ubuntu-24.04-0078d4?style=flat-square&logo=ubuntu&logoColor=white" height="20" alt="Ubuntu 24.04">
2026-07-28 21:06:41 +08:00
<img src="https://img.shields.io/badge/Ubuntu-26.04-0078d4?style=flat-square&logo=ubuntu&logoColor=white" height="20" alt="Ubuntu 26.04">
2026-07-02 11:45:17 +08:00
<!-- Second row: -->
<br>
<a href="https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main">
<img src="https://img.shields.io/badge/branch-v2--main-555555?style=flat-square" height="20" alt="branch v2-main">
</a>
<a href="http://www.apache.org/licenses/LICENSE-2.0">
<img src="https://img.shields.io/badge/license-Apache--2.0-6bcf00?style=flat-square" height="20" alt="license Apache-2.0">
</a>
<a href="https://gitee.com/orbbecdeveloper/OrbbecSDK_ROS2">
<img src="https://img.shields.io/badge/Gitee-mirror-c71d23?style=flat-square" height="20" alt="Gitee mirror">
</a>
</div>
2025-09-18 10:56:41 +08:00
2025-09-23 17:44:06 +08:00
## Introduction
2024-11-01 17:14:16 +08:00
2026-07-28 21:06:41 +08:00
The **OrbbecSDK ROS2 Wrapper** provides seamless integration of Orbbec cameras with the ROS 2 ecosystem and supports the **ROS2 Foxy** , **Humble** , **Jazzy** , and **Lyrical** distributions, with experimental support for **Rolling** .
2024-11-22 14:17:47 +08:00
2025-09-23 17:44:06 +08:00
- Default branch: **v2-main**
- For legacy **OpenNI** devices: use the **main** branch
- For users in China: use the [Gitee repository ](https://gitee.com/orbbecdeveloper/OrbbecSDK_ROS2 )
2026-08-19 16:40:21 +08:00
## Start Here
Detailed usage, parameters, and troubleshooting are maintained on the official
[OrbbecSDK ROS2 documentation site ](https://orbbec.github.io/OrbbecSDK_ROS2/en/index.html ).
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 ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/2_installation/installation.html ) |
| Launch a camera and view images in RViz2 | [ROS Package QuickStarts ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/3_quickstarts/quickstart.html ) |
| Check device support, firmware, and the correct launch file | [Supported hardware ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/1_overview/introduction.html ) |
| Configure launch parameters, topics, services, TF, or point clouds | [Application Guide ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/4_application_guide/application_guide.html ) |
| Find maintenance, diagnostic, benchmark, or multi-camera tools | [Tool Index ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/6_benchmark/tools.html ) |
| Use network cameras, GMSL, multi-camera, or advanced modes | [Advanced Guide ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/5_advanced_guide/advanced_guide.html ) |
| Diagnose a failure or collect logs for support | [Frequently Asked Questions ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/8_FAQ/FAQ.html ) |
| Migrate an existing project from main (v1.x) | [Migration Guide ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/7_developer_guide/migration_guide.html ) |
| Use an Orbbec LiDAR | [LiDAR documentation ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/lidar_devices/index.html ) |
Source files for practical launch examples are listed in the
[Examples index ](./orbbec_camera/examples/ ).
2025-09-23 17:44:06 +08:00
## branch selection
2025-05-22 19:40:01 +08:00
2024-11-25 19:42:38 +08:00
Here is the device support list of main branch (v1.x) and v2-main branch (v2.x):
2024-11-25 15:29:10 +08:00
<table border="1" style="border-collapse: collapse; text-align: left; width: 100%;">
<thead>
2026-05-18 14:20:21 +08:00
<tr style="background-color: #1f4e78 ; color: black; text-align: center;">
2024-11-25 15:29:10 +08:00
<th>Product Series</th>
<th>Product</th>
2024-11-25 19:42:38 +08:00
<th><a href="https://github.com/orbbec/OrbbecSDK_ROS2/tree/main" style="color: black; text-decoration: none;">Branch main</a></th>
<th><a href="https://github.com/orbbec/OrbbecSDK_ROS2/tree/v2-main" style="color: black; text-decoration: none;">Branch v2-main</a></th>
2024-11-25 15:29:10 +08:00
</tr>
</thead>
<tbody>
2026-05-18 14:20:21 +08:00
<tr>
<td style="text-align: center; font-weight: bold;">Gemini 430</td>
<td>Gemini 435Le</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td rowspan="2" style="text-align: center; font-weight: bold;">Gemini 301</td>
2026-01-22 14:35:09 +08:00
<td>Gemini 305</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2026-04-30 17:26:35 +08:00
<tr>
2026-05-06 10:07:24 +08:00
<td>Gemini 305g</td>
2026-04-30 17:26:35 +08:00
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2025-05-22 17:25:25 +08:00
<tr>
2026-08-06 20:30:27 +08:00
<td rowspan="10" style="text-align: center; font-weight: bold;">Gemini 330</td>
2024-11-25 15:29:10 +08:00
<td>Gemini 335</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td>Gemini 336</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2025-04-16 20:31:28 +08:00
</tr>
2025-05-12 14:32:20 +08:00
<tr>
2025-05-22 17:25:25 +08:00
<td>Gemini 330</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Gemini 335L</td>
<td>full maintenance</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Gemini 336L</td>
<td>full maintenance</td>
<td>recommended for new designs</td>
2025-05-22 17:25:25 +08:00
</tr>
<tr>
<td>Gemini 330L</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Gemini 335Lg</td>
<td>not supported</td>
<td>recommended for new designs</td>
2025-05-12 14:32:20 +08:00
</tr>
2026-05-18 14:20:21 +08:00
<tr>
<td>Gemini 335Le</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2026-08-06 20:30:27 +08:00
<tr>
<td>Gemini 338Le</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Gemini 338Lg</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2026-05-18 14:20:21 +08:00
<tr>
<td style="text-align: center; font-weight: bold;">Gemini 340</td>
<td>Gemini 345Lg</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2024-11-25 15:29:10 +08:00
<tr>
2025-09-18 17:42:38 +08:00
<td rowspan="5" style="text-align: center; font-weight: bold;">Gemini 2</td>
2024-11-25 15:29:10 +08:00
<td>Gemini 2</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td>Gemini 2 L</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td>Gemini 2 XL</td>
2025-10-23 17:51:35 +08:00
<td>recommended for new designs</td>
2026-05-18 14:20:21 +08:00
<td>not supported</td>
2024-11-25 15:29:10 +08:00
</tr>
2025-09-18 17:42:38 +08:00
<tr>
<td>Gemini 215</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Gemini 210</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2024-11-25 15:29:10 +08:00
<tr>
<td rowspan="3" style="text-align: center; font-weight: bold;">Femto</td>
<td>Femto Bolt</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
2024-11-28 17:18:57 +08:00
<td>Femto Mega</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-28 17:18:57 +08:00
</tr>
2024-11-25 15:29:10 +08:00
<tr>
<td>Femto Mega I</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td rowspan="3" style="text-align: center; font-weight: bold;">Astra</td>
<td>Astra 2</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td>Astra+</td>
2025-10-23 17:51:35 +08:00
<td>limited maintenance</td>
<td>not supported</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
<td>Astra Pro Plus</td>
2025-10-23 17:51:35 +08:00
<td>limited maintenance</td>
<td>not supported</td>
2024-11-25 15:29:10 +08:00
</tr>
<tr>
2026-05-18 14:20:21 +08:00
<td rowspan="2" style="text-align: center; font-weight: bold;">Astra Mini</td>
<td>Astra Mini Pro</td>
<td>full maintenance</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Astra Mini S Pro</td>
2025-10-23 17:51:35 +08:00
<td>full maintenance</td>
<td>recommended for new designs</td>
2024-11-25 15:29:10 +08:00
</tr>
2025-12-30 15:25:42 +08:00
<tr>
2025-12-30 16:53:03 +08:00
<td rowspan="2" style="text-align: center; font-weight: bold;">LiDAR</td>
2025-12-30 15:25:42 +08:00
<td>Pulsar ME450</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
<tr>
<td>Pulsar SL450</td>
<td>not supported</td>
<td>recommended for new designs</td>
</tr>
2024-11-25 15:29:10 +08:00
</tbody>
</table>
2026-07-20 09:12:06 +08:00
**Note** : LiDAR devices are supported in v2.6.3 and later versions. For usage details, please refer to the [LiDAR documentation ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/lidar_devices/index.html ). If you do not find your device, please contact our FAE or sales representative for help.
2024-11-25 19:42:38 +08:00
2024-11-25 15:29:10 +08:00
**Definition** :
2025-05-06 17:41:55 +08:00
1. Recommended for new designs: we will provide full supports with new features, bug fix and performance optimization;
2. Full maintenance: we will provide bug fix support;
3. Limited maintenance: we will provide critical bug fix support;
4. Not supported: we will not support specific device in this version;
5. To be supported: we will add support in the near future.
2024-11-22 14:17:47 +08:00
2025-10-22 13:50:33 +08:00
**Migration Guide**
2026-01-16 09:51:00 +08:00
If you need to migrate existing projects from the main (v1.x) branch to the v2-main (v2.x) branch, please refer to the official [migration guide ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/7_developer_guide/migration_guide.html )
2025-10-22 13:50:33 +08:00
2022-06-10 14:24:27 +08:00
## Installation Instructions
2025-12-29 14:08:49 +08:00
**Environment configuration**
2023-03-10 10:19:06 +08:00
2026-08-03 09:55:48 +08:00
Install one of the supported ROS 2 distributions according to its official guide:
2022-06-10 14:24:27 +08:00
2026-08-03 09:55:48 +08:00
* [Foxy ](https://docs.ros.org/en/foxy/ )
* [Humble ](https://docs.ros.org/en/humble/ )
* [Jazzy ](https://docs.ros.org/en/jazzy/ )
Source the ROS 2 environment before running the commands below:
```bash
source /opt/ros/humble/setup.bash # Replace humble with foxy or jazzy as needed
```
2025-12-29 14:08:49 +08:00
Install dependencies:
```bash
sudo apt install libgflags-dev nlohmann-json3-dev \
ros-$ROS_DISTRO -image-transport ros-${ ROS_DISTRO } -image-transport-plugins ros-${ ROS_DISTRO } -compressed-image-transport \
ros-$ROS_DISTRO -image-publisher ros-$ROS_DISTRO -camera-info-manager \
ros-$ROS_DISTRO -diagnostic-updater ros-$ROS_DISTRO -diagnostic-msgs ros-$ROS_DISTRO -statistics-msgs ros-$ROS_DISTRO -xacro \
2026-01-13 17:22:23 +08:00
ros-$ROS_DISTRO -backward-ros libdw-dev libssl-dev mesa-utils libgl1 libgoogle-glog-dev
2025-12-29 14:08:49 +08:00
```
Enable ROS 2 auto-completion:
2022-06-10 14:24:27 +08:00
```bash
eval " $( register-python-argcomplete3 ros2) "
eval " $( register-python-argcomplete3 colcon) "
```
2025-12-29 14:08:49 +08:00
**Linux Binary Package Installation**
Check available packages:
```bash
sudo apt update
apt list | grep orbbec
```
2026-08-03 09:55:48 +08:00
If binary packages are available for your ROS 2 distribution, install the OrbbecSDK ROS2 packages with:
2025-12-29 14:08:49 +08:00
```bash
2026-08-03 09:55:48 +08:00
sudo apt install ros-${ ROS_DISTRO } -orbbec-camera ros-${ ROS_DISTRO } -orbbec-description
2025-12-29 14:08:49 +08:00
```
After installation, you can use it directly without compilation.
**Build from Source**
Create a `colcon` workspace:
2022-06-10 14:24:27 +08:00
```bash
mkdir -p ~/ros2_ws/src
```
2025-12-29 14:08:49 +08:00
Clone source and checkout `v2-main` branch:
2023-05-11 10:32:28 +08:00
```bash
cd ~/ros2_ws/src
2023-09-20 16:23:47 +08:00
git clone https://github.com/orbbec/OrbbecSDK_ROS2.git
2024-10-12 18:45:13 +08:00
cd OrbbecSDK_ROS2
2024-11-25 15:29:10 +08:00
git checkout v2-main
2023-05-11 10:32:28 +08:00
```
2022-06-15 15:40:46 +08:00
2025-12-29 14:08:49 +08:00
Build:
2022-06-15 15:40:46 +08:00
```bash
2025-12-29 14:08:49 +08:00
cd ~/ros2_ws
colcon build --event-handlers console_direct+ --cmake-args -DCMAKE_BUILD_TYPE= Release
2025-09-16 15:42:33 +08:00
```
2025-12-29 14:08:49 +08:00
## Registration Script (Required)
To allow the Orbbec cameras to be recognized correctly on Linux, install the udev rules.
**Binary Installation**
2022-06-13 14:58:47 +08:00
2022-06-10 14:24:27 +08:00
```bash
2025-12-29 14:08:49 +08:00
sudo cp /opt/ros/$ROS_DISTRO /share/orbbec_camera/udev/99-obsensor-libusb.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger
2022-06-10 14:24:27 +08:00
```
2023-02-13 09:54:58 +08:00
2025-12-29 14:08:49 +08:00
**Build from Source**
2025-09-23 17:44:06 +08:00
```bash
cd ~/ros2_ws/src/OrbbecSDK_ROS2/orbbec_camera/scripts
sudo bash install_udev_rules.sh
```
2025-12-29 14:08:49 +08:00
This step is **mandatory** for Linux users.
2026-08-03 09:55:48 +08:00
> **Note:** Without the udev rules, the device may fail to open because of insufficient permissions. Install the rules and reconnect the camera instead of running ROS 2 nodes with `sudo`.
2025-12-29 14:08:49 +08:00
2025-09-23 17:44:06 +08:00
## Getting start
2023-02-13 09:54:58 +08:00
Launch camera node
2023-02-17 15:14:45 +08:00
- On terminal 1
2023-02-13 09:54:58 +08:00
2023-02-17 15:14:45 +08:00
```bash
2025-09-18 10:56:31 +08:00
source ~/ros2_ws/install/setup.bash
2025-09-23 17:44:06 +08:00
ros2 run orbbec_camera list_devices_node # Check if the camera is connected
2025-05-06 18:27:19 +08:00
ros2 launch orbbec_camera gemini_330_series.launch.py # Or other launch file, see below table
2022-06-10 14:24:27 +08:00
```
2023-02-13 09:54:58 +08:00
2023-02-17 15:14:45 +08:00
- On terminal 2
2022-06-10 14:24:27 +08:00
```bash
2025-09-18 10:56:31 +08:00
source ~/ros2_ws/install/setup.bash
2023-02-13 14:30:21 +08:00
rviz2
2022-06-10 14:24:27 +08:00
```
2023-02-13 15:34:44 +08:00
2023-02-13 14:30:21 +08:00
Select the topic you want to display
2023-02-13 09:54:58 +08:00
2025-05-08 16:00:38 +08:00
- List topics / services/ parameters ( On terminal 3)
2022-06-10 14:24:27 +08:00
```bash
ros2 topic list
ros2 service list
ros2 param list
```
2022-06-10 15:15:18 +08:00
2025-09-18 10:56:31 +08:00
- Echo a topic
2022-06-10 15:15:18 +08:00
2023-02-17 15:14:45 +08:00
```bash
2025-09-18 10:56:31 +08:00
ros2 topic echo /camera/depth/camera_info
2022-06-10 15:15:18 +08:00
```
2023-02-13 09:54:58 +08:00
2025-09-18 10:56:31 +08:00
- Call a service
2022-06-10 15:15:18 +08:00
```bash
2022-06-13 14:58:47 +08:00
ros2 service call /camera/get_sdk_version orbbec_camera_msgs/srv/GetString '{}'
2022-06-10 15:15:18 +08:00
```
2026-01-16 09:51:00 +08:00
For more usage details, please refer to the official [OrbbecSDK ROS2 documentation ](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/4_application_guide/application_guide.html )
2024-08-27 17:58:12 +08:00
2025-09-23 17:44:06 +08:00
## Supported Devices
2024-10-21 17:47:54 +08:00
2026-08-03 09:55:48 +08:00
Currently, the following devices are supported by the OrbbecSDK ROS2 Wrapper v2-main branch. More devices support will be added in the near future. If you can not find your device in the table below, try the [main ](https://github.com/orbbec/OrbbecSDK_ROS2/tree/main ) branch.
2023-09-06 21:54:28 +08:00
2025-09-23 17:44:06 +08:00
For optimal performance, we strongly recommend updating to the latest firmware version. This ensures that you benefit from the most recent enhancements and bug fixes.
2023-02-13 09:54:58 +08:00
2026-05-18 14:20:21 +08:00
<table border="1" style="border-collapse: collapse; text-align: left; width: 100%;">
<thead>
<tr>
<th>Product Series</th>
<th>Products List</th>
<th>Recommended FW Version</th>
<th>Launch File</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: center; font-weight: bold;">Gemini 430</td>
<td>Gemini 435Le</td>
2026-06-22 15:31:43 +08:00
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemin435Le-Firmware">1.3.19</a></td>
2026-05-18 14:20:21 +08:00
<td>gemini435_le.launch.py</td>
</tr>
<tr>
2026-07-20 09:12:06 +08:00
<td rowspan="2" style="text-align: center; font-weight: bold;">Gemini 301</td>
2026-05-18 14:20:21 +08:00
<td>Gemini 305</td>
<td><a href="https://doc.orbbec.com/documentation/Gemini%20305%20Documentation/Firmware%20Release%20of%20Gemini%20305">1.0.70</a></td>
2026-06-05 18:19:49 +08:00
<td>gemini_301_series.launch.py</td>
2026-05-18 14:20:21 +08:00
</tr>
<tr>
<td>Gemini 305g</td>
<td><a href="https://doc.orbbec.com/documentation/Gemini%20305%20Documentation/Firmware%20Release%20of%20Gemini%20305">1.0.70</a></td>
2026-06-05 18:19:49 +08:00
<td>gemini_301_series.launch.py</td>
2026-05-18 14:20:21 +08:00
</tr>
<tr>
2026-08-06 20:30:27 +08:00
<td rowspan="10" style="text-align: center; font-weight: bold;">Gemini 330</td>
2026-05-18 14:20:21 +08:00
<td>Gemini 335</td>
2026-07-20 09:12:06 +08:00
<td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td>
2026-05-18 14:20:21 +08:00
<td>gemini_330_series.launch.py</td>
</tr>
2026-07-20 09:12:06 +08:00
<tr><td>Gemini 336</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 330</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 335L</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 336L</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 330L</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 335Lg</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 335Le</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_1.8.10.zip">1.8.10</a></td><td>gemini_330_series.launch.py</td></tr>
2026-08-06 20:30:27 +08:00
<tr><td>Gemini 338Le</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_v1.8.17.zip">1.8.17</a></td><td>gemini_330_series.launch.py</td></tr>
<tr><td>Gemini 338Lg</td><td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Gemini330_Release_v1.8.17.zip">1.8.17</a></td><td>gemini_330_series.launch.py</td></tr>
2026-05-18 14:20:21 +08:00
<tr>
<td style="text-align: center; font-weight: bold;">Gemini 340</td>
<td>Gemini 345Lg</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini340-Firmware">1.9.03</a></td>
<td>gemini345_lg.launch.py</td>
</tr>
<tr>
<td rowspan="4" style="text-align: center; font-weight: bold;">Gemini 2</td>
<td>Gemini 2</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2-Firmware">1.4.98</a></td>
<td>gemini2.launch.py</td>
</tr>
<tr>
<td>Gemini 2 L</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini2L-Firmware">1.5.2</a></td>
<td>gemini2L.launch.py</td>
</tr>
<tr>
<td>Gemini 215</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini215-Firmware">1.0.9</a></td>
<td>gemini210.launch.py</td>
</tr>
<tr>
<td>Gemini 210</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Gemini210-Firmware">1.0.9</a></td>
<td>gemini210.launch.py</td>
</tr>
<tr>
<td rowspan="3" style="text-align: center; font-weight: bold;">Femto</td>
<td>Femto Bolt</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Bolt-Firmware">1.1.3</a></td>
<td>femto_bolt.launch.py</td>
</tr>
<tr>
<td>Femto Mega</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-Firmware">1.3.1</a></td>
<td>femto_mega.launch.py</td>
</tr>
<tr>
<td>Femto Mega I</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Femto-Mega-I-Firmware">2.0.4</a></td>
<td>femto_mega.launch.py</td>
</tr>
<tr>
<td style="text-align: center; font-weight: bold;">Astra</td>
<td>Astra 2</td>
<td><a href="https://orbbec-debian-repos-aws.s3.amazonaws.com/product/Astra2_Release_2.8.20.zip">2.8.20</a></td>
<td>astra2.launch.py</td>
</tr>
<tr>
<td rowspan="2" style="text-align: center; font-weight: bold;">Astra Mini</td>
<td>Astra Mini Pro</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-Pro">2.0.03</a></td>
<td>astra.launch.py</td>
</tr>
<tr>
<td>Astra Mini S Pro</td>
<td><a href="https://github.com/orbbec/OrbbecFirmware/releases/tag/Astra-Mini-S-Pro">2.0.03</a></td>
<td>astra.launch.py</td>
</tr>
<tr>
<td rowspan="2" style="text-align: center; font-weight: bold;">LiDAR</td>
<td>Pulsar ME450</td>
<td>1.0.0.6</td>
<td>lidar.launch.py</td>
</tr>
<tr>
<td>Pulsar SL450</td>
<td>2.2.4.5</td>
<td>lidar.launch.py</td>
</tr>
</tbody>
</table>
2025-05-06 17:41:55 +08:00
2025-09-23 17:44:06 +08:00
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.
2024-05-08 22:28:27 +08:00
2026-08-19 16:40:21 +08:00
## Related Links
2024-05-14 10:12:54 +08:00
2025-10-23 14:47:55 +08:00
- [OrbbecSDK ROS2 documentation ](https://orbbec.github.io/OrbbecSDK_ROS2/en/index.html )
2026-08-19 16:40:21 +08:00
- [Examples index ](./orbbec_camera/examples/ )
2024-11-01 17:14:16 +08:00
- [OrbbecSDK_v2 ](https://github.com/orbbec/OrbbecSDK_v2/releases )
2024-05-14 10:12:54 +08:00
- [Gemini 330 depth presets ](https://www.orbbec.com/docs/g330-use-depth-presets/ )
2023-02-13 09:54:58 +08:00
## License
2024-05-14 10:03:34 +08:00
Copyright 2024 Orbbec Ltd.
2023-02-13 09:54:58 +08:00
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this project except in compliance with
the License. You may obtain a copy of the License at
[http://www.apache.org/licenses/LICENSE-2.0 ](http://www.apache.org/licenses/LICENSE-2.0 )
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "
AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
language governing permissions and limitations under the License.
**Other names and brands may be claimed as the property of others**