Patina Development Vehicle

The primary purpose of this repository 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. It contains a permanent fork of OvmfPkg from EDK II adapted for Patina.

Documentation

All patina-qemu platform documentation is maintained in the docs/ mdBook. Start with the Introduction. The two supported platforms have their own documentation pages:

• QEMU Q35
• QEMU ARM Virt

Other common topics:

• Building the Firmware
• Rapid Patina Iteration
• WinDbg + QEMU + Patina UEFI Debugging Guide
• WinDbg + QEMU + Windows OS Debugging Guide

The book is built with mdBook.

Building the Book Locally

The pinned versions of mdBook and its preprocessors are defined in the [tools] section of rust-toolchain.toml. CI installs the same versions from this file.

To install them locally, install Rust and then run cargo install --locked <name>@<version> for each entry under [tools]. For example:

cargo install --locked mdbook@<version>

Substitute cargo binstall for cargo install if you have it for faster installs from prebuilt binaries.

Then serve the book from the docs/ directory:

cd docs
mdbook serve --open

Related Links

• Open Device Partnership (ODP)
• Patina project documentation
• Patina GitHub organization
• Patina GitHub repository
• Patina DXE Core QEMU
  • The Patina DXE Core .efi binary used by this repository