gem5
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes | List of all members
Bridge::BridgeMasterPort Class Reference

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

#include <bridge.hh>

Inheritance diagram for Bridge::BridgeMasterPort:
MasterPort BaseMasterPort Port

Public Member Functions

 BridgeMasterPort (const std::string &_name, Bridge &_bridge, BridgeSlavePort &_slavePort, Cycles _delay, int _req_limit)
 Constructor for the BridgeMasterPort. 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 checkFunctional (PacketPtr pkt)
 Check a functional request against the packets in our request queue. More...
 
- Public Member Functions inherited from MasterPort
 MasterPort (const std::string &name, MemObject *owner, PortID id=InvalidPortID)
 Master port. More...
 
virtual ~MasterPort ()
 
void bind (BaseSlavePort &slave_port)
 Bind this master port to a slave port. More...
 
void unbind ()
 Unbind this master port and the associated slave port. 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...
 
void sendFunctional (PacketPtr pkt)
 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 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...
 
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...
 
- Public Member Functions inherited from BaseMasterPort
BaseSlavePortgetSlavePort () const
 
bool isConnected () const
 
- Public Member Functions inherited from Port
const std::string name () const
 Return port name (for DPRINTF). More...
 
PortID getId () const
 Get the port id. More...
 

Protected Member Functions

bool recvTimingResp (PacketPtr pkt)
 When receiving a timing request from the peer port, pass it to the bridge. More...
 
void recvReqRetry ()
 When receiving a retry request from the peer port, pass it to the bridge. More...
 
- Protected Member Functions inherited from MasterPort
virtual Tick recvAtomicSnoop (PacketPtr pkt)
 Receive an atomic snoop request packet from the slave port. More...
 
virtual void recvFunctionalSnoop (PacketPtr pkt)
 Receive a functional snoop request packet from the slave port. More...
 
virtual void recvTimingSnoopReq (PacketPtr pkt)
 Receive a timing snoop request from the slave port. More...
 
virtual void recvRetrySnoopResp ()
 Called by the slave port if sendTimingSnoopResp was called on this master port (causing recvTimingSnoopResp to be called on the slave port) and was unsuccesful. More...
 
virtual void recvRangeChange ()
 Called to receive an address range change from the peer slave port. More...
 
- Protected Member Functions inherited from BaseMasterPort
 BaseMasterPort (const std::string &name, MemObject *owner, PortID id=InvalidPortID)
 
virtual ~BaseMasterPort ()
 
- Protected Member Functions inherited from Port
 Port (const std::string &_name, MemObject &_owner, PortID _id)
 Abstract base class for ports. More...
 
virtual ~Port ()
 Virtual destructor due to inheritance. 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

Bridgebridge
 The bridge to which this port belongs. More...
 
BridgeSlavePortslavePort
 The slave port on the other side of the bridge. More...
 
const Cycles delay
 Minimum delay though this bridge. More...
 
std::deque< DeferredPackettransmitList
 Request packet queue. More...
 
const unsigned int reqQueueLimit
 Max queue size for request packets. More...
 
EventWrapper< BridgeMasterPort,&BridgeMasterPort::trySendTimingsendEvent
 Send event for the request queue. More...
 

Additional Inherited Members

- Protected Attributes inherited from BaseMasterPort
BaseSlavePort_baseSlavePort
 
- 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...
 
MemObjectowner
 A reference to the MemObject that owns this port. More...
 

Detailed Description

Port on the side that forwards requests and receives responses.

The master port has a buffer for the requests not yet sent.

Definition at line 223 of file bridge.hh.

Constructor & Destructor Documentation

Bridge::BridgeMasterPort::BridgeMasterPort ( const std::string &  _name,
Bridge _bridge,
BridgeSlavePort _slavePort,
Cycles  _delay,
int  _req_limit 
)

Constructor for the BridgeMasterPort.

Parameters
_namethe port name including the owner
_bridgethe structural owner
_slavePortthe slave port on the other side of the bridge
_delaythe delay in cycles from receiving to sending
_req_limitthe size of the request queue

Definition at line 69 of file bridge.cc.

Member Function Documentation

bool Bridge::BridgeMasterPort::checkFunctional ( 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 381 of file bridge.cc.

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

Referenced by Bridge::BridgeSlavePort::recvFunctional().

void Bridge::BridgeMasterPort::recvReqRetry ( )
protectedvirtual

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

Implements MasterPort.

Definition at line 336 of file bridge.cc.

bool Bridge::BridgeMasterPort::recvTimingResp ( PacketPtr  pkt)
protectedvirtual

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

Implements MasterPort.

Definition at line 131 of file bridge.cc.

References Packet::cmdString(), DPRINTF, Packet::getAddr(), Packet::headerDelay, Packet::payloadDelay, Bridge::BridgeSlavePort::schedTimingResp(), and Bridge::slavePort.

bool Bridge::BridgeMasterPort::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 125 of file bridge.cc.

Referenced by Bridge::BridgeSlavePort::recvTimingReq(), and Bridge::BridgeSlavePort::trySendTiming().

void Bridge::BridgeMasterPort::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 223 of file bridge.cc.

Referenced by Bridge::BridgeSlavePort::recvTimingReq().

void Bridge::BridgeMasterPort::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 254 of file bridge.cc.

References curTick(), DPRINTF, Packet::getAddr(), Bridge::BridgeSlavePort::retryStalledReq(), Bridge::slavePort, and Bridge::DeferredPacket::tick.

Member Data Documentation

Bridge& Bridge::BridgeMasterPort::bridge
private

The bridge to which this port belongs.

Definition at line 229 of file bridge.hh.

const Cycles Bridge::BridgeMasterPort::delay
private

Minimum delay though this bridge.

Definition at line 237 of file bridge.hh.

const unsigned int Bridge::BridgeMasterPort::reqQueueLimit
private

Max queue size for request packets.

Definition at line 248 of file bridge.hh.

EventWrapper<BridgeMasterPort, &BridgeMasterPort::trySendTiming> Bridge::BridgeMasterPort::sendEvent
private

Send event for the request queue.

Definition at line 259 of file bridge.hh.

BridgeSlavePort& Bridge::BridgeMasterPort::slavePort
private

The slave port on the other side of the bridge.

Definition at line 234 of file bridge.hh.

std::deque<DeferredPacket> Bridge::BridgeMasterPort::transmitList
private

Request packet queue.

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

Definition at line 245 of file bridge.hh.


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

Generated on Fri Jun 9 2017 13:04:04 for gem5 by doxygen 1.8.6