> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 入门指南

## **Qualcomm Dragonwing Industrial Edge Suite™**

**Dragonwing Industrial Edge Suite** 是一个整合的端到端工业软件包（套件），为实时工业运营提供计算丰富的平台，在 Qualcomm SoC / 平台上运行效果最佳。这是 Qualcomm 专属的工业品牌，结合了专为关键任务边缘部署打造的芯片、软件和服务。它面向工厂车间、仓库、无人机、运营商网络和工人安全应用——在这些场景中，端侧 AI、确定性计算和坚固可靠性都是不可或缺的。

> [!TIP]
>
> “面向实时工业运营的计算丰富平台”。

该平台无需依赖云端即可提供边缘智能：AI 推理、实时监控和运营决策均直接在 SoC 上运行。主要工业用例包括自主仓储机器人、基于无人机巡检的预测性维护、工人安全监控以及无感零售自动化。Dragonwing 以 Qualcomm 数十年的连接与计算专业积累、包含参考蓝图的完整开发者生态系统，以及旨在大规模简化工业复杂性的软硬件一体化技术栈为这些用例提供支撑。该硬件平台由 **Qualcomm Linux** 和 **Ubuntu** 提供支持。

***

## **Qualcomm Linux**

**Qualcomm Linux (QLI)** 是一个基于 Yocto Project LTS 构建、坚持上游优先并公开开发的 Linux 发行版。单一统一的 BSP 覆盖整个 Dragonwing SoC 系列——一次构建，跨设备部署。它开箱即提供虚拟化、OTA 更新和标准启动基础设施，Qualcomm 特定组件则以清晰的模块化叠加层形式添加。其发布模式达到生产级：每季度发布次要版本，约每 2 年发布主要版本，并提供长达 10 年的扩展维护——与工业产品生命周期相匹配。

***

## **Ubuntu**

**[Ubuntu on Qualcomm® IoT Platforms](https://www.qualcomm.com/developer/software/ubuntu-on-qualcomm-iot-platforms)** 是与 Canonical 联合开发、专为 Qualcomm 平台设计的 Ubuntu 专用版本。它将熟悉的 Ubuntu 开发者体验——`apt` 包管理、标准工具链和广泛的开源生态系统——直接带到 Qualcomm Dragonwing™ SoC 上，在不牺牲硬件级优化的前提下加快应用开发。

它面向工业物联网和边缘 AI 工作负载，为 Qualcomm 特有的硬件功能（包括 Hexagon DSP、摄像头子系统和连接协议栈）提供开箱即用的支持。对于已投入 Ubuntu 生态系统、希望以最小平台阻力在 Qualcomm 硬件上部署的团队而言，这是一个务实的选择。

> [!NOTE]
>
> IES 同时支持 **Qualcomm Linux (QLI)** 和 **Ubuntu** 作为基础平台。如需对 Yocto 构建栈进行最大程度的控制并获得长期工业维护保障，请选择 QLI；如需熟悉的基于 Debian 的开发者工作流程和广泛的生态系统兼容性，请选择 Ubuntu。

> [!NOTE]
>
> TODO：以模板形式提供不同发行版和选项，例如 Ubuntu Desktop、Ubuntu Server、Ubuntu Core 和 Red Hat。

***

## **为什么选择 Dragonwing Industrial Edge Suite？**

IES 提供的能力超越了 Dragonwing 平台和 Qualcomm Linux 的开箱即用功能：

| 差异化优势 | IES 提供的内容 |
| - | - |
| **低于 20 µs 的 RT 延迟，经硬件验证** | 经 Cyclictest 验证的 IQ9、IQ8 和 IQ6 PREEMPT\_RT 结果——真实数据 |
| **RT 与 KVM 同时运行** | 实时客户机与通用客户机在同一 SoC 上并发运行，RT 延迟不会下降 |
| **KAS 优先的可复现构建** | `kas shell` + `lock.yml` 锁定层的修订版本，实现确定性的工厂构建——这对工业认证流程至关重要 |
| **覆盖 IQ 系列，单一构建系统** | 在 IQ6 / IQ8 / IQ9 / IQ-X 上使用同一个 Yocto 栈、通用 RT 内核配方和一致的 KAS YAML 模式 |
| **10 年维护期** | QLI 的扩展支持模式与工业产品寿命保持一致——无需在产品现场使用期间迁移内核 |

***

## **Qualcomm Linux 入门**

**Qualcomm Linux (QLI)** 是 Qualcomm 为 [Qualcomm Dragonwing™](https://www.qualcomm.com/products/internet-of-things/industrial) SoC 打造的基于 Linux 的参考软件发行版。QLI 以 [Yocto Project](https://www.yoctoproject.org/) / OpenEmbedded 构建框架为基础，提供从引导加载程序到应用层的生产就绪、垂直集成的 Linux 技术栈——针对实时工业工作负载、边缘 AI 推理和确定性计算进行了优化。

**QLI 2.0** 是最新的主要版本，在 `qcom-linux-wrynose` Yocto 分支上跟踪 Linux 内核 **6.18.x**。它引入了一流的 KVM 虚拟机管理程序支持、上游 PREEMPT\_RT 实时内核集成，并通过 [QAIRT SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-64748-2/introduction.html) 扩展了 AI/ML 支持。

> [!NOTE]
>
> IES 以 **QLI 2.0** 作为其基础平台。本文档中的所有构建说明和工具链参考均假定使用 `qcom-linux-wrynose` 分支和 `qli.2.0-rc3.xml`（或更高版本）清单。

***

### **架构概览**

（编辑：更新图表。此图表应突出显示 IES 功能）

```
┌─────────────────────────────────────────────────────────────────┐
│                    Application Layer                            │
│        (ROS 2, Industrial Apps, Container Runtime)              │
├─────────────────────────────────────────────────────────────────┤
│               Middleware / SDK Layer                            │
│     (QAIRT SDK, FastCV, GStreamer, Audio Reach)                 │
├──────────────────────────┬──────────────────────────────────────┤
│   Real-Time Guest OS     │        General-Purpose OS            │
│  (PREEMPT_RT Linux 6.18) │  (Multimedia, Networking, UI)        │
├──────────────────────────┴──────────────────┬───────────────────┤
│    inux Kernel 6.18 + Qualcomm BSP Drivers  │     RT KVM        │
├──────────────┬───────────────────────┬──────┴───────────────────┤
│  Hexagon DSP │  Qualcomm Dragonwing™ │  Camera / Multimedia     │
│   (AI/ML)    │       SoC Fabric      │     Subsystem            │
└──────────────┴───────────────────────┴──────────────────────────┘
```

***

### **后续步骤**

> [card] [目标系统](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/target-systems.md)
>
> 查看受支持的 Qualcomm Dragonwing™ SoC 和硬件平台的完整列表

> [card] [构建软件](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/build-software.md)
>
> 针对每个受支持目标的分步构建说明

> [card] [实时 Linux 内核](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/real-time-linux-kernel.md)
>
> 配置、构建和调优 PREEMPT\_RT 内核，以获得确定性性能

> [card] [参考资料](https://dragonwingdocs-staging.qualcomm.com/zh/Suites/Industrial-Edge-Suite/references.md)
>
> Qualcomm Linux 官方文档和上游资源
