2001-12-27 19:54:36 +00:00
|
|
|
//============================================================================
|
|
|
|
//
|
|
|
|
// 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
|
|
|
|
//
|
2005-06-16 00:56:00 +00:00
|
|
|
// Copyright (c) 1995-2005 by Bradford W. Mott and the Stella team
|
2001-12-27 19:54:36 +00:00
|
|
|
//
|
|
|
|
// See the file "license" for information on usage and redistribution of
|
|
|
|
// this file, and for a DISCLAIMER OF ALL WARRANTIES.
|
|
|
|
//
|
2005-06-27 15:07:54 +00:00
|
|
|
// $Id: Cart4K.hxx,v 1.5 2005-06-27 15:07:54 urchlay Exp $
|
2001-12-27 19:54:36 +00:00
|
|
|
//============================================================================
|
|
|
|
|
|
|
|
#ifndef CARTRIDGE4K_HXX
|
|
|
|
#define CARTRIDGE4K_HXX
|
|
|
|
|
|
|
|
class Cartridge4K;
|
|
|
|
class System;
|
2002-05-13 19:17:32 +00:00
|
|
|
class Serializer;
|
|
|
|
class Deserializer;
|
2001-12-27 19:54:36 +00:00
|
|
|
|
|
|
|
#include "bspf.hxx"
|
|
|
|
#include "Cart.hxx"
|
|
|
|
|
|
|
|
/**
|
|
|
|
This is the standard Atari 4K cartridge. These cartridges are
|
|
|
|
not bankswitched.
|
|
|
|
|
|
|
|
@author Bradford W. Mott
|
2005-06-27 15:07:54 +00:00
|
|
|
@version $Id: Cart4K.hxx,v 1.5 2005-06-27 15:07:54 urchlay Exp $
|
2001-12-27 19:54:36 +00:00
|
|
|
*/
|
|
|
|
class Cartridge4K : public Cartridge
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
Create a new cartridge using the specified image
|
|
|
|
|
|
|
|
@param image Pointer to the ROM image
|
|
|
|
*/
|
|
|
|
Cartridge4K(const uInt8* image);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Destructor
|
|
|
|
*/
|
|
|
|
virtual ~Cartridge4K();
|
|
|
|
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
Get a null terminated string which is the device's name (i.e. "M6532")
|
|
|
|
|
|
|
|
@return The name of the device
|
|
|
|
*/
|
|
|
|
virtual const char* name() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
Reset cartridge to its power-on state
|
|
|
|
*/
|
|
|
|
virtual 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
|
|
|
|
*/
|
|
|
|
virtual void install(System& system);
|
|
|
|
|
2002-05-13 19:17:32 +00:00
|
|
|
/**
|
|
|
|
Saves the current state of this device to the given Serializer.
|
|
|
|
|
|
|
|
@param out The serializer device to save to.
|
|
|
|
@return The result of the save. True on success, false on failure.
|
|
|
|
*/
|
|
|
|
virtual bool save(Serializer& out);
|
|
|
|
|
|
|
|
/**
|
|
|
|
Loads the current state of this device from the given Deserializer.
|
|
|
|
|
|
|
|
@param in The deserializer device to load from.
|
|
|
|
@return The result of the load. True on success, false on failure.
|
|
|
|
*/
|
|
|
|
virtual bool load(Deserializer& in);
|
|
|
|
|
2001-12-27 19:54:36 +00:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
Get the byte at the specified address.
|
|
|
|
|
|
|
|
@return The byte at the specified address
|
|
|
|
*/
|
|
|
|
virtual 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
|
|
|
|
*/
|
|
|
|
virtual void poke(uInt16 address, uInt8 value);
|
|
|
|
|
2005-06-27 15:07:54 +00:00
|
|
|
bool patch(uInt16 address, uInt8 value);
|
|
|
|
|
2001-12-27 19:54:36 +00:00
|
|
|
private:
|
|
|
|
// The 4K ROM image for the cartridge
|
|
|
|
uInt8 myImage[4096];
|
|
|
|
};
|
|
|
|
#endif
|
|
|
|
|