gem5
[DEVELOP-FOR-23.0]
|
#include <base_gic.hh>
Public Types | |
enum | GicVersion { GicVersion::GIC_V2, GicVersion::GIC_V3, GicVersion::GIC_V4 } |
typedef BaseGicParams | Params |
![]() | |
using | Params = PioDeviceParams |
![]() | |
using | Params = ClockedObjectParams |
Parameters of ClockedObject. More... | |
![]() | |
typedef SimObjectParams | Params |
Public Member Functions | |
BaseGic (const Params &p) | |
virtual | ~BaseGic () |
void | init () override |
init() is called after all C++ SimObjects have been created and all ports are connected. More... | |
const Params & | params () const |
virtual void | sendInt (uint32_t num)=0 |
Post an interrupt from a device that is connected to the GIC. More... | |
virtual void | sendPPInt (uint32_t num, uint32_t cpu)=0 |
Interface call for private peripheral interrupts. More... | |
virtual void | clearPPInt (uint32_t num, uint32_t cpu)=0 |
virtual void | clearInt (uint32_t num)=0 |
Clear an interrupt from a device that is connected to the GIC. More... | |
ArmSystem * | getSystem () const |
virtual bool | supportsVersion (GicVersion version)=0 |
Check if version supported. More... | |
![]() | |
PioDevice (const Params &p) | |
virtual | ~PioDevice () |
void | init () override |
init() is called after all C++ SimObjects have been created and all ports are connected. More... | |
Port & | getPort (const std::string &if_name, PortID idx=InvalidPortID) override |
Get a port with a given name and index. More... | |
![]() | |
ClockedObject (const ClockedObjectParams &p) | |
void | serialize (CheckpointOut &cp) const override |
Serialize an object. More... | |
void | unserialize (CheckpointIn &cp) override |
Unserialize an object. More... | |
![]() | |
const Params & | params () const |
SimObject (const Params &p) | |
virtual | ~SimObject () |
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... | |
![]() | |
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) |
This function is not needed by the usual gem5 event loop but may be necessary in derived EventQueues which host gem5 on other schedulers. More... | |
void | setCurTick (Tick newVal) |
EventManager (EventManager &em) | |
Event manger manages events in the event queue. More... | |
EventManager (EventManager *em) | |
EventManager (EventQueue *eq) | |
![]() | |
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) |
![]() | |
DrainState | drainState () const |
Return the current drain state of an object. More... | |
virtual void | notifyFork () |
Notify a child process of a fork. More... | |
![]() | |
Group (Group *parent, const char *name=nullptr) | |
Construct a new statistics group. More... | |
virtual | ~Group () |
virtual void | regStats () |
Callback to set stat parameters. More... | |
virtual void | resetStats () |
Callback to reset stats. More... | |
virtual void | preDumpStats () |
Callback before stats are dumped. More... | |
void | addStat (statistics::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... | |
const Info * | resolveStat (std::string name) const |
Resolve a stat by its name within this group. More... | |
void | mergeStatGroup (Group *block) |
Merge the contents (stats & children) of a block to this block. More... | |
Group ()=delete | |
Group (const Group &)=delete | |
Group & | operator= (const Group &)=delete |
![]() | |
Named (const std::string &name_) | |
virtual | ~Named ()=default |
virtual std::string | name () const |
![]() | |
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 | blockIntUpdate () const |
When trasferring the state between two GICs (essentially writing architectural registers) an interrupt might be posted by the model. More... | |
![]() | |
virtual AddrRangeList | getAddrRanges () const =0 |
Every PIO device is obliged to provide an implementation that returns the address ranges the device responds to. More... | |
virtual Tick | read (PacketPtr pkt)=0 |
Pure virtual function that the device must implement. More... | |
virtual Tick | write (PacketPtr pkt)=0 |
Pure virtual function that the device must implement. More... | |
![]() | |
Drainable () | |
virtual | ~Drainable () |
virtual void | drainResume () |
Resume execution after a successful drain. More... | |
void | signalDrainDone () const |
Signal that an object is drained. More... | |
![]() | |
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 | |
Platform * | platform |
Platform this GIC belongs to. More... | |
![]() | |
System * | sys |
PioPort< PioDevice > | pioPort |
The pioPort that handles the requests for us and provides us requests that it sees. More... | |
![]() | |
const SimObjectParams & | _params |
Cached copy of the object parameters. More... | |
![]() | |
EventQueue * | eventq |
A pointer to this object's event queue. More... | |
Additional Inherited Members | |
![]() | |
static void | serializeAll (const std::string &cpt_dir) |
Create a checkpoint by serializing 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 void | setSimObjectResolver (SimObjectResolver *resolver) |
There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. More... | |
static SimObjectResolver * | getSimObjectResolver () |
There is a single object name resolver, and it is only set when simulation is restoring from checkpoints. More... | |
![]() | |
static const std::string & | currentSection () |
Gets the fully-qualified name of the active section. More... | |
static void | generateCheckpointOut (const std::string &cpt_dir, std::ofstream &outstream) |
Generate a checkpoint file so that the serialization can be routed to it. More... | |
![]() | |
PowerState * | powerState |
Definition at line 72 of file base_gic.hh.
typedef BaseGicParams gem5::BaseGic::Params |
Definition at line 75 of file base_gic.hh.
|
strong |
Enumerator | |
---|---|
GIC_V2 | |
GIC_V3 | |
GIC_V4 |
Definition at line 76 of file base_gic.hh.
gem5::BaseGic::BaseGic | ( | const Params & | p | ) |
Definition at line 52 of file base_gic.cc.
References fatal_if, gem5::VegaISA::p, and gem5::RealView::setGic().
|
virtual |
Definition at line 66 of file base_gic.cc.
|
inlineprotectedvirtual |
When trasferring the state between two GICs (essentially writing architectural registers) an interrupt might be posted by the model.
We don't want this to happen as the GIC might be in an inconsistent state. We therefore disable side effects by relying on the blockIntUpdate method.
Definition at line 130 of file base_gic.hh.
Referenced by gem5::Gicv3Redistributor::update(), gem5::Gicv3Distributor::update(), gem5::Gicv3CPUInterface::update(), gem5::GicV2::updateIntState(), and gem5::Gicv3CPUInterface::virtualUpdate().
|
pure virtual |
Clear an interrupt from a device that is connected to the GIC.
Depending on the configuration, the GIC may de-assert it's CPU line.
num | number of interrupt to send |
Implemented in gem5::GicV2, gem5::fastmodel::GIC, and gem5::Gicv3.
Referenced by gem5::ArmSPI::clear(), gem5::UFSHostDevice::clearInterrupt(), gem5::RealView::clearPciInt(), and gem5::NoMaliGpu::onInterrupt().
|
pure virtual |
Implemented in gem5::GicV2, gem5::fastmodel::GIC, and gem5::Gicv3.
Referenced by gem5::ArmPPI::clear(), and gem5::VGic::unPostMaintInt().
|
inline |
Definition at line 114 of file base_gic.hh.
References gem5::PioDevice::sys.
Referenced by gem5::Gicv3CPUInterface::assertWakeRequest(), gem5::Gicv3CPUInterface::deassertWakeRequest(), gem5::Gicv3CPUInterface::generateSGI(), gem5::Gicv3Redistributor::getAffinity(), gem5::Gicv3Distributor::Gicv3Distributor(), gem5::Gicv3CPUInterface::haveEL(), init(), gem5::Gicv3Redistributor::init(), gem5::Gicv3Redistributor::read(), gem5::Gicv3Distributor::route(), gem5::Gicv3::unserialize(), and gem5::Gicv3Distributor::update().
|
overridevirtual |
init() is called after all C++ SimObjects have been created and all ports are connected.
Initializations that are independent of unserialization but rely on a fully instantiated and connected SimObject graph should be done here.
Reimplemented from gem5::SimObject.
Reimplemented in gem5::Gicv3.
Definition at line 71 of file base_gic.cc.
References getSystem(), gem5::PioDevice::init(), and gem5::ArmSystem::setGIC().
Referenced by gem5::Gicv3::init().
const BaseGic::Params & gem5::BaseGic::params | ( | ) | const |
Definition at line 78 of file base_gic.cc.
References gem5::SimObject::_params.
Referenced by gem5::fastmodel::GIC::GIC(), gem5::Gicv3::init(), gem5::Gicv3::read(), gem5::Gicv3::reserved(), gem5::Gicv3CPUInterface::setThreadContext(), gem5::Gicv3::supportsVersion(), and gem5::Gicv3::write().
|
pure virtual |
Post an interrupt from a device that is connected to the GIC.
Depending on the configuration, the GIC will pass this interrupt on through to a CPU.
num | number of interrupt to send |
Implemented in gem5::GicV2, gem5::fastmodel::GIC, and gem5::Gicv3.
Referenced by gem5::UFSHostDevice::generateInterrupt(), gem5::NoMaliGpu::onInterrupt(), gem5::RealView::postPciInt(), gem5::ArmSPI::raise(), and gem5::Gicv2m::write().
|
pure virtual |
Interface call for private peripheral interrupts.
num | number of interrupt to send |
cpu | CPU to forward interrupt to |
Implemented in gem5::GicV2, gem5::fastmodel::GIC, and gem5::Gicv3.
Referenced by gem5::VGic::postMaintInt(), and gem5::ArmPPI::raise().
|
pure virtual |
Check if version supported.
Implemented in gem5::GicV2, gem5::Gicv3, and gem5::fastmodel::GIC.
Referenced by gem5::ArmISA::FsWorkload::initState().
|
protected |
Platform this GIC belongs to.
Definition at line 134 of file base_gic.hh.