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

# RT with KVM

## **RT with KVM**

Dragonwing Industrial Edge Suite supports the upstream KVM hypervisor on QLI 2.0, enabling concurrent execution of a real-time guest OS and a general-purpose guest OS on the same Qualcomm Dragonwing™ SoC — with no RT latency degradation.

***

### Key Points

* **KVM is the default hypervisor for QLI 2.0**, selected via the `qcom-distro-kvm.yml` KAS overlay
* **PREEMPT\_RT + KVM simultaneously** — RT guest and general-purpose guest run concurrently on the same SoC
* **CPU partitioning** — RT-isolated CPUs (e.g., 2–7) are dedicated to the RT guest; housekeeping CPUs (0–1) handle the hypervisor, emulator, and non-RT guest
* **SR-IOV support** — Intel X550 NIC virtual functions can be passed through directly to the RT guest via `<hostdev>` and `virtio-iommu-pci`
* **Managed by Libvirt/Virsh** — standard domain XML files define and drive guest VM lifecycle

***

### Architecture

```
┌─────────────────────────────────────────────────────────────────┐
│                      Application Layer                          │
├──────────────────────────────┬──────────────────────────────────┤
│   Real-Time Guest OS         │    General-Purpose Guest OS      │
│   (PREEMPT_RT 6.18)          │    (Multimedia / Networking)     │
│   vCPUs pinned to CPU 2–7    │    vCPUs pinned to CPU 0–1       │
│   SCHED_FIFO, SR-IOV VFs     │    CFS scheduler                 │
├──────────────────────────────┴──────────────────────────────────┤
│              KVM Hypervisor + QEMU (QLI 2.0)                    │
│              Emulator thread pinned to CPU 0                    │
├─────────────────────────────────────────────────────────────────┤
│          Linux Kernel 6.18 + Qualcomm BSP Drivers               │
│          isolcpus=2-7  irqaffinity=0-1  nohz_full=2-7           │
└─────────────────────────────────────────────────────────────────┘
```

***

### Subpages

> [card] [Build](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-build.md)
>
> KAS build commands, image recipes, and runtime verification

> [card] [RT Configuration](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-rt-config.md)
>
> Kernel boot parameters and Yocto RT tuning variables

> [card] [NIC & SR-IOV](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-nic-sriov.md)
>
> Intel X550 NIC, SR-IOV VF passthrough, and IOMMU-map setup

> [card] [VM Management](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-vm-management.md)
>
> Virsh setup, known issues, and sample RT/HK domain XML files

***

### RT Benchmarks under KVM

> [card] [RT Benchmarks IQ9 (KVM)](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/kvm-rt-benchmarks-iq9.md)
>
> Cyclictest results for the Dragonwing IQ-9075 running the RT kernel under KVM
