A Pac Man machine emulator written in Java
Switch branches/tags
Nothing to show
Clone or download
frisnit Merge pull request #1 from frisnit/develop
Added support for namco pacman, midway pacman and hangly man
Latest commit 1c53d54 Jun 30, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist Added .jar to repo Mar 26, 2015
src updated comments and readme Jun 30, 2016
.gitignore Added .jar to repo Mar 26, 2015
LICENSE Initial commit Mar 23, 2015
README.md Update README.md Jun 30, 2016
screenshot.png Initial creation Mar 23, 2015

README.md

pacman-emulator

A Pac Man machine emulator written in Java

This emulator currently supports Namco Pacman, Midway Pacman and Hangly Man.

alt tag

This emulator was written with the help of Chris Lomont's Pac Man emulation guide:

http://www.lomont.org/Software/Games/PacMan/PacmanEmulation.pdf

Take a look at that for full details of the implementation.

There are six main parts to the emulator:

CPU

This is based on the Java Z80 microprocessor emulator that can be found here: https://code.google.com/p/z80-cpu/ with additions to support the mode 2 external interrupt (INT) required by the machine's sound and display hardware. Pressing 'r' while the emulator is running will force a CPU reset.

Memory

This emulates the CPU address bus (Z80Memory.java) and provides the address mappings to the program ROM (0x0000 to 0x3fff), RAM (0x4000 to 0x4fff) and memory mapped IO space (0x5000 to 0x50ff) which is used to control the sound, sprites and player controls.

IO

Not to be confused with the memory mapped IO described above, this emulates the Z80 peripheral hardware IO bus (Z80IO.java). In this emulation this performs only one function: to store the INT vector for use during the 60Hz VBLANK interrupt.

Video

This emulates the video hardware and produces a representation of the screen based on the state of the video RAM and sprite registers. It runs 60 times a second. The Pac Man screen consists of an array of static tiles overlaid with sprites. The tiles are stored in a character based array in RAM alongside the corresponding palette entries for each tile. The sprite hardware is completely separate from the CPU and is controlled by the sprite registers in the memory mapped IO space. The hardware can draw up to eight 16x16 pixel sprites anywhere on the screen. The tile layout, tile/sprite image format and colour lookup is completely bonkers. See Chris's PDF for a full explanation. Maybe it makes more sense when you look at the actual hardware. See Video.java for the implementation.

Sound

The Pac Man sound hardware supports 3 voices on a single mono channel. Each of these voices can select the volume and frequency of one of 8 output waveforms. The sound registers are written to by the CPU over the memory mapped IO space during the 60Hz VBLANK interrupt. The Pac Man sound hardware runs at a 96kHz sample rate so the output from the sound emulator is low pass filtered and downsampled to 22050Hz for output. See Sound.java for implementation.

Inputs

This emulation currently supports the following keyboard controls:

Machine controls

  • Player 1 controls (cursor keys)
  • Player 2 controls (cursor keys)
  • 1 player start button (1)
  • 2 player start button (2)
  • Coin input (5).

The DIP switches are hardcoded. See Io.java for implementation.

Emulator controls

  • 'r' to reset the Z80 emulation
  • 'c' to apply an invincibility cheat patch to the ROM image (do this after the machine boots else it'll fail the ROM test)
  • 'p' to pause the emulation

ROMs

You'll need to get a set of ROMs from somewhere else to make this work. Put the following ROM images in a .zip file in the project root directory and define ROMPACK_FILENAME in Main.java to be the name of the file and it'll get picked up when the machine starts. You may have to rename the ROM filenames in the .zip to match these depending where you get them from:

Midway Pacman

pacman.6e SHA1 813cecf44bf5464b1aed64b36f5047e4c79ba176
pacman.6f SHA1 9b5ddaaa8b564654f97af193dbcc29f81f230a25
pacman.6h SHA1 afe72fdfec66c145b53ed865f98734686b26e921
pacman.6j SHA1 0694ac558db9b4b9423a04223856b0fb784bcbf2
pacman.5e SHA1 06ef227747a440831c9a3a613b76693d52a2f0a9
pacman.5f SHA1 4a937ac02216ea8c96477d4a15522070507fb599
82s123.7f SHA1 8d0268dee78e47c712202b0ec4f1f51109b1f2a5
82s126.4a SHA1 19097b5f60d1030f8b82d9f1d3a241f93e5c75d6
82s126.1m SHA1 bbcec0570aeceb582ff8238a4bc8546a23430081
82s126.3m SHA1 0c4d0bee858b97632411c440bea6948a74759746

Namco Pacman

pacman.6e SHA1 87117ba5082cd7a615b4ec7c02dd819003fbd669
pacman.6f SHA1 326dbbf94c6fa2e96613dedb53702f8832b47d59
pacman.6h SHA1 7e1945f6eb51f2e51806d0439f975f7a2889b9b8
pacman.6j SHA1 39939bcd6fb785d0d06fd29f0287158ab1267dfc
pacman.5e SHA1 06ef227747a440831c9a3a613b76693d52a2f0a9
pacman.5f SHA1 4a937ac02216ea8c96477d4a15522070507fb599
82s123.7f SHA1 8d0268dee78e47c712202b0ec4f1f51109b1f2a5
82s126.4a SHA1 19097b5f60d1030f8b82d9f1d3a241f93e5c75d6
82s126.1m SHA1 bbcec0570aeceb582ff8238a4bc8546a23430081
82s126.3m SHA1 0c4d0bee858b97632411c440bea6948a74759746

Hangly Man

pacman.6e SHA1 d63eaebd85e10aa6c27bb7f47642dd403eeb6934
pacman.6f SHA1 cedddc5194589039dd8b64f07ab6320d7d4f55f9
pacman.6h SHA1 bd42e68b29b4d654dc817782ba00db69b7d2dfe2
pacman.6j SHA1 0a7ac0e59d4d26fe52a2f4196c9f19e5ab677c87
pacman.5e SHA1 06ef227747a440831c9a3a613b76693d52a2f0a9
pacman.5f SHA1 4a937ac02216ea8c96477d4a15522070507fb599
82s123.7f SHA1 8d0268dee78e47c712202b0ec4f1f51109b1f2a5
82s126.4a SHA1 19097b5f60d1030f8b82d9f1d3a241f93e5c75d6
82s126.1m SHA1 bbcec0570aeceb582ff8238a4bc8546a23430081
82s126.3m SHA1 0c4d0bee858b97632411c440bea6948a74759746

The emulator doesn't check the hashes, it'll try and run anything you give it (including no ROMs at all). These are just given here as a first line in sanity checking your setup.