Step-by-step instructions to run a Yocto-based Linux guest on a QNX SDP 8 Hypervisor on a Raspberry Pi 5.
- QNX SDP Version 8 shall be used
- The QNX Everywhere license shall be used
- The Hypervisor shall run on a Raspberry Pi 5
- The Linux guest shall be Yocto based
- Instructions shall explain every step required
- Instructions shall contain links to required artifacts
| Component | Version / Details |
|---|---|
| QNX SDP | 8.0 |
| QNX Hypervisor | 2.2 |
| Raspberry Pi 5 BSP | SDP 8.0 BSP for RPi5 |
| Yocto release | Scarthgap (5.0 LTS) |
| Linux kernel (guest) | 6.6 LTS (as built by Yocto scarthgap) |
| Host build machine OS | Ubuntu 22.04 LTS (x86-64) |
| Raspberry Pi firmware | Latest stable (raspi-firmware) |
| SD card | ≥ 16 GB, Class 10 / A1 or faster |
This repository ships a dev container based on Ubuntu 22.04 LTS. It automatically installs every Yocto build prerequisite, ShellCheck, and markdownlint-cli2 so you can start building the guest image without any manual setup on your local machine.
Open in GitHub Codespaces (no local install required):
Open in VS Code Dev Containers (Docker must be running locally):
- Install the Dev Containers extension.
- Open the repository folder in VS Code.
- When prompted, click Reopen in Container (or run Dev Containers: Reopen in Container from the command palette).
Note: The dev container handles Step 1 (Host Prerequisites) automatically. QNX SDP 8 and the Hypervisor package are proprietary and must still be installed manually (Step 2 and Step 4).
- Host Prerequisites
- Install QNX SDP 8
- Activate the QNX Everywhere License
- Install the QNX Hypervisor
- Prepare the Raspberry Pi 5
- Build the Yocto Linux Guest Image
- Configure the QNX Guest VM
- Boot and Verify
- Architecture Overview
- Boot Flow
- Troubleshooting
- Contributing
configs/guest.qvmconf– annotated VM configuration templatescripts/build_yocto.sh– automated Yocto build script.devcontainer/– dev container configuration