Skip to main content
qrb_ros_samples 是一个参考示例目录,它将 QNN 推理以及(在适用情况下)零拷贝传输接入可直接运行的 ROS 2 launch 文件。该仓库采用 BSD‑3‑Clause 许可证。main 分支为活跃开发分支;如需稳定发行版请跟踪 jazzy-rel 分支。
这些是起点和参考——并非使用 Qualcomm 机器人平台的唯一受支持方式。相同的原语(QNN delegate、qrb_ros_transport 以及来自 Qualcomm AI Hub 的模型)可以直接与标准 ROS 2 / 社区软件包组合。NPU 工作流程就是这种从零构建方式的示例,面向同一个 NPU。

AI 示例

视觉和音频管线——深度、姿态、分割、检测、语音识别。推理通过 QNN 在 NPU 上运行。

机器人示例

AMR 运动、2D 激光雷达 SLAM、Nav2、AprilTag、跟随、抓取放置。包括设备端和 Gazebo 仿真。

如何解读支持矩阵

上游 README 没有为其支持列定义图例,且各示例的 README 有时与顶层表格不一致。以下是本页对数据的解读方式:此目录中列出的每个示例都可以在 Qualcomm® IoT 平台的 Ubuntu 镜像上从源码构建。仅通过 Qualcomm Linux / QIRP SDK 工具链提供的示例已被排除。
空复选框 不代表”不支持”——只代表”上游未验证”。在为某个套件上的示例投入时间之前,请查看该示例自己的 README(从”示例”列链接)以获得权威的按套件支持列表。当示例的 README 与此目录不一致时,以示例的 README 为准。

AI 示例

大多数视觉示例从 qrb_ros_camera(Qualcomm CSI/GMSL)采集。要改用 USB 网络摄像头运行这些示例,请将摄像头节点换成 v4l2_camera——端到端示例参见 NPU 工作流程
各行按上手难易程度排序——所需额外硬件最少的排在最前。
想在这些示例封装的相同原语之上从零构建推理管线?参见 NPU 工作流程,那里有一个直接使用 QNN TFLite delegate 的手工深度估计示例。

机器人示例

各行按上手难易程度排序——先是仿真,然后是基于摄像头的,最后是特定厂商外设的。

系统要求

根据上游要求:面向 Qualcomm IoT 平台的 Canonical Ubuntu。参见在 Qualcomm IoT 平台上安装 Ubuntu安装 ROS Jazzy。对于 Qualcomm Linux 目标,请改用 QIRP SDK