enhance binary installation instructions and clarify registration script requirements

This commit is contained in:
ob-yalian
2025-11-28 15:52:02 +08:00
parent 72254ee03b
commit 2f21cd1bb9
4 changed files with 76 additions and 26 deletions
@@ -1,3 +1,30 @@
### Binary Installation
#### Environment
Install ROS 2 according to the official guide:
* [ROS 2 installation (Ubuntu)](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html)
#### Linux Binary Package Installation
Check available packages:
```bash
sudo apt update
apt list | grep orbbec
```
Install OrbbecSDK ROS2 package:
```bash
sudo apt install ros-humble-orbbec-camera ros-humble-orbbec-description
```
After installation, you can use it directly without compilation.
---
### Build from Source
#### Environment
@@ -36,15 +63,8 @@ Install dependencies:
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-backward-ros libdw-dev
```
Optional dependencies:
```bash
# 435Le writeCustomerDate feature:
sudo apt install libssl-dev
ros-$ROS_DISTRO-diagnostic-updater ros-$ROS_DISTRO-diagnostic-msgs ros-$ROS_DISTRO-statistics-msgs ros-$ROS_DISTRO-xacro \
ros-$ROS_DISTRO-backward-ros libdw-dev libssl-dev
```
Build:
@@ -1,6 +1,15 @@
## Registration script (required)
## Registration Script (Required)
To allow the Orbbec cameras to be recognized correctly on Linux, install the udev rules:
To allow the Orbbec cameras to be recognized correctly on Linux, install the udev rules.
### Binary Installation
```bash
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
```
### Build from Source
```bash
cd ~/ros2_ws/src/OrbbecSDK_ROS2/orbbec_camera/scripts
@@ -1,6 +1,4 @@
### 从源码构建
#### 环境配置
### 环境配置
根据官方指南安装 ROS 2
@@ -19,6 +17,29 @@ eval "$(register-python-argcomplete3 colcon)"
mkdir -p ~/ros2_ws/src
```
### 二进制安装
#### Linux 二进制包安装
查看软件包:
```bash
sudo apt update
apt list | grep orbbec
```
安装 OrbbecSDK ROS2 包:
```bash
sudo apt install ros-humble-orbbec-camera ros-humble-orbbec-description
```
安装完成后,直接使用即可,无需编译。
---
### 从源码构建
#### Linux ROS2 包装器编译
克隆源代码并切换到 `v2-main` 分支:
@@ -36,15 +57,8 @@ git checkout v2-main
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-backward-ros libdw-dev
```
可选依赖项:
```bash
# 435Le writeCustomerDate 功能:
sudo apt install libssl-dev
ros-$ROS_DISTRO-diagnostic-updater ros-$ROS_DISTRO-diagnostic-msgs ros-$ROS_DISTRO-statistics-msgs ros-$ROS_DISTRO-xacro \
ros-$ROS_DISTRO-backward-ros libdw-dev libssl-dev
```
构建:
@@ -53,4 +67,3 @@ sudo apt install libssl-dev
cd ~/ros2_ws
colcon build --event-handlers console_direct+ --cmake-args -DCMAKE_BUILD_TYPE=Release
```
@@ -1,6 +1,15 @@
## 注册脚本(必需)
为了让 Orbbec 相机在 Linux 上被正确识别,请安装 udev 规则
为了让 Orbbec 相机在 Linux 上被正确识别,请安装 udev 规则
### 二进制安装
```bash
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
```
### 从源码构建
```bash
cd ~/ros2_ws/src/OrbbecSDK_ROS2/orbbec_camera/scripts
@@ -11,4 +20,3 @@ sudo udevadm control --reload-rules && sudo udevadm trigger
此步骤对于 Linux 用户是**必需的**。
`注意:` 如果不执行此脚本,由于权限问题,打开设备将会失败。您需要使用 sudo(管理员权限)运行示例程序。