openMSX
Classes | Public Types | Public Member Functions | Static Public Member Functions | List of all members
openmsx::MSXCPUInterface Class Reference

#include <MSXCPUInterface.hh>

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

Public Types

using BreakPoints = std::vector< BreakPoint >
 
using WatchPoints = std::vector< std::shared_ptr< WatchPoint > >
 
using Conditions = std::vector< DebugCondition >
 

Public Member Functions

 MSXCPUInterface (const MSXCPUInterface &)=delete
 
MSXCPUInterfaceoperator= (const MSXCPUInterface &)=delete
 
 MSXCPUInterface (MSXMotherBoard &motherBoard)
 
 ~MSXCPUInterface ()
 
void register_IO_In (byte port, MSXDevice *device)
 Devices can register their In ports. More...
 
void unregister_IO_In (byte port, MSXDevice *device)
 
void register_IO_Out (byte port, MSXDevice *device)
 Devices can register their Out ports. More...
 
void unregister_IO_Out (byte port, MSXDevice *device)
 
bool replace_IO_In (byte port, MSXDevice *oldDevice, MSXDevice *newDevice)
 These methods replace a previously registered device with a new one. More...
 
bool replace_IO_Out (byte port, MSXDevice *oldDevice, MSXDevice *newDevice)
 
void registerMemDevice (MSXDevice &device, int ps, int ss, int base, int size)
 Devices can register themself in the MSX slotstructure. More...
 
void unregisterMemDevice (MSXDevice &device, int ps, int ss, int base, int size)
 
void registerGlobalWrite (MSXDevice &device, word address)
 (Un)register global writes. More...
 
void unregisterGlobalWrite (MSXDevice &device, word address)
 
void registerGlobalRead (MSXDevice &device, word address)
 (Un)register global read. More...
 
void unregisterGlobalRead (MSXDevice &device, word address)
 
void reset ()
 Reset (the slot state) More...
 
byte readMem (word address, EmuTime::param time)
 This reads a byte from the currently selected device. More...
 
void writeMem (word address, byte value, EmuTime::param time)
 This writes a byte to the currently selected device. More...
 
byte readIO (word port, EmuTime::param time)
 This read a byte from the given IO-port. More...
 
void writeIO (word port, byte value, EmuTime::param time)
 This writes a byte to the given IO-port. More...
 
const bytegetReadCacheLine (word start) const
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading. More...
 
bytegetWriteCacheLine (word start) const
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing. More...
 
byte readIRQVector ()
 CPU uses this method to read 'extra' data from the databus used in interrupt routines. More...
 
void setPrimarySlots (byte value)
 
void invalidateRWCache (word start, unsigned size, int ps, int ss)
 
void invalidateRCache (word start, unsigned size, int ps, int ss)
 
void invalidateWCache (word start, unsigned size, int ps, int ss)
 
void fillRWCache (unsigned start, unsigned size, const byte *rData, byte *wData, int ps, int ss)
 
void fillRCache (unsigned start, unsigned size, const byte *rData, int ps, int ss)
 
void fillWCache (unsigned start, unsigned size, byte *wData, int ps, int ss)
 
byte peekMem (word address, EmuTime::param time) const
 Peek memory location. More...
 
byte peekSlottedMem (unsigned address, EmuTime::param time) const
 
byte readSlottedMem (unsigned address, EmuTime::param time)
 
void writeSlottedMem (unsigned address, byte value, EmuTime::param time)
 
void setExpanded (int ps)
 
void unsetExpanded (int ps)
 
void testUnsetExpanded (int ps, std::vector< MSXDevice * > allowed) const
 
bool isExpanded (int ps) const
 
void changeExpanded (bool newExpanded)
 
DummyDevicegetDummyDevice ()
 
void setWatchPoint (const std::shared_ptr< WatchPoint > &watchPoint)
 
void removeWatchPoint (std::shared_ptr< WatchPoint > watchPoint)
 
const WatchPointsgetWatchPoints () const
 
void doBreak ()
 
void doStep ()
 
void doContinue ()
 
void setFastForward (bool fastForward_)
 
bool isFastForward () const
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 
- Public Member Functions inherited from ProfileCounters< PROFILE_CACHELINES, CacheLineCounters >
 ~ProfileCounters ()
 
void tick (CacheLineCounters e) const
 

Static Public Member Functions

static void insertBreakPoint (BreakPoint bp)
 
static void removeBreakPoint (const BreakPoint &bp)
 
static const BreakPointsgetBreakPoints ()
 
static void setCondition (DebugCondition cond)
 
static void removeCondition (const DebugCondition &cond)
 
static const ConditionsgetConditions ()
 
static bool isBreaked ()
 
static bool anyBreakPoints ()
 
static bool checkBreakPoints (unsigned pc, MSXMotherBoard &motherBoard)
 
static void cleanup ()
 

Detailed Description

Definition at line 63 of file MSXCPUInterface.hh.

Member Typedef Documentation

◆ BreakPoints

Definition at line 255 of file MSXCPUInterface.hh.

◆ Conditions

Definition at line 266 of file MSXCPUInterface.hh.

◆ WatchPoints

using openmsx::MSXCPUInterface::WatchPoints = std::vector<std::shared_ptr<WatchPoint> >

Definition at line 261 of file MSXCPUInterface.hh.

Constructor & Destructor Documentation

◆ MSXCPUInterface() [1/2]

openmsx::MSXCPUInterface::MSXCPUInterface ( const MSXCPUInterface )
delete

◆ MSXCPUInterface() [2/2]

openmsx::MSXCPUInterface::MSXCPUInterface ( MSXMotherBoard motherBoard)
explicit

◆ ~MSXCPUInterface()

openmsx::MSXCPUInterface::~MSXCPUInterface ( )

Member Function Documentation

◆ anyBreakPoints()

static bool openmsx::MSXCPUInterface::anyBreakPoints ( )
inlinestatic

Definition at line 275 of file MSXCPUInterface.hh.

◆ changeExpanded()

void openmsx::MSXCPUInterface::changeExpanded ( bool  newExpanded)

◆ checkBreakPoints()

static bool openmsx::MSXCPUInterface::checkBreakPoints ( unsigned  pc,
MSXMotherBoard motherBoard 
)
inlinestatic

Definition at line 279 of file MSXCPUInterface.hh.

References ranges::equal_range(), and isBreaked().

◆ cleanup()

void openmsx::MSXCPUInterface::cleanup ( )
static

Definition at line 1036 of file MSXCPUInterface.cc.

Referenced by openmsx::Interpreter::~Interpreter().

◆ doBreak()

void openmsx::MSXCPUInterface::doBreak ( )

◆ doContinue()

void openmsx::MSXCPUInterface::doContinue ( )

◆ doStep()

void openmsx::MSXCPUInterface::doStep ( )

Definition at line 1014 of file MSXCPUInterface.cc.

References doContinue(), isFastForward(), and setCondition().

◆ fillRCache()

void openmsx::MSXCPUInterface::fillRCache ( unsigned  start,
unsigned  size,
const byte rData,
int  ps,
int  ss 
)

◆ fillRWCache()

void openmsx::MSXCPUInterface::fillRWCache ( unsigned  start,
unsigned  size,
const byte rData,
byte wData,
int  ps,
int  ss 
)

◆ fillWCache()

void openmsx::MSXCPUInterface::fillWCache ( unsigned  start,
unsigned  size,
byte wData,
int  ps,
int  ss 
)

◆ getBreakPoints()

static const BreakPoints& openmsx::MSXCPUInterface::getBreakPoints ( )
inlinestatic

Definition at line 256 of file MSXCPUInterface.hh.

◆ getConditions()

static const Conditions& openmsx::MSXCPUInterface::getConditions ( )
inlinestatic

Definition at line 267 of file MSXCPUInterface.hh.

◆ getDummyDevice()

DummyDevice& openmsx::MSXCPUInterface::getDummyDevice ( )
inline

Definition at line 251 of file MSXCPUInterface.hh.

Referenced by openmsx::VDPIODelay::VDPIODelay().

◆ getReadCacheLine()

const byte* openmsx::MSXCPUInterface::getReadCacheLine ( word  start) const
inline

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. An interval will never cross a 16KB border. An interval will never contain the address 0xffff.

Definition at line 185 of file MSXCPUInterface.hh.

References openmsx::CacheLine::BITS, openmsx::GetReadCacheLine, openmsx::MSXDevice::getReadCacheLine(), ProfileCounters< PROFILE_CACHELINES, CacheLineCounters >::tick(), and unlikely.

◆ getWatchPoints()

const WatchPoints& openmsx::MSXCPUInterface::getWatchPoints ( ) const
inline

Definition at line 262 of file MSXCPUInterface.hh.

Referenced by openmsx::Debugger::transfer().

◆ getWriteCacheLine()

byte* openmsx::MSXCPUInterface::getWriteCacheLine ( word  start) const
inline

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. An interval will never cross a 16KB border. An interval will never contain the address 0xffff.

Definition at line 205 of file MSXCPUInterface.hh.

References openmsx::CacheLine::BITS, openmsx::GetWriteCacheLine, openmsx::MSXDevice::getWriteCacheLine(), ProfileCounters< PROFILE_CACHELINES, CacheLineCounters >::tick(), and unlikely.

◆ insertBreakPoint()

void openmsx::MSXCPUInterface::insertBreakPoint ( BreakPoint  bp)
static

Definition at line 783 of file MSXCPUInterface.cc.

References ranges::upper_bound().

◆ invalidateRCache()

void openmsx::MSXCPUInterface::invalidateRCache ( word  start,
unsigned  size,
int  ps,
int  ss 
)

◆ invalidateRWCache()

void openmsx::MSXCPUInterface::invalidateRWCache ( word  start,
unsigned  size,
int  ps,
int  ss 
)

◆ invalidateWCache()

void openmsx::MSXCPUInterface::invalidateWCache ( word  start,
unsigned  size,
int  ps,
int  ss 
)

◆ isBreaked()

static bool openmsx::MSXCPUInterface::isBreaked ( )
inlinestatic

Definition at line 269 of file MSXCPUInterface.hh.

Referenced by checkBreakPoints().

◆ isExpanded()

bool openmsx::MSXCPUInterface::isExpanded ( int  ps) const
inline

◆ isFastForward()

bool openmsx::MSXCPUInterface::isFastForward ( ) const
inline

Definition at line 297 of file MSXCPUInterface.hh.

Referenced by doBreak(), doContinue(), and doStep().

◆ operator=()

MSXCPUInterface& openmsx::MSXCPUInterface::operator= ( const MSXCPUInterface )
delete

◆ peekMem()

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

Peek memory location.

See also
MSXDevice::peekMem()

Definition at line 722 of file MSXCPUInterface.cc.

References isExpanded(), and openmsx::MSXDevice::peekMem().

Referenced by openmsx::dasm().

◆ peekSlottedMem()

byte openmsx::MSXCPUInterface::peekSlottedMem ( unsigned  address,
EmuTime::param  time 
) const

Definition at line 731 of file MSXCPUInterface.cc.

References isExpanded(), and openmsx::MSXDevice::peekMem().

Referenced by openmsx::MSXMirrorDevice::peekMem().

◆ readIO()

byte openmsx::MSXCPUInterface::readIO ( word  port,
EmuTime::param  time 
)
inline

This read a byte from the given IO-port.

See also
MSXDevice::readIO()

Definition at line 161 of file MSXCPUInterface.hh.

References openmsx::MSXDevice::readIO().

◆ readIRQVector()

byte openmsx::MSXCPUInterface::readIRQVector ( )

CPU uses this method to read 'extra' data from the databus used in interrupt routines.

In MSX this returns always 255.

Definition at line 656 of file MSXCPUInterface.cc.

References openmsx::MSXMotherBoard::readIRQVector().

◆ readMem()

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

This reads a byte from the currently selected device.

Definition at line 137 of file MSXCPUInterface.hh.

References openmsx::CacheLine::BITS, openmsx::MSXDevice::readMem(), openmsx::SlowRead, ProfileCounters< PROFILE_CACHELINES, CacheLineCounters >::tick(), and unlikely.

◆ readSlottedMem()

byte openmsx::MSXCPUInterface::readSlottedMem ( unsigned  address,
EmuTime::param  time 
)

Definition at line 748 of file MSXCPUInterface.cc.

References isExpanded(), and openmsx::MSXDevice::peekMem().

Referenced by openmsx::MSXMirrorDevice::readMem().

◆ register_IO_In()

void openmsx::MSXCPUInterface::register_IO_In ( byte  port,
MSXDevice device 
)

Devices can register their In ports.

This is normally done in their constructor. Once device are registered, their readIO() method can get called.

Definition at line 338 of file MSXCPUInterface.cc.

Referenced by openmsx::ColecoSuperGameModule::ColecoSuperGameModule(), openmsx::MSXMotherBoard::createMapperIO(), openmsx::MSXDeviceSwitch::registerDevice(), openmsx::RomArc::RomArc(), openmsx::RomKonamiKeyboardMaster::RomKonamiKeyboardMaster(), and openmsx::RomManbow2::RomManbow2().

◆ register_IO_Out()

void openmsx::MSXCPUInterface::register_IO_Out ( byte  port,
MSXDevice device 
)

◆ registerGlobalRead()

void openmsx::MSXCPUInterface::registerGlobalRead ( MSXDevice device,
word  address 
)

◆ registerGlobalWrite()

void openmsx::MSXCPUInterface::registerGlobalWrite ( MSXDevice device,
word  address 
)

◆ registerMemDevice()

void openmsx::MSXCPUInterface::registerMemDevice ( MSXDevice device,
int  ps,
int  ss,
int  base,
int  size 
)

Devices can register themself in the MSX slotstructure.

This is normally done in their constructor. Once devices are registered their readMem() / writeMem() methods can get called.

Definition at line 513 of file MSXCPUInterface.cc.

References isExpanded(), gl::min(), and utf8::unchecked::size().

◆ removeBreakPoint()

void openmsx::MSXCPUInterface::removeBreakPoint ( const BreakPoint bp)
static

◆ removeCondition()

void openmsx::MSXCPUInterface::removeCondition ( const DebugCondition cond)
static

Definition at line 917 of file MSXCPUInterface.cc.

References rfind_if_unguarded().

◆ removeWatchPoint()

void openmsx::MSXCPUInterface::removeWatchPoint ( std::shared_ptr< WatchPoint watchPoint)

◆ replace_IO_In()

bool openmsx::MSXCPUInterface::replace_IO_In ( byte  port,
MSXDevice oldDevice,
MSXDevice newDevice 
)

These methods replace a previously registered device with a new one.

This method checks whether the current device is the same as the 'oldDevice' parameter.

  • If it's the same, the current device is replace with 'newDevice' and this method returns true.
  • If it's not the same, then no changes are made and this method returns false.

The intention is that devices using these methods extend (=wrap) the functionality of a previously registered device. Typically the destructor of the wrapping device will perform the inverse replacement.

Definition at line 407 of file MSXCPUInterface.cc.

◆ replace_IO_Out()

bool openmsx::MSXCPUInterface::replace_IO_Out ( byte  port,
MSXDevice oldDevice,
MSXDevice newDevice 
)

Definition at line 418 of file MSXCPUInterface.cc.

◆ reset()

void openmsx::MSXCPUInterface::reset ( )

Reset (the slot state)

Definition at line 648 of file MSXCPUInterface.cc.

References setPrimarySlots().

Referenced by openmsx::MSXMotherBoard::doReset(), MSXCPUInterface(), and openmsx::MSXMotherBoard::powerUp().

◆ serialize()

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

Definition at line 1249 of file MSXCPUInterface.cc.

References setPrimarySlots().

◆ setCondition()

void openmsx::MSXCPUInterface::setCondition ( DebugCondition  cond)
static

Definition at line 912 of file MSXCPUInterface.cc.

Referenced by doStep().

◆ setExpanded()

void openmsx::MSXCPUInterface::setExpanded ( int  ps)

Definition at line 245 of file MSXCPUInterface.cc.

References changeExpanded(), and isExpanded().

◆ setFastForward()

void openmsx::MSXCPUInterface::setFastForward ( bool  fastForward_)
inline

Definition at line 296 of file MSXCPUInterface.hh.

◆ setPrimarySlots()

void openmsx::MSXCPUInterface::setPrimarySlots ( byte  value)

Definition at line 661 of file MSXCPUInterface.cc.

References changeExpanded(), isExpanded(), and unlikely.

Referenced by reset(), and serialize().

◆ setWatchPoint()

void openmsx::MSXCPUInterface::setWatchPoint ( const std::shared_ptr< WatchPoint > &  watchPoint)

◆ testUnsetExpanded()

void openmsx::MSXCPUInterface::testUnsetExpanded ( int  ps,
std::vector< MSXDevice * >  allowed 
) const

◆ unregister_IO_In()

void openmsx::MSXCPUInterface::unregister_IO_In ( byte  port,
MSXDevice device 
)

◆ unregister_IO_Out()

void openmsx::MSXCPUInterface::unregister_IO_Out ( byte  port,
MSXDevice device 
)

◆ unregisterGlobalRead()

void openmsx::MSXCPUInterface::unregisterGlobalRead ( MSXDevice device,
word  address 
)

◆ unregisterGlobalWrite()

void openmsx::MSXCPUInterface::unregisterGlobalWrite ( MSXDevice device,
word  address 
)

◆ unregisterMemDevice()

void openmsx::MSXCPUInterface::unregisterMemDevice ( MSXDevice device,
int  ps,
int  ss,
int  base,
int  size 
)

Definition at line 543 of file MSXCPUInterface.cc.

References gl::min(), and utf8::unchecked::size().

◆ unsetExpanded()

void openmsx::MSXCPUInterface::unsetExpanded ( int  ps)

◆ writeIO()

void openmsx::MSXCPUInterface::writeIO ( word  port,
byte  value,
EmuTime::param  time 
)
inline

This writes a byte to the given IO-port.

See also
MSXDevice::writeIO()

Definition at line 169 of file MSXCPUInterface.hh.

References openmsx::MSXDevice::writeIO().

◆ writeMem()

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

◆ writeSlottedMem()

void openmsx::MSXCPUInterface::writeSlottedMem ( unsigned  address,
byte  value,
EmuTime::param  time 
)

Definition at line 765 of file MSXCPUInterface.cc.

References isExpanded(), and openmsx::MSXDevice::writeMem().

Referenced by openmsx::MSXMirrorDevice::writeMem().


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