#include <MSXMotherBoard.hh>

Public Types
using	Extensions = std::vector< std::unique_ptr< HardwareConfig > >

Public Member Functions
	MSXMotherBoard (const MSXMotherBoard &)=delete

MSXMotherBoard &	operator= (const MSXMotherBoard &)=delete

	MSXMotherBoard (Reactor &reactor)

	~MSXMotherBoard ()

string_view	getMachineID () const

string_view	getMachineName () const

bool	execute ()
	Run emulation. More...

void	fastForward (EmuTime::param time, bool fast)
	Run emulation until a certain time in fast forward mode. More...

void	exitCPULoopAsync ()
	See CPU::exitCPULoopAsync(). More...

void	exitCPULoopSync ()

void	pause ()
	Pause MSX machine. More...

void	unpause ()

void	powerUp ()

void	doReset ()

void	activate (bool active)

bool	isActive () const

bool	isFastForwarding () const

byte	readIRQVector ()

const HardwareConfig *	getMachineConfig () const

void	setMachineConfig (HardwareConfig *machineConfig)

std::string	getMachineType () const

bool	isTurboR () const

std::string	loadMachine (const std::string &machine)

const Extensions &	getExtensions () const

HardwareConfig *	findExtension (string_view extensionName)

std::string	loadExtension (string_view extensionName, string_view slotname)

std::string	insertExtension (string_view name, std::unique_ptr< HardwareConfig > extension)

void	removeExtension (const HardwareConfig &extension)

CliComm &	getMSXCliComm ()

MSXCommandController &	getMSXCommandController ()

Scheduler &	getScheduler ()

MSXEventDistributor &	getMSXEventDistributor ()

StateChangeDistributor &	getStateChangeDistributor ()

CartridgeSlotManager &	getSlotManager ()

RealTime &	getRealTime ()

Debugger &	getDebugger ()

MSXMixer &	getMSXMixer ()

PluggingController &	getPluggingController ()

MSXCPU &	getCPU ()

MSXCPUInterface &	getCPUInterface ()

PanasonicMemory &	getPanasonicMemory ()

MSXDeviceSwitch &	getDeviceSwitch ()

CassettePortInterface &	getCassettePort ()

JoystickPortIf &	getJoystickPort (unsigned port)

RenShaTurbo &	getRenShaTurbo ()

LedStatus &	getLedStatus ()

ReverseManager &	getReverseManager ()

Reactor &	getReactor ()

VideoSourceSetting &	getVideoSource ()

CommandController &	getCommandController ()

InfoCommand &	getMachineInfoCommand ()

EmuTime::param	getCurrentTime ()
	Convenience method: This is the same as getScheduler().getCurrentTime(). More...

void	addDevice (MSXDevice &device)
	All MSXDevices should be registered by the MotherBoard. More...

void	removeDevice (MSXDevice &device)

MSXDevice *	findDevice (string_view name)
	Find a MSXDevice by name. More...

template<typename T , typename ... Args>
std::shared_ptr< T >	getSharedStuff (string_view name, Args &&...args)
	Some MSX device parts are shared between several MSX devices (e.g. More...

MSXMapperIO &	createMapperIO ()
	All memory mappers in one MSX machine share the same four (logical) memory mapper registers. More...

MSXMapperIO &	getMapperIO () const

void	destroyMapperIO ()

std::string	getUserName (const std::string &hwName)
	Keep track of which 'usernames' are in use. More...

void	freeUserName (const std::string &hwName, const std::string &userName)

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

Friends
class	DeviceInfo

class	SettingObserver

Detailed Description

Definition at line 59 of file MSXMotherBoard.hh.

Member Typedef Documentation

◆ Extensions

using openmsx::MSXMotherBoard::Extensions = std::vector<std::unique_ptr<HardwareConfig> >

Definition at line 107 of file MSXMotherBoard.hh.

Constructor & Destructor Documentation

◆ MSXMotherBoard() [1/2]

openmsx::MSXMotherBoard::MSXMotherBoard ( const MSXMotherBoard & )

delete

◆ MSXMotherBoard() [2/2]

openmsx::MSXMotherBoard::MSXMotherBoard ( Reactor & reactor )

explicit

Definition at line 177 of file MSXMotherBoard.cc.

References openmsx::Subject< T >::attach(), openmsx::Reactor::getEventDistributor(), and openmsx::Reactor::getGlobalSettings().

◆ ~MSXMotherBoard()

openmsx::MSXMotherBoard::~MSXMotherBoard ( )

Definition at line 232 of file MSXMotherBoard.cc.

References openmsx::Subject< T >::detach(), getMachineConfig(), openmsx::MSXException::getMessage(), removeExtension(), and UNREACHABLE.

Member Function Documentation

◆ activate()

void openmsx::MSXMotherBoard::activate ( bool active )

Definition at line 625 of file MSXMotherBoard.cc.

References openmsx::OPENMSX_MACHINE_ACTIVATED, and openmsx::OPENMSX_MACHINE_DEACTIVATED.

Referenced by getMachineName(), and openmsx::Reactor::switchMachine().

◆ addDevice()

void openmsx::MSXMotherBoard::addDevice ( MSXDevice & device )

All MSXDevices should be registered by the MotherBoard.

Definition at line 540 of file MSXMotherBoard.cc.

Referenced by openmsx::HardwareConfig::createDevices(), and getVideoSource().

◆ createMapperIO()

MSXMapperIO & openmsx::MSXMotherBoard::createMapperIO ( )

All memory mappers in one MSX machine share the same four (logical) memory mapper registers.

These two methods handle this sharing.

Definition at line 655 of file MSXMotherBoard.cc.

References openmsx::DeviceFactory::createMapperIO(), getCPUInterface(), getMachineConfig(), openmsx::MSXCPUInterface::register_IO_In(), and openmsx::MSXCPUInterface::register_IO_Out().

Referenced by getSharedStuff().

◆ destroyMapperIO()

void openmsx::MSXMotherBoard::destroyMapperIO ( )

Definition at line 674 of file MSXMotherBoard.cc.

References getCPUInterface(), openmsx::MSXCPUInterface::unregister_IO_In(), and openmsx::MSXCPUInterface::unregister_IO_Out().

Referenced by getMapperIO().

◆ doReset()

void openmsx::MSXMotherBoard::doReset ( )

Definition at line 550 of file MSXMotherBoard.cc.

References openmsx::EventDistributor::distributeEvent(), openmsx::MSXCPU::doReset(), getCPU(), getCPUInterface(), getCurrentTime(), openmsx::Reactor::getEventDistributor(), getMachineConfig(), openmsx::OPENMSX_BOOT_EVENT, and openmsx::MSXCPUInterface::reset().

Referenced by openmsx::ResetCmd::execute(), and getMachineName().

◆ execute()

bool openmsx::MSXMotherBoard::execute ( )

Run emulation.

Returns: True if emulation steps were done, false if emulation is suspended.

Definition at line 494 of file MSXMotherBoard.cc.

References getCPU(), and getMachineConfig().

Referenced by getMachineName().

◆ exitCPULoopAsync()

void openmsx::MSXMotherBoard::exitCPULoopAsync ( )

See CPU::exitCPULoopAsync().

Definition at line 636 of file MSXMotherBoard.cc.

References openmsx::MSXCPU::exitCPULoopAsync(), getCPU(), and getMachineConfig().

Referenced by getMachineName().

◆ exitCPULoopSync()

void openmsx::MSXMotherBoard::exitCPULoopSync ( )

Definition at line 643 of file MSXMotherBoard.cc.

References openmsx::MSXCPU::exitCPULoopSync(), and getCPU().

Referenced by getMachineName(), openmsx::FastForwardHelper::setTarget(), and openmsx::MSXMixer::updateSoftwareVolume().

◆ fastForward()

void openmsx::MSXMotherBoard::fastForward	(	EmuTime::param	time,
		bool	fast
	)

Run emulation until a certain time in fast forward mode.

Definition at line 505 of file MSXMotherBoard.cc.

References getCPU(), getCurrentTime(), and getMachineConfig().

Referenced by getMachineName(), and openmsx::ReverseManager::~ReverseManager().

◆ findDevice()

MSXDevice * openmsx::MSXMotherBoard::findDevice ( string_view name )

Find a MSXDevice by name.

Parameters

name	The name of the device as returned by MSXDevice::getName()

Returns: A pointer to the device or nullptr if the device could not be found.

Definition at line 648 of file MSXMotherBoard.cc.

References end(), and ranges::find_if().

Referenced by openmsx::DeviceInfo::execute(), getVideoSource(), and openmsx::MSXDevice::testRemove().

◆ findExtension()

HardwareConfig * openmsx::MSXMotherBoard::findExtension ( string_view extensionName )

Definition at line 351 of file MSXMotherBoard.cc.

References end(), and ranges::find_if().

Referenced by openmsx::HardwareConfig::createDevices(), openmsx::RemoveExtCmd::execute(), and getExtensions().

◆ freeUserName()

void openmsx::MSXMotherBoard::freeUserName	(	const std::string &	hwName,
		const std::string &	userName
	)

Definition at line 706 of file MSXMotherBoard.cc.

References move_pop_back(), and rfind_unguarded().

Referenced by getMapperIO(), and openmsx::HardwareConfig::~HardwareConfig().

◆ getCassettePort()

CassettePortInterface & openmsx::MSXMotherBoard::getCassettePort ( )

Definition at line 411 of file MSXMotherBoard.cc.

References getMachineConfig().

Referenced by getMSXMixer(), and openmsx::LaserdiscPlayer::LaserdiscPlayer().

◆ getCommandController()

CommandController & openmsx::MSXMotherBoard::getCommandController ( )

Definition at line 479 of file MSXMotherBoard.cc.

Referenced by openmsx::PluggableFactory::createAll(), openmsx::HardwareConfig::createRomConfig(), openmsx::DeviceConfig::getCommandController(), openmsx::MSXDevice::getCommandController(), getVideoSource(), openmsx::HD::HD(), openmsx::IDECDROM::IDECDROM(), openmsx::ImagePrinter::ImagePrinter(), openmsx::CartridgeSlotManager::isExternalSlot(), openmsx::RealDrive::RealDrive(), openmsx::SCSILS120::SCSILS120(), and openmsx::CassettePlayer::~CassettePlayer().

◆ getCPU()

MSXCPU & openmsx::MSXMotherBoard::getCPU ( )

Definition at line 382 of file MSXMotherBoard.cc.

References getMachineConfig().

Referenced by doReset(), execute(), exitCPULoopAsync(), exitCPULoopSync(), fastForward(), openmsx::MSXDevice::getCPU(), getMSXMixer(), pause(), powerUp(), openmsx::AmdFlash::reset(), and unpause().

◆ getCPUInterface()

MSXCPUInterface & openmsx::MSXMotherBoard::getCPUInterface ( )

Definition at line 389 of file MSXMotherBoard.cc.

References getMachineConfig().

Referenced by openmsx::HardwareConfig::createDevices(), createMapperIO(), destroyMapperIO(), doReset(), openmsx::MSXDevice::getCPUInterface(), openmsx::WatchIO::getDevice(), getMSXMixer(), openmsx::HardwareConfig::parseSlots(), powerUp(), openmsx::Debugger::removeProbeBreakPoint(), openmsx::HardwareConfig::testRemove(), openmsx::Debugger::transfer(), and openmsx::HardwareConfig::~HardwareConfig().

◆ getCurrentTime()

EmuTime::param openmsx::MSXMotherBoard::getCurrentTime ( )

Convenience method: This is the same as getScheduler().getCurrentTime().

Definition at line 489 of file MSXMotherBoard.cc.

Referenced by doReset(), fastForward(), openmsx::PluggingController::getCurrentTime(), openmsx::MSXDevice::getCurrentTime(), getVideoSource(), powerUp(), openmsx::SimpleDebuggable::read(), openmsx::Y8950::serialize(), openmsx::PluggingController::unregisterConnector(), openmsx::V9990PixelRenderer::V9990PixelRenderer(), openmsx::SimpleDebuggable::write(), openmsx::YMF262::YMF262(), openmsx::YMF278::YMF278(), openmsx::CassettePort::~CassettePort(), and openmsx::ReverseManager::~ReverseManager().

◆ getDebugger()

Debugger& openmsx::MSXMotherBoard::getDebugger ( )

inline

Definition at line 123 of file MSXMotherBoard.hh.

Referenced by openmsx::MSXCPU::MSXCPU(), openmsx::SimpleDebuggable::SimpleDebuggable(), openmsx::MSXCPU::~MSXCPU(), openmsx::ReverseManager::~ReverseManager(), and openmsx::SimpleDebuggable::~SimpleDebuggable().

◆ getDeviceSwitch()

MSXDeviceSwitch & openmsx::MSXMotherBoard::getDeviceSwitch ( )

Definition at line 403 of file MSXMotherBoard.cc.

References openmsx::DeviceFactory::createDeviceSwitch(), and getMachineConfig().

Referenced by getMSXMixer(), openmsx::MSXSwitchedDevice::MSXSwitchedDevice(), and openmsx::MSXSwitchedDevice::~MSXSwitchedDevice().

◆ getExtensions()

const Extensions& openmsx::MSXMotherBoard::getExtensions ( ) const

inline

Definition at line 108 of file MSXMotherBoard.hh.

References findExtension(), getMSXCliComm(), insertExtension(), loadExtension(), and removeExtension().

Referenced by openmsx::ListExtCmd::execute(), and openmsx::RemoveExtCmd::tabCompletion().

◆ getJoystickPort()

JoystickPortIf & openmsx::MSXMotherBoard::getJoystickPort ( unsigned port )

Definition at line 424 of file MSXMotherBoard.cc.

References string_view::empty(), openmsx::XMLElement::getChildData(), openmsx::HardwareConfig::getConfig(), getMachineConfig(), and getPluggingController().

Referenced by openmsx::ColecoJoystickIO::ColecoJoystickIO(), getMSXMixer(), openmsx::MSXPSG::MSXPSG(), openmsx::JoyPortDebuggable::read(), openmsx::SVIPPI::SVIPPI(), and openmsx::SVIPSG::SVIPSG().

◆ getLedStatus()

LedStatus & openmsx::MSXMotherBoard::getLedStatus ( )

Definition at line 467 of file MSXMotherBoard.cc.

References getMSXCliComm(), and openmsx::Reactor::getRTScheduler().

Referenced by openmsx::MSXDevice::getLedStatus(), openmsx::RealDrive::getMotor(), getMSXMixer(), openmsx::SVIPSG::powerDown(), powerUp(), openmsx::SCSIHD::SCSIHD(), openmsx::RealDrive::serialize(), and openmsx::SCSILS120::~SCSILS120().

◆ getMachineConfig()

const HardwareConfig* openmsx::MSXMotherBoard::getMachineConfig ( ) const

inline

◆ getMachineID()

string_view openmsx::MSXMotherBoard::getMachineID ( ) const

inline

Definition at line 68 of file MSXMotherBoard.hh.

Referenced by openmsx::AddRemoveUpdate::AddRemoveUpdate(), openmsx::DiskChanger::DiskChanger(), openmsx::IDEHD::IDEHD(), openmsx::MSXCliComm::update(), and openmsx::AddRemoveUpdate::~AddRemoveUpdate().

◆ getMachineInfoCommand()

InfoCommand & openmsx::MSXMotherBoard::getMachineInfoCommand ( )

Definition at line 484 of file MSXMotherBoard.cc.

Referenced by getVideoSource().

◆ getMachineName()

string_view openmsx::MSXMotherBoard::getMachineName ( ) const

inline

Definition at line 69 of file MSXMotherBoard.hh.

References activate(), doReset(), execute(), exitCPULoopAsync(), exitCPULoopSync(), fastForward(), pause(), powerUp(), and unpause().

Referenced by openmsx::MachineNameInfo::execute().

◆ getMachineType()

std::string openmsx::MSXMotherBoard::getMachineType ( ) const

Definition at line 272 of file MSXMotherBoard.cc.

References openmsx::XMLElement::getChild(), openmsx::XMLElement::getChildData(), openmsx::HardwareConfig::getConfig(), and getMachineConfig().

Referenced by openmsx::RomFactory::create(), openmsx::MachineTypeInfo::execute(), and getMachineConfig().

◆ getMapperIO()

MSXMapperIO& openmsx::MSXMotherBoard::getMapperIO ( ) const

inline

Definition at line 183 of file MSXMotherBoard.hh.

References destroyMapperIO(), freeUserName(), getUserName(), and serialize().

◆ getMSXCliComm()

CliComm & openmsx::MSXMotherBoard::getMSXCliComm ( )

Definition at line 368 of file MSXMotherBoard.cc.

Referenced by openmsx::CassettePlayer::CassettePlayer(), openmsx::CartridgeSlotManager::createExternalSlot(), openmsx::IDECDROM::eject(), openmsx::ImagePrinter::flushEmulatedPrinter(), openmsx::CassettePlayer::generateChannels(), openmsx::PluggingController::getCliComm(), openmsx::DeviceConfig::getCliComm(), openmsx::MSXCommandController::getCliComm(), openmsx::MSXDevice::getCliComm(), getExtensions(), getLedStatus(), openmsx::HD::HD(), openmsx::IDECDROM::IDECDROM(), openmsx::IDECDROM::insert(), insertExtension(), openmsx::CartridgeSlotManager::isExternalSlot(), openmsx::RealDrive::RealDrive(), removeExtension(), openmsx::CartridgeSlotManager::removeExternalSlot(), openmsx::RomKonami::RomKonami(), openmsx::RomKonamiSCC::RomKonamiSCC(), openmsx::CassettePlayer::serialize(), openmsx::CassettePlayer::setSignal(), openmsx::HD::switchImage(), openmsx::CassettePlayer::~CassettePlayer(), openmsx::HD::~HD(), openmsx::IDECDROM::~IDECDROM(), openmsx::RealDrive::~RealDrive(), and openmsx::SCSILS120::~SCSILS120().

◆ getMSXCommandController()

MSXCommandController& openmsx::MSXMotherBoard::getMSXCommandController ( )

inline

Definition at line 117 of file MSXMotherBoard.hh.

Referenced by openmsx::ProxyCmd::ProxyCmd(), and openmsx::ReverseManager::~ReverseManager().

◆ getMSXEventDistributor()

MSXEventDistributor& openmsx::MSXMotherBoard::getMSXEventDistributor ( )

inline

Definition at line 119 of file MSXMotherBoard.hh.

Referenced by openmsx::PluggableFactory::createAll(), openmsx::VideoLayer::VideoLayer(), and openmsx::VideoLayer::~VideoLayer().

◆ getMSXMixer()

MSXMixer& openmsx::MSXMotherBoard::getMSXMixer ( )

inline

Definition at line 124 of file MSXMotherBoard.hh.

References getCassettePort(), getCPU(), getCPUInterface(), getDeviceSwitch(), getJoystickPort(), getLedStatus(), getPanasonicMemory(), getPluggingController(), and getRenShaTurbo().

Referenced by openmsx::AviRecorder::~AviRecorder(), and openmsx::ReverseManager::~ReverseManager().

◆ getPanasonicMemory()

PanasonicMemory & openmsx::MSXMotherBoard::getPanasonicMemory ( )

Definition at line 395 of file MSXMotherBoard.cc.

Referenced by getMSXMixer(), openmsx::Rom::Rom(), and openmsx::MSXS1990::writeIO().

◆ getPluggingController()

PluggingController & openmsx::MSXMotherBoard::getPluggingController ( )

Definition at line 373 of file MSXMotherBoard.cc.

References getMachineConfig().

Referenced by getJoystickPort(), getMSXMixer(), and openmsx::MSXDevice::getPluggingController().

◆ getReactor()

Reactor& openmsx::MSXMotherBoard::getReactor ( )

inline

Definition at line 135 of file MSXMotherBoard.hh.

Referenced by openmsx::AddRemoveUpdate::AddRemoveUpdate(), openmsx::CassettePlayer::CassettePlayer(), openmsx::PluggableFactory::createAll(), openmsx::MSXCPUInterface::doBreak(), openmsx::MSXCPUInterface::doContinue(), openmsx::WatchIO::getDevice(), openmsx::DeviceConfig::getReactor(), openmsx::MSXDevice::getReactor(), openmsx::HD::HD(), openmsx::LaserdiscPlayer::LaserdiscPlayer(), openmsx::MSXCPUInterface::MSXCPUInterface(), openmsx::LaserdiscPlayer::readSample(), openmsx::MSXCPUInterface::removeBreakPoint(), openmsx::Rom::Rom(), openmsx::CassettePlayer::serialize(), openmsx::HD::switchImage(), openmsx::AddRemoveUpdate::~AddRemoveUpdate(), openmsx::CassettePlayer::~CassettePlayer(), openmsx::LaserdiscPlayer::~LaserdiscPlayer(), openmsx::ProbeBreakPoint::~ProbeBreakPoint(), and openmsx::ReverseManager::~ReverseManager().

◆ getRealTime()

RealTime& openmsx::MSXMotherBoard::getRealTime ( )

inline

Definition at line 122 of file MSXMotherBoard.hh.

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

◆ getRenShaTurbo()

RenShaTurbo & openmsx::MSXMotherBoard::getRenShaTurbo ( )

Definition at line 456 of file MSXMotherBoard.cc.

References openmsx::HardwareConfig::getConfig(), and getMachineConfig().

Referenced by getMSXMixer().

◆ getReverseManager()

ReverseManager& openmsx::MSXMotherBoard::getReverseManager ( )

inline

Definition at line 134 of file MSXMotherBoard.hh.

Referenced by openmsx::Keyboard::Keyboard(), and openmsx::ReverseManager::~ReverseManager().

◆ getScheduler()

Scheduler& openmsx::MSXMotherBoard::getScheduler ( )

inline

Definition at line 118 of file MSXMotherBoard.hh.

Referenced by openmsx::PluggableFactory::createAll(), openmsx::DeviceConfig::getScheduler(), openmsx::MSXDevice::getScheduler(), openmsx::HD::HD(), openmsx::IDECDROM::IDECDROM(), openmsx::CartridgeSlotManager::isExternalSlot(), openmsx::MSXCPU::MSXCPU(), openmsx::SCSILS120::SCSILS120(), and openmsx::MSXCPU::~MSXCPU().

◆ getSharedStuff()

template<typename T , typename ... Args>

std::shared_ptr<T> openmsx::MSXMotherBoard::getSharedStuff	(	string_view	name,
		Args &&...	args
	)

inline

Some MSX device parts are shared between several MSX devices (e.g.

all memory mappers share IO ports 0xFC-0xFF). But this sharing is limited to one MSX machine. This method offers the storage to implement per-machine reference counted objects. TODO This doesn't play nicely with savestates. For example memory mappers don't use this mechanism anymore because of this. Maybe this method can be removed when savestates are finished.

Definition at line 168 of file MSXMotherBoard.hh.

References createMapperIO().

Referenced by openmsx::HD::HD(), openmsx::IDECDROM::IDECDROM(), openmsx::ImagePrinter::ImagePrinter(), openmsx::NowindInterface::NowindInterface(), openmsx::RealDrive::RealDrive(), openmsx::SCSILS120::SCSILS120(), and openmsx::V9990CmdEngine::V9990CmdEngine().

◆ getSlotManager()

CartridgeSlotManager& openmsx::MSXMotherBoard::getSlotManager ( )

inline

Definition at line 121 of file MSXMotherBoard.hh.

Referenced by openmsx::HardwareConfig::createDevices(), openmsx::MSXDevice::getPluggingController(), openmsx::HardwareConfig::testRemove(), and openmsx::HardwareConfig::~HardwareConfig().

◆ getStateChangeDistributor()

StateChangeDistributor& openmsx::MSXMotherBoard::getStateChangeDistributor ( )

inline

Definition at line 120 of file MSXMotherBoard.hh.

Referenced by openmsx::PluggableFactory::createAll(), openmsx::HD::HD(), openmsx::IDECDROM::IDECDROM(), openmsx::CartridgeSlotManager::isExternalSlot(), openmsx::SCSILS120::SCSILS120(), and openmsx::ReverseManager::~ReverseManager().

◆ getUserName()

string openmsx::MSXMotherBoard::getUserName ( const std::string & hwName )

Keep track of which 'usernames' are in use.

For example to be able to use several fmpac extensions at once, each with its own SRAM file, we need to generate unique filenames. We also want to reuse existing filenames as much as possible. ATM the usernames always have the format 'untitled[N]'. In the future we might allow really user specified names.

Definition at line 694 of file MSXMotherBoard.cc.

References contains(), and strCat().

Referenced by getMapperIO(), and openmsx::HardwareConfig::HardwareConfig().