# Qualcomm Intelligent Robotics SDK documentation

The Qualcomm^®^ Intelligent Robotics (QIR) SDK provides the robotics samples and tools for you to develop applications on the development kits supporting the [Qualcomm Linux](https://docs.qualcomm.com/doc/80-70023-115/) software.

## QIR SDK introduction

<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>
 [Overview](https://docs.qualcomm.com/doc/80-70023-265/topic/introduction.html#qir-sdk-intro)

> 
> 
> Provides an overview of what the QIR SDK offers and the Qualcomm hardware platforms it supports.

<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 software architecture](https://docs.qualcomm.com/doc/80-70023-265/topic/architecture.html#architecture-2)

> 
> 
> Shows a visual representation of the QIR SDK software components, functionalities, and tools.

## Get started with QIR SDK

The [Get started](https://docs.qualcomm.com/doc/80-70023-265/topic/quick_start.html#chapter-quickstart) allows you to try out the prebuilt image of the 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> [Download the prebuilt package](https://docs.qualcomm.com/doc/80-70023-265/topic/quick_start.html#dl-prebuilt)

> 
> 
> Download robotics prebuilt package.

<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> [Flash the robotics image](https://docs.qualcomm.com/doc/80-70023-265/topic/quick_start.html#flash-img-qs)

> 
> 
> Flash the robotics image to get the development kits ready for running sample applications.

<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> [Set up the environment for sample applications](https://docs.qualcomm.com/doc/80-70023-265/topic/quick_start.html#setup-demo-qs)

> 
> 
> Complete a few settings to ensure sample applications can run on the development kits.

<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> [Run the demo application](https://docs.qualcomm.com/doc/80-70023-265/topic/quick_start.html#run-demo-qs)

> 
> 
> Run a demo application to verify the SDK installation.

## Run QIR SDK sample applications

Run the sample applications on supported development kits. For details, see [QIR SDK sample applications](https://docs.qualcomm.com/doc/80-70023-265/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> [Run AI sample applications](https://docs.qualcomm.com/doc/80-70023-265/topic/ai_sample.html#ai-sample-home)

> 
> 
> Run AI sample applications, such as detecting hands in a picture.

<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> [Run robotics sample applications](https://docs.qualcomm.com/doc/80-70023-265/topic/robotics_sample.html#robotics-sample-home)

> 
> 
> Run robotics sample applications, such as autonomous moving robot (AMR) 2D lidar 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> [Run platform sample applications](https://docs.qualcomm.com/doc/80-70023-265/topic/platform_sample.html#platform-sample-home)

> 
> 
> Run platform sample applications, such as getting system monitor information.

## Develop applications using the 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> [Understand the file structure](https://docs.qualcomm.com/doc/80-70023-265/topic/develop_application_with_qirp_sdk.html#develop-your-first-application-6)

> 
> 
> Understand the file structure and toolchain included in 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> [Develop a sample ROS2 application](https://docs.qualcomm.com/doc/80-70023-265/topic/develop_application_sample.html#develop-application-samples)

> 
> 
> Use the QIR SDK to develop a ROS 2 sample application.

<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> [Develop a pipeline application](https://docs.qualcomm.com/doc/80-70023-265/topic/develop_pipeline_application.html#develop-pipeline-application)

> 
> 
> Use the QIR SDK to develop a pipeline application using the APIs.

<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 list](https://docs.qualcomm.com/doc/80-70023-265/topic/qir_sdk_api_list.html#qir-sdk-api-list)

> 
> 
> Check all the APIs provided by the QIR SDK.

## Optional developer workflows

The following workflows aren't required for using the 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> [Build the QIR SDK](https://docs.qualcomm.com/doc/80-70023-265/topic/qirp_sdk_build.html#qirp-sdk-build)

> 
> 
> Build the QIR SDK only when you really need to, using [Qualcomm Software Center (QSC) launcher](https://docs.qualcomm.com/doc/80-70023-265/topic/qsc_launcher_gui.html#build-with-the-qsc-launcher), [QSC-CLI](https://docs.qualcomm.com/doc/80-70023-265/topic/qsc_cli.html#using-qsc-cli-3-1), [GitHub](https://docs.qualcomm.com/doc/80-70023-265/topic/github_workflow.html#section-github-workflow) and [Docker](https://docs.qualcomm.com/doc/80-70023-265/topic/docker_workflow.html#section-docker-workflow) based workflows, or the [Robotics eSDK](https://docs.qualcomm.com/doc/80-70023-265/topic/esdk_gen_image.html#section-esdk-gen-image).

<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> [Upgrade individual SDKs](https://docs.qualcomm.com/doc/80-70023-265/topic/upgrade_individual_sdk.html#upgrade-individual-sdk)

> 
> 
> Upgrade the Qualcomm IM SDK, Qualcomm Neural Processing SDK, Qualcomm AI Engine Direct SDK individually as needed.

<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> [Troubleshoot](https://docs.qualcomm.com/doc/80-70023-265/topic/troubleshooting.html#troubleshooting-topic)

> 
> 
> Learn methods to troubleshoot general issues.

Last Published: Dec 29, 2025

[Next Topic
QIR SDK overview](https://docs.qualcomm.com/bundle/publicresource/80-70023-265/topics/introduction.md)