Midway Pacman Emulator (V1.0)
=============================
A.D.Price - September 2008


Introduction
============

Why create a pacman emulator for the wii? Two reasons. Mame on the wii doesn't currently contain wiimote support and I wanted to play pacman. This is the first application I have created for the Wii. I have treated this development as a learning exercise, to gain experience of wii programming and to find out how an emulator works. It should be possible to take this code and extend it for other Z80 based arcade machines without too much difficulty.


Progress
========
-Game works.
-Wiimote, nunchuck and classic controller supported.
-High scores saved and loaded
-Sound emulation needs work (can anybody help?)


The Emulator
============

The emulator code is almost completely contained in pacman.c. Memory, port I/O etc are all in there. The sound is emulated in sound.c (this still needs some work).

Roms
====
You will need to acquire the Mame romset for this. It is usually called pacman.zip. It should contain the files: pacman.5e, pacman.5f, pacman.6e, pacman.6f, pacman.6h, pacman.6j, 82s123.7f, 82s126.4a. 

Create the directory \pacman\roms\ on the front SD Card and insert the files.

You're now ready use the emulator.


Application
===========
Copy the files boot.elf, meta.xml, icon.png into the directory \apps\pacman\.


Controls
========
Wiimote (sideways): 
 A     - Credit
 plus  - 1 player
 minus - 2 player
 up    - left
 down  - right
 left  - down
 right - up
 home  - quit (back to homebrew)

Nunchuck:
 C         - Credit
 Z         - 1 player
 joy up    - up
 joy down  - down  
 joy left  - left  
 joy right - right

Classic controller:
 A         - Credit
 plus      - 1 player
 minus     - 2 player
 up        - up
 down      - down  
 left      - left  
 right     - right
 joy up    - up
 joy down  - down  
 joy left  - left  
 joy right - right
 home      - quit (back to homebrew)


Source Code
===========
The application was developed using devkitpro r15 and programmers notepad on a windows PC. All the files necessary to open and compile the application in this environment are included with this release.


Credits
=======
The emulator is based on two existing applications:

-Midway Space Invaders Emulator by softdev 
 (http://www.tehskeen.com/forums/showthread.php?t=4456)
-Pacman Instructional Emulator by Alessandro Scotti  (http://www.ascotti.org/programming/pie/pie.htm)
-Z80 C Core by Juergen Buchmueller

Thanks also to the developers of devkitpro and libogc and the developers of MAME.

GPL
===

This project is released under the GNU Public Licence v2.
A copy of this document is in the docs directory. Please ensure that you
distribute this document with any derived sources.