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

# Get Started Guide

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

**Dragonwing Industrial Edge Suite** is a consolidated end to end Industrial software package (suite) that provides a compute rich platform for real time industrial operations - runs best on Qualcomm SoC / Platform. This is Qualcomm's dedicated industrial brand, combining silicon, software, and services purpose-built for mission-critical edge deployments. It targets factory floors, warehouses, drones, carrier networks, and worker-safety applications — scenarios where on-device AI, deterministic compute, and rugged reliability are non-negotiable.

> [!TIP]
>
> “The compute rich platform for real time industrial operations”.

The platform delivers edge intelligence without cloud dependency: AI inferencing, real-time monitoring, and operational decision-making run directly on the SoC. Key industrial use cases include autonomous warehouse robotics, predictive maintenance via drone inspection, worker safety monitoring, and frictionless retail automation. Dragonwing backs these with decades of Qualcomm connectivity and compute expertise, a full developer ecosystem of reference blueprints, and a hardware-to-software stack designed to simplify industrial complexity at scale. The hardware platform is enabled by **Qualcomm Linux** and **Ubuntu**.

***

## **Qualcomm Linux**

**Qualcomm Linux (QLI)** is an upstream-first, publicly developed Linux distribution built on Yocto Project LTS. A single unified BSP spans the full Dragonwing SoC family — build once, deploy across devices. It ships with virtualization, OTA updates, and standard boot infrastructure out of the box, with Qualcomm-specific components added as clean, modular overlays. The release model is production-grade: quarterly minor releases, major releases every \~2 years, and up to 10 years of extended maintenance — matching industrial product lifecycles.

***

## **Ubuntu**

**[Ubuntu on Qualcomm® IoT Platforms](https://www.qualcomm.com/developer/software/ubuntu-on-qualcomm-iot-platforms)** is a specialized version of Ubuntu, co-developed with Canonical, designed specifically for Qualcomm platforms. It brings the familiar Ubuntu developer experience — `apt` package management, standard toolchains, and a broad open-source ecosystem — directly to Qualcomm Dragonwing™ SoCs, enabling faster application development without sacrificing hardware-level optimization.

Targeting industrial IoT and edge AI workloads, it provides out-of-the-box support for Qualcomm-specific hardware features including the Hexagon DSP, camera subsystems, and connectivity stacks. This makes it a practical choice for teams already invested in the Ubuntu ecosystem who want to deploy on Qualcomm hardware with minimal platform friction.

> [!NOTE]
>
> IES supports both **Qualcomm Linux (QLI)** and **Ubuntu** as base platforms. Choose QLI for maximum control over the Yocto build stack and long-term industrial maintenance guarantees; choose Ubuntu for a familiar Debian-based developer workflow and broad ecosystem compatibility.

> [!NOTE]
>
> TODO:Provision as a template for different distros and options - like Ubuntu Desktop, Ubuntu server - Ubuntu Core and Red Hat.

***

## **Why Dragonwing Industrial Edge Suite?**

IES goes beyond what the Dragonwing platform and Qualcomm Linux provide out of the box:

| Differentiator | What IES Delivers |
| - | - |
| **Sub-20 µs RT latency, proven on hardware** | Cyclictest-validated PREEMPT\_RT results for IQ9, IQ8, and IQ6 — real numbers |
| **RT + KVM simultaneously** | Real-time guest and general-purpose guest running concurrently on the same SoC, with no RT latency degradation |
| **KAS-first reproducible builds** | `kas shell` + `lock.yml` pins layer revisions for deterministic factory builds — essential for industrial qualification pipelines |
| **IQ-family coverage, single build system** | One Yocto stack, common RT kernel recipe, consistent KAS YAML pattern across IQ6 / IQ8 / IQ9 / IQ-X |
| **10-year maintenance window** | QLI's extended support model aligns with industrial product lifespans — no kernel migration mid-field-life |

***

## **Getting Started with Qualcomm Linux**

**Qualcomm Linux (QLI)** is Qualcomm's reference Linux-based software distribution built for [Qualcomm Dragonwing™](https://www.qualcomm.com/products/internet-of-things/industrial) SoCs. Grounded in the [Yocto Project](https://www.yoctoproject.org/) / OpenEmbedded build framework, QLI delivers a production-ready, vertically integrated Linux stack spanning from the bootloader through the application layer — optimized for real-time industrial workloads, edge AI inference, and deterministic computing.

**QLI 2.0** is the latest major release, tracking Linux kernel **6.18.x** on the `qcom-linux-wrynose` Yocto branch. It introduces first-class KVM hypervisor support, upstream PREEMPT\_RT real-time kernel integration, and expanded AI/ML enablement via the [QAIRT SDK](https://docs.qualcomm.com/bundle/publicresource/topics/80-64748-2/introduction.html).

> [!NOTE]
>
> IES targets **QLI 2.0** as its base platform. All build instructions and toolchain references in this documentation assume the `qcom-linux-wrynose` branch and the `qli.2.0-rc3.xml` (or later) manifest.

***

### **Architecture Overview**

(Edit: Update diagram. This Diagram should highlight the IES features)

```
┌─────────────────────────────────────────────────────────────────┐
│                    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            │
└──────────────┴───────────────────────┴──────────────────────────┘
```

***

### **Next Steps**

> [card] [Target Systems](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/target-systems.md)
>
> View the full list of supported Qualcomm Dragonwing™ SoCs and hardware platforms

> [card] [Build Software](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/build-software.md)
>
> Step-by-step build instructions for each supported target

> [card] [Real-Time Linux Kernel](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/real-time-linux-kernel.md)
>
> Configure, build, and tune the PREEMPT\_RT kernel for deterministic performance

> [card] [References](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/references.md)
>
> Official Qualcomm Linux documentation and upstream resources
