openMSX
|
#include <MSXMemoryMapperBase.hh>
Public Member Functions | |
MSXMemoryMapperBase (const DeviceConfig &config) | |
byte | getSelectedSegment (byte page) const override |
Returns the currently selected segment for the given page. More... | |
unsigned | getSizeInBlocks () |
void | reset (EmuTime::param time) override |
This method is called on reset. More... | |
void | powerUp (EmuTime::param time) override |
This method is called when MSX is powered up. More... | |
byte | readIO (word port, EmuTime::param time) override |
Read a byte from an IO port at a certain time from this device. More... | |
byte | peekIO (word port, EmuTime::param time) const override |
Read a byte from a given IO port. More... | |
byte | readMem (word address, EmuTime::param time) override |
Read a byte from a location at a certain time from this device. More... | |
void | writeMem (word address, byte value, EmuTime::param time) override |
Write a given byte to a given location at a certain time to this device. More... | |
const byte * | getReadCacheLine (word start) const override |
Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading. More... | |
byte * | getWriteCacheLine (word start) const override |
Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing. More... | |
byte | peekMem (word address, EmuTime::param time) const override |
Read a byte from a given memory location. More... | |
unsigned | getBaseSizeAlignment () const override |
The 'base' and 'size' attribute values need to be at least aligned to CacheLine::SIZE. More... | |
void | writeIO (word port, byte value, EmuTime::param time) override=0 |
Write a byte to a given IO port at a certain time to this device. More... | |
template<typename Archive > | |
void | serialize (Archive &ar, unsigned version) |
![]() | |
MSXDevice (const MSXDevice &)=delete | |
MSXDevice & | operator= (const MSXDevice &)=delete |
virtual | ~MSXDevice ()=0 |
const HardwareConfig & | getHardwareConfig () const |
Returns the hardwareconfig this device belongs to. More... | |
void | testRemove (Devices alreadyRemoved) const |
Checks whether this device can be removed (no other device has a reference to it). More... | |
virtual byte | readIRQVector () |
Gets IRQ vector used in IM2. More... | |
virtual void | powerDown (EmuTime::param time) |
This method is called when MSX is powered down. More... | |
virtual std::string | getName () const |
Returns a human-readable name for this device. More... | |
virtual void | getNameList (TclObject &result) const |
Returns list of name(s) of this device. More... | |
void | getDeviceInfo (TclObject &result) const |
Get device info. More... | |
void | getVisibleMemRegion (unsigned &base, unsigned &size) const |
Returns the range where this device is visible in memory. More... | |
virtual void | globalWrite (word address, byte value, EmuTime::param time) |
Global writes. More... | |
virtual void | globalRead (word address, EmuTime::param time) |
Global reads. More... | |
void | invalidateDeviceRWCache () |
Calls MSXCPUInterface::invalidateXXCache() for the specific (part of) the slot that this device is located in. More... | |
void | invalidateDeviceRCache () |
void | invalidateDeviceWCache () |
void | invalidateDeviceRWCache (unsigned start, unsigned size) |
void | invalidateDeviceRCache (unsigned start, unsigned size) |
void | invalidateDeviceWCache (unsigned start, unsigned size) |
void | fillDeviceRWCache (unsigned start, unsigned size, byte *rwData) |
Calls MSXCPUInterface::fillXXCache() for the specific (part of) the slot that this device is located in. More... | |
void | fillDeviceRWCache (unsigned start, unsigned size, const byte *rData, byte *wData) |
void | fillDeviceRCache (unsigned start, unsigned size, const byte *rData) |
void | fillDeviceWCache (unsigned start, unsigned size, byte *wData) |
MSXMotherBoard & | getMotherBoard () const |
Get the mother board this device belongs to. More... | |
const XMLElement & | getDeviceConfig () const |
Get the configuration section for this device. More... | |
const DeviceConfig & | getDeviceConfig2 () const |
const Devices & | getReferences () const |
Get the device references that are specified for this device. More... | |
EmuTime::param | getCurrentTime () const |
MSXCPU & | getCPU () const |
MSXCPUInterface & | getCPUInterface () const |
Scheduler & | getScheduler () const |
CliComm & | getCliComm () const |
Reactor & | getReactor () const |
CommandController & | getCommandController () const |
PluggingController & | getPluggingController () const |
LedStatus & | getLedStatus () const |
template<typename Archive > | |
void | serialize (Archive &ar, unsigned version) |
Protected Member Functions | |
unsigned | calcAddress (word address) const |
Converts a Z80 address to a RAM address. More... | |
unsigned | segmentOffset (byte page) const |
void | writeIOImpl (word port, byte value, EmuTime::param time) |
![]() | |
MSXDevice (const DeviceConfig &config, const std::string &name) | |
Every MSXDevice has a config entry; this constructor gets some device properties from that config entry. More... | |
MSXDevice (const DeviceConfig &config) | |
virtual void | init () |
virtual bool | allowUnaligned () const |
By default we don't allow unaligned <mem> specifications in the config file. More... | |
virtual void | getExtraDeviceInfo (TclObject &result) const |
![]() | |
MSXMapperIOClient (MSXMotherBoard &motherBoard_) | |
~MSXMapperIOClient () | |
![]() | |
~MSXMemoryMapperInterface ()=default | |
Protected Attributes | |
CheckedRam | checkedRam |
byte | registers [4] |
Additional Inherited Members | |
![]() | |
using | Devices = std::vector< MSXDevice * > |
![]() | |
static byte | unmappedRead [0x10000] |
static byte | unmappedWrite [0x10000] |
Definition at line 11 of file MSXMemoryMapperBase.hh.
|
explicit |
Definition at line 22 of file MSXMemoryMapperBase.cc.
|
protected |
Converts a Z80 address to a RAM address.
address | Index in Z80 address space. |
Definition at line 74 of file MSXMemoryMapperBase.cc.
References segmentOffset().
Referenced by getReadCacheLine(), getWriteCacheLine(), openmsx::PanasonicRam::getWriteCacheLine(), peekMem(), readMem(), writeMem(), and openmsx::PanasonicRam::writeMem().
|
overridevirtual |
The 'base' and 'size' attribute values need to be at least aligned to CacheLine::SIZE.
Though some devices may need a stricter alignment. In that case they must override this method.
Reimplemented from openmsx::MSXDevice.
Definition at line 30 of file MSXMemoryMapperBase.cc.
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.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 94 of file MSXMemoryMapperBase.cc.
References calcAddress(), checkedRam, and openmsx::CheckedRam::getReadCacheLine().
Referenced by openmsx::MusicalMemoryMapper::getReadCacheLine().
Returns the currently selected segment for the given page.
page | Z80 address page (0-3). |
Implements openmsx::MSXMemoryMapperInterface.
Definition at line 20 of file MSXMemoryMapperBase.hh.
References registers.
|
inline |
Definition at line 22 of file MSXMemoryMapperBase.hh.
References checkedRam, and openmsx::CheckedRam::getSize().
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.
Reimplemented in openmsx::PanasonicRam, and openmsx::MusicalMemoryMapper.
Definition at line 99 of file MSXMemoryMapperBase.cc.
References calcAddress(), checkedRam, and openmsx::CheckedRam::getWriteCacheLine().
Referenced by openmsx::MusicalMemoryMapper::getWriteCacheLine().
Read a byte from a given IO port.
Reading via this method has no side effects (doesn't change the device status). If safe 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 just returns 0xFF.
Reimplemented from openmsx::MSXDevice.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 53 of file MSXMemoryMapperBase.cc.
References Math::ceil2(), checkedRam, openmsx::CheckedRam::getSize(), and registers.
Referenced by openmsx::MusicalMemoryMapper::peekIO(), and readIO().
|
overridevirtual |
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.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 79 of file MSXMemoryMapperBase.cc.
References calcAddress(), checkedRam, and openmsx::CheckedRam::peek().
Referenced by openmsx::MusicalMemoryMapper::peekMem().
|
overridevirtual |
This method is called when MSX is powered up.
The default implementation calls reset(), this is usually ok.
time | The moment in time the power up occurs. |
Reimplemented from openmsx::MSXDevice.
Definition at line 35 of file MSXMemoryMapperBase.cc.
References checkedRam, openmsx::CheckedRam::clear(), and reset().
Read a byte from an IO port at a certain time from this device.
The default implementation returns 255.
Reimplemented from openmsx::MSXDevice.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 48 of file MSXMemoryMapperBase.cc.
References peekIO().
Referenced by openmsx::MusicalMemoryMapper::readIO().
Read a byte from a location at a certain time from this device.
The default implementation returns 255.
Reimplemented from openmsx::MSXDevice.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 84 of file MSXMemoryMapperBase.cc.
References calcAddress(), checkedRam, and openmsx::CheckedRam::read().
Referenced by openmsx::MusicalMemoryMapper::readMem().
|
overridevirtual |
This method is called on reset.
Default implementation does nothing.
Reimplemented from openmsx::MSXDevice.
Reimplemented in openmsx::MusicalMemoryMapper.
Definition at line 41 of file MSXMemoryMapperBase.cc.
References ranges::fill(), and registers.
Referenced by powerUp().
|
protected |
Definition at line 66 of file MSXMemoryMapperBase.cc.
References checkedRam, openmsx::CheckedRam::getSize(), and registers.
Referenced by calcAddress(), openmsx::MSXMemoryMapper::writeIO(), and openmsx::PanasonicRam::writeIO().
void openmsx::MSXMemoryMapperBase::serialize | ( | Archive & | ar, |
unsigned | version | ||
) |
Definition at line 128 of file MSXMemoryMapperBase.cc.
References checkedRam, openmsx::CheckedRam::getUncheckedRam(), and registers.
|
overridepure virtual |
Write a byte to a given IO port at a certain time to this device.
The default implementation ignores the write (does nothing)
Reimplemented from openmsx::MSXDevice.
Implemented in openmsx::PanasonicRam, openmsx::MusicalMemoryMapper, and openmsx::MSXMemoryMapper.
|
protected |
Definition at line 59 of file MSXMemoryMapperBase.cc.
References Math::ceil2(), checkedRam, openmsx::CheckedRam::getSize(), and registers.
Referenced by openmsx::MSXMemoryMapper::writeIO(), openmsx::MusicalMemoryMapper::writeIO(), openmsx::PanasonicRam::writeIO(), and openmsx::MusicalMemoryMapper::writeMem().
|
overridevirtual |
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.
Reimplemented in openmsx::PanasonicRam, and openmsx::MusicalMemoryMapper.
Definition at line 89 of file MSXMemoryMapperBase.cc.
References calcAddress(), checkedRam, and openmsx::CheckedRam::write().
Referenced by openmsx::MusicalMemoryMapper::writeMem().
|
protected |
Definition at line 53 of file MSXMemoryMapperBase.hh.
Referenced by getReadCacheLine(), getSizeInBlocks(), getWriteCacheLine(), openmsx::PanasonicRam::getWriteCacheLine(), openmsx::PanasonicRam::PanasonicRam(), peekIO(), peekMem(), powerUp(), readMem(), segmentOffset(), serialize(), openmsx::MSXMemoryMapper::writeIO(), openmsx::PanasonicRam::writeIO(), writeIOImpl(), writeMem(), and openmsx::PanasonicRam::writeMem().
|
protected |
Definition at line 54 of file MSXMemoryMapperBase.hh.
Referenced by getSelectedSegment(), peekIO(), reset(), openmsx::MusicalMemoryMapper::reset(), segmentOffset(), serialize(), and writeIOImpl().