openMSX
Classes | Public Member Functions | List of all members
openmsx::MSXMultiMemDevice Class Reference

#include <MSXMultiMemDevice.hh>

Inheritance diagram for openmsx::MSXMultiMemDevice:
Inheritance graph
[legend]
Collaboration diagram for openmsx::MSXMultiMemDevice:
Collaboration graph
[legend]

Classes

struct  Range

Public Member Functions

 MSXMultiMemDevice (const HardwareConfig &hwConf)
virtual ~MSXMultiMemDevice ()
bool canAdd (int base, int size)
void add (MSXDevice &device, int base, int size)
void remove (MSXDevice &device, int base, int size)
bool empty () const
std::vector< MSXDevice * > getDevices () const
virtual std::string getName () const
 Returns a human-readable name for this device.
virtual void getNameList (TclObject &result) const
 Returns list of name(s) of this device.
virtual byte readMem (word address, EmuTime::param time)
 Read a byte from a location at a certain time from this device.
virtual byte peekMem (word address, EmuTime::param time) const
 Read a byte from a given memory location.
virtual void writeMem (word address, byte value, EmuTime::param time)
 Write a given byte to a given location at a certain time to this device.
virtual const bytegetReadCacheLine (word start) const
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading.
virtual bytegetWriteCacheLine (word start) const
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing.
- Public Member Functions inherited from openmsx::MSXMultiDevice
 MSXMultiDevice (const HardwareConfig &hwConf)
virtual void reset (EmuTime::param time)
 This method is called on reset.
virtual void powerUp (EmuTime::param time)
 This method is called when MSX is powered up.
virtual void powerDown (EmuTime::param time)
 This method is called when MSX is powered down.
- Public Member Functions inherited from openmsx::MSXDevice
virtual ~MSXDevice ()=0
const HardwareConfiggetHardwareConfig () const
 Returns the hardwareconfig this device belongs to.
void testRemove (Devices alreadyRemoved) const
 Checks whether this device can be removed (no other device has a reference to it).
virtual byte readIRQVector ()
 Gets IRQ vector used in IM2.
void getDeviceInfo (TclObject &result) const
 Get device info.
void getVisibleMemRegion (unsigned &base, unsigned &size) const
 Returns the range where this device is visible in memory.
virtual byte readIO (word port, EmuTime::param time)
 Read a byte from an IO port at a certain time from this device.
virtual void writeIO (word port, byte value, EmuTime::param time)
 Write a byte to a given IO port at a certain time to this device.
virtual byte peekIO (word port, EmuTime::param time) const
 Read a byte from a given IO port.
virtual void globalWrite (word address, byte value, EmuTime::param time)
 Global writes.
void invalidateMemCache (word start, unsigned size)
 Invalidate CPU memory-mapping cache.
MSXMotherBoardgetMotherBoard () const
 Get the mother board this device belongs to.
const XMLElementgetDeviceConfig () const
 Get the configuration section for this device.
const DeviceConfiggetDeviceConfig2 () const
const DevicesgetReferences () const
 Get the device references that are specified for this device.
EmuTime::param getCurrentTime () const
MSXCPUgetCPU () const
MSXCPUInterfacegetCPUInterface () const
SchedulergetScheduler () const
CliCommgetCliComm () const
ReactorgetReactor () const
CommandControllergetCommandController () const
PluggingControllergetPluggingController () const
LedStatusgetLedStatus () const
template<typename Archive >
void serialize (Archive &ar, unsigned version)

Additional Inherited Members

- Public Types inherited from openmsx::MSXDevice
typedef std::vector< MSXDevice * > Devices
- Static Public Attributes inherited from openmsx::MSXDevice
static byte unmappedRead [0x10000]
static byte unmappedWrite [0x10000]
- Protected Member Functions inherited from openmsx::MSXDevice
 MSXDevice (const DeviceConfig &config, const std::string &name)
 Every MSXDevice has a config entry; this constructor gets some device properties from that config entry.
 MSXDevice (const DeviceConfig &config)
virtual void init ()
virtual void getExtraDeviceInfo (TclObject &result) const

Detailed Description

Definition at line 11 of file MSXMultiMemDevice.hh.

Constructor & Destructor Documentation

openmsx::MSXMultiMemDevice::MSXMultiMemDevice ( const HardwareConfig hwConf)

Definition at line 28 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::getCPUInterface().

openmsx::MSXMultiMemDevice::~MSXMultiMemDevice ( )
virtual

Definition at line 35 of file MSXMultiMemDevice.cc.

References empty().

Member Function Documentation

void openmsx::MSXMultiMemDevice::add ( MSXDevice device,
int  base,
int  size 
)

Definition at line 62 of file MSXMultiMemDevice.cc.

References canAdd().

bool openmsx::MSXMultiMemDevice::canAdd ( int  base,
int  size 
)

Definition at line 52 of file MSXMultiMemDevice.cc.

References xrange().

Referenced by add().

bool openmsx::MSXMultiMemDevice::empty ( ) const

Definition at line 76 of file MSXMultiMemDevice.cc.

Referenced by ~MSXMultiMemDevice().

std::vector< MSXDevice * > openmsx::MSXMultiMemDevice::getDevices ( ) const

Definition at line 81 of file MSXMultiMemDevice.cc.

References xrange().

std::string openmsx::MSXMultiMemDevice::getName ( ) const
virtual

Returns a human-readable name for this device.

Default implementation is normally ok.

Reimplemented from openmsx::MSXDevice.

Definition at line 90 of file MSXMultiMemDevice.cc.

References getNameList(), openmsx::TclObject::getString(), and string_ref::str().

void openmsx::MSXMultiMemDevice::getNameList ( TclObject result) const
virtual

Returns list of name(s) of this device.

This is normally the same as getName() (but formatted as a Tcl list) except for multi-{mem,io}-devices.

Reimplemented from openmsx::MSXDevice.

Definition at line 96 of file MSXMultiMemDevice.cc.

References openmsx::TclObject::addListElement().

Referenced by getName().

const byte * openmsx::MSXMultiMemDevice::getReadCacheLine ( word  start) const
virtual

Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading.

If it is, a pointer to a buffer containing this interval must be returned. If not, a null pointer must be returned. Cacheable for reading means the data may be read directly from the buffer, thus bypassing the readMem() method, and thus also ignoring EmuTime. The default implementation always returns a null pointer. The start of the interval is CacheLine::SIZE aligned.

Reimplemented from openmsx::MSXDevice.

Definition at line 136 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::getReadCacheLine(), and unlikely.

byte * openmsx::MSXMultiMemDevice::getWriteCacheLine ( word  start) const
virtual

Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing.

If it is, a pointer to a buffer containing this interval must be returned. If not, a null pointer must be returned. Cacheable for writing means the data may be written directly to the buffer, thus bypassing the writeMem() method, and thus also ignoring EmuTime. The default implementation always returns a null pointer. The start of the interval is CacheLine::SIZE aligned.

Reimplemented from openmsx::MSXDevice.

Definition at line 151 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::getWriteCacheLine(), and unlikely.

byte openmsx::MSXMultiMemDevice::peekMem ( word  address,
EmuTime::param  time 
) const
virtual

Read a byte from a given memory location.

Reading memory via this method has no side effects (doesn't change the device status). If save reading is not possible this method returns 0xFF. This method is not used by the emulation. It can however be used by a debugger. The default implementation uses the cache mechanism (getReadCacheLine() method). If a certain region is not cacheable you cannot read it by default, Override this method if you want to improve this behaviour.

Reimplemented from openmsx::MSXDevice.

Definition at line 126 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::peekMem().

byte openmsx::MSXMultiMemDevice::readMem ( word  address,
EmuTime::param  time 
)
virtual

Read a byte from a location at a certain time from this device.

The default implementation returns 255.

Reimplemented from openmsx::MSXDevice.

Definition at line 121 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::readMem().

void openmsx::MSXMultiMemDevice::remove ( MSXDevice device,
int  base,
int  size 
)

Definition at line 68 of file MSXMultiMemDevice.cc.

void openmsx::MSXMultiMemDevice::writeMem ( word  address,
byte  value,
EmuTime::param  time 
)
virtual

Write a given byte to a given location at a certain time to this device.

The default implementation ignores the write (does nothing).

Reimplemented from openmsx::MSXDevice.

Definition at line 131 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::writeMem().


The documentation for this class was generated from the following files: