A non-coherent crossbar connects a number of non-snooping masters and slaves, and routes the request and response packets based on the address. More...
#include <noncoherent_xbar.hh>
Classes | |
| class | NoncoherentXBarMasterPort |
| Declaration of the crossbar master port type, one will be instantiated for each of the slave ports connecting to the crossbar. More... | |
| class | NoncoherentXBarSlavePort |
| Declaration of the non-coherent crossbar slave port type, one will be instantiated for each of the master ports connecting to the crossbar. More... | |
Public Member Functions | |
| NoncoherentXBar (const NoncoherentXBarParams *p) | |
| virtual | ~NoncoherentXBar () |
 Public Member Functions inherited from BaseXBar | |
| virtual | ~BaseXBar () |
| Port & | getPort (const std::string &if_name, PortID idx=InvalidPortID) override |
| A function used to return the port associated with this object. More... | |
| void | regStats () override |
| Callback to set stat parameters. More... | |
| Public Member Functions inherited from ClockedObject | |
| ClockedObject (const ClockedObjectParams *p) | |
| const Params * | params () const |
| void | serialize (CheckpointOut &cp) const override |
| Serialize an object. More... | |
| void | unserialize (CheckpointIn &cp) override |
| Unserialize an object. More... | |
| Enums::PwrState | pwrState () const |
| std::string | pwrStateName () const |
| std::vector< double > | pwrStateWeights () const |
| Returns the percentage residency for each power state. More... | |
| void | computeStats () |
| Record stats values like state residency by computing the time difference from previous update. More... | |
| void | pwrState (Enums::PwrState) |
| Public Member Functions inherited from SimObject | |
| const Params * | params () const |
| SimObject (const Params *_params) | |
| virtual | ~SimObject () |
| virtual const std::string | name () const |
| virtual void | init () |
| init() is called after all C++ SimObjects have been created and all ports are connected. More... | |
| virtual void | loadState (CheckpointIn &cp) |
| loadState() is called on each SimObject when restoring from a checkpoint. More... | |
| virtual void | initState () |
| initState() is called on each SimObject when not restoring from a checkpoint. More... | |
| virtual void | regProbePoints () |
| Register probe points for this object. More... | |
| virtual void | regProbeListeners () |
| Register probe listeners for this object. More... | |
| ProbeManager * | getProbeManager () |
| Get the probe manager for this object. More... | |
| virtual void | startup () |
| startup() is the final initialization call before simulation. More... | |
| DrainState | drain () override |
| Provide a default implementation of the drain interface for objects that don't need draining. More... | |
| virtual void | memWriteback () |
| Write back dirty buffers to memory using functional writes. More... | |
| virtual void | memInvalidate () |
| Invalidate the contents of memory buffers. More... | |
| void | serialize (CheckpointOut &cp) const override |
| Serialize an object. More... | |
| void | unserialize (CheckpointIn &cp) override |
| Unserialize an object. More... | |
| Public Member Functions inherited from EventManager | |
| EventManager (EventManager &em) | |
| EventManager (EventManager *em) | |
| EventManager (EventQueue *eq) | |
| EventQueue * | eventQueue () const |
| void | schedule (Event &event, Tick when) |
| void | deschedule (Event &event) |
| void | reschedule (Event &event, Tick when, bool always=false) |
| void | schedule (Event *event, Tick when) |
| void | deschedule (Event *event) |
| void | reschedule (Event *event, Tick when, bool always=false) |
| void | wakeupEventQueue (Tick when=(Tick) -1) |
| void | setCurTick (Tick newVal) |
| Public Member Functions inherited from Serializable | |
| Serializable () | |
| virtual | ~Serializable () |
| void | serializeSection (CheckpointOut &cp, const char *name) const |
| Serialize an object into a new section. More... | |
| void | serializeSection (CheckpointOut &cp, const std::string &name) const |
| void | unserializeSection (CheckpointIn &cp, const char *name) |
| Unserialize an a child object. More... | |
| void | unserializeSection (CheckpointIn &cp, const std::string &name) |
| Public Member Functions inherited from Drainable | |
| DrainState | drainState () const |
| Return the current drain state of an object. More... | |
| virtual void | notifyFork () |
| Notify a child process of a fork. More... | |
| Public Member Functions inherited from Stats::Group | |
| Group ()=delete | |
| Group (const Group &)=delete | |
| Group & | operator= (const Group &)=delete |
| Group (Group *parent, const char *name=nullptr) | |
| Construct a new statistics group. More... | |
| virtual | ~Group () |
| virtual void | resetStats () |
| Callback to reset stats. More... | |
| virtual void | preDumpStats () |
| Callback before stats are dumped. More... | |
| void | addStat (Stats::Info *info) |
| Register a stat with this group. More... | |
| const std::map< std::string, Group * > & | getStatGroups () const |
| Get all child groups associated with this object. More... | |
| const std::vector< Info * > & | getStats () const |
| Get all stats associated with this object. More... | |
| void | addStatGroup (const char *name, Group *block) |
| Add a stat block as a child of this block. More... | |
| Public Member Functions inherited from Clocked | |
| void | updateClockPeriod () |
| Update the tick to the current tick. More... | |
| Tick | clockEdge (Cycles cycles=Cycles(0)) const |
| Determine the tick when a cycle begins, by default the current one, but the argument also enables the caller to determine a future cycle. More... | |
| Cycles | curCycle () const |
| Determine the current cycle, corresponding to a tick aligned to a clock edge. More... | |
| Tick | nextCycle () const |
| Based on the clock of the object, determine the start tick of the first cycle that is at least one cycle in the future. More... | |
| uint64_t | frequency () const |
| Tick | clockPeriod () const |
| double | voltage () const |
| Cycles | ticksToCycles (Tick t) const |
| Tick | cyclesToTicks (Cycles c) const |
Protected Member Functions | |
| virtual bool | recvTimingReq (PacketPtr pkt, PortID slave_port_id) |
| virtual bool | recvTimingResp (PacketPtr pkt, PortID master_port_id) |
| void | recvReqRetry (PortID master_port_id) |
| Tick | recvAtomicBackdoor (PacketPtr pkt, PortID slave_port_id, MemBackdoorPtr *backdoor=nullptr) |
| void | recvFunctional (PacketPtr pkt, PortID slave_port_id) |
| Protected Member Functions inherited from BaseXBar | |
| virtual void | recvRangeChange (PortID master_port_id) |
| Function called by the port when the crossbar is recieving a range change. More... | |
| PortID | findPort (AddrRange addr_range) |
| Find which port connected to this crossbar (if any) should be given a packet with this address range. More... | |
| AddrRangeList | getAddrRanges () const |
| Return the address ranges the crossbar is responsible for. More... | |
| void | calcPacketTiming (PacketPtr pkt, Tick header_delay) |
| Calculate the timing parameters for the packet. More... | |
| BaseXBar (const BaseXBarParams *p) | |
| Protected Member Functions inherited from Drainable | |
| Drainable () | |
| virtual | ~Drainable () |
| virtual void | drainResume () |
| Resume execution after a successful drain. More... | |
| void | signalDrainDone () const |
| Signal that an object is drained. More... | |
| Protected Member Functions inherited from Clocked | |
| Clocked (ClockDomain &clk_domain) | |
| Create a clocked object and set the clock domain based on the parameters. More... | |
| Clocked (Clocked &)=delete | |
| Clocked & | operator= (Clocked &)=delete |
| virtual | ~Clocked () |
| Virtual destructor due to inheritance. More... | |
| void | resetClock () const |
| Reset the object's clock using the current global tick value. More... | |
| virtual void | clockPeriodUpdated () |
| A hook subclasses can implement so they can do any extra work that's needed when the clock rate is changed. More... | |
Protected Attributes | |
| std::vector< ReqLayer * > | reqLayers |
| Declare the layers of this crossbar, one vector for requests and one for responses. More... | |
| std::vector< RespLayer * > | respLayers |
| Protected Attributes inherited from BaseXBar | |
| const Cycles | frontendLatency |
| Cycles of front-end pipeline including the delay to accept the request and to decode the address. More... | |
| const Cycles | forwardLatency |
| const Cycles | responseLatency |
| const uint32_t | width |
| the width of the xbar in bytes More... | |
| AddrRangeMap< PortID, 3 > | portMap |
| std::unordered_map< RequestPtr, PortID > | routeTo |
| Remember where request packets came from so that we can route responses to the appropriate port. More... | |
| AddrRangeList | xbarRanges |
| all contigous ranges seen by this crossbar More... | |
| AddrRange | defaultRange |
| std::vector< bool > | gotAddrRanges |
| Remember for each of the master ports of the crossbar if we got an address range from the connected slave. More... | |
| bool | gotAllAddrRanges |
| std::vector< QueuedSlavePort * > | slavePorts |
| The master and slave ports of the crossbar. More... | |
| std::vector< MasterPort * > | masterPorts |
| PortID | defaultPortID |
| Port that handles requests that don't match any of the interfaces. More... | |
| const bool | useDefaultRange |
| If true, use address range provided by default device. More... | |
| Stats::Vector | transDist |
| Stats for transaction distribution and data passing through the crossbar. More... | |
| Stats::Vector2d | pktCount |
| Stats::Vector2d | pktSize |
| Protected Attributes inherited from ClockedObject | |
| Enums::PwrState | _currPwrState |
| To keep track of the current power state. More... | |
| Tick | prvEvalTick |
| ClockedObject::ClockedObjectStats | stats |
| Protected Attributes inherited from SimObject | |
| const SimObjectParams * | _params |
| Cached copy of the object parameters. More... | |
| Protected Attributes inherited from EventManager | |
| EventQueue * | eventq |
| A pointer to this object's event queue. More... | |
Additional Inherited Members | |
| Public Types inherited from ClockedObject | |
| typedef ClockedObjectParams | Params |
| Parameters of ClockedObject. More... | |
| Public Types inherited from SimObject | |
| typedef SimObjectParams | Params |
| Static Public Member Functions inherited from SimObject | |
| static void | serializeAll (CheckpointOut &cp) |
| Serialize all SimObjects in the system. More... | |
| static SimObject * | find (const char *name) |
| Find the SimObject with the given name and return a pointer to it. More... | |
| Static Public Member Functions inherited from Serializable | |
| static const std::string & | currentSection () |
| Get the fully-qualified name of the active section. More... | |
| static void | serializeAll (const std::string &cpt_dir) |
| static void | unserializeGlobals (CheckpointIn &cp) |
| Static Public Attributes inherited from Serializable | |
| static int | ckptCount = 0 |
| static int | ckptMaxCount = 0 |
| static int | ckptPrevCount = -1 |
Detailed Description
A non-coherent crossbar connects a number of non-snooping masters and slaves, and routes the request and response packets based on the address.
The request packets issued by the master connected to a non-coherent crossbar could still snoop in caches attached to a coherent crossbar, as is the case with the I/O bus and memory bus in most system configurations. No snoops will, however, reach any master on the non-coherent crossbar itself.
The non-coherent crossbar can be used as a template for modelling PCIe, and non-coherent AMBA and OCP buses, and is typically used for the I/O buses.
Definition at line 70 of file noncoherent_xbar.hh.
Constructor & Destructor Documentation
◆ NoncoherentXBar()
| NoncoherentXBar::NoncoherentXBar | ( | const NoncoherentXBarParams * | p | ) |
Definition at line 57 of file noncoherent_xbar.cc.
References csprintf(), BaseXBar::defaultPortID, ArmISA::i, BaseXBar::masterPorts, SimObject::name(), reqLayers, respLayers, and BaseXBar::slavePorts.
Referenced by recvFunctional(), and NoncoherentXBar::NoncoherentXBarMasterPort::recvReqRetry().
◆ ~NoncoherentXBar()
|
virtual |
Definition at line 93 of file noncoherent_xbar.cc.
References MipsISA::l, reqLayers, and respLayers.
Referenced by NoncoherentXBar::NoncoherentXBarMasterPort::recvReqRetry().
Member Function Documentation
◆ recvAtomicBackdoor()
|
protected |
Definition at line 246 of file noncoherent_xbar.cc.
References Packet::cmdString(), Packet::cmdToIndex(), DPRINTF, BaseXBar::findPort(), Packet::getAddr(), Packet::getAddrRange(), Packet::getSize(), Packet::hasData(), Packet::isResponse(), BaseXBar::masterPorts, SimObject::name(), Packet::payloadDelay, BaseXBar::pktCount, BaseXBar::pktSize, BaseXBar::slavePorts, and BaseXBar::transDist.
Referenced by NoncoherentXBar::NoncoherentXBarSlavePort::recvAtomic(), and NoncoherentXBar::NoncoherentXBarSlavePort::recvAtomicBackdoor().
◆ recvFunctional()
Definition at line 286 of file noncoherent_xbar.cc.
References Packet::cmdString(), DPRINTF, BaseXBar::findPort(), Packet::getAddr(), Packet::getAddrRange(), Packet::isPrint(), Packet::makeResponse(), BaseXBar::masterPorts, SimObject::name(), Packet::needsResponse(), NoncoherentXBar(), MipsISA::p, and BaseXBar::slavePorts.
Referenced by NoncoherentXBar::NoncoherentXBarSlavePort::recvFunctional().
◆ recvReqRetry()
|
protected |
Definition at line 237 of file noncoherent_xbar.cc.
References reqLayers.
Referenced by NoncoherentXBar::NoncoherentXBarMasterPort::recvReqRetry().
◆ recvTimingReq()
Reimplemented in HMCController.
Definition at line 102 of file noncoherent_xbar.cc.
References Packet::cacheResponding(), BaseXBar::calcPacketTiming(), Clocked::clockEdge(), Clocked::clockPeriod(), Packet::cmdString(), Packet::cmdToIndex(), DPRINTF, BaseXBar::findPort(), BaseXBar::forwardLatency, BaseXBar::frontendLatency, Packet::getAddr(), Packet::getAddrRange(), Packet::getSize(), Packet::hasData(), Packet::headerDelay, Packet::isExpressSnoop(), BaseXBar::masterPorts, Port::name(), Packet::needsResponse(), Packet::payloadDelay, BaseXBar::pktCount, BaseXBar::pktSize, Packet::req, reqLayers, BaseXBar::routeTo, BaseXBar::slavePorts, and BaseXBar::transDist.
Referenced by NoncoherentXBar::NoncoherentXBarSlavePort::recvTimingReq().
◆ recvTimingResp()
Definition at line 180 of file noncoherent_xbar.cc.
References BaseXBar::calcPacketTiming(), Clocked::clockEdge(), Clocked::clockPeriod(), Packet::cmdString(), Packet::cmdToIndex(), curTick(), DPRINTF, Packet::getAddr(), Packet::getSize(), Packet::hasData(), Packet::headerDelay, InvalidPortID, BaseXBar::masterPorts, Port::name(), Packet::payloadDelay, BaseXBar::pktCount, BaseXBar::pktSize, Packet::req, respLayers, BaseXBar::responseLatency, BaseXBar::routeTo, BaseXBar::slavePorts, and BaseXBar::transDist.
Referenced by NoncoherentXBar::NoncoherentXBarMasterPort::recvReqRetry(), and NoncoherentXBar::NoncoherentXBarMasterPort::recvTimingResp().
Member Data Documentation
◆ reqLayers
|
protected |
Declare the layers of this crossbar, one vector for requests and one for responses.
Definition at line 79 of file noncoherent_xbar.hh.
Referenced by NoncoherentXBar(), recvReqRetry(), HMCController::recvTimingReq(), recvTimingReq(), and ~NoncoherentXBar().
◆ respLayers
|
protected |
Definition at line 80 of file noncoherent_xbar.hh.
Referenced by NoncoherentXBar(), recvTimingResp(), and ~NoncoherentXBar().
The documentation for this class was generated from the following files: