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

#include <MSXCPUInterface.hh>

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 primSl, int secSL, int base, int size)
 Devices can register themself in the MSX slotstructure. More...
 
void unregisterMemDevice (MSXDevice &device, int primSl, int secSL, 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)
 
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 isExpanded)
 
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)
 

Static Public Member Functions

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

Detailed Description

Definition at line 40 of file MSXCPUInterface.hh.

Member Typedef Documentation

◆ BreakPoints

Definition at line 218 of file MSXCPUInterface.hh.

◆ Conditions

Definition at line 229 of file MSXCPUInterface.hh.

◆ WatchPoints

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

Definition at line 224 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 244 of file MSXCPUInterface.hh.

◆ changeExpanded()

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

◆ checkBreakPoints()

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

Definition at line 248 of file MSXCPUInterface.hh.

References begin(), and end().

Referenced by removeBreakPoint().

◆ cleanup()

void openmsx::MSXCPUInterface::cleanup ( )
static

Definition at line 969 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 942 of file MSXCPUInterface.cc.

References isFastForward().

◆ getBreakPoints()

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

Definition at line 219 of file MSXCPUInterface.hh.

◆ getConditions()

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

Definition at line 230 of file MSXCPUInterface.hh.

◆ getDummyDevice()

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

Definition at line 214 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 160 of file MSXCPUInterface.hh.

References unlikely.

◆ getWatchPoints()

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

Definition at line 225 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 179 of file MSXCPUInterface.hh.

References unlikely.

◆ insertBreakPoint()

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

Definition at line 734 of file MSXCPUInterface.cc.

References begin(), and end().

◆ isBreaked()

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

Definition at line 232 of file MSXCPUInterface.hh.

◆ isContinue()

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

Definition at line 240 of file MSXCPUInterface.hh.

◆ isExpanded()

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

◆ isFastForward()

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

Definition at line 267 of file MSXCPUInterface.hh.

References openmsx::serialize().

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

◆ isStep()

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

Definition at line 238 of file MSXCPUInterface.hh.

◆ 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 673 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 682 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 136 of file MSXCPUInterface.hh.

◆ 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 607 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 114 of file MSXCPUInterface.hh.

References unlikely.

◆ readSlottedMem()

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

Definition at line 699 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 
)

◆ 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  primSl,
int  secSL,
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 496 of file MSXCPUInterface.cc.

References isExpanded(), and gl::min().

Referenced by openmsx::MSXDevice::getPluggingController().

◆ removeBreakPoint()

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

◆ removeCondition()

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

◆ 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 392 of file MSXCPUInterface.cc.

◆ replace_IO_Out()

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

◆ reset()

void openmsx::MSXCPUInterface::reset ( )

Reset (the slot state)

Definition at line 599 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 1189 of file MSXCPUInterface.cc.

References setPrimarySlots().

◆ setCondition()

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

Definition at line 819 of file MSXCPUInterface.cc.

◆ setContinue()

static void openmsx::MSXCPUInterface::setContinue ( bool  x)
inlinestatic

Definition at line 241 of file MSXCPUInterface.hh.

◆ setExpanded()

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

Definition at line 230 of file MSXCPUInterface.cc.

References changeExpanded(), and isExpanded().

Referenced by openmsx::HardwareConfig::createDevices().

◆ setFastForward()

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

Definition at line 266 of file MSXCPUInterface.hh.

◆ setPrimarySlots()

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

Definition at line 612 of file MSXCPUInterface.cc.

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

Referenced by reset(), serialize(), and openmsx::MSXPPI::writeIO().

◆ setStep()

static void openmsx::MSXCPUInterface::setStep ( bool  x)
inlinestatic

Definition at line 239 of file MSXCPUInterface.hh.

◆ setWatchPoint()

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

◆ testUnsetExpanded()

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

Definition at line 244 of file MSXCPUInterface.cc.

References begin(), end(), isExpanded(), strAppend(), and strCat().

Referenced by openmsx::HardwareConfig::testRemove(), and unsetExpanded().

◆ 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  primSl,
int  secSL,
int  base,
int  size 
)

Definition at line 526 of file MSXCPUInterface.cc.

References gl::min().

Referenced by openmsx::MSXDevice::getPluggingController().

◆ 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 144 of file MSXCPUInterface.hh.

◆ writeMem()

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

This writes a byte to the currently selected device.

Definition at line 124 of file MSXCPUInterface.hh.

References unlikely.

◆ writeSlottedMem()

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

Definition at line 716 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: