

		      The Minus/4 Emulator V0.5!
		      Copyright Mike Dailly 1996


			     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!



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

      Well, simply put - This is an emulator, that trys its best
      best to emulate a Commodore Plus/4 On an IBM compatable PC
      You'll need to get the Plus/4 ROMS from.

		"ftp://ftp.funet.fi/pub/CBM/plus4"

			       or from

		       "www.scotch.demon.co.uk"


	Your directory should look like this. 
	(at least, you may have more..)


 	Volume in drive E is BUGGER     
 	Volume Serial Number is 2066-0AD0
 	Directory of E:\SOURCE\P4\beta

	.              <DIR>        23/11/96  11:21 .
	..             <DIR>        23/11/96  11:21 ..
	MINUS4   EXE       128,096  28/11/96  21:42 minus4.exe
	README   TXT         5,173  28/11/96  21:44 README.TXT
	DOS4GW   EXE       231,179  26/01/95  11:42 DOS4GW.EXE
	C16BASIC ROM        16,384  28/10/94   0:00 c16basic.rom
	C16KERN  ROM        16,384  28/10/94   0:00 c16kern.rom
	C16CHAR  ROM         2,048  02/06/94   0:00 c16char.rom
	3PLUS1LO ROM        16,384  09/11/96  12:14 3PLUS1LO.ROM
	3PLUS1HI ROM        16,384  09/11/96  12:14 3PLUS1HI.ROM
         	8 file(s)        432,032 bytes
         	2 dir(s)      81,477,632 bytes free




			     Whats NEXT!
			     -----------
       Well, I may start on writing the emulation code in assembler.
       Everything but the screen draw is in C!! And very SLOW C at
       that!

       I have to do the Y scroll, and add the bitmap scroll...
       Sound needs done one day too!

       And so does the Timer and its IRQ's... 

       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 also want to put a front end on the loader like C64s. And
       support the D64 and T64 formats...

       I'll probably start speeding things up... it'd be nice having
       it run at full speed.. I think its about half speed just now..

       Any suggestions are welcome!!



			   Whats NEW now!!
			   ---------------
       For V0.6
       --------
       1) Added "DOS4GW.EXE" to the archive... sorry chaps!

       2) Added screen "BLANKED" mode ($ff06, bit 4)

       3) Register $ff1c and $ff1d are now, read write. (I hope!)

       4) Bug fixed in character ROM address calculation. it crashed!


       For V0.5
       --------
       1) Most games now seem to work! whaahay!
	  Still can't get the processor speed quite right (cycles per
          scan line). Some require about 61, and others about 100!
	  Ah well, I'll work it out..

       2) The packer problem in V0.4 turned out to be corrupted
          files! great! the best kind of problem!

       3) I've added scrolling in X, but not Y yet...

       4) Fixed up small problems in the raster system...
	  I still seem to get a glitch in graphic mode 2
	  (BASIC's split screen graphics). There shouldn't be 
	  a black line there... Mmmm..

       5) Fixed some crashes, but it still happens now and then...



       For V0.4	
       --------

       1) Well, I've added the bit maps modes. Hires, and Hi-res 
          multi colour! What this means, is games like 3DPOOL now 
          work!

       2) I've also added a command line option to allow you to load
          any game (.PRG file) you want! Most still dont work, so
          don't get too excited! but the problems seem to be with the
          packers, and not the games... 
          I'm still working hard on it, so don't worry!

       3) working games so far... (that de-crunch that is..)

	  All basic programs seem to work...
	  Finders keepers (default game)
	  Trailblazer (the file called "a" in the .ZIP??)
	  Airwolf - except the scrolling....(Next?)
	  3DPool!
	  if you find any more, let me know!



			   How do I use it!
			   ----------------
	 Well, the first thing you'll need to do, is run it!
    
			The ROMS required are 
	   "c16basic.rom" "c16kern.rom" and "c16char.rom"
	
      There is also the built in 3-plus-1 ROMS. they can be run.
		 You must get the 3-plus-1 roms from:

		"ftp://ftp.funet.fi/pub/CBM/plus4"

			       or from

		       "www.scotch.demon.co.uk"


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

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


     To load a game (a .PRG file) specify the path\name.prg on the command
	  line. Then once in the Plus/4 emulator, press F10. i.e.

		      "minus4 games\finders.prg"

      once loaded, the game will have to be "RUN", so type "RUN"
			    and thats all!


	
			    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.


			     The Monitor
			     -----------
	F11	takes you to my debug monitor. 
	Enter	traces slowly.
	F9	traces quickly.
	S   	then an address typed in sets a break point.
	R   	then an address typed in sets the current PC
	M   	then an address typed in shows memory there.
	F12 	GO! RUN! EXECUTE!
	Q   	to quit from the monitor.
	


	    NOTE: the joystick (1) seems to map to these keys 

				5 - Up
				R - Down
				D - Left
				6 - Right
				T - Fire


			   THATS ALL FOLKS!
		       mike@scotch.demon.co.uk




