> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-hands.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=39ee8e569cd1990332eda16ab440c9b2" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-faces.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=e2430fce5b98e03905cf2d90d10e4e4d" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-poses.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=4dcb801e2b7aa319df633432041027fb" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-depth.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=1bdbd2e3abc5f10f15c163b4c4d28170" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-resnet101.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=ff49227cee42ad69fae38b65ccf1ebbd" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-object.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=0ee7897370568eb5200b355d10d1caf6" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-segment.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=92dfd6e8501b91102126b8ac29179516" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-ocr.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=1144c525e18527e4131e7259b88cfa42" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-slam.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=d411e143845bc4384640f93ba65c4bff" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-navigation.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=de4d9f195eef1468a235fa6334b346a4" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-pickplace.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=15d9860c28e94c45b56af3787b87689c" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-remote-assistant.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=57a642a6879d12c029e33138efd3765e" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-motion.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=c513114814ff3d9ac66e65209e251c40" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-lidar.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=9b8ebc72b96d7eaf1bccfc12a8e37a03" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-apriltag.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=5057f5e3c77f9973513bd5f6a0c61cb8" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-orbbec.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=832dbc2b930d423e27b199a4521ac57a" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-camera.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=50c38b221cc898e0f5bcbc49e939f002" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-rplidar.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=9ca2e5312006162029914df1576b8d6b" 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-prod/Wc1juBQkT-boIg_Z/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/colorspace-convert-pipeline.png?fit=max&auto=format&n=Wc1juBQkT-boIg_Z&q=85&s=2fa12692f99647df4d0d35d9483ae70a" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-system-status.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=31da70069242ff17f96f7c636b3af38b" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-benchmark.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=d852adb7cd888bfd5650b832bb78076b" 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-prod/EDJV-hu6qJhZi4pm/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/showcase-nn.png?fit=max&auto=format&n=EDJV-hu6qJhZi4pm&q=85&s=8d0137f1c42da4c4bf23b574e70ca5a2" 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-prod/IP0o0G5fE3MFmCJ8/SDKs/QIR-SDK-2.0/media/80-65220-2-qirp-sdk-qsg/qrb_ros_audio_service_pipeline.png?fit=max&auto=format&n=IP0o0G5fE3MFmCJ8&q=85&s=9de9f6d7eae3ea9df27883e12b3a2753" 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>
