#include <MSXCPU.hh>

Inheritance diagram for openmsx::MSXCPU:

[legend]

Collaboration diagram for openmsx::MSXCPU:

[legend]

Public Types
enum class	Type { Z80 , R800 }

Public Member Functions
	MSXCPU (MSXMotherBoard &motherboard)

	~MSXCPU ()

void	doReset (EmuTime::param time)
	Reset CPU.

void	setActiveCPU (Type cpu)
	Switch between Z80/R800.

void	setDRAMmode (bool dram)
	Sets DRAM or ROM mode (influences memory access speed for R800).

void	updateVisiblePage (byte page, byte primarySlot, byte secondarySlot)
	Inform CPU of bank switch.

void	invalidateAllSlotsRWCache (word start, unsigned size)
	Invalidate the CPU its cache for the interval [start, start + size) For example MSXMemoryMapper and MSXGameCartridge need to call this method when a 'memory switch' occurs.

void	invalidateRWCache (unsigned start, unsigned size, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)
	Similar to the method above, but only invalidates one specific slot.

void	invalidateRCache (unsigned start, unsigned size, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)

void	invalidateWCache (unsigned start, unsigned size, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)

void	fillRWCache (unsigned start, unsigned size, const byte rData, byte wData, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)
	Fill the read and write cache lines for a specific slot with the specified value.

void	fillRCache (unsigned start, unsigned size, const byte *rData, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)

void	fillWCache (unsigned start, unsigned size, byte *wData, int ps, int ss, std::span< const byte, 256 > disallowRead, std::span< const byte, 256 > disallowWrite)

void	raiseIRQ ()
	This method raises a maskable interrupt.

void	lowerIRQ ()
	This methods lowers the maskable interrupt again.

void	raiseNMI ()
	This method raises a non-maskable interrupt.

void	lowerNMI ()
	This methods lowers the non-maskable interrupt again.

bool	isM1Cycle (unsigned address) const
	Should only be used from within a MSXDevice::readMem() method.

void	exitCPULoopSync ()
	See CPUCore::exitCPULoopSync()

void	exitCPULoopAsync ()
	See CPUCore::exitCPULoopAsync()

bool	isR800Active () const
	Is the R800 currently active?

void	setZ80Freq (unsigned freq)
	Switch the Z80 clock freq.

void	setInterface (MSXCPUInterface *interface)

void	setPaused (bool paused)
	(un)pause CPU.

void	setNextSyncPoint (EmuTime::param time)

void	wait (EmuTime::param time)

EmuTime	waitCyclesZ80 (EmuTime::param time, unsigned cycles)

EmuTime	waitCyclesR800 (EmuTime::param time, unsigned cycles)

CPURegs &	getRegisters ()

auto *	getZ80 ()

auto *	getR800 ()

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

Friends
class	MSXMotherBoard

Detailed Description

Definition at line 30 of file MSXCPU.hh.

Member Enumeration Documentation

◆ Type

enum class openmsx::MSXCPU::Type

strong

Enumerator
Z80
R800

Definition at line 33 of file MSXCPU.hh.

Constructor & Destructor Documentation

◆ MSXCPU()

openmsx::MSXCPU::MSXCPU ( MSXMotherBoard & motherboard )

explicit

Definition at line 25 of file MSXCPU.cc.

References openmsx::Subject< T >::attach(), openmsx::MSXMotherBoard::getDebugger(), openmsx::MSXMotherBoard::getScheduler(), openmsx::Debugger::setCPU(), and openmsx::Scheduler::setCPU().

◆ ~MSXCPU()

openmsx::MSXCPU::~MSXCPU ( )

Definition at line 64 of file MSXCPU.cc.

References openmsx::Subject< T >::detach(), openmsx::MSXMotherBoard::getDebugger(), openmsx::MSXMotherBoard::getScheduler(), openmsx::Debugger::setCPU(), and openmsx::Scheduler::setCPU().

Member Function Documentation

◆ doReset()

void openmsx::MSXCPU::doReset ( EmuTime::param time )

Reset CPU.

Requires CPU is not in the middle of an instruction, so exitCPULoop was called and execute() method returned.

Definition at line 84 of file MSXCPU.cc.

References invalidateAllSlotsRWCache().

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

◆ exitCPULoopAsync()

void openmsx::MSXCPU::exitCPULoopAsync ( )

See CPUCore::exitCPULoopAsync()

Definition at line 135 of file MSXCPU.cc.

Referenced by openmsx::MSXMotherBoard::exitCPULoopAsync().

◆ exitCPULoopSync()

void openmsx::MSXCPU::exitCPULoopSync ( )

See CPUCore::exitCPULoopSync()

Definition at line 130 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::doBreak(), openmsx::MSXMotherBoard::exitCPULoopSync(), and setActiveCPU().

◆ fillRCache()

void openmsx::MSXCPU::fillRCache	(	unsigned	start,
		unsigned	size,
		const byte *	rData,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Definition at line 280 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::fillRCache().

◆ fillRWCache()

void openmsx::MSXCPU::fillRWCache	(	unsigned	start,
		unsigned	size,
		const byte *	rData,
		byte *	wData,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Fill the read and write cache lines for a specific slot with the specified value.

Except for the lines where the corresponding 'disallow{Read,Write}' array is non-zero, those lines are marked non-cacheable. This is useful on e.g. a memory mapper bank switch because:

Marking the lines 'unknown' (as done by invalidateMemCache) is as much work as directly setting the correct value.
Directly setting the correct value saves work later on.

Definition at line 274 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::fillRWCache().

◆ fillWCache()

void openmsx::MSXCPU::fillWCache	(	unsigned	start,
		unsigned	size,
		byte *	wData,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Definition at line 286 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::fillWCache().

◆ getR800()

auto * openmsx::MSXCPU::getR800 ( )

inline

Definition at line 152 of file MSXCPU.hh.

Referenced by openmsx::ImGuiSettings::showMenu().

◆ getRegisters()

CPURegs & openmsx::MSXCPU::getRegisters ( )

Definition at line 343 of file MSXCPU.cc.

Referenced by openmsx::ImGuiDebugger::paint().

◆ getZ80()

auto * openmsx::MSXCPU::getZ80 ( )

inline

Definition at line 151 of file MSXCPU.hh.

Referenced by openmsx::ImGuiSettings::showMenu().

◆ invalidateAllSlotsRWCache()

void openmsx::MSXCPU::invalidateAllSlotsRWCache	(	word	start,
		unsigned	size
	)

Invalidate the CPU its cache for the interval [start, start + size) For example MSXMemoryMapper and MSXGameCartridge need to call this method when a 'memory switch' occurs.

Definition at line 185 of file MSXCPU.cc.

References ranges::fill(), openmsx::InvalidateAllSlots, openmsx::CacheLine::SIZE, subspan(), ProfileCounters< ENABLED, ENUM >::tick(), and xrange().

Referenced by openmsx::MSXCPUInterface::changeExpanded(), doReset(), openmsx::MSXCPUInterface::registerGlobalRead(), openmsx::MSXCPUInterface::registerGlobalWrite(), serialize(), openmsx::PanasonicMemory::setDRAM(), openmsx::MSXCPUInterface::unregisterGlobalRead(), openmsx::MSXCPUInterface::unregisterGlobalWrite(), and openmsx::CheckedRam::write().

◆ invalidateRCache()

void openmsx::MSXCPU::invalidateRCache	(	unsigned	start,
		unsigned	size,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Definition at line 259 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::invalidateRCache().

◆ invalidateRWCache()

void openmsx::MSXCPU::invalidateRWCache	(	unsigned	start,
		unsigned	size,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Similar to the method above, but only invalidates one specific slot.

One small tweak: lines that are in 'disallowRead/Write' are immediately marked as 'non-cacheable' instead of (first) as 'unknown'.

Definition at line 251 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::invalidateRWCache().

◆ invalidateWCache()

void openmsx::MSXCPU::invalidateWCache	(	unsigned	start,
		unsigned	size,
		int	ps,
		int	ss,
		std::span< const byte, 256 >	disallowRead,
		std::span< const byte, 256 >	disallowWrite
	)

Definition at line 266 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::invalidateWCache().

◆ isM1Cycle()

bool openmsx::MSXCPU::isM1Cycle ( unsigned address ) const

Should only be used from within a MSXDevice::readMem() method.

Returns true if that read was the first byte of an instruction (the Z80 M1 pin is active). This implementation is not 100% accurate, but good enough for now.

Definition at line 314 of file MSXCPU.cc.

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

◆ isR800Active()

bool openmsx::MSXCPU::isR800Active ( ) const

inline

Is the R800 currently active?

Definition at line 132 of file MSXCPU.hh.

◆ lowerIRQ()

void openmsx::MSXCPU::lowerIRQ ( )

This methods lowers the maskable interrupt again.

A device may never call this method more often than it called the method raiseIRQ(). Before using this method take a look at IRQHelper.

Definition at line 298 of file MSXCPU.cc.

Referenced by openmsx::IRQSource::lower(), and openmsx::OptionalIRQ::lower().

◆ lowerNMI()

void openmsx::MSXCPU::lowerNMI ( )

This methods lowers the non-maskable interrupt again.

A device may never call this method more often than it called the method raiseNMI(). Before using this method take a look at IRQHelper.

Definition at line 308 of file MSXCPU.cc.

Referenced by openmsx::OptionalIRQ::lower().

◆ raiseIRQ()

void openmsx::MSXCPU::raiseIRQ ( )

This method raises a maskable interrupt.

A device may call this method more than once. If the device wants to lower the interrupt again it must call the lowerIRQ() method exactly as many times. Before using this method take a look at IRQHelper.

Definition at line 293 of file MSXCPU.cc.

Referenced by openmsx::IRQSource::raise(), and openmsx::OptionalIRQ::raise().

◆ raiseNMI()

void openmsx::MSXCPU::raiseNMI ( )

This method raises a non-maskable interrupt.

A device may call this method more than once. If the device wants to lower the interrupt again it must call the lowerNMI() method exactly as many times. Before using this method take a look at IRQHelper.

Definition at line 303 of file MSXCPU.cc.

Referenced by openmsx::OptionalIRQ::raise().

◆ serialize()

template<typename Archive >

void openmsx::MSXCPU::serialize	(	Archive &	ar,
		unsigned	version
	)

Definition at line 526 of file MSXCPU.cc.

References invalidateAllSlotsRWCache().

◆ setActiveCPU()

void openmsx::MSXCPU::setActiveCPU ( Type cpu )

Switch between Z80/R800.

Definition at line 94 of file MSXCPU.cc.

References exitCPULoopSync(), R800, and Z80.

◆ setDRAMmode()

void openmsx::MSXCPU::setDRAMmode ( bool dram )

Sets DRAM or ROM mode (influences memory access speed for R800).

Definition at line 105 of file MSXCPU.cc.

◆ setInterface()

void openmsx::MSXCPU::setInterface ( MSXCPUInterface * interface )

Definition at line 77 of file MSXCPU.cc.

Referenced by openmsx::MSXCPUInterface::MSXCPUInterface(), and openmsx::MSXCPUInterface::~MSXCPUInterface().

◆ setNextSyncPoint()

void openmsx::MSXCPU::setNextSyncPoint ( EmuTime::param time )

Definition at line 147 of file MSXCPU.cc.

◆ setPaused()

void openmsx::MSXCPU::setPaused ( bool paused )

(un)pause CPU.

During pause the CPU executes NOP instructions continuously (just like during HALT). Used by turbor hw pause.

Definition at line 359 of file MSXCPU.cc.

Referenced by openmsx::MSXMotherBoard::pause(), and openmsx::MSXMotherBoard::unpause().

◆ setZ80Freq()

void openmsx::MSXCPU::setZ80Freq ( unsigned freq )

Switch the Z80 clock freq.

Definition at line 320 of file MSXCPU.cc.

Referenced by openmsx::MSXCielTurbo::writeIO(), and openmsx::MSXMatsushita::writeSwitchedIO().

◆ updateVisiblePage()

void openmsx::MSXCPU::updateVisiblePage	(	byte	page,
		byte	primarySlot,
		byte	secondarySlot
	)

Inform CPU of bank switch.

This will invalidate memory cache and update memory timings on R800.

Definition at line 164 of file MSXCPU.cc.

References openmsx::CacheLine::SIZE.

◆ wait()

void openmsx::MSXCPU::wait ( EmuTime::param time )

Definition at line 325 of file MSXCPU.cc.

◆ waitCyclesR800()

EmuTime openmsx::MSXCPU::waitCyclesR800	(	EmuTime::param	time,
		unsigned	cycles
	)

Definition at line 337 of file MSXCPU.cc.

Referenced by openmsx::TurboRFDC::readMem(), and openmsx::TurboRFDC::writeMem().

◆ waitCyclesZ80()

EmuTime openmsx::MSXCPU::waitCyclesZ80	(	EmuTime::param	time,
		unsigned	cycles
	)

Definition at line 331 of file MSXCPU.cc.

Referenced by openmsx::VDP::writeIO().

Friends And Related Symbol Documentation

◆ MSXMotherBoard

friend class MSXMotherBoard

friend

Definition at line 162 of file MSXCPU.hh.

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

Public Types

Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ Type

Constructor & Destructor Documentation

◆ MSXCPU()

◆ ~MSXCPU()

Member Function Documentation

◆ doReset()

◆ exitCPULoopAsync()

◆ exitCPULoopSync()

◆ fillRCache()

◆ fillRWCache()

◆ fillWCache()

◆ getR800()

◆ getRegisters()

◆ getZ80()

◆ invalidateAllSlotsRWCache()

◆ invalidateRCache()

◆ invalidateRWCache()

◆ invalidateWCache()

◆ isM1Cycle()

◆ isR800Active()

◆ lowerIRQ()

◆ lowerNMI()

◆ raiseIRQ()

◆ raiseNMI()

◆ serialize()

◆ setActiveCPU()

◆ setDRAMmode()

◆ setInterface()

◆ setNextSyncPoint()

◆ setPaused()

◆ setZ80Freq()

◆ updateVisiblePage()

◆ wait()

◆ waitCyclesR800()

◆ waitCyclesZ80()

Friends And Related Symbol Documentation

◆ MSXMotherBoard