The simple timing port uses a queued port to implement recvFunctional and recvTimingReq through recvAtomic. More...
#include <tport.hh>
Public Member Functions | |
| SimpleTimingPort (const std::string &name, SimObject *owner) | |
| Create a new SimpleTimingPort that relies on a packet queue to hold responses, and implements recvTimingReq and recvFunctional through calls to recvAtomic. More... | |
| virtual | ~SimpleTimingPort () |
 Public Member Functions inherited from QueuedResponsePort | |
| QueuedResponsePort (const std::string &name, SimObject *owner, RespPacketQueue &resp_queue, PortID id=InvalidPortID) | |
| Create a QueuedPort with a given name, owner, and a supplied implementation of a packet queue. More... | |
| virtual | ~QueuedResponsePort () |
| void | schedTimingResp (PacketPtr pkt, Tick when) |
| Schedule the sending of a timing response. More... | |
| bool | trySatisfyFunctional (PacketPtr pkt) |
| Check the list of buffered packets against the supplied functional request. 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... | |
| virtual AddrRangeList | getAddrRanges () const =0 |
| Get a list of the non-overlapping address ranges the owner is responsible for. 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... | |
| 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 | recvFunctional (PacketPtr pkt) |
| Implemented using recvAtomic(). More... | |
| bool | recvTimingReq (PacketPtr pkt) |
| Implemented using recvAtomic(). More... | |
| virtual Tick | recvAtomic (PacketPtr pkt)=0 |
| Receive an atomic request packet from the peer. More... | |
| Protected Member Functions inherited from QueuedResponsePort | |
| void | recvRespRetry () |
| Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called on the peer) and was unsuccessful. 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... | |
Protected Attributes | |
| std::unique_ptr< Packet > | pendingDelete |
| Upstream caches need this packet until true is returned, so hold it for deletion until a subsequent call. More... | |
| Protected Attributes inherited from QueuedResponsePort | |
| RespPacketQueue & | respQueue |
| Packet queue used to store outgoing responses. More... | |
| Protected Attributes inherited from ResponsePort | |
| 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 Attributes | |
| RespPacketQueue | queueImpl |
| The packet queue used to store outgoing responses. More... | |
Detailed Description
The simple timing port uses a queued port to implement recvFunctional and recvTimingReq through recvAtomic.
It is always a response port.
Constructor & Destructor Documentation
◆ SimpleTimingPort()
| SimpleTimingPort::SimpleTimingPort | ( | const std::string & | name, |
| SimObject * | owner | ||
| ) |
Create a new SimpleTimingPort that relies on a packet queue to hold responses, and implements recvTimingReq and recvFunctional through calls to recvAtomic.
Once a request arrives, it is passed to recvAtomic, and in the case of a timing access any response is scheduled to be sent after the delay of the atomic operation.
- Parameters
-
name port name owner structural owner
◆ ~SimpleTimingPort()
|
inlinevirtual |
Member Function Documentation
◆ recvAtomic()
Receive an atomic request packet from the peer.
Implements AtomicResponseProtocol.
Implemented in PioPort< Device >, PioPort< PioDevice >, PioPort< X86ISA::Interrupts >, SMMUControlPort, X86ISA::IntResponsePort< Device >, and X86ISA::IntResponsePort< X86ISA::Interrupts >.
Referenced by recvFunctional(), and recvTimingReq().
◆ recvFunctional()
|
protectedvirtual |
Implemented using recvAtomic().
Implements FunctionalResponseProtocol.
Definition at line 51 of file tport.cc.
References recvAtomic(), QueuedResponsePort::respQueue, and PacketQueue::trySatisfyFunctional().
◆ recvTimingReq()
|
protectedvirtual |
Implemented using recvAtomic().
Implements TimingResponseProtocol.
Definition at line 60 of file tport.cc.
References Packet::cacheResponding(), curTick(), Packet::isResponse(), Packet::needsResponse(), panic, pendingDelete, recvAtomic(), and QueuedResponsePort::schedTimingResp().
Member Data Documentation
◆ pendingDelete
|
protected |
Upstream caches need this packet until true is returned, so hold it for deletion until a subsequent call.
Definition at line 86 of file tport.hh.
Referenced by recvTimingReq().
◆ queueImpl
|
private |
The packet queue used to store outgoing responses.
Note that the queue is made private and that we avoid overloading the name used in the QueuedResponsePort. Access is provided through the queue reference in the base class.
The documentation for this class was generated from the following files: