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

Port on the side that forwards requests and receives responses. More...

#include <serial_link.hh>

Inheritance diagram for SerialLink::SerialLinkRequestPort:
RequestPort Port AtomicRequestProtocol TimingRequestProtocol FunctionalRequestProtocol

Public Member Functions

 SerialLinkRequestPort (const std::string &_name, SerialLink &_serial_link, SerialLinkResponsePort &_cpu_side_port, Cycles _delay, int _req_limit)
 Constructor for the SerialLinkRequestPort. More...
 
bool reqQueueFull () const
 Is this side blocked from accepting new request packets. More...
 
void schedTimingReq (PacketPtr pkt, Tick when)
 Queue a request packet to be sent out later and also schedule a send if necessary. More...
 
bool trySatisfyFunctional (PacketPtr pkt)
 Check a functional request against the packets in our request queue. 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...
 
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 recvTimingResp (PacketPtr pkt)
 When receiving a timing request from the peer port, pass it to the serial_link. More...
 
void recvReqRetry ()
 When receiving a retry request from the peer port, pass it to the serial_link. 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...
 

Private Member Functions

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

Private Attributes

SerialLinkserial_link
 The serial_link to which this port belongs. More...
 
SerialLinkResponsePortcpu_side_port
 The response (CPU-side port) port on the other side of the serial_link. More...
 
const Cycles delay
 Minimum delay though this serial_link. More...
 
std::deque< DeferredPackettransmitList
 Request packet queue. More...
 
const unsigned int reqQueueLimit
 Max queue size for request packets. More...
 
EventFunctionWrapper sendEvent
 Send event for the request queue. More...
 

Additional Inherited Members

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

Port on the side that forwards requests and receives responses.

The memory-side port has a buffer for the requests not yet sent.

Definition at line 210 of file serial_link.hh.

Constructor & Destructor Documentation

◆ SerialLinkRequestPort()

SerialLink::SerialLinkRequestPort::SerialLinkRequestPort ( const std::string &  _name,
SerialLink _serial_link,
SerialLinkResponsePort _cpu_side_port,
Cycles  _delay,
int  _req_limit 
)

Constructor for the SerialLinkRequestPort.

Parameters
_namethe port name including the owner
_serial_linkthe structural owner
_cpu_side_portthe CPU-side port on the other side of the serial_link
_delaythe delay in cycles from receiving to sending
_req_limitthe size of the request queue

Definition at line 70 of file serial_link.cc.

References trySendTiming().

Member Function Documentation

◆ recvReqRetry()

void SerialLink::SerialLinkRequestPort::recvReqRetry ( )
protectedvirtual

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

Implements TimingRequestProtocol.

Definition at line 361 of file serial_link.cc.

◆ recvTimingResp()

bool SerialLink::SerialLinkRequestPort::recvTimingResp ( PacketPtr  pkt)
protectedvirtual

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

Implements TimingRequestProtocol.

Definition at line 129 of file serial_link.cc.

References Packet::cmdString(), SerialLink::cpu_side_port, divCeil(), DPRINTF, Packet::getAddr(), Packet::getSize(), Packet::headerDelay, Packet::payloadDelay, SerialLink::SerialLinkResponsePort::schedTimingResp(), and ArmISA::t.

◆ reqQueueFull()

bool SerialLink::SerialLinkRequestPort::reqQueueFull ( ) const

Is this side blocked from accepting new request packets.

Returns
true if the occupied space has reached the set limit

Definition at line 123 of file serial_link.cc.

Referenced by SerialLink::SerialLinkResponsePort::recvTimingReq(), and SerialLink::SerialLinkResponsePort::trySendTiming().

◆ schedTimingReq()

void SerialLink::SerialLinkRequestPort::schedTimingReq ( PacketPtr  pkt,
Tick  when 
)

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

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

Definition at line 239 of file serial_link.cc.

References ArmISA::sendEvent().

Referenced by SerialLink::SerialLinkResponsePort::recvTimingReq().

◆ trySatisfyFunctional()

bool SerialLink::SerialLinkRequestPort::trySatisfyFunctional ( PacketPtr  pkt)

Check a functional request against the packets in our request queue.

Parameters
pktpacket to check against
Returns
true if we find a match

Definition at line 403 of file serial_link.cc.

References ArmISA::i, Packet::makeResponse(), and Packet::trySatisfyFunctional().

Referenced by SerialLink::SerialLinkResponsePort::recvFunctional().

◆ trySendTiming()

void SerialLink::SerialLinkRequestPort::trySendTiming ( )
private

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

Definition at line 270 of file serial_link.cc.

References SerialLink::cpu_side_port, curTick(), divCeil(), DPRINTF, Packet::getAddr(), Packet::getSize(), SerialLink::DeferredPacket::pkt, SerialLink::SerialLinkResponsePort::retryStalledReq(), ArmISA::sendEvent(), ArmISA::t, and SerialLink::DeferredPacket::tick.

Referenced by SerialLinkRequestPort().

Member Data Documentation

◆ cpu_side_port

SerialLinkResponsePort& SerialLink::SerialLinkRequestPort::cpu_side_port
private

The response (CPU-side port) port on the other side of the serial_link.

Definition at line 222 of file serial_link.hh.

◆ delay

const Cycles SerialLink::SerialLinkRequestPort::delay
private

Minimum delay though this serial_link.

Definition at line 225 of file serial_link.hh.

◆ reqQueueLimit

const unsigned int SerialLink::SerialLinkRequestPort::reqQueueLimit
private

Max queue size for request packets.

Definition at line 236 of file serial_link.hh.

◆ sendEvent

EventFunctionWrapper SerialLink::SerialLinkRequestPort::sendEvent
private

Send event for the request queue.

Definition at line 246 of file serial_link.hh.

◆ serial_link

SerialLink& SerialLink::SerialLinkRequestPort::serial_link
private

The serial_link to which this port belongs.

Definition at line 216 of file serial_link.hh.

◆ transmitList

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

Request packet queue.

Request 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 233 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