openMSX
Public Types | Public Member Functions | List of all members
openmsx::RomAscii8_8 Class Referencefinal

#include <RomAscii8_8.hh>

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

Public Types

enum class  SubType {
  ASCII8_8 , KOEI_8 , KOEI_32 , WIZARDRY ,
  ASCII8_2 , ASCII8_32
}
 
- Public Types inherited from openmsx::MSXDevice
using Devices = std::vector< MSXDevice * >
 

Public Member Functions

 RomAscii8_8 (const DeviceConfig &config, Rom &&rom, SubType subType)
 
void reset (EmuTime::param time) override
 This method is called on reset.
 
byte readMem (word address, EmuTime::param time) override
 Read a byte from a location at a certain time from this device.
 
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.
 
const bytegetReadCacheLine (word address) const override
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading.
 
bytegetWriteCacheLine (word address) override
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for writing.
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 
- Public Member Functions inherited from openmsx::RomBlocks< BANK_SIZE_ >
unsigned getBaseSizeAlignment () const override
 The 'base' and 'size' attribute values need to be at least aligned to CacheLine::SIZE.
 
byte readMem (word address, EmuTime::param time) override
 Read a byte from a location at a certain time from this device.
 
byte peekMem (word address, EmuTime::param time) const override
 Read a byte from a given memory location.
 
const bytegetReadCacheLine (word address) const override
 Test that the memory in the interval [start, start + CacheLine::SIZE) is cacheable for reading.
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 
- Public Member Functions inherited from openmsx::MSXRom
void getExtraDeviceInfo (TclObject &result) const override
 
void getInfo (TclObject &result) const
 Add dict values with info to result.
 
RomType getRomType () const
 
- Public Member Functions inherited from openmsx::MSXDevice
 MSXDevice (const MSXDevice &)=delete
 
 MSXDevice (MSXDevice &&)=delete
 
MSXDeviceoperator= (const MSXDevice &)=delete
 
MSXDeviceoperator= (MSXDevice &&)=delete
 
virtual ~MSXDevice ()=0
 
const HardwareConfiggetHardwareConfig () const
 Returns the hardwareconfig this device belongs to.
 
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).
 
virtual byte readIRQVector ()
 Gets IRQ vector used in IM2.
 
virtual void powerDown (EmuTime::param time)
 This method is called when MSX is powered down.
 
virtual void powerUp (EmuTime::param time)
 This method is called when MSX is powered up.
 
virtual const std::string & getName () const
 Returns a human-readable name for this device.
 
virtual void getNameList (TclObject &result) const
 Returns list of name(s) of this device.
 
void getDeviceInfo (TclObject &result) const
 Get device info.
 
void getVisibleMemRegion (unsigned &base, unsigned &size) const
 Returns the range where this device is visible in memory.
 
virtual byte readIO (word port, EmuTime::param time)
 Read a byte from an IO port at a certain time from this device.
 
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.
 
virtual byte peekIO (word port, EmuTime::param time) const
 Read a byte from a given IO port.
 
virtual void globalWrite (word address, byte value, EmuTime::param time)
 Global writes.
 
virtual void globalRead (word address, EmuTime::param time)
 Global reads.
 
void invalidateDeviceRWCache ()
 Calls MSXCPUInterface::invalidateXXCache() for the specific (part of) the slot that this device is located in.
 
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.
 
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)
 
MSXMotherBoardgetMotherBoard () const
 Get the mother board this device belongs to.
 
const XMLElementgetDeviceConfig () const
 Get the configuration section for this device.
 
const DeviceConfiggetDeviceConfig2 () const
 
const DevicesgetReferences () const
 Get the device references that are specified for this device.
 
EmuTime::param getCurrentTime () const
 
MSXCPUgetCPU () const
 
MSXCPUInterfacegetCPUInterface () const
 
SchedulergetScheduler () const
 
MSXCliCommgetCliComm () const
 
ReactorgetReactor () const
 
CommandControllergetCommandController () const
 
PluggingControllergetPluggingController () const
 
LedStatusgetLedStatus () const
 
template<typename Archive >
void serialize (Archive &ar, unsigned version)
 

Additional Inherited Members

- Static Public Attributes inherited from openmsx::RomBlocks< BANK_SIZE_ >
static constexpr unsigned BANK_SIZE = BANK_SIZE_
 
static constexpr unsigned NUM_BANKS = 0x10000 / BANK_SIZE
 
static constexpr unsigned BANK_MASK = BANK_SIZE - 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::RomBlocks< BANK_SIZE_ >
 RomBlocks (const DeviceConfig &config, Rom &&rom, unsigned debugBankSizeShift=0)
 Constructor.
 
 ~RomBlocks () override
 
void setUnmapped (unsigned region)
 Select 'unmapped' memory for this region.
 
void setBank (unsigned region, const byte *adr, byte block)
 Sets the memory visible for reading in a certain region.
 
void setRom (unsigned region, unsigned block)
 Selects a block of the ROM image for reading in a certain region.
 
void setBlockMask (int mask)
 Sets a mask for the block numbers.
 
void setExtraMemory (std::span< const byte > mem)
 Inform this base class of extra mappable memory block.
 
- Protected Member Functions inherited from openmsx::MSXRom
 MSXRom (const DeviceConfig &config, Rom &&rom)
 
- 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.
 
 MSXDevice (const DeviceConfig &config)
 
virtual void init ()
 
virtual bool allowUnaligned () const
 By default we don't allow unaligned <mem> specifications in the config file.
 
byte getPrimarySlot () const
 
- Protected Attributes inherited from openmsx::RomBlocks< BANK_SIZE_ >
std::array< const byte *, NUM_BANKSbankPtr
 
std::unique_ptr< SRAMsram
 
std::array< byte, NUM_BANKSblockNr
 
- Protected Attributes inherited from openmsx::MSXRom
Rom rom
 
- Protected Attributes inherited from openmsx::MSXDevice
std::string deviceName
 

Detailed Description

Definition at line 9 of file RomAscii8_8.hh.

Member Enumeration Documentation

◆ SubType

enum class openmsx::RomAscii8_8::SubType
strong
Enumerator
ASCII8_8 
KOEI_8 
KOEI_32 
WIZARDRY 
ASCII8_2 
ASCII8_32 

Definition at line 12 of file RomAscii8_8.hh.

Constructor & Destructor Documentation

◆ RomAscii8_8()

openmsx::RomAscii8_8::RomAscii8_8 ( const DeviceConfig config,
Rom &&  rom,
SubType  subType 
)

Member Function Documentation

◆ getReadCacheLine()

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

References openmsx::RomBlocks< BANK_SIZE_ >::BANK_MASK, openmsx::RomBlocks< BANK_SIZE_ >::BANK_SIZE, openmsx::RomBlocks< BANK_SIZE_ >::getReadCacheLine(), and openmsx::RomBlocks< BANK_SIZE_ >::sram.

◆ getWriteCacheLine()

byte * openmsx::RomAscii8_8::getWriteCacheLine ( word  start)
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::MSXRom.

Definition at line 107 of file RomAscii8_8.cc.

References openmsx::RomBlocks< BANK_SIZE_ >::BANK_SIZE, and openmsx::MSXDevice::unmappedWrite.

◆ readMem()

byte openmsx::RomAscii8_8::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 53 of file RomAscii8_8.cc.

References openmsx::RomBlocks< BANK_SIZE_ >::BANK_MASK, openmsx::RomBlocks< BANK_SIZE_ >::BANK_SIZE, openmsx::RomBlocks< BANK_SIZE_ >::readMem(), and openmsx::RomBlocks< BANK_SIZE_ >::sram.

◆ reset()

void openmsx::RomAscii8_8::reset ( EmuTime::param  time)
overridevirtual

This method is called on reset.

Default implementation does nothing.

Reimplemented from openmsx::MSXDevice.

Definition at line 40 of file RomAscii8_8.cc.

References openmsx::RomBlocks< BANK_SIZE_ >::setRom(), openmsx::RomBlocks< BANK_SIZE_ >::setUnmapped(), and xrange().

Referenced by RomAscii8_8().

◆ serialize()

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

Definition at line 121 of file RomAscii8_8.cc.

◆ writeMem()

void openmsx::RomAscii8_8::writeMem ( word  address,
byte  value,
EmuTime::param  time 
)
overridevirtual

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