README

   1 Plex86/Bochs VGABios
   2 --------------------
   3
   4 The goal of this project is to have a LGPL'd Video Bios in plex86
   5 and bochs.
   6 This VGA Bios is very specific to the emulated VGA card.
   7 It is NOT meant to drive a physical vga card.
   8
   9
  10 Install
  11 -------
  12 To compile the VGA Bios you will need :
  13 - gcc
  14 - bcc
  15 - as86
  16 - ld86
  17
  18 Untar the archive, and type make. You should get a "vgabios.bin" file.
  19 Alternatively, you can use the binary file "vgabios-XXX.bin", i have
  20 compiled for you.
  21
  22 Edit your plex86/bochs conf file, and modify the load-rom command in the
  23 VGA BIOS section, to point to the new vgabios.bin file.
  24
  25
  26 Debugging
  27 ---------
  28 You can get a very basic debugging system: messages printed by the vgabios.
  29 You have to register the "unmapped" device driver in plex86 or bochs, and make
  30 sure it grabs port 0xfff0.
  31
  32 Comment the #undef DEBUG at the beginning of vgabios.c.
  33 You can then use the "printf" function in the bios.
  34
  35
  36 Testing
  37 -------
  38 Look at the "testvga.c" file in the archive. This is a minimal Turbo C 2.0
  39 source file that calls a few int10 functions. Feel free to modify it to suit
  40 your needs.
  41 The VGA Bios in its current version has been very little tested.
  42
  43
  44 Copyright and License
  45 ---------------------
  46 This program has been written by Christophe Bothamy
  47 It is protected by the GNU Lesser Public License, which you should
  48 have received a copy of along with this package.
  49
  50
  51 Reverse Engineering
  52 -------------------
  53 The VGA Bios has been written without reverse-engineering any existing Bios.
  54
  55
  56 Acknowledgment
  57 --------------
  58 The source code contains code ripped from rombios.c of plex86, written
  59 by Kevin Lawton <kevin2001@yahoo.com>
  60
  61 The source code contains fonts from fntcol16.zip (c) by Joseph Gil avalable at :
  62 ftp://ftp.simtel.net/pub/simtelnet/msdos/screen/fntcol16.zip
  63 These fonts are public domain
  64
  65 The source code is based on information taken from :
  66 - Kevin Lawton's vga card emulation for bochs/plex86
  67 - Ralf Brown's interrupts list avalaible at
  68   http://www.cs.cmu.edu/afs/cs/user/ralf/pub/WWW/files.html
  69 - Finn Thogersons' VGADOC4b available at http://home.worldonline.dk/~finth/
  70 - Michael Abrash's Graphics Programming Black Book
  71 - Francois Gervais' book "programmation des cartes graphiques cga-ega-vga"
  72   edited by sybex
  73 - DOSEMU 1.0.1 source code for several tables values and formulas
  74
  75
  76 Feedback
  77 --------
  78 Please report any bugs, comments, patches for this VGA Bios to cbothamy@free.fr
  79
  80 You can find the latest release at : http://cbothamy.free.fr/projects/vgabios/
  81
  82 For any information on plex86, visit the website http://www.plex86.org/
  83 For any information on bochs, visit the website http://bochs.sourceforge.net/