home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Emulatoren / r!d-vgbe.lha / VGB-Amiga / VGB.doc next >
Encoding:
Text File  |  1995-10-10  |  8.1 KB  |  211 lines
  1.  
  2.  
  3.                    ******* Virtual GameBoy *******
  4.                 The Portable Nintendo GameBoy Emulator
  5.                              version 0.2
  6.  
  7.                          by Marat Fayzullin
  8.                       
  9.                        email: fms@wam.umd.edu
  10.                             IRC:  RST38h
  11.                WWW:  http://www.cs.umd.edu/users/fms/
  12.  
  13.                              Amiga version by
  14.                       Matthias Bethke & Michael Boese
  15.                    http://wwwstud.uni-giessen.de/~s1089/
  16.  
  17. ******* original documentation for the X11 version *******
  18.  
  19.  
  20. * INTRODUCTION *
  21.  
  22.   This package includes C sources for a portable GameBoy emulator,
  23. and screen/joystick drivers for Unix/X. Virtual GameBoy has been
  24. tested on following Unix systems:
  25.  
  26.   SunOS   Solaris   OSF/1   FreeBSD   HP/UX   AIX 3.2.5
  27.  
  28.   Note that this is only a second release of VGB and many things
  29. do not quite work yet. They will be fixed/implemented in the next
  30. releases of the emulator. Following games were checked and worked
  31. with this version of VGB: 
  32.  
  33.   Minesweeper   Hong Kong              Tennis
  34.   Bombliss      Addams Family 2        Tetris
  35.   Asteroids     Donkey Kong Land       Obelix
  36.   Centipede     Monster Truck Wars
  37.   Motocross     Missile Command
  38.   Twinbee       Riddick Bowe Boxing
  39.   Kwirk         Kirby's Dream Land 2
  40.   Alien 3       Rescue of Blobette
  41.  
  42. Following games didn't work: 
  43.  
  44.   Super Racing Pro Am  - Hangs
  45.   Kung-Fu Master       - Dies after encountering STOP instruction
  46.                          meaning of which is not known yet
  47.  
  48.   If you would like to write new drivers, *please*, contact me by
  49. email or some other means. Feel free to look at existing drivers
  50. as well as at other code. More explanations follow.
  51.  
  52.  
  53.  
  54. * NEW IN THIS VERSION *
  55.  
  56. o Cartridges with battery-backed RAM are now recognized and the RAM is 
  57.   saved into files with .SAV extension. 
  58. o Colors can now be set from command line. 
  59. o A GameGenie-compatible cheat option is implemented but doesn't work
  60.   yet. 
  61. o Screen refresh routines are fixed. 
  62. o Line interrupts work correctly now. 
  63. o Default stack is moved to F000h. 
  64. o When LCD controller is stopped, VBlank and LCD special interrupts 
  65.   are not generated. 
  66. o Both Debug() function and disassembler are majorly cleaned up. 
  67.  
  68.  
  69.  
  70. * FREQUENTLY ASKED QUESTIONS *
  71.  
  72. 1. What is GameBoy?
  73.   GameBoy is a handheld videogame machine produced by Nintendo. It is 
  74. built around a custom CPU similar to Z80, but with some changes. GameBoy 
  75. is frequently laughed at because of its reflective green-on-yellow LCD 
  76. screen which in fact is its virtue. Due to the low power consumption of 
  77. its LCD, GameBoy can work for 35 hours off 4 AA batteries. There is a lot 
  78. of good games produced for GameBoy, both classics [Tetris, Pacman, 
  79. Asteroids, etc.] and specific ones [Final Fantasy series for GB]. It 
  80. excells in RPGs and classic games where gameplay is more important than 
  81. graphics. More information about GameBoy is available from
  82.  
  83.                 http://www.cs.umd.edu/users/fms/GameBoy/
  84.  
  85. 2. Where do I get GameBoy games?
  86.   You buy the cartridges. GameBoy software is copyrighted and still sold. 
  87. Therefore, its distribution is an act of piracy. Nothing prohibits you 
  88. from backing up a cartridge you own and playing it on the emulator though.
  89.  
  90. 3. Why is VGB is so slow on my PC?
  91.   Because your PC is too slow to run VGB. VGB is written entirely in C 
  92. language and therefore is quite slow. Although it works on 486/33 and even 
  93. 386/33 PCs, it runs best on a Pentium/90 or a DEC Alpha/150. You can try to 
  94. speed it up by increasing -uperiod value controlling the number of 
  95. vertical blanking impulses between screen updates to 3-6, and by decreasing 
  96. -vperiod value controlling the number of CPU cycles between vertical 
  97. blanking impulses to 2000-5000. Please, DO NOT SEND ME MAIL about VGB speed. 
  98.  
  99. 4. Can I compile VGB with my Borland/Turbo C compiler?
  100.   You can, given that your compiler creates executables using flat 32bit 
  101. memory model. Two PC compilers which do that are WATCOM [using DOS4GW DOS 
  102. extender] and GCC [using DJPP extender]. No Borland/Turbo C compiler that 
  103. I'm aware of can create such executables though.
  104.  
  105. 5. Where is the complete list of command line options of VGB?
  106.   Use -help option. It will tell VGB to display all options available in 
  107. your version. Following are the options available in VGB 0.2:
  108.  
  109.   -verbose <level>    - Select debugging messages [5]
  110.                         0 - Silent           1 - Startup messages
  111.                         2 - Illegal writes   4 - Illegal CPU ops
  112.                         8 - Bank switching
  113.   -vperiod <period>   - Set VBlank interrupts period [10000ops]
  114.   -uperiod <period>   - Number of interrupts per screen update [2]
  115.   -help               - Print this help page
  116.   -cheat <GG code>    - Activate a GameGenie cheat [not supported yet]
  117.   -shm/-noshm         - Use/don't use MIT SHM extensions for X [-shm]
  118.   -trap <address>     - Trap execution when PC reaches address [FFFFh]
  119.   -saver/-nosaver     - Save/don't save CPU when inactive [-saver]
  120.   -color0 <name>      - Change color#0 [black]
  121.   -color1 <name>      - Change color#1 [#585858]
  122.   -color2 <name>      - Change color#2 [#989898]
  123.   -color3 <name>      - Change color#3 [white]
  124.  
  125. 6. What are the keys used in VGB?
  126.   VGB Unix/X 0.2 keys:
  127.  
  128.   [SPACE] - A button
  129.   [LALT]  - B button
  130.   [TAB]   - SELECT button
  131.   [ENTER] - START button
  132.   [ESC]   - Quit emulation
  133.   [F1]    - Turn tracing on/off
  134.   [F2]    - Show LCD controller registers
  135.  
  136. 7. I can't get some games to work with VGB.
  137.   Try increasing -vperiod value to 10000. If you can't get game to work, 
  138. send it to me for analysis.
  139.  
  140. 8. Is it legal to spread GameBoy cartridge snapshots?
  141.   NO. Be aware of the fact that by using commercial software you haven't 
  142. bought, you are commencing an act of piracy. Not that I care, anyway...
  143.  
  144. 9. When compiling VGB under Unix, I get "undefined name" errors.
  145.   This means that your linker can not find the libraries necessary
  146. for VGB [namely, libX11.a and libXext.a]. Find these libraries in
  147. your system and modify the Makefile so that the final invocation
  148. of the C compiler has "-L<path_to_libs>" options. If the errors
  149. persist, try #undefining MITSHM option.
  150.  
  151. 10. When starting VGB under Unix, I get X_ShmAttach error.
  152.   You are probably trying to run VGB on a remote Xterminal while it 
  153. attempts to use shared memory for interfacing with X. Use -noshm option 
  154. to tell fMSX not to use shared memory.
  155.  
  156. 11. VGB starts under Unix, but then I get X_PutImage error.
  157.   Unix/X version of VGB currently needs 256-color X. Neither 2-color 
  158. nor TrueColor Xterminals will work with the drivers included into 
  159. "official" fMSX distribution.
  160.  
  161. 12. I start Unix version of VGB but the window stays black.
  162.   Some other X application took over all available colors so that VGB 
  163. could not allocate any for itself. Check if you run XV, Netscape, or 
  164. something similar.
  165.  
  166.  
  167.  
  168. Marat.
  169.  
  170.  
  171.  
  172.  
  173. ******* changes in the Amiga version *******
  174.  
  175. - recompiled with SAS/C V6.30
  176. - requires OS 3.0 and 68020 minimum
  177. - key assignments changed, press "help" for an info requester
  178. - does not support a filename on the commandline, instead an ASL
  179.   filerequester is used
  180. - tested on: A4000/040, CV64 (playable)
  181.              A2000/030, ECS  (sloooooooowwww!)
  182. To do:
  183. - speed up graphics
  184.   We took the graphics routines straight from the X11 version which uses
  185.   256-color chunky bitmaps. Speed is quite decent on a 4000/040 with
  186.   chunky-mode graphics board but unusable on ECS. Rewriting the display
  187.   format conversions should give a *big* speedup here.
  188. - implement sound
  189.   Pretty difficult to do...as we understand it, you'd need 8 audio channels
  190.   to do this without too much work for the CPU.
  191. - better user interface, maybe some GadTools stuff. NO, we will NOT use MUI
  192.   for this one :)
  193. - support for the CD32 joypad (an ordinary joystick doesn't have enough
  194.   buttons)
  195. - real disassembler and hex editor with save function ("freezer")
  196.  
  197. Not really:
  198. - contrast/brightness control
  199. - 4-player support (serial cable emu) via AmiTCP sockets
  200. - battery LED emulation
  201.  
  202.  
  203. If you have any suggestions or ideas for future versions, contact us at
  204. these email addresses:
  205. Matthias Bethke: Matthias.Bethke@sowi.uni-giessen.de
  206. Michael Boese  : skywalker@sweetdreams.lahn.de
  207.  
  208. ...or on the following boards:
  209. ThunderDome  (+49-6408-3249)
  210. Sweet Dreams (+49-6406-76571)
  211.