> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Qualcomm Intelligent Robotics SDK 文档

Qualcomm<sup>®</sup> Intelligent Robotics（QIR）SDK 提供机器人示例和工具，供您在支持 Qualcomm Linux 软件的开发套件上开发应用程序。

## 了解 QIR SDK 能做什么

快速了解您可以借助 QIR SDK 构建的各项能力：

export const CapabilityTile = ({href, title, tight, children}) => <a href={href} className="block not-prose">
    {children}
    <div className={tight ? "mt-0 text-xs text-gray-600 dark:text-zinc-400" : "mt-4 text-xs text-gray-600 dark:text-zinc-400"}>{title}</div>
  </a>;

export const Strip = ({children, className}) => <div className={`capability-scroll flex snap-x snap-proximity gap-x-3 overflow-x-auto pb-2 ${className || ""}`}>{children}</div>;

<div className="mt-2">
  <div className="text-xs font-semibold uppercase tracking-wide text-black dark:text-white">感知 / AI</div>

  <Strip className="mt-6">
    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./detect-hands-with-sample-hand-detection" title="手部检测">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-hands.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=1a1e7434cb8d53ddc34ea1a64cd27fdd" alt="手部检测" className="aspect-square w-full rounded-lg object-cover" width="208" height="202" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-hands.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./detect-faces-with-sample-face-detection" title="人脸检测">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-faces.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=29ff5ac0e10ad2baa077368793299a9f" alt="人脸检测" className="aspect-square w-full rounded-lg object-cover" width="768" height="432" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-faces.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./estimate-human-poses-with-sample-hrnet-pose-estimation" title="人体姿态估计">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-poses.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=980e81fc63e92068e760339f74e31fdf" alt="人体姿态估计" className="aspect-square w-full rounded-lg object-cover" width="237" height="299" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-poses.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./estimate-image-depth-values-with-sample-depth-estimation" title="深度估计">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-depth.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=af4bd63d59749c60006eb1aa2731c056" alt="深度估计" className="aspect-square w-full rounded-lg object-cover" width="192" height="144" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-depth.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./classify-images-with-sample-resnet101" title="图像分类">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-resnet101.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=b6831e478f60d260e69db1083f2c375f" alt="图像分类" className="aspect-square w-full rounded-lg object-cover" width="462" height="462" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-resnet101.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./detect-objects-with-sample-object-detection" title="目标检测">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-object.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=af3f6ffc81b95cc6b18e687335611435" alt="目标检测" className="aspect-square w-full rounded-lg object-cover" width="654" height="654" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-object.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./segment-objects-with-sample-object-segmentation" title="目标分割">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-segment.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=f2f504e389da260e6ef287861bb147be" alt="目标分割" className="aspect-square w-full rounded-lg object-cover" width="400" height="401" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-segment.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./run-basic-ocr-with-ocr-service" title="OCR">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-ocr.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=f9f4097e34ae663d6d7bcaa68ecec5e4" alt="OCR" className="aspect-square w-full rounded-lg object-cover" width="831" height="831" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-ocr.png" />
      </CapabilityTile>
    </div>
  </Strip>
</div>

<div className="mt-8">
  <div className="text-xs font-semibold uppercase tracking-wide text-black dark:text-white">导航与移动</div>

  <Strip className="mt-6">
    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./enable-2-d-lidar-slam-with-cartographer-ros" title="2D 激光雷达 SLAM">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-slam.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=fc5473d977efd68bb21eaf88fe0364b5" alt="2D 激光雷达 SLAM" className="aspect-square w-full rounded-lg object-cover" width="883" height="1040" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-slam.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./enable-navigation-in-the-simulator-with-navigation2" title="导航">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-navigation.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=c06cd0e4f9d8c8ca45c3d309ae71904b" alt="导航" className="aspect-square w-full rounded-lg object-cover" width="495" height="495" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-navigation.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./enable-pick-and-place-in-the-simulator-with-simulation-sample-pick-and-place" title="抓取与放置">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-pickplace.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=0c71b762992b3a5f01143e651f2ca8d6" alt="抓取与放置" className="aspect-square w-full rounded-lg object-cover" width="566" height="566" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-pickplace.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./experience-remote-assistant-in-the-simulator-with-simulation-remote-assistant" title="远程助手">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-remote-assistant.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=4261c6c6c8cc75fc19b4cf5e60990dad" alt="远程助手" className="aspect-square w-full rounded-lg object-cover" width="760" height="760" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-remote-assistant.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./control-amr-in-the-simulator-with-simulation-sample-amr-simple-motion" title="AMR 简单运动">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-motion.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=ab0dfe665218992a6272ee86bf37fb23" alt="AMR 简单运动" className="aspect-square w-full rounded-lg object-cover" width="480" height="480" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-motion.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_2.25rem)/4)]">
      <CapabilityTile href="./enable-2-d-lidar-slam-in-the-simulator-with-cartographer-ros" title="2D 激光雷达 SLAM（模拟器）">
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-lidar.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=abd14543f6fa0dd6efdd2962000a4e2a" alt="2D 激光雷达 SLAM（模拟器）" className="aspect-square w-full rounded-lg object-cover" width="443" height="443" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-lidar.png" />
      </CapabilityTile>
    </div>
  </Strip>
</div>

<div className="grid grid-cols-2 gap-x-3 mt-8">
  <div className="text-xs font-semibold uppercase tracking-wide text-black dark:text-white">摄像头与传感</div>
  <div className="text-xs font-semibold uppercase tracking-wide text-black dark:text-white">系统与平台工具</div>

  <Strip className="mt-6">
    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./enable-april-tag-pipeline-with-sample-apriltag" title="AprilTag 管线" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-apriltag.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=21a79c5b06e4fd588119f752c0f8bb56" alt="AprilTag 管线" className="aspect-square w-full rounded-lg object-cover" width="322" height="230" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-apriltag.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./enable-orbbec-gemini-335-l-with-orbbec-camera" title="Orbbec Gemini 335L 摄像头" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-orbbec.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=0d70c7c5655268ed310261d3208b0f35" alt="Orbbec Gemini 335L 摄像头" className="aspect-square w-full rounded-lg object-cover" width="1030" height="1030" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-orbbec.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./run-a-zero-copy-camera-with-qrb-ros-camera" title="零拷贝摄像头" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-camera.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=371fa1c6381f908cbca6e627cd3c1001" alt="零拷贝摄像头" className="aspect-square w-full rounded-lg object-cover" width="1810" height="1810" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-camera.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./enable-basic-rplidar-handling-with-rplidar-ros2" title="RPLidar ROS 2" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-rplidar.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=535b19de2a43ac1ac77841f7d4f7b248" alt="RPLidar ROS 2" className="aspect-square w-full rounded-lg object-cover" width="1498" height="1498" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-rplidar.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./convert-between-nv-12-and-rgb-888-with-qrb-ros-colorspace-convert" title="NV12 到 RGB888 转换" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/qMmE1ZLNeBAcOAi4/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/colorspace-convert-pipeline.png?fit=max&auto=format&n=qMmE1ZLNeBAcOAi4&q=85&s=c91f08bf0d8e5225859976a176a09ccc" alt="NV12 到 RGB888 转换" className="aspect-square w-full rounded-lg object-cover" width="878" height="818" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/colorspace-convert-pipeline.png" />
      </CapabilityTile>
    </div>
  </Strip>

  <Strip className="mt-6">
    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./publish-system-status-with-qrb-ros-system-monitor" title="系统状态监控" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-system-status.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=66d0e7128fd7ac69af58b82e79a0504b" alt="系统状态监控" className="aspect-square w-full rounded-lg object-cover" width="640" height="640" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-system-status.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./evaluating-performance-of-ros-2-components-with-qrb-ros-benchmark" title="ROS 2 性能基准测试" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-benchmark.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=741a598c6ab0c14954ab49610721f9ff" alt="ROS 2 性能基准测试" className="aspect-square w-full rounded-lg object-cover" width="640" height="640" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-benchmark.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./execute-ai-model-inference-with-qrb-ros-nn-inference" title="AI 模型推理" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/jb0dXIodkfWxsAHM/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-nn.png?fit=max&auto=format&n=jb0dXIodkfWxsAHM&q=85&s=95551f8869b8ab52ea26b7427c9e0ada" alt="AI 模型推理" className="aspect-square w-full rounded-lg object-cover" width="1876" height="1876" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-nn.png" />
      </CapabilityTile>
    </div>

    <div className="flex-shrink-0 snap-start w-[calc((100%_-_0.75rem)/2)]">
      <CapabilityTile href="./enable-core-audio-with-qrb-ros-audio-service" title="核心音频服务" tight>
        <img noZoom src="https://mintcdn.com/qualcomm-staging/qMmE1ZLNeBAcOAi4/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/qrb_ros_audio_service_pipeline.png?fit=max&auto=format&n=qMmE1ZLNeBAcOAi4&q=85&s=215cb9f123cb2e0cf620629203270062" alt="核心音频服务" className="aspect-square w-full rounded-lg object-cover" width="1002" height="1395" data-path="SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/qrb_ros_audio_service_pipeline.png" />
      </CapabilityTile>
    </div>
  </Strip>
</div>

## 推荐路径

初次使用 QIR SDK？按照以下步骤在您的开发套件上运行示例应用程序：

<Steps>
  <Step title="开始使用">
    [开始使用 QIR SDK](./get-started-with-qir-sdk)，了解预构建镜像烧录方法和主机要求。
  </Step>

  <Step title="下载预构建软件包">
    为您的开发套件[下载预构建软件包](./download-the-prebuilt-packages)。
  </Step>

  <Step title="烧录机器人镜像">
    将[机器人镜像烧录](./flash-the-robotics-image)到您的开发套件。
  </Step>

  <Step title="设置环境">
    [设置环境](./set-up-env-for-sample-app)以运行示例应用程序。
  </Step>

  <Step title="运行演示应用程序">
    [运行演示应用程序](./run-demo-application)以验证您的安装。
  </Step>

  <Step title="探索示例应用程序（可选）">
    继续前往 [QIR SDK 示例应用程序](./qir-sdk-sample-applications)，尝试更多示例。
  </Step>
</Steps>

## 您想做什么？

已经知道自己要找什么？直接跳转到下面的相关部分。

<Columns cols={2}>
  <Card title="QIR SDK 软件架构" icon="boxes" href="./qir-software-architecture">
    探索 QIR SDK 的组件、功能和工具。
  </Card>

  <Card title="运行示例应用程序" icon="robot" href="./qir-sdk-sample-applications">
    在支持的开发套件上运行机器人、AI 和平台示例。
  </Card>

  <Card title="开发应用程序" icon="file-code" href="./develop-applications-using-the-qir-sdk">
    使用 QIR SDK 的文件结构、API 和 ROS 2 示例构建您自己的应用程序。
  </Card>

  <Card title="构建与定制" icon="hammer" href="./optional-developer-workflows">
    构建、升级 QIR SDK 或进行故障排查，以满足您的需求。
  </Card>

  <Card title="迁移" icon="clipboard-list" href="./migration-overview">
    将您的应用程序从 Qualcomm Linux 1.0 迁移到 2.0。
  </Card>

  <Card title="发行说明" icon="newspaper" href="./release-notes">
    了解最新 QIR SDK 版本的新增内容。
  </Card>
</Columns>
