tmp

docs/en/source/2_installation/build_the_package.md

@@ -0,0 +1,55 @@
+### Build from Source
+
+#### Environment
+
+Install ROS 2 according to the official guide:
+
+* [ROS 2 installation (Ubuntu)](https://docs.ros.org/en/humble/Installation/Ubuntu-Install-Debians.html)
+
+Enable ROS 2 auto-completion:
+
+```bash
+eval "$(register-python-argcomplete3 ros2)"
+eval "$(register-python-argcomplete3 colcon)"
+```
+
+Create a `colcon` workspace:
+
+```bash
+mkdir -p ~/ros2_ws/src
+```
+
+#### Linux ROS2 Wrapper Compilation
+
+Clone source and checkout `v2-main` branch:
+
+```bash
+cd ~/ros2_ws/src
+git clone https://github.com/orbbec/OrbbecSDK_ROS2.git
+cd OrbbecSDK_ROS2
+git checkout v2-main
+```
+
+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-backward-ros libdw-dev
+```
+
+Optional dependencies:
+
+```bash
+# 435Le writeCustomerDate feature:
+sudo apt install libssl-dev
+```
+
+Build:
+
+```bash
+cd ~/ros2_ws
+colcon build --event-handlers console_direct+ --cmake-args -DCMAKE_BUILD_TYPE=Release
+```

docs/en/source/2_installation/installation.rst

@@ -0,0 +1,11 @@
+Installation
+======================================================
+
+This chapter explains how to install the Orbbec ROS2 Python SDK, including building from source, installing dependencies, and using registration scripts.
+
+.. toctree::
+    :maxdepth: 2
+
+    build_the_package.md
+    registration_script.md
+

docs/en/source/2_installation/registration_script.md

@@ -0,0 +1,13 @@
+## Registration script (required)
+
+To allow the Orbbec cameras to be recognized correctly on Linux, install the udev rules:
+
+```bash
+cd  ~/ros2_ws/src/OrbbecSDK_ROS2/orbbec_camera/scripts
+sudo bash install_udev_rules.sh
+sudo udevadm control --reload-rules && sudo udevadm trigger
+```
+
+This step is **mandatory** for Linux users.
+
+`Notes:` If this script is not executed, open the device will fail due to permission issues. You need to run the sample with sudo (administrator privileges).