Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduction

Welcome to the Patina QEMU Platforms book. This book documents the two virtual platforms maintained in the patina-qemu repository and the workflows used to build, debug, and validate them.

The primary purpose of patina-qemu is to serve as a test vehicle for the Patina project. It can also be used as a reference for a simple integration of Patina with EDK II components. The repository contains a permanent fork of OvmfPkg from EDK II adapted for Patina.

Platforms:

  • QEMU Q35 - an x86_64 platform based on the Q35 chipset.
  • QEMU SBSA - an AArch64 platform based on the Arm Server Base System Architecture.

What is in this book

This book is organized into the following sections:

  1. Building and Running - Setting up your environment, compiling the firmware, running it in QEMU, and the rapid Patina iteration workflow used by most Patina developers.
  2. Debugging - Connecting WinDbg to UEFI firmware running in QEMU and to a Windows guest OS booted on top of it.
  3. Testing - Scheduled regression tests run against the default branch.
  4. Performance - Collecting and interpreting boot performance data, and the size of the Patina DXE Core release binary.