mirror of https://github.com/stella-emu/stella.git
135 lines
3.8 KiB
C++
135 lines
3.8 KiB
C++
//============================================================================
|
|
//
|
|
// MM MM 6666 555555 0000 2222
|
|
// MMMM MMMM 66 66 55 00 00 22 22
|
|
// MM MMM MM 66 55 00 00 22
|
|
// MM M MM 66666 55555 00 00 22222 -- "A 6502 Microprocessor Emulator"
|
|
// MM MM 66 66 55 00 00 22
|
|
// MM MM 66 66 55 55 00 00 22
|
|
// MM MM 6666 5555 0000 222222
|
|
//
|
|
// Copyright (c) 1995-2017 by Bradford W. Mott, Stephen Anthony
|
|
// 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.
|
|
//============================================================================
|
|
|
|
#ifndef DEVICE_HXX
|
|
#define DEVICE_HXX
|
|
|
|
class System;
|
|
|
|
#include "Console.hxx"
|
|
#include "Serializable.hxx"
|
|
#include "bspf.hxx"
|
|
|
|
/**
|
|
Abstract base class for devices which can be attached to a 6502
|
|
based system.
|
|
|
|
@author Bradford W. Mott
|
|
*/
|
|
class Device : public Serializable
|
|
{
|
|
public:
|
|
Device() : mySystem(nullptr) { }
|
|
virtual ~Device() = default;
|
|
|
|
public:
|
|
/**
|
|
Reset device to its power-on state.
|
|
|
|
*DO NOT* call this method until the device has been attached to
|
|
the System. In fact, it should never be necessary to call this
|
|
method directly at all.
|
|
*/
|
|
virtual void reset() = 0;
|
|
|
|
/**
|
|
Notification method invoked by the system when the console type
|
|
has changed. It may be necessary to override this method for
|
|
devices that want to know about console changes.
|
|
|
|
@param timing Enum representing the new console type
|
|
*/
|
|
virtual void consoleChanged(ConsoleTiming timing) { }
|
|
|
|
/**
|
|
Install device in the specified system. Invoked by the system
|
|
when the device is attached to it.
|
|
|
|
@param system The system the device should install itself in
|
|
*/
|
|
virtual void install(System& system) = 0;
|
|
|
|
/**
|
|
Save the current state of this device to the given Serializer.
|
|
|
|
@param out The Serializer object to use
|
|
@return False on any errors, else true
|
|
*/
|
|
virtual bool save(Serializer& out) const override = 0;
|
|
|
|
/**
|
|
Load the current state of this device from the given Serializer.
|
|
|
|
@param in The Serializer object to use
|
|
@return False on any errors, else true
|
|
*/
|
|
virtual bool load(Serializer& in) override = 0;
|
|
|
|
/**
|
|
Get a descriptor for the device name (used in error checking).
|
|
|
|
@return The name of the object
|
|
*/
|
|
virtual string name() const override = 0;
|
|
|
|
public:
|
|
/**
|
|
Get the byte at the specified address
|
|
|
|
@return The byte at the specified address
|
|
*/
|
|
virtual uInt8 peek(uInt16 address) { return 0; }
|
|
|
|
/**
|
|
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
|
|
*/
|
|
virtual bool poke(uInt16 address, uInt8 value) { return false; }
|
|
|
|
/**
|
|
Query the given address for its disassembly flags
|
|
|
|
@param address The address to modify
|
|
*/
|
|
virtual uInt8 getAccessFlags(uInt16 address) const { return 0; }
|
|
|
|
/**
|
|
Change the given address type to use the given disassembly flags
|
|
|
|
@param address The address to modify
|
|
@param flags A bitfield of DisasmType directives for the given address
|
|
*/
|
|
virtual void setAccessFlags(uInt16 address, uInt8 flags) { }
|
|
|
|
protected:
|
|
/// Pointer to the system the device is installed in or the null pointer
|
|
System* mySystem;
|
|
|
|
private:
|
|
// Following constructors and assignment operators not supported
|
|
Device(const Device&) = delete;
|
|
Device(Device&&) = delete;
|
|
Device& operator=(const Device&) = delete;
|
|
Device& operator=(Device&&) = delete;
|
|
};
|
|
|
|
#endif
|