Merge remote-tracking branch 'remotes/rth/tags/pull-tcg-20210921' into staging
[qemu.git] / pc-bios / README
1 - SeaBIOS (bios.bin) is the successor of pc bios.
2   See http://www.seabios.org/ for more information.
3
4 - The VGA BIOS and the Cirrus VGA BIOS come from the LGPL VGA bios
5   project (http://www.nongnu.org/vgabios/).
6
7 - OpenBIOS (http://www.openbios.org/) is a free (GPL v2) portable
8   firmware implementation. The goal is to implement a 100% IEEE
9   1275-1994 (referred to as Open Firmware) compliant firmware.
10   The included images for PowerPC (for 32 and 64 bit PPC CPUs),
11   Sparc32 (including QEMU,tcx.bin and QEMU,cgthree.bin) and Sparc64 are built
12   from OpenBIOS SVN revision 1280.
13
14 - SLOF (Slimline Open Firmware) is a free IEEE 1275 Open Firmware
15   implementation for certain IBM POWER hardware.  The sources are at
16   https://github.com/aik/SLOF, and the image currently in qemu is
17   built from git tag qemu-slof-20210711.
18
19 - VOF (Virtual Open Firmware) is a minimalistic firmware to work with
20   -machine pseries,x-vof=on. When enabled, the firmware acts as a slim shim and
21   QEMU implements parts of the IEEE 1275 Open Firmware interface.
22
23 - sgabios (the Serial Graphics Adapter option ROM) provides a means for
24   legacy x86 software to communicate with an attached serial console as
25   if a video card were attached.  The master sources reside in a subversion
26   repository at http://sgabios.googlecode.com/svn/trunk.  A git mirror is
27   available at https://gitlab.com/qemu-project/sgabios.git.
28
29 - The PXE roms come from the iPXE project. Built with BANNER_TIME 0.
30   Sources available at http://ipxe.org.  Vendor:Device ID -> ROM mapping:
31
32         8086:100e -> pxe-e1000.rom
33         8086:1209 -> pxe-eepro100.rom
34         1050:0940 -> pxe-ne2k_pci.rom
35         1022:2000 -> pxe-pcnet.rom
36         10ec:8139 -> pxe-rtl8139.rom
37         1af4:1000 -> pxe-virtio.rom
38
39 - The sources for the Alpha palcode image is available from:
40   https://github.com/rth7680/qemu-palcode.git
41
42 - The u-boot binary for e500 comes from the upstream denx u-boot project where
43   it was compiled using the qemu-ppce500 target.
44   A git mirror is available at: https://gitlab.com/qemu-project/u-boot.git
45   The hash used to compile the current version is: 2072e72
46
47 - Skiboot (https://github.com/open-power/skiboot/) is an OPAL
48   (OpenPower Abstraction Layer) firmware for OpenPOWER systems. It can
49   run an hypervisor OS or simply a host OS on the "baremetal"
50   platform, also known as the PowerNV (Non-Virtualized) platform.
51
52 - QemuMacDrivers (https://github.com/ozbenh/QemuMacDrivers) is a project to
53   provide virtualised drivers for PPC MacOS guests.
54
55 - The "edk2-*.fd.bz2" images are platform firmware binaries and matching UEFI
56   variable store templates built from the TianoCore community's EFI Development
57   Kit II project
58   <https://github.com/tianocore/tianocore.github.io/wiki/EDK-II>. The images
59   were built at git tag "edk2-stable202008". The firmware binaries bundle parts
60   of the OpenSSL project, at git tag "OpenSSL_1_1_1g" (the OpenSSL tag is a
61   function of the edk2 tag). Parts of the Berkeley SoftFloat library are
62   bundled as well, at Release 3e plus a subsequent typo fix (commit
63   b64af41c3276f97f0e181920400ee056b9c88037), as an OpenSSL dependency on 32-bit
64   ARM. Licensing information is given in "edk2-licenses.txt". The image files
65   are described by the JSON documents in the "pc-bios/descriptors" directory,
66   which conform to the "docs/interop/firmware.json" schema.
67
68 - OpenSBI (https://github.com/riscv/opensbi) aims to provide an open-source
69   reference implementation of the RISC-V Supervisor Binary Interface (SBI)
70   specifications for platform-specific firmwares executing in M-mode. For all
71   supported platforms, OpenSBI provides several runtime firmware examples.
72   These example firmwares can be used to replace the legacy riscv-pk bootloader
73   and enable the use of well-known bootloaders such as U-Boot.
74   OpenSBI is distributed under the terms of the BSD 2-clause license
75   ("Simplified BSD License" or "FreeBSD License", SPDX: BSD-2-Clause). OpenSBI
76   source code also contains code reused from other projects desribed here:
77   https://github.com/riscv/opensbi/blob/master/ThirdPartyNotices.md.
78
79 - npcm7xx_bootrom.bin is a simplified, free (Apache 2.0) boot ROM for Nuvoton
80   NPCM7xx BMC devices. It currently implements the bare minimum to load, parse,
81   initialize and run boot images stored in SPI flash, but may grow more
82   features over time as needed. The source code is available at:
83   https://github.com/google/vbootrom