

		      The Minus/4 Emulator V1.3!
		    Copyright Mike Dailly 1996,97

		           With help from 
                             Tibor Biczo


			     E-Mail me on
		       mike@scotch.demon.co.uk


		  The latest relase can be found at
			www.scotch.demon.co.uk




			      DISCLIAMER


	 THE BORING BIT! THIS PRODUCT IS FREE. AND AS SUCH I
	 ACCEPT NO RESPONSIBILITY FOR ANY DAMAGE DONE BY THIS
	 PRODUCT. IF YOU USE IT, ITS YOUR FAULT. IF SOMETHING
	 HAPPENS COZ YOU USED IT, ITS YOUR FAULT. IF THE EARTH
	 EXPLODES WHILE YOU USE IT, IT'S YOUR FAULT. IF I HAVE
	 A BAD DAY COZ YOU USED IT. YOU GUESSED IT - ITS YOU'R
	 FAULT! ALL IN ALL - YOU USE IT AT YOUR OWN RISK!


	  --------------------------------------------------
	  | Please see the history.txt file for whats new. |
	  --------------------------------------------------




     What IS this thing I've just downloaded!
     ----------------------------------------

     Well, simply put - This is an emulator, that trys its best	to 
     emulate a Commodore Plus/4 On an IBM compatable PC. Theres loads
     of info and games available at ftp://ftp.funet.fi/pub/CBM/plus4
     if you want some more information, then drop by my homepage at
     http://www.scotch.demon.co.uk




     How do I use it!
     ----------------
     Well, the first thing you'll need to do, is get ROMS required to
     run it. These are "c16basic.rom" "c16kern.rom" and "c16char.rom"
     There is also the built in 3-plus-1 ROMS. 
    
     These are all available from ftp://ftp.funet.fi/pub/CBM/plus4 or 
     "www.scotch.demon.co.uk"

     The ROMS must be called "3plus1lo.rom" and "3plus1hi.rom" for Minus4
     to find them.

	

     Loading a Game
     --------------
     To load a game (a .PRG or .D64 file) specify the "PATH" on the 
     command line. for example:

			    "minus4 games"
     
     Then once in the Plus/4 emulator, press F10 to get to the loading
     menu. Once a game is Loaded, it will have to be "RUN", so type "RUN"
     and thats all!
     

     PLEASE NOTE: DONT TRY AND LOAD ANYTHING USING FROM DISK OR TAPE
                  ONLY F10 WORKS JUST NOW!




	
     How do I quit!
     --------------
     To quit, press "ALT+BREAK" this should return you to dos.
     If your in windows...it probably wont! 
     Windows grabs the ALT key - try and exit through the monitor.



     Command Line Switches
     ---------------------
     <game directory>	MUST be fill in. you can use "." (DOT) for
                        the current directory.
     -x    = Disable mode X. Use mode13 (320x200) No border areas are
	     shown. But it will run much quicker.

     -a    = Disable all audio. No sounds will be played

     -t    = Disable timer. Don't sync to Plus/4 speed. makes it go
             FULL rate! FLAT out
 
     -v    = Sync to monitors refresh rate. syncs to the vertical
             blank. Faster than a Plus/4 but will look very smooth.

     -d    = Start in the monitor. Don't boot the kernal.

     -s    = Enable Sample playing through a Sound blaster.
	     only DMA 1 and PORT 220 are supported just now.


     The Monitor
     -----------
     Escape- return to full speed emulation
     F12   - reset Plus/4 (also exits monitor)
     F5    - View frame
             Space = render next scan line. Actually processes a
                     scan line of 6502.
	     Enter = process next FRAME.
             Escape= return to debugger.
     F6    - Save current view. type in a name.bmp then press
             enter. Remember DOS filenames!
             Also remember that it saves the CURRENT view. So, if
             you were view the display, and pressed space for a
             while, it will save 1/2 this and 1/2 the last frame!
     F9    - Trace FAST
     Enter - Trace SLOW
     M     - Dump memory
     S     - Run to (break point)
     R     - set PC to address
     Q     - Quit program (back to DOS)


     In Emulation Mode
     -----------------
     F5        - Enable joystick 1
     F6        - Enable joystick 2
     F8        - Calabrate a real joystick. Must do once each session.
     F10       - Load Game
     F11       - Monitor
     F12       - Reset
     Shift+F12 - Force reset to Basic 


     Joystick!
     ---------

     F5 will enable joystick 1
     F6 will enable joystick 2
     F8 will calabrate a real joystick/joypad. (also enable using)

     Both use the cursor keys and SPACE. A redefine option will be
     added later. I will also add "real" joystick support soon.



     Sound
     -----
     Plus/4 sound is emulated via the AdLib (or compatable) sound
     card. You can disable audio with the "-a" command line switch.
     You can also enable "sample" playing by using a "-s" on the 
     command line. NOTE: only PORT 220 and DMA 1 are supported just
     now! More will come soon.



     Whats NEXT!
     -----------

     Disk emulation

     SID sound emulation via a soundblaster.

     And so does the Timer and its IRQ's... (1 down 2 to go!)

     One day I'll write the Cursor routine correctly! <g>

     I'd also love to map the PC's serial and parallel ports on to
     the Plus/4's User port!! That'd be really neat!

     I've gotten a hold of the OS96 from solder, so I may add a
     boot menu as well. If I get it working!
     (This DOES run just now! If you replace the C16Basic and
      C16Kern ROMS!!)

     PAL/NTSC switch! ($ff07 - bit 6, $40)

     How about a packer that allows you to run "snapshots"  on the
     actual Plus/4???

     256K memory emulation. 

     Any suggestions are welcome!! Honest!! Really!! Send some!! 





			      Thanks To
			      ---------

     "Tibor Biczo" for the help in the real tricky stuff.
     "Marco Polo" for the CD full of really neat and helpful stuff!!!
     "SOLDER" for his fantastic SID card! and the help on OS/2
     "Kreuz" for all the helpfull info on his Homepage!
     "Luca/FIRE" for pointing out some WORKING non-standard opcode stuff
     "Karoly" of Delta Systems for beta testing!
     "Thomas Koenig" for his help in general.


     In fact, loads of ex-plus/4-scene guys, for being great in general!



     THATS ALL FOLKS!
     ----------------
     
     e-mail me if you have an idea or question, I'll try my best to answer.

     

		      --------------------------
		      | KEEP EMULATORS FREE!!! |
		      --------------------------




