orbbec/OrbbecSDK_ROS1
orbbec/OrbbecSDK_ROS1 has 129 GitHub stars and 61 forks. GitHot measured 0 stars in 24 hours, 0 in 7 days, and +1 in 15 days. Last checked 2026-11-18 03:44 UTC. Last push 2026-10-08.
实测星标增长
- 24小时
- 0
- 7天
- 0
- 15天
- +1
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
OrbbecSDK ROS wrapper
创作与媒体README_CN.MD
原文OrbbecSDK ROS v2
简介
OrbbecSDK ROS1 Wrapper v2 为 Orbbec 相机与 ROS 1 生态系统提供无缝集成。 它支持 ROS1 的 Kinetic、Melodic 和 Noetic 发行版。
- 默认分支:v2-main
- 对于传统 OpenNI 设备:请使用 main 分支
- 中国用户:请使用 Gitee 仓库
分支选择
下面是 main 分支 (v1.x) 和 v2-main 分支 (v2.x) 的设备支持列表:
| 产品系列 | 产品 | Orbbec SDK v1.x | Orbbec SDK v2.x |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | not supported | recommended for new designs |
| Gemini 301 | Gemini 305 | not supported | recommended for new designs |
| Gemini 305g | not supported | recommended for new designs | |
| Gemini 330 | Gemini 335 | full maintenance | recommended for new designs |
| Gemini 336 | full maintenance | recommended for new designs | |
| Gemini 330 | full maintenance | recommended for new designs | |
| Gemini 335L | full maintenance | recommended for new designs | |
| Gemini 336L | full maintenance | recommended for new designs | |
| Gemini 330L | full maintenance | recommended for new designs | |
| Gemini 335Lg | not supported | recommended for new designs | |
| Gemini 335Le | not supported | recommended for new designs | |
| Gemini 338Lg | not supported | recommended for new designs | |
| Gemini 338Le | not supported | recommended for new designs | |
| Gemini 340 | Gemini 345Lg | not supported | recommended for new designs |
| Gemini 2 | Gemini 2 | full maintenance | recommended for new designs |
| Gemini 2 L | full maintenance | recommended for new designs | |
| Gemini 2 XL | recommended for new designs | not supported | |
| Gemini 215 | not supported | recommended for new designs | |
| Gemini 210 | not supported | recommended for new designs | |
| Femto | Femto Bolt | full maintenance | recommended for new designs |
| Femto Mega | full maintenance | recommended for new designs | |
| Femto Mega I | full maintenance | recommended for new designs | |
| Astra | Astra 2 | full maintenance | recommended for new designs |
| Astra+ | limited maintenance | not supported | |
| Astra Pro Plus | limited maintenance | not supported | |
| Astra Mini | Astra Mini Pro | full maintenance | recommended for new designs |
| Astra Mini S Pro | full maintenance | recommended for new designs | |
| LiDAR | Pulsar ME450 | not supported | recommended for new designs |
| Pulsar SL450 | not supported | recommended for new designs |
注意: 雷达设备在v2.6.3及之后的版本中支持。使用详情请参考文档.如果没有找到您的设备,请联系 FAE 或销售人员获取帮助。
定义:
- 推荐用于新项目:我们将提供完整支持,包括新功能、bug 修复和性能优化;
- 完整维护:我们将提供 bug 修复支持;
- 有限维护:我们将提供关键 bug 修复支持;
- 不支持:此版本不支持该设备;
- 即将支持:我们将在不久的将来添加支持。
迁移指南
如果您需要将现有项目从 main (v1.x) 分支迁移到 v2-main (v2.x) 分支,请参考官方迁移指南
安装依赖
ROS
- 请直接参考 ROS wiki 进行安装。
其他依赖
安装依赖(请注意 ROS 发行版):
# 假设您已经加载了 ROS 环境,以下相同 sudo apt install libgflags-dev ros-$ROS_DISTRO-image-geometry ros-$ROS_DISTRO-camera-info-manager \ ros-${ROS_DISTRO}-image-transport-plugins ros-${ROS_DISTRO}-compressed-image-transport \ 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
创建 ROS 工作空间并编译
创建 ROS 工作空间(如果尚未创建):
mkdir -p ~/ros_ws/src
获取源码:
cd ~/ros_ws/src
git clone https://github.com/orbbec/OrbbecSDK_ROS1.git
roscd orbbec_camera
git checkout v2-main
git branch #检查分支是否切换成功
编译包:
cd ~/ros_ws
catkin_make
安装 udev 规则:
cd ~/ros_ws
source ./devel/setup.bash
roscd orbbec_camera
sudo bash ./scripts/install_udev_rules.sh
启动相机
终端 1:
source ./devel/setup.bash
roslaunch orbbec_camera gemini_330_series.launch
终端 2:
source ./devel/setup.bash
rviz
查看话题、服务和参数(终端3):
rostopic list
rosservice list
rosparam list
输出话题:
rostopic echo /camera/depth/camera_info
调用服务:
rosservice call /camera/get_sdk_version "{}"
更多使用细节,请参考官方 OrbbecSDK ROS 文档
支持的设备
目前,以下设备受 OrbbecSDK ROS Wrapper v2-main 分支支持。后续会添加更多设备支持。如果您在下表中找不到设备,请尝试 main 分支。
为了获得最佳性能,强烈建议升级到最新固件版本。这将确保您能够获得最新的改进和 bug 修复。
以下设备受 OrbbecSDK ROS Wrapper 支持:
| Product Series | Products List | Recommended FW Version | Launch File |
|---|---|---|---|
| Gemini 430 | Gemini 435Le | 1.3.19 | gemini435_le.launch |
| Gemini 301 | Gemini 305 | 1.0.70 | gemini_301_series.launch |
| Gemini 305g | 1.0.70 | gemini_301_series.launch | |
| Gemini 330 | Gemini 335 | 1.8.10 | gemini_330_series.launch |
| Gemini 336 | 1.8.10 | gemini_330_series.launch | |
| Gemini 330 | 1.8.10 | gemini_330_series.launch | |
| Gemini 335L | 1.8.10 | gemini_330_series.launch | |
| Gemini 336L | 1.8.10 | gemini_330_series.launch | |
| Gemini 330L | 1.8.10 | gemini_330_series.launch | |
| Gemini 335Lg | 1.8.10 | gemini_330_series.launch | |
| Gemini 335Le | 1.8.10 | gemini_330_series.launch | |
| Gemini 338Lg | 1.8.17 | gemini_330_series.launch | |
| Gemini 338Le | 1.8.17 | gemini_330_series.launch | |
| Gemini 340 | Gemini 345Lg | 1.9.03 | gemini345_lg.launch |
| Gemini 2 | Gemini 2 | 1.4.98 | gemini2.launch |
| Gemini 2 L | 1.5.2 | gemini2L.launch | |
| Gemini 215 | 1.0.9 | gemini210.launch | |
| Gemini 210 | 1.0.9 | gemini210.launch | |
| Femto | Femto Bolt | 1.1.3 | femto_bolt.launch |
| Femto Mega | 1.3.1 | femto_mega.launch | |
| Femto Mega I | 2.0.4 | femto_mega.launch | |
| Astra | Astra 2 | 2.8.20 | astra2.launch |
| Astra Mini | Astra Mini Pro | 2.0.03 | astra.launch |
| Astra Mini S Pro | 2.0.03 | astra.launch | |
| LiDAR | Pulsar ME450 | 1.0.0.6 | lidar.launch |
| Pulsar SL450 | 2.2.4.5 | lidar.launch |
所有的 launch 文件基本相同,主要区别在于针对同系列不同型号设定的参数默认值不同。USB 2.0 和 USB 3.0 等标准差异,可能需要对参数进行调整。如果遇到启动失败,请仔细检查规格手册,尤其是 launch 文件中的分辨率设置及其他参数,确保兼容性和最佳性能。
教程
请参考官方 OrbbecSDK ROS 文档
示例
要了解实际示例并掌握如何在 ROS 中使用相机,请前往 Examples 目录查看更多信息。
其他有用的链接
许可证
Copyright 2024 Orbbec Ltd.
根据 Apache License 2.0(以下简称“许可”)授权;除非遵循本许可,否则您不能使用此项目。您可以在以下地址获取许可副本:
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,本软件按“原样”分发,不附带任何明示或暗示的担保或条件。请参阅许可中有关特定语言的权限和限制的内容。
其他名称和品牌可能归他人所有。