# 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

> 
> 
> 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

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

## Get started with QIR SDK

The Get started 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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.

<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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> 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

> 
> 
> Build the QIR SDK only when you really need to, using Qualcomm Software Center (QSC) launcher, QSC-CLI, GitHub and Docker based workflows, or the Robotics eSDK.

<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

> 
> 
> 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

> 
> 
> Learn methods to troubleshoot general issues.

Last Published: Dec 29, 2025

Next Topic

QIR SDK overview