
                         --------------
                          PowerMappers
                         --------------

                           v23 (BETA)

                           by thefox
                        thefox@aspekt.fi
                     http://kkfos.aspekt.fi



Introduction
------------

PowerMappers is a new set of mappers for the PowerPak NES flash
cartridge. It is a complete rewrite of my previous Save State Mappers.

Features:

  * 15 mappers supported
  * In-game menu
  * 5 save slots available per session
  * Saves/loads directly to/from CF, no need to hold down reset to save
  * Slightly faster ROM loading speeds
  * PRG upload progress and ROM information is shown while loading
  * Menu settings are saved
  * Partial NES 2.0 support
    * ROMs with more than 8 KB of CHR-RAM are supported
      NOTE: Only the first 8 KB is saved in the slot!

NOTE: Game Genie codes are NOT supported at this time. They take
too much space on the FPGA to be able to fit with some of the more
complex mappers. Game Genie code support might be implemented later by
pre-patching the ROM (although such solution can never be 100% reliable).


Installation
------------

Copy all .MAP files from the mappers directory into the POWERPAK directory
on your CF card. Make sure to overwrite any existing files.

To be able to save/load, you also need to copy one or more 128 KB slot
files (.POW) into the CF card. Each 128 KB slot file can hold up to
5 saves.


How to Use
----------

In the options screen shown after a ROM has been selected, choose "Select
Slot File" to select a slot file to be used for the current session. If
you don't select a slot file, saving and loading is not possible.

During the game, press Select+Start to enter the in-game menu. In the
menu you can:

  * Save state
  * Load state
  * Close the menu
  * Reset the game
  * Exit to the PowerPak main menu
  * Select the current slot (1..5)
  * Set configuration options

Press Select to move between option sets. Press A to select/toggle
an option.

Save/Load always applies to the currently selected slot (default is slot
1). If quick save/load is enabled, you can press Select+A to quick save
and Select+B to quick load during the game.

Select "Back to Game" to leave the in-game menu.


Supported Mappers
-----------------

  * NROM (#0)
  * AxROM (#7)
  * BxROM (#34)
  * CxROM (#3)
  * GxROM (#66)
  * UxROM (#2)
  * MMC1 (#1)
  * MMC2 (#9)
  * MMC3 (#4)
    * TxSROM (#118)
    * TQROM (#119)
  * MMC4 (#10)
  * FME-7 (#69, no sound)
  * Codemasters (#71)
  * ColorDreams (#11)


Compatibility
-------------

I have tested compatibility with all officially licensed PAL and NTSC
games that I have. Results of the testing can be found at:

  https://docs.google.com/spreadsheets/d/13s79Q6BdxXlUv3620TSkmeCReB94mvXkNxjyanKXXBw/edit?usp=sharing

If you disagree with some entry on the compatibility list, you can let
me know by e-mail:

  thefox@aspekt.fi


To-be-done
----------

  * More mappers
  * Automatic slot file selection based on ROM name
  * Source release


Thanks
------

Thanks to:

  * loopy for providing the previous MMC3 IRQ implementation
  * Pasky for some beta testing


Version History
---------------

- v23 (2015-12-28)
  * New MMC3 IRQ implementation (RAMBO-1 style, based on M2). Doesn't
  exactly match real MMC3 timings, but should be more robust than the
  previous implementation.
  * Don't enable CHR-RAM if PPU asserts /RD and /WR at the same time due
  to rogue $2007 writes. Fixes graphics glitching in the following games:
    - Noah's Ark (E)
    - Addams Family, The - Pugsley's Scavenger Hunt (U)
    - Baseball Stars II (U)
    - Bigfoot (U)
    - Krusty's Fun House (U)
    - Perfect Fit (U)

- v21 (2015-12-16)
  * Fixed a bug in controller read corruption handling (caused menu to
  show up spuriously in Bomberman II). Thanks to WaverBoy for report.
  * FME-7 IRQ acknowledgement behavior changed to match
  http://forums.nesdev.com/viewtopic.php?p=142246#p142246 (should not
  affect any games).

- v20 (2014-10-22)
  * Initial release.
