#include <MSXRS232.hh>

Inheritance diagram for openmsx::MSXRS232:

[legend]

Collaboration diagram for openmsx::MSXRS232:

[legend]

Public Member Functions
	MSXRS232 (const DeviceConfig &config)

	~MSXRS232 () override

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

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

byte	readIO (word port, EmuTime::param time) override
	Read a byte from an IO port at a certain time from this device. More...

byte	peekIO (word port, EmuTime::param time) const override
	Read a byte from a given IO port. More...

void	writeIO (word port, byte value, EmuTime::param time) override
	Write a byte to a given IO port at a certain time to this device. More...

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

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

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. More...

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

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

void	setDataBits (DataBits bits) override

void	setStopBits (StopBits bits) override

void	setParityBit (bool enable, ParityBit parity) override

void	recvByte (byte value, EmuTime::param time) override

bool	ready () override

bool	acceptsData () override

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

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

MSXDevice &	operator= (const MSXDevice &)=delete

virtual	~MSXDevice ()=0

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

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). More...

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

virtual byte	readIRQVector ()
	Gets IRQ vector used in IM2. More...

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

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

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

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

void	getDeviceInfo (TclObject &result) const
	Get device info. More...

void	getVisibleMemRegion (unsigned &base, unsigned &size) const
	Returns the range where this device is visible in memory. More...

virtual byte	readIO (word port, EmuTime::param time)
	Read a byte from an IO port at a certain time from this device. More...

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. More...

virtual byte	peekIO (word port, EmuTime::param time) const
	Read a byte from a given IO port. More...

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

virtual void	writeMem (word address, byte value, EmuTime::param time)
	Write a given byte to a given location at a certain time to this device. More...

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

virtual byte *	getWriteCacheLine (word start) const
	Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing. More...

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

virtual void	globalWrite (word address, byte value, EmuTime::param time)
	Global writes. More...

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

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

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. More...

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. More...

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

const DeviceConfig &	getDeviceConfig2 () const

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

EmuTime::param	getCurrentTime () const

MSXCPU &	getCPU () const

MSXCPUInterface &	getCPUInterface () const

Scheduler &	getScheduler () const

CliComm &	getCliComm () const

Reactor &	getReactor () const

CommandController &	getCommandController () const

PluggingController &	getPluggingController () const

LedStatus &	getLedStatus () const

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

Public Member Functions inherited from openmsx::RS232Connector
RS232Device &	getPluggedRS232Dev () const

std::string_view	getDescription () const final
	Get a description for this connector. More...

std::string_view	getClass () const final
	A Connector belong to a certain class. More...

void	setDataBits (DataBits bits) override=0

void	setStopBits (StopBits bits) override=0

void	setParityBit (bool enable, ParityBit parity) override=0

void	recvByte (byte value, EmuTime::param time) override=0

virtual bool	ready ()=0

virtual bool	acceptsData ()=0

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

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

Connector &	operator= (const Connector &)=delete

const std::string &	getName () const
	Name that identifies this connector. More...

virtual std::string_view	getDescription () const =0
	Get a description for this connector. More...

virtual std::string_view	getClass () const =0
	A Connector belong to a certain class. More...

virtual void	plug (Pluggable &device, EmuTime::param time)
	This plugs a Pluggable in this Connector. More...

virtual void	unplug (EmuTime::param time)
	This unplugs the currently inserted Pluggable from this Connector. More...

Pluggable &	getPlugged () const
	Returns the Pluggable currently plugged in. More...

PluggingController &	getPluggingController () const

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

virtual void	setDataBits (DataBits bits)=0

virtual void	setStopBits (StopBits bits)=0

virtual void	setParityBit (bool enable, ParityBit parity)=0

virtual void	recvByte (byte value, EmuTime::param time)=0

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

Public Types inherited from openmsx::SerialDataInterface
enum	DataBits { DATA_5 = 5 , DATA_6 = 6 , DATA_7 = 7 , DATA_8 = 8 }

enum	StopBits { STOP_INV = 0 , STOP_1 = 2 , STOP_15 = 3 , STOP_2 = 4 }

enum	ParityBit { EVEN = 0 , ODD = 1 }

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. More...

	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. More...

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

virtual void	getExtraDeviceInfo (TclObject &result) const

byte	getPrimarySlot () const

Protected Member Functions inherited from openmsx::RS232Connector
	RS232Connector (PluggingController &pluggingController, std::string name)

	~RS232Connector ()=default

Protected Member Functions inherited from openmsx::Connector
	Connector (PluggingController &pluggingController, std::string name, std::unique_ptr< Pluggable > dummy)
	Creates a new Connector. More...

	~Connector ()

Protected Member Functions inherited from openmsx::SerialDataInterface
	~SerialDataInterface ()=default

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

Detailed Description

Definition at line 17 of file MSXRS232.hh.

Constructor & Destructor Documentation

◆ MSXRS232()

openmsx::MSXRS232::MSXRS232 ( const DeviceConfig & config )

explicit

Definition at line 20 of file MSXRS232.cc.

References openmsx::I8254::getClockPin(), openmsx::MSXDevice::getCurrentTime(), powerUp(), and openmsx::ClockPin::setPeriodicState().

◆ ~MSXRS232()

openmsx::MSXRS232::~MSXRS232 ( )

overridedefault

Member Function Documentation

◆ acceptsData()

bool openmsx::MSXRS232::acceptsData ( )

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 395 of file MSXRS232.cc.

References openmsx::I8251::isRecvEnabled().

◆ allowUnaligned()

bool openmsx::MSXRS232::allowUnaligned ( ) const

overridevirtual

By default we don't allow unaligned <mem> specifications in the config file.

Though for a machine like 'Victor HC-95A' is it useful to model it with combinations of unaligned devices. So we do allow it for a select few devices: devices that promise to not call any of the 'fillDeviceXXXCache()' methods.

Reimplemented from openmsx::MSXDevice.

Definition at line 138 of file MSXRS232.cc.

◆ getReadCacheLine()

const byte * openmsx::MSXRS232::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 90 of file MSXRS232.cc.

References openmsx::CacheLine::HIGH, openmsx::RAM_OFFSET, openmsx::RAM_SIZE, and openmsx::MSXDevice::unmappedRead.

◆ getWriteCacheLine()

byte * openmsx::MSXRS232::getWriteCacheLine ( word start ) const

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 125 of file MSXRS232.cc.

References openmsx::CacheLine::HIGH, openmsx::RAM_OFFSET, openmsx::RAM_SIZE, and openmsx::MSXDevice::unmappedWrite.

◆ peekIO()

byte openmsx::MSXRS232::peekIO	(	word	port,
		EmuTime::param	time
	)		const

overridevirtual

Read a byte from a given IO port.

Reading via this method has no side effects (doesn't change the device status). If safe 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 just returns 0xFF.

Reimplemented from openmsx::MSXDevice.

Definition at line 172 of file MSXRS232.cc.

References openmsx::I8254::peekIO(), openmsx::I8251::peekIO(), and UNREACHABLE.

◆ powerUp()

void openmsx::MSXRS232::powerUp ( EmuTime::param time )

overridevirtual

This method is called when MSX is powered up.

The default implementation calls reset(), this is usually ok.

Parameters

time	The moment in time the power up occurs.

Reimplemented from openmsx::MSXDevice.

Definition at line 58 of file MSXRS232.cc.

References reset().

Referenced by MSXRS232().

◆ readIO()

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

overridevirtual

Read a byte from an IO port at a certain time from this device.

The default implementation returns 255.

Reimplemented from openmsx::MSXDevice.

Definition at line 144 of file MSXRS232.cc.

◆ readMem()

byte openmsx::MSXRS232::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 75 of file MSXRS232.cc.

References openmsx::RAM_OFFSET, and openmsx::RAM_SIZE.

◆ ready()

bool openmsx::MSXRS232::ready ( )

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 390 of file MSXRS232.cc.

References openmsx::I8251::isRecvReady().

◆ recvByte()

void openmsx::MSXRS232::recvByte	(	byte	value,
		EmuTime::param	time
	)

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 415 of file MSXRS232.cc.

References openmsx::I8251::recvByte().

◆ reset()

void openmsx::MSXRS232::reset ( EmuTime::param time )

overridevirtual

This method is called on reset.

Default implementation does nothing.

Reimplemented from openmsx::MSXDevice.

Definition at line 64 of file MSXRS232.cc.

References openmsx::IntHelper< SOURCE >::reset().

Referenced by powerUp().

◆ serialize()

template<typename Archive >

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

Definition at line 424 of file MSXRS232.cc.

◆ setDataBits()

void openmsx::MSXRS232::setDataBits ( DataBits bits )

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 400 of file MSXRS232.cc.

References openmsx::I8251::setDataBits().

◆ setParityBit()

void openmsx::MSXRS232::setParityBit	(	bool	enable,
		ParityBit	parity
	)

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 410 of file MSXRS232.cc.

References openmsx::I8251::setParityBit().

◆ setStopBits()

void openmsx::MSXRS232::setStopBits ( StopBits bits )

overridevirtual

Implements openmsx::RS232Connector.

Definition at line 405 of file MSXRS232.cc.

References openmsx::I8251::setStopBits().

◆ writeIO()

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

overridevirtual

Write a byte to a given IO port at a certain time to this device.

The default implementation ignores the write (does nothing)

Reimplemented from openmsx::MSXDevice.

Definition at line 194 of file MSXRS232.cc.

◆ writeMem()

void openmsx::MSXRS232::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 105 of file MSXRS232.cc.

References openmsx::RAM_OFFSET, and openmsx::RAM_SIZE.

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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MSXRS232()

◆ ~MSXRS232()

Member Function Documentation

◆ acceptsData()

◆ allowUnaligned()

◆ getReadCacheLine()

◆ getWriteCacheLine()

◆ peekIO()

◆ powerUp()

◆ readIO()

◆ readMem()

◆ ready()

◆ recvByte()

◆ reset()

◆ serialize()

◆ setDataBits()

◆ setParityBit()

◆ setStopBits()

◆ writeIO()

◆ writeMem()