# Qualcomm Intelligent Robotics SDK 文档

Qualcomm^®^ Intelligent Robotics (QIR) SDK 为您提供机器人示例和工具，以便在支持 [Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/topics/80-70022-115/) 软件的开发套件上开发应用程序。

## QIR SDK 简介

<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewbox="0 0 48 48" aria-label="icon2">
  <defs>
    <style>.svg-1 .fill-primary-blue { fill: var(--color-navigation-link, #2a2aea) }
.svg-1 .fill-none { fill: none }</style>
  </defs>
  <g id="Layer_2" data-name="Layer 2">
    <g id="Layer_1-2" data-name="Layer 1">
      <g id="sw-sdks">
        <rect class="fill-none" width="48" height="48"></rect>
        <g>
          <path class="fill-primary-blue" d="M32.152,19.911a1.69,1.69,0,0,1-.839-.222L11.006,8.19a1.664,1.664,0,0,1-.628-2.285,1.7,1.7,0,0,1,2.309-.622l20.307,11.5a1.664,1.664,0,0,1,.628,2.285A1.7,1.7,0,0,1,32.152,19.911Z"></path>
          <path class="fill-primary-blue" d="M22,47.993a6.253,6.253,0,0,1-3.105-.821L3.109,38.245A6.147,6.147,0,0,1,0,32.93V15.065A6.146,6.146,0,0,1,3.1,9.752L18.9.817a6.28,6.28,0,0,1,6.2,0L40.891,9.748A6.149,6.149,0,0,1,44,15.063V32.928a6.146,6.146,0,0,1-3.1,5.314L25.1,47.176A6.232,6.232,0,0,1,22,47.993ZM22,3.349a2.835,2.835,0,0,0-1.408.372l-15.8,8.935a2.792,2.792,0,0,0-1.4,2.411V32.928A2.791,2.791,0,0,0,4.794,35.34l15.789,8.929a2.861,2.861,0,0,0,2.827,0l15.8-8.935a2.791,2.791,0,0,0,1.4-2.411V15.067a2.8,2.8,0,0,0-1.41-2.415L23.417,3.725A2.857,2.857,0,0,0,22,3.349Z"></path>
          <path class="fill-primary-blue" d="M22,25.671a1.7,1.7,0,0,1-.843-.223L1.526,14.284A1.665,1.665,0,0,1,.9,12a1.7,1.7,0,0,1,2.311-.617L22,22.065,40.787,11.381A1.7,1.7,0,0,1,43.1,12a1.665,1.665,0,0,1-.624,2.286L22.843,25.448A1.7,1.7,0,0,1,22,25.671Z"></path>
          <path class="fill-primary-blue" d="M22,48a1.683,1.683,0,0,1-1.692-1.675V24a1.692,1.692,0,0,1,3.384,0V46.325A1.683,1.683,0,0,1,22,48Z"></path>
        </g>
      </g>
    </g>
  </g>
</svg>
 [概述](https://docs.qualcomm.com/doc/80-70022-265Y/topic/introduction.html#qir-sdk-intro)

> 
> 
> 概述 QIR SDK 提供的功能及其支持的 Qualcomm 硬件平台。

<svg xmlns="http://www.w3.org/2000/svg" width="48" height="48" viewbox="0 0 48 48" aria-label="icon2">
  <defs>
    <style>.svg-2 .fill-primary-blue { fill: var(--color-navigation-link, #2a2aea) }
.svg-2 .fill-none { fill: none }</style>
  </defs>
  <g id="Layer_2" data-name="Layer 2">
    <g id="Layer_1-2" data-name="Layer 1">
      <g id="sw-sdks">
        <rect class="fill-none" width="48" height="48"></rect>
        <g>
          <path class="fill-primary-blue" d="M32.152,19.911a1.69,1.69,0,0,1-.839-.222L11.006,8.19a1.664,1.664,0,0,1-.628-2.285,1.7,1.7,0,0,1,2.309-.622l20.307,11.5a1.664,1.664,0,0,1,.628,2.285A1.7,1.7,0,0,1,32.152,19.911Z"></path>
          <path class="fill-primary-blue" d="M22,47.993a6.253,6.253,0,0,1-3.105-.821L3.109,38.245A6.147,6.147,0,0,1,0,32.93V15.065A6.146,6.146,0,0,1,3.1,9.752L18.9.817a6.28,6.28,0,0,1,6.2,0L40.891,9.748A6.149,6.149,0,0,1,44,15.063V32.928a6.146,6.146,0,0,1-3.1,5.314L25.1,47.176A6.232,6.232,0,0,1,22,47.993ZM22,3.349a2.835,2.835,0,0,0-1.408.372l-15.8,8.935a2.792,2.792,0,0,0-1.4,2.411V32.928A2.791,2.791,0,0,0,4.794,35.34l15.789,8.929a2.861,2.861,0,0,0,2.827,0l15.8-8.935a2.791,2.791,0,0,0,1.4-2.411V15.067a2.8,2.8,0,0,0-1.41-2.415L23.417,3.725A2.857,2.857,0,0,0,22,3.349Z"></path>
          <path class="fill-primary-blue" d="M22,25.671a1.7,1.7,0,0,1-.843-.223L1.526,14.284A1.665,1.665,0,0,1,.9,12a1.7,1.7,0,0,1,2.311-.617L22,22.065,40.787,11.381A1.7,1.7,0,0,1,43.1,12a1.665,1.665,0,0,1-.624,2.286L22.843,25.448A1.7,1.7,0,0,1,22,25.671Z"></path>
          <path class="fill-primary-blue" d="M22,48a1.683,1.683,0,0,1-1.692-1.675V24a1.692,1.692,0,0,1,3.384,0V46.325A1.683,1.683,0,0,1,22,48Z"></path>
        </g>
      </g>
    </g>
  </g>
</svg>
 [QIR 软件架构](https://docs.qualcomm.com/doc/80-70022-265Y/topic/architecture.html#architecture-2)

> 
> 
> 以可视化的方式展示 QIR SDK 软件组件、功能和工具。

## 开始使用 QIR SDK

[入门指南](https://docs.qualcomm.com/doc/80-70022-265Y/topic/quick_start.html#chapter-quickstart)允许您试用 QIR SDK 的预编译镜像。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [下载预编译包](https://docs.qualcomm.com/doc/80-70022-265Y/topic/quick_start.html#dl-prebuilt)

> 
> 
> 下载机器人预编译包。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [刷写机器人镜像](https://docs.qualcomm.com/doc/80-70022-265Y/topic/quick_start.html#flash-img-qs)

> 
> 
> 刷写机器人镜像，使开发套件准备好运行示例应用程序。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [搭建示例应用程序的环境](https://docs.qualcomm.com/doc/80-70022-265Y/topic/quick_start.html#setup-demo-qs)

> 
> 
> 完成一些设置，以确保示例应用程序可以在开发套件上运行。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [运行演示应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/quick_start.html#run-demo-qs)

> 
> 
> 运行演示应用程序以验证 SDK 安装。

## 运行 QIR SDK 示例应用程序

在支持的开发套件上运行示例应用程序。更多详细信息，参见 [QIR SDK 示例应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qirp_sdk_sample.html#qirp-sdk-sample)。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [运行示例应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/ai_sample.html#ai-sample-home)

> 
> 
> 运行 AI 示例应用程序，例如检测图片中的手。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [运行机器人示例应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/robotics_sample.html#robotics-sample-home)

> 
> 
> 运行机器人示例应用程序，例如自主移动机器人 (AMR) 2D 激光雷达 SLAM。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [运行平台示例应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/platform_sample.html#platform-sample-home)

> 
> 
> 运行平台示例应用程序，例如获取系统显示器信息。

## 使用 QIR SDK 开发应用程序

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [了解文件结构](https://docs.qualcomm.com/doc/80-70022-265Y/topic/develop_application_with_qirp_sdk.html#develop-your-first-application-6)

> 
> 
> 了解 QIR SDK 中包含的文件结构和工具链。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [开发示例 ROS2 应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/develop_application_sample.html#develop-application-samples)

> 
> 
> 使用 QIR SDK 开发 ROS 2 示例应用程序。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [开发 pipeline 应用程序](https://docs.qualcomm.com/doc/80-70022-265Y/topic/develop_pipeline_application.html#develop-pipeline-application)

> 
> 
> 使用 QIR SDK 通过 API 开发 pipeline 应用程序。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [QIR SDK API 列表](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qir_sdk_api_list.html#qir-sdk-api-list)

> 
> 
> 检查 QIR SDK 提供的所有 API。

## 可选的开发者工作流

使用 QIR SDK 不需要以下工作流。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [编译 QIR SDK](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qirp_sdk_build.html#qirp-sdk-build)

> 
> 
> 仅在真正需要时，才使用 [Qualcomm Software Center (QSC) launcher](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qsc_launcher_gui.html#build-with-the-qsc-launcher)、[QSC-CLI](https://docs.qualcomm.com/doc/80-70022-265Y/topic/qsc_cli.html#using-qsc-cli-3-1)、[GitHub](https://docs.qualcomm.com/doc/80-70022-265Y/topic/github_workflow.html#section-github-workflow) 和 [Docker](https://docs.qualcomm.com/doc/80-70022-265Y/topic/docker_workflow.html#section-docker-workflow) 工作流或 [Robotics eSDK](https://docs.qualcomm.com/doc/80-70022-265Y/topic/esdk_gen_image.html#section-esdk-gen-image) 编译 QIR SDK。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [升级单个 SDK](https://docs.qualcomm.com/doc/80-70022-265Y/topic/upgrade_individual_sdk.html#upgrade-individual-sdk)

> 
> 
> 根据需要分别升级 Qualcomm IM SDK、Qualcomm Neural Processing SDK 和 Qualcomm AI Engine Direct SDK。

<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewbox="0 0 16 16" fill="none" aria-label="icon-book">
  <path d="M8 2V14M3.33333 2H12.6667C13.403 2 14 2.59695 14 3.33333V12.6667C14 13.403 13.403 14 12.6667 14H3.33333C2.59695 14 2 13.403 2 12.6667V3.33333C2 2.59695 2.59695 2 3.33333 2Z" stroke="#2A2AEA" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"></path>
</svg> [问题排查](https://docs.qualcomm.com/doc/80-70022-265Y/topic/troubleshooting.html#troubleshooting-topic)

> 
> 
> 了解排查常见问题的方法。

Last Published: Nov 11, 2025

[Next Topic
QIR SDK 概述](https://docs.qualcomm.com/bundle/publicresource/80-70022-265Y/topics/introduction.md)