qemu/roms/seabios/docs/SeaVGABIOS.md

   1 SeaVGABIOS is a sub-project of the SeaBIOS project - it is an open
   2 source implementation of a 16bit X86
   3 [VGA BIOS](http://en.wikipedia.org/wiki/Video_BIOS). SeaVGABIOS is the
   4 default VGA BIOS on [QEMU](http://www.qemu.org/). SeaVGABIOS can also
   5 run natively on some X86 VGA hardware with
   6 [coreboot](http://www.coreboot.org/).
   7
   8 Building SeaVGABIOS
   9 ===================
  10
  11 To build SeaVGABIOS, obtain the [code](Download), run `make
  12 menuconfig` and select the type of VGA BIOS to build in the "VGA ROM"
  13 menu. Once selected, run `make` and the final VGA BIOS binary will be
  14 located in "out/vgabios.bin".
  15
  16 The choice of available VGA BIOSes within "make menuconfig" is
  17 dependent on whether CONFIG_QEMU, CONFIG_COREBOOT, or CONFIG_CSM is
  18 selected. Also, the debug options under the "Debugging" menu apply to
  19 SeaVGABIOS. All other options found in "make menuconfig" apply only to
  20 SeaBIOS and will not impact the SeaVGABIOS build.
  21
  22 If SeaVGABIOS is needed for multiple different devices (eg, QEMU's
  23 cirrus emulation and QEMU's "dispi" emulation), then one must compile
  24 SeaVGABIOS multiple times with the appropriate config for each build.
  25
  26 SeaVGABIOS code
  27 ===============
  28
  29 The source code for SeaVGABIOS is located in the SeaBIOS
  30 [git repository](Download). The main VGA BIOS code is located in the
  31 "vgasrc/" directory. The VGA BIOS code is always compiled in 16bit
  32 mode.
  33
  34 The SeaVGABIOS builds to a separate binary from the main SeaBIOS
  35 binary, and much of the VGA BIOS code is separate from the main BIOS
  36 code. However, much of the SeaBIOS
  37 [developer documentation](Developer_Documentation) applies to
  38 SeaVGABIOS. To contribute, please join the
  39 [SeaBIOS mailing list](Mailinglist).