The QueuedMasterPort combines two queues, a request queue and a snoop response queue, that both share the same port. More...

#include <qport.hh>

Inheritance diagram for QueuedMasterPort:

Public Member Functions
	QueuedMasterPort (const std::string &name, SimObject *owner, ReqPacketQueue &req_queue, SnoopRespPacketQueue &snoop_resp_queue, PortID id=InvalidPortID)
	Create a QueuedPort with a given name, owner, and a supplied implementation of two packet queues. More...

virtual	~QueuedMasterPort ()

void	schedTimingReq (PacketPtr pkt, Tick when)
	Schedule the sending of a timing request. More...

void	schedTimingSnoopResp (PacketPtr pkt, Tick when)
	Schedule the sending of a timing snoop response. More...

bool	trySatisfyFunctional (PacketPtr pkt)
	Check the list of buffered packets against the supplied functional request. More...

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

virtual	~MasterPort ()

void	bind (Port &peer) override
	Bind this master port to a slave port. More...

void	unbind () override
	Unbind this master port and the associated slave port. More...

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

AddrRangeList	getAddrRanges () const
	Get the address ranges of the connected slave 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 slave port by calling its corresponding receive function. More...

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

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

virtual void	sendRetryResp ()
	Send a retry to the slave port that previously attempted a sendTimingResp to this master 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...

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

void	recvRetrySnoopResp ()
	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 MasterPort
virtual void	recvRangeChange ()
	Called to receive an address range change from the peer slave 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...

Protected Member Functions inherited from Port
	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...

virtual bool	recvTimingResp (PacketPtr pkt)=0
	Receive a timing response from the peer. 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 Attributes
ReqPacketQueue &	reqQueue
	Packet queue used to store outgoing requests. More...

SnoopRespPacketQueue &	snoopRespQueue
	Packet queue used to store outgoing snoop responses. More...

Protected Attributes inherited from MasterPort
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...

Detailed Description

The QueuedMasterPort combines two queues, a request queue and a snoop response queue, that both share the same port.

The flow control for requests and snoop responses are completely independent, and so each queue manages its own flow control (retries).

Definition at line 106 of file qport.hh.

Constructor & Destructor Documentation

◆ QueuedMasterPort()

QueuedMasterPort::QueuedMasterPort	(	const std::string &	name,
		SimObject *	owner,
		ReqPacketQueue &	req_queue,
		SnoopRespPacketQueue &	snoop_resp_queue,
		PortID	id = `InvalidPortID`
	)

inline

Create a QueuedPort with a given name, owner, and a supplied implementation of two packet queues.

The external definition of the queues enables e.g. the cache to implement a specific queue behaviuor in a subclass, and provide the latter to the QueuePort constructor.

Definition at line 130 of file qport.hh.

◆ ~QueuedMasterPort()

virtual QueuedMasterPort::~QueuedMasterPort ( )

inlinevirtual

Definition at line 138 of file qport.hh.

Member Function Documentation

◆ recvReqRetry()

void QueuedMasterPort::recvReqRetry ( )

inlineprotectedvirtual

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 117 of file qport.hh.

References PacketQueue::retry().

◆ recvRetrySnoopResp()

void QueuedMasterPort::recvRetrySnoopResp ( )

inlineprotectedvirtual

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

Reimplemented from MasterPort.

Definition at line 119 of file qport.hh.

References PacketQueue::retry().

◆ schedTimingReq()

void QueuedMasterPort::schedTimingReq	(	PacketPtr	pkt,
		Tick	when
	)

inline

Schedule the sending of a timing request.

Parameters

pkt	Packet to send
when	Absolute time (in ticks) to send packet

Definition at line 146 of file qport.hh.

References PacketQueue::schedSendTiming().

Referenced by MemDelay::SlavePort::recvTimingReq(), and AbstractController::serviceMemoryQueue().

◆ schedTimingSnoopResp()

void QueuedMasterPort::schedTimingSnoopResp	(	PacketPtr	pkt,
		Tick	when
	)

inline

Schedule the sending of a timing snoop response.

Parameters

pkt	Packet to send
when	Absolute time (in ticks) to send packet

Definition at line 155 of file qport.hh.

References PacketQueue::schedSendTiming().

Referenced by Cache::doTimingSupplyResponse(), Cache::recvTimingSnoopResp(), and MemDelay::SlavePort::recvTimingSnoopResp().

◆ trySatisfyFunctional()

bool QueuedMasterPort::trySatisfyFunctional ( PacketPtr pkt )

inline

Check the list of buffered packets against the supplied functional request.

Definition at line 160 of file qport.hh.

References PacketQueue::trySatisfyFunctional().

Referenced by BaseCache::functionalAccess(), AbstractController::functionalMemoryWrite(), and MemDelay::trySatisfyFunctional().

Member Data Documentation

◆ reqQueue

ReqPacketQueue& QueuedMasterPort::reqQueue

protected

Packet queue used to store outgoing requests.

Definition at line 112 of file qport.hh.

◆ snoopRespQueue

SnoopRespPacketQueue& QueuedMasterPort::snoopRespQueue

protected

Packet queue used to store outgoing snoop responses.

Definition at line 115 of file qport.hh.

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

mem/qport.hh

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ QueuedMasterPort()

◆ ~QueuedMasterPort()

Member Function Documentation

◆ recvReqRetry()

◆ recvRetrySnoopResp()

◆ schedTimingReq()

◆ schedTimingSnoopResp()

◆ trySatisfyFunctional()

Member Data Documentation

◆ reqQueue

◆ snoopRespQueue