DepthAI v2 has been superseded by DepthAI v3. You are viewing legacy documentation.
此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 安装依赖项
  • 设置过程
  • 构建
  • 在 ROS1 上运行 Docker 镜像
  • 在 ROS2 上运行 Docker 镜像
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

从源代码安装

最后更新

安装依赖项

以下脚本将安装 depthai-core 并更新 USB 规则以及安装 DepthAI 设备:
Command Line
1sudo wget -qO- https://raw.githubusercontent.com/luxonis/depthai-ros/main/install_dependencies.sh | sudo bash
如果未安装 OpenCV,请尝试 sudo apt install libopencv-dev。如果未安装 rosdep 且未初始化,请执行以下步骤:
Command Line
1sudo apt install python3-rosdep
2sudo rosdep init
3rosdep update

设置过程

以下设置过程假设您已安装 cmake 版本 >= 3.10.2 和 OpenCV 版本 >= 4.0.0。我们选择 dai_ws 作为新文件夹的名称,因为它将是我们的 DepthAI ROS 工作区。
  1. mkdir -p dai_ws/src
  2. cd dai_ws/src
  3. git clone --branch <ros-distro> https://github.com/luxonis/depthai-ros.git
  4. cd ..
  5. rosdep install --from-paths src --ignore-src -r -y
  6. source /opt/ros/<ros-distro>/setup.bash
  7. catkin_make_isolated (适用于 ROS1) MAKEFLAGS="-j1 -l1" colcon build (适用于 ROS2)
  8. source devel/setup.bash (适用于 ROS1) & source install/setup.bash (适用于 ROS2)
注意 如果您使用的是低端 PC 或 RPi,标准构建可能会占用大量 RAM 并使您的 PC 堵塞。为避免这种情况,您可以使用工作区中的 build.sh 命令(它只是封装了 colcon 命令): ./src/depthai-ros/build.sh
最后更新
您还可以在本地机器上构建和运行 Docker 镜像。为此,请按照上述步骤添加 USB 规则。

运行预构建镜像

每个带标签的版本都有自己的预构建 Docker 镜像。要下载并运行它:
Command Line
1xhost +local:docker
以启用 GUI 工具,例如 rviz 或 rqt。然后
Command Line
1docker run -it -v /dev/:/dev/  --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix luxonis/depthai-ros:noetic-latest [CMD]
其中 [CMD] 是容器首次运行时将执行的命令,例如:
  • bash(它将允许您浏览文件并修改代码并重新构建它)
  • zsh(安装的其他 shell,比 bash 具有一些优势)
  • roslaunch depthai_ros_driver camera.launch(这只是一个示例,任何启动文件都可以在这里工作) 这里有一个旁注,depthai_ros_driver 中的启动文件有一些由驱动程序内部的 .yaml 文件设置的默认参数。您可以在容器内部编辑它们,或者您可以在主机上创建一个 .yaml 文件(例如 /home/YOUR_USERNAME_HERE/params/example_config.yaml),并将其作为参数传递给可执行文件,如下所示:
Command Line
1docker run -it -v /dev/:/dev/ -v /home/YOUR_USERNAME_HERE/params:/params --network host --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix luxonis/depthai-ros:noetic-latest roslaunch depthai_ros_driver camera.launch params_file:=/params/example_config.yaml
请注意,为了使镜像更紧凑,只安装了一些外部依赖项,例如,如果您想在 Docker 中试用 RTABMap 示例,您必须:
  • 通过在 bash/zsh 模式下运行容器来安装它
  • 修改 Dockerfile,使其在构建期间安装 - 之后您必须重新构建容器。
  • 在我们的容器中运行基本相机节点,并在主机/单独的容器中单独运行 RTABMap(请参阅启动文件,了解单独运行时需要更改哪些参数/主题名称)。

构建

克隆存储库并在其中运行(这取决于您所在的分支):
Command Line
1docker build --build-arg USE_RVIZ=1 -t depthai-ros .
如果您在构建过程中发现 RAM 不足,您还可以设置 BUILD_SEQUENTIAL=1 以一次构建一个包,这会花费更长时间,但会使用更少的 RAM。RUN_RVIZ 参数表示 rviz 将安装在 Docker 内部。如果您想运行它,还需要执行以下命令(重启 PC 后需要再次执行):
Command Line
1xhost +local:docker
然后您可以通过以下方式运行您的镜像:
Command Line
1docker run -it -v /dev/:/dev/ --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix depthai-ros
将运行交互式 Docker 会话。您也可以尝试:
Command Line
1docker run -it -v /dev/:/dev/ --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix depthai-ros roslaunch depthai_examples stereo_inertial_node.launch.py
以运行您选择的启动文件。注意 ROS2 Humble Docker 镜像使用 Cyclone 作为 RMW 实现。

在 ROS1 上运行 Docker 镜像

Command Line
1docker run -it -v /dev/:/dev/ --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix depthai-ros roslaunch depthai_examples stereo_inertial_node.launch
将只启动 stereo_inertial_node 启动文件(您可以尝试不同的命令)。

在 ROS2 上运行 Docker 镜像

Command Line
1docker run -it -v /dev/:/dev/ --privileged -e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix depthai-ros ros2 launch depthai_examples stereo_inertial_node.launch.py