gem5  v20.1.0.0
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
SerialLink::SerialLinkResponsePort Class Reference

The port on the side that receives requests and sends responses. More...

#include <serial_link.hh>

Inheritance diagram for SerialLink::SerialLinkResponsePort:
ResponsePort Port AtomicResponseProtocol TimingResponseProtocol FunctionalResponseProtocol

Public Member Functions

 SerialLinkResponsePort (const std::string &_name, SerialLink &_serial_link, SerialLinkRequestPort &_mem_side_port, Cycles _delay, int _resp_limit, const std::vector< AddrRange > &_ranges)
 Constructor for the SerialLinkResponsePort. More...
 
void schedTimingResp (PacketPtr pkt, Tick when)
 Queue a response packet to be sent out later and also schedule a send if necessary. More...
 
void retryStalledReq ()
 Retry any stalled request that we have failed to accept at an earlier point in time. More...
 
- Public Member Functions inherited from ResponsePort
 ResponsePort (const std::string &name, SimObject *_owner, PortID id=InvalidPortID)
 Response port. More...
 
virtual ~ResponsePort ()
 
bool isSnooping () const
 Find out if the peer request port is snooping or not. More...
 
void sendRangeChange () const
 Called by the owner to send a range change. More...
 
void unbind () override
 We let the request port do the work, so these don't do anything. More...
 
void bind (Port &peer) override
 Attach to a peer port. More...
 
Tick sendAtomicSnoop (PacketPtr pkt)
 Send an atomic snoop request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
void sendFunctionalSnoop (PacketPtr pkt) const
 Send a functional snoop 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 sendTimingResp (PacketPtr pkt)
 Attempt to send a timing response to the request port by calling its corresponding receive function. More...
 
void sendTimingSnoopReq (PacketPtr pkt)
 Attempt to send a timing snoop request packet to the request port by calling its corresponding receive function. More...
 
void sendRetryReq ()
 Send a retry to the request port that previously attempted a sendTimingReq to this response port and failed. More...
 
void sendRetrySnoopResp ()
 Send a retry to the request port that previously attempted a sendTimingSnoopResp to this response port and failed. More...
 
- Public Member Functions inherited from Port
virtual ~Port ()
 Virtual destructor due to inheritance. More...
 
PortgetPeer ()
 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

bool recvTimingReq (PacketPtr pkt)
 When receiving a timing request from the peer port, pass it to the serial_link. More...
 
void recvRespRetry ()
 When receiving a retry request from the peer port, pass it to the serial_link. More...
 
Tick recvAtomic (PacketPtr pkt)
 When receiving a Atomic requestfrom the peer port, pass it to the serial_link. More...
 
void recvFunctional (PacketPtr pkt)
 When receiving a Functional request from the peer port, pass it to the serial_link. More...
 
AddrRangeList getAddrRanges () const
 When receiving a address range request the peer port, pass it to the serial_link. More...
 
- Protected Member Functions inherited from ResponsePort
void responderUnbind ()
 Called by the request port to unbind. More...
 
void responderBind (RequestPort &request_port)
 Called by the request port to bind. More...
 
Tick recvAtomicBackdoor (PacketPtr pkt, MemBackdoorPtr &backdoor) override
 Default implementations. More...
 
bool tryTiming (PacketPtr pkt) override
 Availability request from the peer. More...
 
bool recvTimingSnoopResp (PacketPtr pkt) override
 Receive a timing snoop response from the peer. 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 AtomicResponseProtocol
Tick sendSnoop (AtomicRequestProtocol *peer, PacketPtr pkt)
 Send an atomic snoop request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
- Protected Member Functions inherited from TimingResponseProtocol
bool sendResp (TimingRequestProtocol *peer, PacketPtr pkt)
 Attempt to send a timing response to the peer by calling its corresponding receive function. More...
 
void sendSnoopReq (TimingRequestProtocol *peer, PacketPtr pkt)
 Attempt to send a timing snoop request packet to the peer by calling its corresponding receive function. More...
 
void sendRetryReq (TimingRequestProtocol *peer)
 Send a retry to the peer that previously attempted a sendTimingReq to this protocol and failed. More...
 
void sendRetrySnoopResp (TimingRequestProtocol *peer)
 Send a retry to the peer that previously attempted a sendTimingSnoopResp to this peer and failed. More...
 
- Protected Member Functions inherited from FunctionalResponseProtocol
void sendSnoop (FunctionalRequestProtocol *peer, PacketPtr pkt) const
 Send a functional snoop 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...
 

Private Member Functions

bool respQueueFull () const
 Is this side blocked from accepting new response packets. More...
 
void trySendTiming ()
 Handle send event, scheduled when the packet at the head of the response queue is ready to transmit (for timing accesses only). More...
 

Private Attributes

SerialLinkserial_link
 The serial_link to which this port belongs. More...
 
SerialLinkRequestPortmem_side_port
 Request port on the other side of the serial_link. More...
 
const Cycles delay
 Minimum request delay though this serial_link. More...
 
const AddrRangeList ranges
 Address ranges to pass through the serial_link. More...
 
std::deque< DeferredPackettransmitList
 Response packet queue. More...
 
unsigned int outstandingResponses
 Counter to track the outstanding responses. More...
 
bool retryReq
 If we should send a retry when space becomes available. More...
 
unsigned int respQueueLimit
 Max queue size for reserved responses. More...
 
EventFunctionWrapper sendEvent
 Send event for the response queue. More...
 

Additional Inherited Members

- Protected Attributes inherited from ResponsePort
SimObjectowner
 
- 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 port on the side that receives requests and sends responses.

The CPU-side port has a set of address ranges that it is responsible for. The CPU-side port also has a buffer for the responses not yet sent.

Definition at line 94 of file serial_link.hh.

Constructor & Destructor Documentation

◆ SerialLinkResponsePort()

SerialLink::SerialLinkResponsePort::SerialLinkResponsePort ( const std::string &  _name,
SerialLink _serial_link,
SerialLinkRequestPort _mem_side_port,
Cycles  _delay,
int  _resp_limit,
const std::vector< AddrRange > &  _ranges 
)

Constructor for the SerialLinkResponsePort.

Parameters
_namethe port name including the owner
_serial_linkthe structural owner
_mem_side_portthe memory-side port on the other side of the serial_link
_delaythe delay in cycles from receiving to sending
_resp_limitthe size of the response queue
_rangesa number of address ranges to forward

Definition at line 55 of file serial_link.cc.

References trySendTiming().

Member Function Documentation

◆ getAddrRanges()

AddrRangeList SerialLink::SerialLinkResponsePort::getAddrRanges ( ) const
protectedvirtual

When receiving a address range request the peer port, pass it to the serial_link.

Implements ResponsePort.

Definition at line 420 of file serial_link.cc.

◆ recvAtomic()

Tick SerialLink::SerialLinkResponsePort::recvAtomic ( PacketPtr  pkt)
protectedvirtual

When receiving a Atomic requestfrom the peer port, pass it to the serial_link.

Implements AtomicResponseProtocol.

Definition at line 373 of file serial_link.cc.

References SerialLink::mem_side_port, and RequestPort::sendAtomic().

◆ recvFunctional()

void SerialLink::SerialLinkResponsePort::recvFunctional ( PacketPtr  pkt)
protectedvirtual

◆ recvRespRetry()

void SerialLink::SerialLinkResponsePort::recvRespRetry ( )
protectedvirtual

When receiving a retry request from the peer port, pass it to the serial_link.

Implements TimingResponseProtocol.

Definition at line 367 of file serial_link.cc.

◆ recvTimingReq()

bool SerialLink::SerialLinkResponsePort::recvTimingReq ( PacketPtr  pkt)
protectedvirtual

◆ respQueueFull()

bool SerialLink::SerialLinkResponsePort::respQueueFull ( ) const
private

Is this side blocked from accepting new response packets.

Returns
true if the reserved space has reached the set limit

Definition at line 117 of file serial_link.cc.

References outstandingResponses, and respQueueLimit.

◆ retryStalledReq()

void SerialLink::SerialLinkResponsePort::retryStalledReq ( )

Retry any stalled request that we have failed to accept at an earlier point in time.

This call will do nothing if no request is waiting.

Definition at line 229 of file serial_link.cc.

References DPRINTF.

Referenced by SerialLink::SerialLinkRequestPort::trySendTiming().

◆ schedTimingResp()

void SerialLink::SerialLinkResponsePort::schedTimingResp ( PacketPtr  pkt,
Tick  when 
)

Queue a response packet to be sent out later and also schedule a send if necessary.

Parameters
pkta response to send out after a delay
whentick when response packet should be sent

Definition at line 256 of file serial_link.cc.

References ArmISA::sendEvent().

Referenced by SerialLink::SerialLinkRequestPort::recvTimingResp().

◆ trySendTiming()

void SerialLink::SerialLinkResponsePort::trySendTiming ( )
private

Handle send event, scheduled when the packet at the head of the response queue is ready to transmit (for timing accesses only).

Definition at line 313 of file serial_link.cc.

References curTick(), divCeil(), DPRINTF, Packet::getAddr(), Packet::getSize(), SerialLink::mem_side_port, SerialLink::DeferredPacket::pkt, SerialLink::SerialLinkRequestPort::reqQueueFull(), ArmISA::sendEvent(), ArmISA::t, and SerialLink::DeferredPacket::tick.

Referenced by SerialLinkResponsePort().

Member Data Documentation

◆ delay

const Cycles SerialLink::SerialLinkResponsePort::delay
private

Minimum request delay though this serial_link.

Definition at line 108 of file serial_link.hh.

◆ mem_side_port

SerialLinkRequestPort& SerialLink::SerialLinkResponsePort::mem_side_port
private

Request port on the other side of the serial_link.

Definition at line 105 of file serial_link.hh.

◆ outstandingResponses

unsigned int SerialLink::SerialLinkResponsePort::outstandingResponses
private

Counter to track the outstanding responses.

Definition at line 122 of file serial_link.hh.

Referenced by respQueueFull().

◆ ranges

const AddrRangeList SerialLink::SerialLinkResponsePort::ranges
private

Address ranges to pass through the serial_link.

Definition at line 111 of file serial_link.hh.

◆ respQueueLimit

unsigned int SerialLink::SerialLinkResponsePort::respQueueLimit
private

Max queue size for reserved responses.

Definition at line 128 of file serial_link.hh.

Referenced by respQueueFull().

◆ retryReq

bool SerialLink::SerialLinkResponsePort::retryReq
private

If we should send a retry when space becomes available.

Definition at line 125 of file serial_link.hh.

◆ sendEvent

EventFunctionWrapper SerialLink::SerialLinkResponsePort::sendEvent
private

Send event for the response queue.

Definition at line 145 of file serial_link.hh.

◆ serial_link

SerialLink& SerialLink::SerialLinkResponsePort::serial_link
private

The serial_link to which this port belongs.

Definition at line 100 of file serial_link.hh.

◆ transmitList

std::deque<DeferredPacket> SerialLink::SerialLinkResponsePort::transmitList
private

Response packet queue.

Response packets are held in this queue for a specified delay to model the processing delay of the serial_link. We use a deque as we need to iterate over the items for functional accesses.

Definition at line 119 of file serial_link.hh.


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

Generated on Wed Sep 30 2020 14:02:31 for gem5 by doxygen 1.8.17