/HelloIommuPkg

The sample DXE runtime driver demonstrating how to program DMA remapping.

Primary LanguageCMIT LicenseMIT

HelloIommuPkg

HelloIommuPkg is a sample DXE runtime driver demonstrating how to program DMA remapping, one of the Intel VT-d features, to protect the system from DMA access.

This project is meant to show a simplified yet functioning code example for learning purposes and not designed for actual use in production systems.

For more information about this project see my blog post: Introductory Study of IOMMU (VT-d) and Kernel DMA Protection on Intel Processors

Building

  1. Set up edk2 build environment
    • bb18fb80abb9d35d01be5d693086a9ed4b9d65b5 is the latest revision that confirmed to compile this project successfully .
  2. Copy HelloIommuPkg as edk2\HelloIommuPkg
  3. On the edk2 build command prompt, run the below command: 
    > edksetup.bat
> build -t VS2019 -a X64 -b NOOPT -p HelloIommuPkg\HelloIommuPkg.dsc
or
> build -t CLANGPDB -a X64 -b NOOPT -p HelloIommuPkg\HelloIommuPkg.dsc
    Or on WSL or Linux, 
    $ . edksetup.sh
$ build -t GCC5 -a X64 -b NOOPT -p HelloIommuPkg/HelloIommuPkg.dsc

Also, pre-compiled binary files are available at the Release page.