diff --git a/docs/en/source/2_installation/build_the_package.md b/docs/en/source/2_installation/build_the_package.md index 10bd795d..81470d1f 100644 --- a/docs/en/source/2_installation/build_the_package.md +++ b/docs/en/source/2_installation/build_the_package.md @@ -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: diff --git a/docs/en/source/2_installation/registration_script.md b/docs/en/source/2_installation/registration_script.md index f7da5f01..b980570e 100644 --- a/docs/en/source/2_installation/registration_script.md +++ b/docs/en/source/2_installation/registration_script.md @@ -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 diff --git a/docs/zh/source/2_installation/build_the_package.md b/docs/zh/source/2_installation/build_the_package.md index 378176fd..c7d50d1f 100644 --- a/docs/zh/source/2_installation/build_the_package.md +++ b/docs/zh/source/2_installation/build_the_package.md @@ -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 ``` - diff --git a/docs/zh/source/2_installation/registration_script.md b/docs/zh/source/2_installation/registration_script.md index bb80b4fa..03b0533f 100644 --- a/docs/zh/source/2_installation/registration_script.md +++ b/docs/zh/source/2_installation/registration_script.md @@ -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(管理员权限)运行示例程序。 -