#include <MSXMultiMemDevice.hh>

Inheritance diagram for openmsx::MSXMultiMemDevice:

[legend]

Collaboration diagram for openmsx::MSXMultiMemDevice:

[legend]

Public Member Functions
	MSXMultiMemDevice (const HardwareConfig &hwConf)

	~MSXMultiMemDevice () override

bool	canAdd (unsigned base, unsigned size)

void	add (MSXDevice &device, unsigned base, unsigned size)

void	remove (MSXDevice &device, unsigned base, unsigned size)

bool	empty () const

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

const std::string &	getName () const override
	Returns a human-readable name for this device.

void	getNameList (TclObject &result) const override
	Returns list of name(s) of this device.

byte	readMem (word address, EmuTime::param time) override
	Read a byte from a location at a certain time from this device.

byte	peekMem (word address, EmuTime::param time) const override
	Read a byte from a given memory location.

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.

const byte *	getReadCacheLine (word start) const override
	Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading.

byte *	getWriteCacheLine (word start) override
	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)

void	reset (EmuTime::param time) override
	This method is called on reset.

void	powerUp (EmuTime::param time) override
	This method is called when MSX is powered up.

void	powerDown (EmuTime::param time) override
	This method is called when MSX is powered down.

Public Member Functions inherited from openmsx::MSXDevice
	MSXDevice (const MSXDevice &)=delete

	MSXDevice (MSXDevice &&)=delete

MSXDevice &	operator= (const MSXDevice &)=delete

MSXDevice &	operator= (MSXDevice &&)=delete

virtual	~MSXDevice ()=0

const HardwareConfig &	getHardwareConfig () const
	Returns the hardwareconfig this device belongs to.

void	testRemove (std::span< const std::unique_ptr< MSXDevice > > removed) 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.

virtual void	globalRead (word address, EmuTime::param time)
	Global reads.

void	invalidateDeviceRWCache ()
	Calls MSXCPUInterface::invalidateXXCache() for the specific (part of) the slot that this device is located in.

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.

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.

const XMLElement &	getDeviceConfig () const
	Get the configuration section for this device.

const DeviceConfig &	getDeviceConfig2 () const

const Devices &	getReferences () const
	Get the device references that are specified for this device.

EmuTime::param	getCurrentTime () const

MSXCPU &	getCPU () const

MSXCPUInterface &	getCPUInterface () const

Scheduler &	getScheduler () const

MSXCliComm &	getCliComm () const

Reactor &	getReactor () const

CommandController &	getCommandController () const

PluggingController &	getPluggingController () const

LedStatus &	getLedStatus () const

template<typename Archive >
void	serialize (Archive &ar, unsigned version)

Additional Inherited Members
Public Types inherited from openmsx::MSXDevice
using	Devices = std::vector< MSXDevice * >

Static Public Attributes inherited from openmsx::MSXDevice
static std::array< byte, 0x10000 >	unmappedRead

static std::array< byte, 0x10000 >	unmappedWrite

Protected Member Functions inherited from openmsx::MSXDevice
	MSXDevice (const DeviceConfig &config, std::string_view 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 unsigned	getBaseSizeAlignment () const
	The 'base' and 'size' attribute values need to be at least aligned to CacheLine::SIZE.

virtual bool	allowUnaligned () const
	By default we don't allow unaligned <mem> specifications in the config file.

virtual void	getExtraDeviceInfo (TclObject &result) const

byte	getPrimarySlot () const

Protected Attributes inherited from openmsx::MSXDevice
std::string	deviceName

Detailed Description

Definition at line 9 of file MSXMultiMemDevice.hh.

Constructor & Destructor Documentation

◆ MSXMultiMemDevice()

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

explicit

Definition at line 19 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::getCPUInterface().

◆ ~MSXMultiMemDevice()

openmsx::MSXMultiMemDevice::~MSXMultiMemDevice ( )

override

Definition at line 26 of file MSXMultiMemDevice.cc.

References empty().

Member Function Documentation

◆ add()

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

Definition at line 50 of file MSXMultiMemDevice.cc.

References begin(), and canAdd().

◆ canAdd()

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

Definition at line 43 of file MSXMultiMemDevice.cc.

References view::drop_back(), and ranges::none_of().

Referenced by add().

◆ empty()

bool openmsx::MSXMultiMemDevice::empty ( ) const

inline

Definition at line 18 of file MSXMultiMemDevice.hh.

Referenced by ~MSXMultiMemDevice().

◆ getDevices()

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

Definition at line 61 of file MSXMultiMemDevice.cc.

References view::drop_back(), to_vector(), and view::transform().

◆ getName()

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

overridevirtual

Returns a human-readable name for this device.

Default implementation is normally ok.

Reimplemented from openmsx::MSXDevice.

Definition at line 67 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::deviceName, getNameList(), and openmsx::TclObject::getString().

◆ getNameList()

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

overridevirtual

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 74 of file MSXMultiMemDevice.cc.

References openmsx::TclObject::addListElement().

Referenced by getName().

◆ getReadCacheLine()

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

overridevirtual

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 111 of file MSXMultiMemDevice.cc.

References openmsx::CacheLine::HIGH.

◆ getWriteCacheLine()

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

overridevirtual

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 126 of file MSXMultiMemDevice.cc.

References openmsx::CacheLine::HIGH.

◆ peekMem()

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

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.

Definition at line 101 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::peekMem().

◆ readMem()

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

overridevirtual

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 96 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::readMem().

◆ remove()

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

Definition at line 56 of file MSXMultiMemDevice.cc.

References rfind_unguarded().

◆ writeMem()

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

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.

Definition at line 106 of file MSXMultiMemDevice.cc.

References openmsx::MSXDevice::writeMem().

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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MSXMultiMemDevice()

◆ ~MSXMultiMemDevice()

Member Function Documentation

◆ add()

◆ canAdd()

◆ empty()

◆ getDevices()

◆ getName()

◆ getNameList()

◆ getReadCacheLine()

◆ getWriteCacheLine()

◆ peekMem()

◆ readMem()

◆ remove()

◆ writeMem()