mirror of https://github.com/stella-emu/stella.git
148 lines
3.7 KiB
C++
148 lines
3.7 KiB
C++
//============================================================================
|
|
//
|
|
// SSSS tt lll lll
|
|
// SS SS tt ll ll
|
|
// SS tttttt eeee ll ll aaaa
|
|
// SSSS tt ee ee ll ll aa
|
|
// SS tt eeeeee ll ll aaaaa -- "An Atari 2600 VCS Emulator"
|
|
// SS SS tt ee ll ll aa aa
|
|
// SSSS ttt eeeee llll llll aaaaa
|
|
//
|
|
// Copyright (c) 1995-2010 by Bradford W. Mott and the Stella Team
|
|
//
|
|
// See the file "License.txt" for information on usage and redistribution of
|
|
// this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
|
//
|
|
// $Id: CartSB.hxx,v 1.0 2007/10/11
|
|
//============================================================================
|
|
|
|
#ifndef CARTRIDGESB_HXX
|
|
#define CARTRIDGESB_HXX
|
|
|
|
#include "bspf.hxx"
|
|
#include "Cart.hxx"
|
|
#include "System.hxx"
|
|
|
|
/**
|
|
Cartridge class used for SB "SUPERbanking" 128k-256k bankswitched games.
|
|
There are either 32 or 64 4K banks.
|
|
|
|
@author Fred X. Quimby
|
|
*/
|
|
class CartridgeSB : public Cartridge
|
|
{
|
|
public:
|
|
/**
|
|
Create a new cartridge using the specified image
|
|
|
|
@param image Pointer to the ROM image
|
|
*/
|
|
CartridgeSB(const uInt8* image, uInt32 size);
|
|
|
|
/**
|
|
Destructor
|
|
*/
|
|
virtual ~CartridgeSB();
|
|
|
|
public:
|
|
/**
|
|
Reset device to its power-on state
|
|
*/
|
|
void reset();
|
|
|
|
/**
|
|
Install cartridge in the specified system. Invoked by the system
|
|
when the cartridge is attached to it.
|
|
|
|
@param system The system the device should install itself in
|
|
*/
|
|
void install(System& system);
|
|
|
|
/**
|
|
Install pages for the specified bank in the system.
|
|
|
|
@param bank The bank that should be installed in the system
|
|
*/
|
|
void bank(uInt16 bank);
|
|
|
|
/**
|
|
Get the current bank.
|
|
*/
|
|
int bank();
|
|
|
|
/**
|
|
Query the number of banks supported by the cartridge.
|
|
*/
|
|
int bankCount();
|
|
|
|
/**
|
|
Patch the cartridge ROM.
|
|
|
|
@param address The ROM address to patch
|
|
@param value The value to place into the address
|
|
@return Success or failure of the patch operation
|
|
*/
|
|
bool patch(uInt16 address, uInt8 value);
|
|
|
|
/**
|
|
Access the internal ROM image for this cartridge.
|
|
|
|
@param size Set to the size of the internal ROM image data
|
|
@return A pointer to the internal ROM image data
|
|
*/
|
|
uInt8* getImage(int& size);
|
|
|
|
/**
|
|
Save the current state of this cart to the given Serializer.
|
|
|
|
@param out The Serializer object to use
|
|
@return False on any errors, else true
|
|
*/
|
|
bool save(Serializer& out) const;
|
|
|
|
/**
|
|
Load the current state of this cart from the given Serializer.
|
|
|
|
@param in The Serializer object to use
|
|
@return False on any errors, else true
|
|
*/
|
|
bool load(Serializer& in);
|
|
|
|
/**
|
|
Get a descriptor for the device name (used in error checking).
|
|
|
|
@return The name of the object
|
|
*/
|
|
string name() const { return "CartridgeSB"; }
|
|
|
|
public:
|
|
/**
|
|
Get the byte at the specified address.
|
|
|
|
@return The byte at the specified address
|
|
*/
|
|
uInt8 peek(uInt16 address);
|
|
|
|
/**
|
|
Change the byte at the specified address to the given value
|
|
|
|
@param address The address where the value should be stored
|
|
@param value The value to be stored at the address
|
|
@return True if the poke changed the device address space, else false
|
|
*/
|
|
bool poke(uInt16 address, uInt8 value);
|
|
|
|
private:
|
|
// The 128-256K ROM image and size of the cartridge
|
|
uInt8* myImage;
|
|
uInt32 mySize;
|
|
|
|
// Indicates which bank is currently active
|
|
uInt16 myCurrentBank;
|
|
|
|
// Previous Device's page access
|
|
System::PageAccess myHotSpotPageAccess[8];
|
|
};
|
|
|
|
#endif
|