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