> ## 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 简介

<Columns cols={2}>
  <Card title="概述" icon="book" href="./qir-sdk-overview">
    概述 QIR SDK 提供的功能及其支持的 Qualcomm Dragonwing<sup>TM</sup> 硬件平台。
  </Card>

  <Card title="QIR SDK 软件架构" icon="boxes" href="./qir-software-architecture">
    以可视化方式展示 QIR SDK 的软件组件、功能和工具。
  </Card>
</Columns>

## QIR SDK 快速入门

通过[快速入门](./get-started-with-qir-sdk)，您可以试用 QIR SDK 的预构建镜像。

<Columns cols={2}>
  <Card title="下载预构建软件包" icon="download" href="./download-the-prebuilt-packages">
    下载机器人预构建软件包。
  </Card>

  <Card title="刷写机器人镜像" icon="hard-drive" href="./flash-the-robotics-image">
    刷写机器人镜像，使开发套件准备好运行示例应用程序。
  </Card>

  <Card title="设置示例应用程序的环境" icon="wrench" href="./set-up-env-for-sample-app">
    完成必要的设置，确保示例应用程序可以在开发套件上运行。
  </Card>

  <Card title="运行演示应用程序" icon="play-circle" href="./run-demo-application">
    运行演示应用程序以验证 QIR SDK 安装。
  </Card>
</Columns>

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

在支持的开发套件上运行示例应用程序。有关详细信息，请参阅 [QIR SDK 示例应用程序](./qir-sdk-sample-applications)。

<Columns cols={3}>
  <Card title="运行机器人示例应用程序" icon="robot" href="./run-robotics-sample-applications">
    运行机器人示例应用程序，例如自主移动机器人 (AMR) 2D 激光雷达 SLAM。
  </Card>

  <Card title="运行平台示例应用程序" icon="terminal" href="./run-platform-sample-applications">
    运行平台示例应用程序，例如获取系统监控信息。
  </Card>
</Columns>

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

<Columns cols={2}>
  <Card title="了解文件结构" icon="folder-tree" href="./develop-applications-using-the-qir-sdk#qir-sdk-file-structure">
    了解 QIR SDK 中包含的文件结构和工具链。
  </Card>

  <Card title="QIR SDK API 列表" icon="clipboard-list" href="./explore-the-available-apis">
    查看 QIR SDK 提供的所有 API。
  </Card>

  <Card title="开发示例 ROS2 应用程序" icon="file-code" href="./develop-a-sample-ros-2-application">
    使用 QIR SDK 开发 ROS 2 示例应用程序。
  </Card>
</Columns>

## 构建和自定义

仅当您需要自定义 QIR SDK 时，以下工作流才是可选执行的。在构建 QIR SDK 或升级构件之前，请确保您已理解相关流程。

<Columns cols={1}>
  <Card title="构建 QIR SDK" icon="hammer" href="./build-the-qir-sdk">
    仅在确有需要时才构建 QIR SDK，可使用以下工作流：

    * [GitHub 工作流](./build-with-git-hub-workflow)
    * [Robotics eSDK](./build-the-robotics-image-with-the-prebuilt-robotics-esdk)
  </Card>

  <Card title="升级 QIR SDK 构件" icon="refresh" href="./upgrade-qir-sdk-artifact">
    在不重新构建整个 QIR SDK 的情况下升级 QIR SDK 构件。
  </Card>

  <Card title="故障排除" icon="shield" href="./troubleshoot">
    了解排查常见问题的方法。
  </Card>
</Columns>

## 从 Qualcomm Linux 1.0 迁移到 2.0

<Columns cols={2}>
  <Card title="迁移概述" icon="clipboard-list" href="./migration-overview">
    总结 QIR SDK 中的关键变更，包括层整合和镜像组成更新。
  </Card>

  <Card title="Robotics OpenEmbedded 层变更" icon="file-text" href="./migration-robotics-oe-layer-changes">
    介绍在 Qualcomm Linux 2.0 中将多个机器人层整合为单个层的情况。
  </Card>

  <Card title="Robotics 镜像组成变更" icon="folders" href="./migration-image-composition">
    介绍从 `base`/`custom` 构建变体模型到独立镜像配方的转变。
  </Card>
</Columns>