O2EM V0.50
			    an Odyssey 2 emulator

	     copyright 1997 by Daniel Boris (dan.boris@coat.com)

---------------------------------------------------------------------------

Acknowledgments:

I would like to thank the following people for their help and encouragement:


	Keita Iida (Keita/Pooka/Fygar)
		for his enthusiasm, for the O2EM beta testing, and
		general encouragement.

	Marco Kerstens (MarcoK)
		for providing Videopac schematics, and general support.

	Bo Krogsgaard (Therion23)
		for putting the idea of doing the emulator into my head to 
		start with.

	Dave (Conjurer)
		for help in beta testing.

	Erica (unico)
		for putting up with me while I was working on this ;)

	and everyone on EFNET IRC channels #emulate and #rgvc.

---------------------------------------------------------------------------
Copyright:
O2EM is copyright 1997 by Daniel Boris.

Odyssey 2 and Videopac are trademarks of Phillips Electronics.

O2EM is free as long as it is not used in a commercial matter and not
altered in any way. The contents of this archive should not be
added to or changed in any way. ROM images should never be distributed
with this emulator.

I maintain the right to forbid the use of the emulator  at
any time. I am not responsible for any damage caused by the use
of this program. This program is distributed "as-is". I make no
guarantees as to it's accuracy, performance, or compatibility with
the users hardware. 

The emulator is not to be distributed for profit and may not be  
included on CD's without my express permission.
---------------------------------------------------------------------------    

Introduction
	
	O2EM is and Odyssey 2 video game console emulator. The 
current version of this emulator is far from complete, there is no 
sound, no real joystick support, and a good number of games do not
run perfectly (or at all). The reason for this is that this emulator
was built up completely from scratch with almost no technical information
to work from. The only materials I had to work with when writing this
emulator where the Intel 8048 microcontroller data book, an O^2 console,
and a couple of cartridges. Everything else was figured out by tracing
circuits, running code on the real hardware, and generally doing a lot
of hi-tech detective work. I am releasing the emulator in this state 
because crossing the next compatibility hurdle will require a major
re-write and some more research, so I wanted to release this now 
so people can start playing with it as I continue to improve it. 

The current version was written with Borland C 3.1 and is not at all 
optimized. For the next version I will port it to DJGPP and do some
optimizations so the speed shout be much better.

The current version of O2EM can be found at:

	http://www.geocities.com/SiliconValley/9461

---------------------------------------------------------------------------

Setup:

	Before you can run O2EM you need a copy of the O2 BIOS ROM. For
copyright reasons I am not including this ROM image in this archive. This
rom image is stored inside the 8048 processor and can be read out with the
appropriate equipment. The image should be 1024 bytes long , named 
O2ROM.BIN and should be in the same directory as the emulator.

You will also need cartridge images, but again for copyright reasons I cannot
provide these. PLEASE DO NOT E-mail me asking for ROM images! All messages
asking for ROM images will be promptly deleted.

The following games run almost perfectly:
KC Munchkin, Thunderball Pinball, KC's Krazy Chase, Pick Axe Pete among others.

------------------------------------------------------------------------------------

Usage:

O2EM file -[options]

	file - O2 file to load. The file should be either 2048, 4096, or 8192 
	bytes long.

	-debug  - Start emulator in debug mode.

----------------------------------------------------------------------------

Controls:
    
    Arrow keys = Joystick 1
    W,D,X,A    = Joystick 2
    Right Shift = Fire Stick 1
    Left Shift  = Fire Stick 2

    ESC        = Leave the emulator
    F4         = Enter debugger

    NOTE: If you have problems with the keyboard controls try
    pressing Num Lock, this may fix the problem.

----------------------------------------------------------------------------

Debugger

The emulator comes with a built in debugger that I used for development.
The debugger is not very polished and fairly incomplete but it can be
useful for single stepping through programs and watching thier behavior.
I will clean up and improve the debugger in later versions.

H = display help

----------------------------------------------------------------------------

Limitations
	 - no sound
         - no line interrupts (this effects a lot of games)


Version History:

v0.50: 7/00/97 First Public Release