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