dungnn / edk2

EDK II

inspired by https://forum.proxmox.com/threads/igd-gvt-d-ovmf%EF%BC%88add-the-vbt-and-gop-drivers-to-the-ovmf-%E6%B7%BB%E5%8A%A0%E6%A0%B8%E6%98%BE%E9%A9%B1%E5%8A%A8%E5%88%B0ovmf%EF%BC%81%EF%BC%89.79858/, currently on edk2-stable202105, with GOP support from https://github.com/projectacrn/acrn-edk2, intel specific patches from https://projectacrn.github.io/latest/tutorials/gpu-passthru.html

https://wiki.archlinux.org/title/Intel_GVT-g#Using_DMA-BUF_with_UEFI/OVMF boot rom from there will still likely be required

Vbt.bin and IntelGopDriver.efi extraction instruction:

https://github.com/Kethen/edk2/blob/edk2-intel-gop/extract_vbt_gop.md

Build Instruction:

if podman is available this build script can be used https://github.com/Kethen/edk2-build-intel-gop

otherwise below are the steps

# requires GCC5, iasm, nasm, python, below attaches a docker file for reference
# clone this project
git clone https://github.com/Kethen/edk2
cd edk2

# pull submodules
git submodule update --init --recursive

# bootstrap(?) edk2 build environment
source edksetup.sh

# copy IntelGopDriver.efi and Vbt.bin extracted from your target host
cp <path> OvmfPkg/IntelGop/IntelGopDriver.efi
cp <path> OvmfPkg/Vbt/Vbt.bin

# Prepare base tools
make -C BaseTools

# Edit Conf/target.txt with these build target specs
# ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc
# TARGET_ARCH = X64
# TOOL_CHAIN_TAG = GCC5

# build
build -DFD_SIZE_2MB -DDEBUG_ON_SERIAL_PORT=TRUE

# built files can be found in Build/OvmfX64/DEBUG_GCC5/FV, or Build/OvmfX64/RELEASE_GCC5/FV for release builds

# debug messages can be viewed during boot with:
# qemu-kvm ... -bios OVMF.fd -serial stdio

# debug message can be disabled by building changing Conf/target.txt
# TARGET = RELEASE

Reference Docker File:

FROM ubuntu:18.04
RUN apt update; apt install -y gcc-5 g++-5 make nano git python uuid-dev nasm iasl
RUN ln -s /usr/bin/gcc-5 /usr/bin/gcc; ln -s /usr/bin/gcc-5 /usr/bin/cc; ln -s /usr/bin/g++-5 /usr/bin/g++; ln -s /usr/bin/gcc-ar-5 /usr/bin/gcc-ar

Reference Build Shell:

podman image build -t edk2-build -f edk2-build-docker-file
podman run \
  -it --rm \
  -v ./edk2:/workdir \
  -w /workdir \
  --entrypoint /bin/bash \
  edk2-build

Reference Boot Script:

PLATFORM="-enable-kvm -cpu host -m 2G -smp sockets=1,cores=2,threads=1 -M pc"

FIRMWARE="-drive if=pflash,format=raw,file=OVMF_CODE.fd,readonly=on"
FIRMWARE="$FIRMWARE -drive if=pflash,format=raw,file=OVMF_VARS.fd"

NETWORK="-netdev user,id=eth0"
NETWORK="$NETWORK -device virtio-net,netdev=eth0,mac=12:49:59:bc:16:12,bus=pci.0,addr=3"

PASS="-device vfio-pci,host=00:02.0,x-igd-gms=2,id=hostdev0,bus=pci.0,addr=2,x-igd-opregion=on,romfile=vbios_gvt_uefi.rom,driver=vfio-pci-nohotplug"

# update evdev as needed, or pass input device in your own way
INPUT="$INPUT -device virtio-input-host-pci,evdev=/dev/input/by-path/pci-0000:00:15.0-platform-i2c_designware.0-event-mouse,multifunction=on,bus=pci.0,addr=5.0"
INPUT="$INPUT -device virtio-input-host-pci,evdev=/dev/input/by-path/platform-i8042-serio-0-event-kbd,multifunction=on,bus=pci.0,addr=5.1"

MISC="-nodefaults -display none"
MISC="$MISC -vga none"
MISC="$MISC -serial stdio"

# for testing I usually run `boot.sh -cdrom <live cd path>`
qemu-kvm $PLATFORM $FIRMWARE $NETWORK $PASS $INPUT $MISC "$@"

EDK II Project

A modern, feature-rich, cross-platform firmware development environment for the UEFI and PI specifications from www.uefi.org.

Core CI Build Status

Host Type & Toolchain	Build Status	Test Status	Code Coverage
Windows_VS2019
Ubuntu_GCC5

More CI Build information

Platform CI Build Status

Microsoft Windows VS2019

Toolchain	CONFIG	DEBUG	RELEASE	NOOPT
EmulatorPkg_Win_VS2019	IA32
	X64
	IA32 FULL
	X64 FULL
OvmfPkg_Win_VS2019	IA32
	X64
	IA32 X64
	IA32 X64 FULL			_

Ubuntu 18.04 GCC5

Toolchain	CONFIG	DEBUG	RELEASE	NOOPT
ArmVirtPkg_Ubuntu_GCC5	AARCH64
	ARM
EmulatorPkg_Ubuntu_GCC5	IA32
	X64
	IA32 FULL
	X64 FULL
OvmfPkg_Ubuntu_GCC5	IA32
	X64
	IA32 X64
	IA32 X64 FULL

_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.

_ - EmulatorPkg Ubuntu GCC5 Segfaults during execution.

More ArmVirtPkg CI Build Information

More EmulatorPkg CI Build Information

More OvmfPkg CI Build Information

License Details

The majority of the content in the EDK II open source project uses a BSD-2-Clause Plus Patent License. The EDK II open source project contains the following components that are covered by additional licenses:

• BaseTools/Source/C/LzmaCompress
• BaseTools/Source/C/VfrCompile/Pccts
• CryptoPkgLibraryBaseCryptLibSysCallinet_pton.c
• CryptoPkgLibraryIncludecryptodso_conf.h
• CryptoPkgLibraryIncludeopensslopensslconf.h
• EmbeddedPkg/Library/FdtLib. (EDK II uses BSD License)
• EmbeddedPkg/Include/fdt.h. (EDK II uses BSD Licence)
• EmbeddedPkg/Include/libfdt.h. (EDK II uses BSD License)
• MdeModulePkg/Library/LzmaCustomDecompressLib
• OvmfPkg

The EDK II open source project uses content from upstream projects as git submodules that are covered by additional licenses.

• ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
• BaseTools/Source/C/BrotliCompress/brotli
• CryptoPkg/Library/OpensslLib/openssl
• MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
• MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
• UnitTestFrameworkPkg/Library/CmockaLib/cmocka
• RedfishPkg/Library/JsonLib/jansson

The EDK II Project is composed of packages. The maintainers for each package are listed in Maintainers.txt.

Resources

• TianoCore
• EDK II
• Getting Started with EDK II
• Mailing Lists
• TianoCore Bugzilla
• How To Contribute
• Release Planning

Code Contributions

To make a contribution to a TianoCore project, follow these steps.

1. Create a change description in the format specified below to

   use in the source control commit log.

2. Your commit message must include your Signed-off-by signature

3. Submit your code to the TianoCore project using the process

   that the project documents on its web page. If the process is not documented, then submit the code on development email list for the project.

4. It is preferred that contributions are submitted using the same

   copyright license as the base project. When that is not possible, then contributions using the following licenses can be accepted:

• BSD (2-clause): http://opensource.org/licenses/BSD-2-Clause
• BSD (3-clause): http://opensource.org/licenses/BSD-3-Clause
• MIT: http://opensource.org/licenses/MIT
• Python-2.0: http://opensource.org/licenses/Python-2.0
• Zlib: http://opensource.org/licenses/Zlib

For documentation:

• FreeBSD Documentation License

  https://www.freebsd.org/copyright/freebsd-doc-license.html

Contributions of code put into the public domain can also be accepted.

Contributions using other licenses might be accepted, but further review will be required.

Developer Certificate of Origin

Your change description should use the standard format for a commit message, and must include your Signed-off-by signature.

In order to keep track of who did what, all patches contributed must include a statement that to the best of the contributor's knowledge they have the right to contribute it under the specified license.

The test for this is as specified in the Developer's Certificate of Origin (DCO) 1.1. The contributor certifies compliance by adding a line saying

Signed-off-by: Developer Name [email protected]

where Developer Name is the contributor's real name, and the email address is one the developer is reachable through at the time of contributing.

Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I
    have the right to submit it under the open source license
    indicated in the file; or

(b) The contribution is based upon previous work that, to the best
    of my knowledge, is covered under an appropriate open source
    license and I have the right under that license to submit that
    work with modifications, whether created in whole or in part
    by me, under the same open source license (unless I am
    permitted to submit under a different license), as indicated
    in the file; or

(c) The contribution was provided directly to me by some other
    person who certified (a), (b) or (c) and I have not modified
    it.

(d) I understand and agree that this project and the contribution
    are public and that a record of the contribution (including all
    personal information I submit with it, including my sign-off) is
    maintained indefinitely and may be redistributed consistent with
    this project or the open source license(s) involved.

Sample Change Description / Commit Message

From: Contributor Name <[email protected]>
Subject: [Repository/Branch PATCH] Pkg-Module: Brief-single-line-summary

Full-commit-message

Signed-off-by: Contributor Name <[email protected]>

Notes for sample patch email

• The first line of commit message is taken from the email's subject line following [Repository/Branch PATCH]. The remaining portion of the commit message is the email's content.
• git format-patch is one way to create this format

Definitions for sample patch email

• Repository is the identifier of the repository the patch applies.

  This identifier should only be provided for repositories other than edk2. For example edk2-BuildSpecification or staging.

• Branch is the identifier of the branch the patch applies. This

  identifier should only be provided for branches other than

  edk2/master.

  For example edk2/UDK2015,

  edk2-BuildSpecification/release/1.27, or

  staging/edk2-test.

• Module is a short identifier for the affected code or documentation. For example MdePkg, MdeModulePkg/UsbBusDxe, Introduction, or EDK II INF File Format.
• Brief-single-line-summary is a short summary of the change.
• The entire first line should be less than ~70 characters.

• Full-commit-message a verbose multiple line comment describing

  the change. Each line should be less than ~70 characters.

• Signed-off-by is the contributor's signature identifying them

  by their real/legal name and their email address.

Submodules

Submodule in EDK II is allowed but submodule chain should be avoided as possible as we can. Currently EDK II contains the following submodules

• CryptoPkg/Library/OpensslLib/openssl
• ArmPkg/Library/ArmSoftFloatLib/berkeley-softfloat-3
• MdeModulePkg/Universal/RegularExpressionDxe/oniguruma
• MdeModulePkg/Library/BrotliCustomDecompressLib/brotli
• BaseTools/Source/C/BrotliCompress/brotli

ArmSoftFloatLib is actually required by OpensslLib. It's inevitable in openssl-1.1.1 (since stable201905) for floating point parameter conversion, but should be dropped once there's no such need in future release of openssl.

To get a full, buildable EDK II repository, use following steps of git command

git clone https://github.com/tianocore/edk2.git
cd edk2
git submodule update --init
cd ..

If there's update for submodules, use following git commands to get the latest submodules code.

cd edk2
git pull
git submodule update

Note: When cloning submodule repos, '--recursive' option is not recommended. EDK II itself will not use any code/feature from submodules in above submodules. So using '--recursive' adds a dependency on being able to reach servers we do not actually want any code from, as well as needlessly downloading code we will not use.