#include <dma_device.hh>

Inheritance diagram for DmaPort:

Classes
struct	DmaReqState

Public Member Functions
	DmaPort (ClockedObject dev, System s, uint32_t sid=0, uint32_t ssid=0)

void	dmaAction (Packet::Command cmd, Addr addr, int size, Event event, uint8_t data, Tick delay, Request::Flags flag=0)

void	dmaAction (Packet::Command cmd, Addr addr, int size, Event event, uint8_t data, uint32_t sid, uint32_t ssid, Tick delay, Request::Flags flag=0)

bool	dmaPending () const

DrainState	drain () override
	Draining is the process of clearing out the states of SimObjects.These are the SimObjects that are partially executed or are partially in flight. More...

Public Member Functions inherited from RequestPort
	RequestPort (const std::string &name, SimObject *_owner, PortID id=InvalidPortID)
	Request port. More...

virtual	~RequestPort ()

void	bind (Port &peer) override
	Bind this request port to a response port. More...

void	unbind () override
	Unbind this request port and the associated response port. More...

virtual bool	isSnooping () const
	Determine if this request port is snooping or not. More...

AddrRangeList	getAddrRanges () const
	Get the address ranges of the connected responder port. More...

void	printAddr (Addr a)
	Inject a PrintReq for the given address to print the state of that address throughout the memory system. More...

Tick	sendAtomic (PacketPtr pkt)
	Send an atomic request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...

Tick	sendAtomicBackdoor (PacketPtr pkt, MemBackdoorPtr &backdoor)
	Send an atomic request packet like above, but also request a backdoor to the data being accessed. More...

void	sendFunctional (PacketPtr pkt) const
	Send a functional request packet, where the data is instantly updated everywhere in the memory system, without affecting the current state of any block or moving the block. More...

bool	sendTimingReq (PacketPtr pkt)
	Attempt to send a timing request to the responder port by calling its corresponding receive function. More...

bool	tryTiming (PacketPtr pkt) const
	Check if the responder can handle a timing request. More...

bool	sendTimingSnoopResp (PacketPtr pkt)
	Attempt to send a timing snoop response packet to the response port by calling its corresponding receive function. More...

virtual void	sendRetryResp ()
	Send a retry to the response port that previously attempted a sendTimingResp to this request port and failed. More...

Public Member Functions inherited from Port
virtual	~Port ()
	Virtual destructor due to inheritance. More...

Port &	getPeer ()
	Return a reference to this port's peer. More...

const std::string	name () const
	Return port name (for DPRINTF). More...

PortID	getId () const
	Get the port id. More...

bool	isConnected () const
	Is this port currently connected to a peer? More...

void	takeOverFrom (Port *old)
	A utility function to make it easier to swap out ports. More...

Public Member Functions inherited from Drainable
DrainState	drainState () const
	Return the current drain state of an object. More...

virtual void	notifyFork ()
	Notify a child process of a fork. More...

Public Attributes
ClockedObject *const	device
	The device that owns this port. More...

System *const	sys
	The system that device/port are in. More...

const RequestorID	requestorId
	Id for all requests. More...

Protected Member Functions
bool	recvTimingResp (PacketPtr pkt) override
	Receive a timing response from the peer. More...

void	recvReqRetry () override
	Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on the peer) and was unsuccessful. More...

Protected Member Functions inherited from RequestPort
virtual void	recvRangeChange ()
	Called to receive an address range change from the peer response port. More...

Tick	recvAtomicSnoop (PacketPtr pkt) override
	Default implementations. More...

void	recvFunctionalSnoop (PacketPtr pkt) override
	Receive a functional snoop request packet from the peer. More...

void	recvTimingSnoopReq (PacketPtr pkt) override
	Receive a timing snoop request from the peer. More...

void	recvRetrySnoopResp () override
	Called by the peer if sendTimingSnoopResp was called on this protocol (causing recvTimingSnoopResp to be called on the peer) and was unsuccessful. More...

Protected Member Functions inherited from Port
void	reportUnbound () const

	Port (const std::string &_name, PortID _id)
	Abstract base class for ports. More...

Protected Member Functions inherited from AtomicRequestProtocol
Tick	send (AtomicResponseProtocol *peer, PacketPtr pkt)
	Send an atomic request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...

Tick	sendBackdoor (AtomicResponseProtocol *peer, PacketPtr pkt, MemBackdoorPtr &backdoor)
	Send an atomic request packet like above, but also request a backdoor to the data being accessed. More...

Protected Member Functions inherited from TimingRequestProtocol
bool	sendReq (TimingResponseProtocol *peer, PacketPtr pkt)
	Attempt to send a timing request to the peer by calling its corresponding receive function. More...

bool	trySend (TimingResponseProtocol *peer, PacketPtr pkt) const
	Check if the peer can handle a timing request. More...

bool	sendSnoopResp (TimingResponseProtocol *peer, PacketPtr pkt)
	Attempt to send a timing snoop response packet to it's peer by calling its corresponding receive function. More...

void	sendRetryResp (TimingResponseProtocol *peer)
	Send a retry to the peer that previously attempted a sendTimingResp to this protocol and failed. More...

Protected Member Functions inherited from FunctionalRequestProtocol
void	send (FunctionalResponseProtocol *peer, PacketPtr pkt) const
	Send a functional request packet, where the data is instantly updated everywhere in the memory system, without affecting the current state of any block or moving the block. More...

Protected Member Functions inherited from Drainable
	Drainable ()

virtual	~Drainable ()

virtual void	drainResume ()
	Resume execution after a successful drain. More...

void	signalDrainDone () const
	Signal that an object is drained. More...

Protected Attributes
std::deque< DmaReqState * >	transmitList
	Use a deque as we never do any insertion or removal in the middle. More...

EventFunctionWrapper	sendEvent
	Event used to schedule a future sending from the transmit list. More...

uint32_t	pendingCount = 0
	Number of outstanding packets the dma port has. More...

PacketPtr	inRetry = nullptr
	The packet (if any) waiting for a retry to send. More...

const uint32_t	defaultSid
	Default streamId. More...

const uint32_t	defaultSSid
	Default substreamId. More...

const int	cacheLineSize

Protected Attributes inherited from RequestPort
SimObject &	owner

Protected Attributes inherited from Port
const PortID	id
	A numeric identifier to distinguish ports in a vector, and set to InvalidPortID in case this port is not part of a vector. More...

Port *	_peer
	A pointer to this port's peer. More...

bool	_connected
	Whether this port is currently connected to a peer port. More...

Private Member Functions
void	trySendTimingReq ()
	Take the first request on the transmit list and attempt to send a timing packet from it. More...

void	sendDma ()
	For timing, attempt to send the first item on the transmit list, and if it is successful and there are more packets waiting, then schedule the sending of the next packet. More...

bool	sendAtomicReq (DmaReqState *state)
	Send the next packet from a DMA request in atomic mode. More...

bool	sendAtomicBdReq (DmaReqState *state)
	Send the next packet from a DMA request in atomic mode, and request and/or use memory backdoors if possible. More...

void	handleRespPacket (PacketPtr pkt, Tick delay=0)
	Handle a response packet by updating the corresponding DMA request state to reflect the bytes received, and also update the pending request counter. More...

void	handleResp (DmaReqState *state, Addr addr, Addr size, Tick delay=0)

Private Attributes
AddrRangeMap< MemBackdoorPtr, 1 >	memBackdoors

Detailed Description

Definition at line 58 of file dma_device.hh.

Constructor & Destructor Documentation

◆ DmaPort()

DmaPort::DmaPort	(	ClockedObject *	dev,
		System *	s,
		uint32_t	sid = `0`,
		uint32_t	ssid = `0`
	)

Definition at line 55 of file dma_device.cc.

References sendDma().

Member Function Documentation

◆ dmaAction() [1/2]

void DmaPort::dmaAction	(	Packet::Command	cmd,
		Addr	addr,
		int	size,
		Event *	event,
		uint8_t *	data,
		Tick	delay,
		Request::Flags	flag = `0`
	)

◆ dmaAction() [2/2]

void DmaPort::dmaAction	(	Packet::Command	cmd,
		Addr	addr,
		int	size,
		Event *	event,
		uint8_t *	data,
		uint32_t	sid,
		uint32_t	ssid,
		Tick	delay,
		Request::Flags	flag = `0`
	)

Definition at line 171 of file dma_device.cc.

References X86ISA::addr, cacheLineSize, data, ContextSwitchTaskId::DMA, DPRINTF, MipsISA::event, pendingCount, requestorId, sendDma(), and transmitList.

◆ dmaPending()

bool DmaPort::dmaPending ( ) const

inline

Definition at line 195 of file dma_device.hh.

References pendingCount.

Referenced by DmaDevice::dmaPending().

◆ drain()

DrainState DmaPort::drain ( )

overridevirtual

Draining is the process of clearing out the states of SimObjects.These are the SimObjects that are partially executed or are partially in flight.

Draining is mostly used before forking and creating a check point.

This function notifies an object that it needs to drain its state.

If the object does not need further simulation to drain internal buffers, it returns DrainState::Drained and automatically switches to the Drained state. If the object needs more simulation, it returns DrainState::Draining and automatically enters the Draining state. Other return values are invalid.

Note: An object that has entered the Drained state can be disturbed by other objects in the system and consequently stop being drained. These perturbations are not visible in the drain state. The simulator therefore repeats the draining process until all objects return DrainState::Drained on the first call to drain().

Returns: DrainState::Drained if the object is drained at this point in time, DrainState::Draining if it needs further simulation.

Implements Drainable.

Definition at line 153 of file dma_device.cc.

References DPRINTF, Drained, Draining, and pendingCount.

◆ handleResp()

void DmaPort::handleResp	(	DmaReqState *	state,
		Addr	addr,
		Addr	size,
		Tick	delay = `0`
	)

private

Definition at line 79 of file dma_device.cc.

References X86ISA::addr, DmaPort::DmaReqState::cmd, DmaPort::DmaReqState::completionEvent, curTick(), DmaPort::DmaReqState::delay, device, ContextSwitchTaskId::DMA, DPRINTF, DmaPort::DmaReqState::numBytes, pendingCount, EventManager::schedule(), Event::scheduled(), Drainable::signalDrainDone(), MemCmd::toString(), and DmaPort::DmaReqState::totBytes.

Referenced by handleRespPacket(), and sendAtomicBdReq().

◆ handleRespPacket()

void DmaPort::handleRespPacket	(	PacketPtr	pkt,
		Tick	delay = `0`
	)

private

Handle a response packet by updating the corresponding DMA request state to reflect the bytes received, and also update the pending request counter.

If the DMA request that this packet is part of is complete, then signal the completion event if present, potentially with a delay added to it.

Parameters

pkt	Response packet to handler
delay	Additional delay for scheduling the completion event

Definition at line 64 of file dma_device.cc.

References Packet::getAddr(), handleResp(), Packet::isResponse(), Packet::req, and Packet::senderState.

Referenced by recvTimingResp(), sendAtomicBdReq(), and sendAtomicReq().

◆ recvReqRetry()

void DmaPort::recvReqRetry ( )

overrideprotectedvirtual

Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on the peer) and was unsuccessful.

Implements TimingRequestProtocol.

Definition at line 164 of file dma_device.cc.

References transmitList, and trySendTimingReq().

◆ recvTimingResp()

bool DmaPort::recvTimingResp ( PacketPtr pkt )

overrideprotectedvirtual

Receive a timing response from the peer.

Implements TimingRequestProtocol.

Definition at line 129 of file dma_device.cc.

References Packet::cacheResponding(), handleRespPacket(), Packet::hasSharers(), and Packet::req.

◆ sendAtomicBdReq()

bool DmaPort::sendAtomicBdReq ( DmaReqState * state )

private

Send the next packet from a DMA request in atomic mode, and request and/or use memory backdoors if possible.

Definition at line 255 of file dma_device.cc.

References ChunkGenerator::addr(), PowerISA::bd, DmaPort::DmaReqState::cmd, ChunkGenerator::complete(), DmaPort::DmaReqState::createPacket(), DmaPort::DmaReqState::data, ContextSwitchTaskId::DMA, DPRINTF, DmaPort::DmaReqState::gen, handleResp(), handleRespPacket(), MemCmd::isRead(), memBackdoors, ChunkGenerator::next(), ArmISA::offset, panic, RequestPort::sendAtomicBackdoor(), ChunkGenerator::setNext(), ChunkGenerator::size(), and DmaPort::DmaReqState::totBytes.

Referenced by sendDma().

◆ sendAtomicReq()

bool DmaPort::sendAtomicReq ( DmaReqState * state )

private

Send the next packet from a DMA request in atomic mode.

Definition at line 241 of file dma_device.cc.

References ChunkGenerator::addr(), DmaPort::DmaReqState::createPacket(), ContextSwitchTaskId::DMA, DPRINTF, DmaPort::DmaReqState::gen, handleRespPacket(), ChunkGenerator::next(), RequestPort::sendAtomic(), and ChunkGenerator::size().

Referenced by sendDma().

◆ sendDma()

void DmaPort::sendDma ( )

private

For timing, attempt to send the first item on the transmit list, and if it is successful and there are more packets waiting, then schedule the sending of the next packet.

For atomic, simply send and process everything on the transmit list.

Definition at line 327 of file dma_device.cc.

References System::bypassCaches(), ContextSwitchTaskId::DMA, ChunkGenerator::done(), DPRINTF, DmaPort::DmaReqState::gen, inRetry, System::isAtomicMode(), System::isTimingMode(), panic, Event::scheduled(), sendAtomicBdReq(), sendAtomicReq(), sendEvent, sys, transmitList, and trySendTimingReq().

Referenced by dmaAction(), and DmaPort().

◆ trySendTimingReq()

void DmaPort::trySendTimingReq ( )

private

Take the first request on the transmit list and attempt to send a timing packet from it.

If it is successful, schedule the sending of the next packet. Otherwise remember that we are waiting for a retry.

Definition at line 201 of file dma_device.cc.

References Clocked::clockEdge(), Packet::cmdString(), DmaPort::DmaReqState::createPacket(), device, ContextSwitchTaskId::DMA, DPRINTF, DmaPort::DmaReqState::gen, Packet::getAddr(), inRetry, ChunkGenerator::last(), ChunkGenerator::next(), EventManager::schedule(), sendEvent, RequestPort::sendTimingReq(), and transmitList.

Referenced by recvReqRetry(), and sendDma().

Member Data Documentation

◆ cacheLineSize

const int DmaPort::cacheLineSize

protected

Definition at line 175 of file dma_device.hh.

Referenced by dmaAction().

◆ defaultSid

const uint32_t DmaPort::defaultSid

protected

Default streamId.

Definition at line 170 of file dma_device.hh.

Referenced by dmaAction().

◆ defaultSSid

const uint32_t DmaPort::defaultSSid

protected

Default substreamId.

Definition at line 173 of file dma_device.hh.

Referenced by dmaAction().

◆ device

ClockedObject* const DmaPort::device

The device that owns this port.

Definition at line 147 of file dma_device.hh.

Referenced by handleResp(), and trySendTimingReq().

◆ inRetry

PacketPtr DmaPort::inRetry = nullptr

protected

The packet (if any) waiting for a retry to send.

Definition at line 167 of file dma_device.hh.

Referenced by sendDma(), and trySendTimingReq().

◆ memBackdoors

AddrRangeMap<MemBackdoorPtr, 1> DmaPort::memBackdoors

private

Definition at line 61 of file dma_device.hh.

Referenced by sendAtomicBdReq().

◆ pendingCount

uint32_t DmaPort::pendingCount = 0

protected

Number of outstanding packets the dma port has.

Definition at line 164 of file dma_device.hh.

Referenced by dmaAction(), dmaPending(), drain(), and handleResp().

◆ requestorId

const RequestorID DmaPort::requestorId

Id for all requests.

Definition at line 154 of file dma_device.hh.

Referenced by dmaAction().

◆ sendEvent

EventFunctionWrapper DmaPort::sendEvent

protected

Event used to schedule a future sending from the transmit list.

Definition at line 161 of file dma_device.hh.

Referenced by sendDma(), and trySendTimingReq().

◆ sys

System* const DmaPort::sys

The system that device/port are in.

This is used to select which mode we are currently operating in.

Definition at line 151 of file dma_device.hh.

Referenced by DmaReadFifo::resumeFill(), and sendDma().

◆ transmitList

std::deque<DmaReqState *> DmaPort::transmitList

protected

Use a deque as we never do any insertion or removal in the middle.

Definition at line 158 of file dma_device.hh.

Referenced by dmaAction(), recvReqRetry(), sendDma(), and trySendTimingReq().

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

dev/dma_device.hh
dev/dma_device.cc

Classes

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ DmaPort()

Member Function Documentation

◆ dmaAction() [1/2]

◆ dmaAction() [2/2]

◆ dmaPending()

◆ drain()

◆ handleResp()

◆ handleRespPacket()

◆ recvReqRetry()

◆ recvTimingResp()

◆ sendAtomicBdReq()

◆ sendAtomicReq()

◆ sendDma()

◆ trySendTimingReq()

Member Data Documentation

◆ cacheLineSize

◆ defaultSid

◆ defaultSSid

◆ device

◆ inRetry

◆ memBackdoors

◆ pendingCount

◆ requestorId

◆ sendEvent

◆ sys

◆ transmitList