#include <IDECDROM.hh>

Inheritance diagram for openmsx::IDECDROM:

Collaboration diagram for openmsx::IDECDROM:

Public Member Functions
	IDECDROM (const IDECDROM &)=delete

IDECDROM &	operator= (const IDECDROM &)=delete

	IDECDROM (const DeviceConfig &config)

	~IDECDROM () override

void	eject ()

void	insert (const std::string &filename)

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

Public Member Functions inherited from openmsx::AbstractIDEDevice
void	reset (EmuTime::param time) override

word	readData (EmuTime::param time) override

byte	readReg (nibble reg, EmuTime::param time) override

void	writeData (word value, EmuTime::param time) override

void	writeReg (nibble reg, byte value, EmuTime::param time) override

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

Public Member Functions inherited from openmsx::IDEDevice
virtual	~IDEDevice ()=default

Protected Member Functions
bool	isPacketDevice () override
	Is this device a packet (ATAPI) device? More...

const std::string &	getDeviceName () override
	Gets the device name to insert as "model number" into the identify block. More...

void	fillIdentifyBlock (AlignedBuffer &buffer) override
	Tells a subclass to fill the device specific parts of the identify block located in the buffer. More...

unsigned	readBlockStart (AlignedBuffer &buffer, unsigned count) override
	Called when a block of read data should be buffered by the controller: when the buffer is empty or at the start of the transfer. More...

void	readEnd () override
	Called when a read transfer completes. More...

void	writeBlockComplete (AlignedBuffer &buffer, unsigned count) override
	Called when a block of written data has been buffered by the controller: when the buffer is full or at the end of the transfer. More...

void	executeCommand (byte cmd) override
	Starts execution of an IDE command. More...

Protected Member Functions inherited from openmsx::AbstractIDEDevice
	AbstractIDEDevice (MSXMotherBoard &motherBoard)

	~AbstractIDEDevice () override=default

void	setError (byte error)
	Indicates an error: sets error register, error flag, aborts transfers. More...

unsigned	getSectorNumber () const
	Creates an LBA sector address from the contents of the sectorNumReg, cylinderLowReg, cylinderHighReg and devHeadReg registers. More...

unsigned	getNumSectors () const
	Gets the number of sectors indicated by the sector count register. More...

void	setInterruptReason (byte value)
	Writes the interrupt reason register. More...

unsigned	getByteCount () const
	Reads the byte count limit of a packet transfer in the registers. More...

void	setByteCount (unsigned count)
	Writes the byte count of a packet transfer in the registers. More...

void	setSectorNumber (unsigned lba)
	Writes a 28-bit LBA sector number in the registers. More...

void	startLongReadTransfer (unsigned count)
	Indicates the start of a read data transfer which uses blocks. More...

AlignedBuffer &	startShortReadTransfer (unsigned count)
	Indicates the start of a read data transfer where all data fits into the buffer at once. More...

void	abortReadTransfer (byte error)
	Aborts the read transfer in progress. More...

void	startWriteTransfer (unsigned count)
	Indicates the start of a write data transfer. More...

void	abortWriteTransfer (byte error)
	Aborts the write transfer in progress. More...

byte	getFeatureReg () const

void	setLBALow (byte value)

void	setLBAMid (byte value)

void	setLBAHigh (byte value)

MSXMotherBoard &	getMotherBoard () const

Friends
class	CDXCommand

Additional Inherited Members
Static Protected Attributes inherited from openmsx::AbstractIDEDevice
static constexpr byte	DRDY = 0x40

static constexpr byte	DSC = 0x10

static constexpr byte	DRQ = 0x08

static constexpr byte	ERR = 0x01

static constexpr byte	UNC = 0x40

static constexpr byte	IDNF = 0x10

static constexpr byte	ABORT = 0x04

Detailed Description

Definition at line 14 of file IDECDROM.hh.

Constructor & Destructor Documentation

◆ IDECDROM() [1/2]

openmsx::IDECDROM::IDECDROM ( const IDECDROM & )

delete

◆ IDECDROM() [2/2]

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

explicit

Definition at line 38 of file IDECDROM.cc.

References openmsx::AbstractIDEDevice::getMotherBoard(), openmsx::MSXMotherBoard::getMSXCliComm(), openmsx::MSXMotherBoard::getSharedStuff(), openmsx::CliComm::HARDWARE, and openmsx::CliComm::update().

◆ ~IDECDROM()

openmsx::IDECDROM::~IDECDROM ( )

override

Definition at line 70 of file IDECDROM.cc.

References openmsx::AbstractIDEDevice::getMotherBoard(), openmsx::MSXMotherBoard::getMSXCliComm(), openmsx::CliComm::HARDWARE, and openmsx::CliComm::update().

Member Function Documentation

◆ eject()

void openmsx::IDECDROM::eject ( )

Definition at line 311 of file IDECDROM.cc.

References openmsx::File::close(), openmsx::AbstractIDEDevice::getMotherBoard(), openmsx::MSXMotherBoard::getMSXCliComm(), openmsx::CliComm::MEDIA, and openmsx::CliComm::update().

Referenced by openmsx::CDXCommand::execute(), and serialize().

◆ executeCommand()

void openmsx::IDECDROM::executeCommand ( byte cmd )

overrideprotectedvirtual

Starts execution of an IDE command.

Override this to implement additional commands and make sure you call the superclass implementation for all commands that you don't handle.

Reimplemented from openmsx::AbstractIDEDevice.

Definition at line 140 of file IDECDROM.cc.

References openmsx::AbstractIDEDevice::executeCommand(), openmsx::AbstractIDEDevice::getByteCount(), openmsx::AbstractIDEDevice::getFeatureReg(), openmsx::File::is_open(), openmsx::AbstractIDEDevice::setError(), openmsx::AbstractIDEDevice::setInterruptReason(), openmsx::AbstractIDEDevice::setLBAHigh(), openmsx::AbstractIDEDevice::setLBAMid(), and openmsx::AbstractIDEDevice::startWriteTransfer().

◆ fillIdentifyBlock()

void openmsx::IDECDROM::fillIdentifyBlock ( AlignedBuffer & buffer )

overrideprotectedvirtual

Tells a subclass to fill the device specific parts of the identify block located in the buffer.

The generic part is already written there.

Parameters

buffer Array of 512 bytes.

Implements openmsx::AbstractIDEDevice.

Definition at line 90 of file IDECDROM.cc.

◆ getDeviceName()

const std::string & openmsx::IDECDROM::getDeviceName ( )

overrideprotectedvirtual

Gets the device name to insert as "model number" into the identify block.

Returns: An ASCII string, up to 40 characters long.

Implements openmsx::AbstractIDEDevice.

Definition at line 84 of file IDECDROM.cc.

◆ insert()

void openmsx::IDECDROM::insert ( const std::string & filename )

Definition at line 319 of file IDECDROM.cc.

References openmsx::filename, openmsx::AbstractIDEDevice::getMotherBoard(), openmsx::MSXMotherBoard::getMSXCliComm(), openmsx::CliComm::MEDIA, and openmsx::CliComm::update().

Referenced by openmsx::CDXCommand::execute(), and serialize().

◆ isPacketDevice()

bool openmsx::IDECDROM::isPacketDevice ( )

overrideprotectedvirtual

Is this device a packet (ATAPI) device?

Returns: True iff this device supports the packet commands.

Implements openmsx::AbstractIDEDevice.

Definition at line 79 of file IDECDROM.cc.

◆ operator=()

IDECDROM& openmsx::IDECDROM::operator= ( const IDECDROM & )

delete

◆ readBlockStart()

unsigned openmsx::IDECDROM::readBlockStart	(	AlignedBuffer &	buffer,
		unsigned	count
	)

overrideprotectedvirtual

Called when a block of read data should be buffered by the controller: when the buffer is empty or at the start of the transfer.

Parameters

buffer	Pointer to the start of a byte array.
count	Number of bytes to be filled by this method. This number will not exceed the array size nor the transfer length.

Returns: The number of bytes that was added to the array, or 0 if the transfer was aborted (the implementation of this method must set the relevant error flags as well).

Implements openmsx::AbstractIDEDevice.

Definition at line 110 of file IDECDROM.cc.

References openmsx::AbstractIDEDevice::abortReadTransfer(), LZ4::count(), openmsx::File::is_open(), openmsx::File::read(), and openmsx::File::seek().

◆ readEnd()

void openmsx::IDECDROM::readEnd ( )

overrideprotectedvirtual

Called when a read transfer completes.

The default implementation does nothing.

Reimplemented from openmsx::AbstractIDEDevice.

Definition at line 127 of file IDECDROM.cc.

References openmsx::AbstractIDEDevice::setInterruptReason().

◆ serialize()

template<typename Archive >

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

Definition at line 396 of file IDECDROM.cc.

References eject(), openmsx::filename, openmsx::File::getURL(), insert(), and openmsx::File::is_open().

◆ writeBlockComplete()

void openmsx::IDECDROM::writeBlockComplete	(	AlignedBuffer &	buffer,
		unsigned	count
	)

overrideprotectedvirtual

Called when a block of written data has been buffered by the controller: when the buffer is full or at the end of the transfer.

Parameters

buffer	Pointer to the start of a byte array.
count	Number of data bytes in the array.

Implements openmsx::AbstractIDEDevice.

Definition at line 132 of file IDECDROM.cc.

References LZ4::count().

Friends And Related Function Documentation

◆ CDXCommand

friend class CDXCommand

friend

Definition at line 73 of file IDECDROM.hh.

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

Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ IDECDROM() [1/2]

◆ IDECDROM() [2/2]

◆ ~IDECDROM()

Member Function Documentation

◆ eject()

◆ executeCommand()

◆ fillIdentifyBlock()

◆ getDeviceName()

◆ insert()

◆ isPacketDevice()

◆ operator=()

◆ readBlockStart()

◆ readEnd()

◆ serialize()

◆ writeBlockComplete()

Friends And Related Function Documentation

◆ CDXCommand