gem5  v21.1.0.2
Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | Private Attributes | List of all members
gem5::ItsProcess Class Referenceabstract

ItsProcess is a base coroutine wrapper which is spawned by the Gicv3Its module when the latter needs to perform different actions, like translating a peripheral's MSI into an LPI (See derived ItsTranslation) or processing a Command from the ITS queue (ItsCommand). More...

#include <gic_v3_its.hh>

Inheritance diagram for gem5::ItsProcess:
gem5::Packet::SenderState gem5::ItsCommand gem5::ItsTranslation

Public Types

using DTE = Gicv3Its::DTE
 
using ITTE = Gicv3Its::ITTE
 
using CTE = Gicv3Its::CTE
 
using Coroutine = gem5::Coroutine< PacketPtr, ItsAction >
 
using Yield = Coroutine::CallerType
 

Public Member Functions

 ItsProcess (Gicv3Its &_its)
 
virtual ~ItsProcess ()
 
const std::string name () const
 Returns the Gicv3Its name. More...
 
ItsAction run (PacketPtr pkt)
 
- Public Member Functions inherited from gem5::Packet::SenderState
 SenderState ()
 
virtual ~SenderState ()
 

Protected Member Functions

void reinit ()
 
virtual void main (Yield &yield)=0
 
void writeDeviceTable (Yield &yield, uint32_t device_id, DTE dte)
 
void writeIrqTranslationTable (Yield &yield, const Addr itt_base, uint32_t event_id, ITTE itte)
 
void writeIrqCollectionTable (Yield &yield, uint32_t collection_id, CTE cte)
 
uint64_t readDeviceTable (Yield &yield, uint32_t device_id)
 
uint64_t readIrqTranslationTable (Yield &yield, const Addr itt_base, uint32_t event_id)
 
uint64_t readIrqCollectionTable (Yield &yield, uint32_t collection_id)
 
void doRead (Yield &yield, Addr addr, void *ptr, size_t size)
 
void doWrite (Yield &yield, Addr addr, void *ptr, size_t size)
 
void terminate (Yield &yield)
 

Protected Attributes

Gicv3Itsits
 

Private Attributes

std::unique_ptr< Coroutinecoroutine
 

Additional Inherited Members

- Public Attributes inherited from gem5::Packet::SenderState
SenderStatepredecessor
 

Detailed Description

ItsProcess is a base coroutine wrapper which is spawned by the Gicv3Its module when the latter needs to perform different actions, like translating a peripheral's MSI into an LPI (See derived ItsTranslation) or processing a Command from the ITS queue (ItsCommand).

The action to take is implemented by the method:

virtual void main(Yield &yield) = 0; It's inheriting from Packet::SenderState since the generic process will be stopped (we are using coroutines) and sent with the packet to memory when doing table walks. When Gicv3Its receives a response, it will resume the coroutine from the point it stopped when yielding.

Definition at line 355 of file gic_v3_its.hh.

Member Typedef Documentation

◆ Coroutine

Definition at line 361 of file gic_v3_its.hh.

◆ CTE

using gem5::ItsProcess::CTE = Gicv3Its::CTE

Definition at line 360 of file gic_v3_its.hh.

◆ DTE

using gem5::ItsProcess::DTE = Gicv3Its::DTE

Definition at line 358 of file gic_v3_its.hh.

◆ ITTE

using gem5::ItsProcess::ITTE = Gicv3Its::ITTE

Definition at line 359 of file gic_v3_its.hh.

◆ Yield

Definition at line 362 of file gic_v3_its.hh.

Constructor & Destructor Documentation

◆ ItsProcess()

gem5::ItsProcess::ItsProcess ( Gicv3Its _its)

Definition at line 63 of file gic_v3_its.cc.

◆ ~ItsProcess()

gem5::ItsProcess::~ItsProcess ( )
virtual

Definition at line 68 of file gic_v3_its.cc.

Member Function Documentation

◆ doRead()

void gem5::ItsProcess::doRead ( Yield yield,
Addr  addr,
void *  ptr,
size_t  size 
)
protected

◆ doWrite()

void gem5::ItsProcess::doWrite ( Yield yield,
Addr  addr,
void *  ptr,
size_t  size 
)
protected

◆ main()

virtual void gem5::ItsProcess::main ( Yield yield)
protectedpure virtual

Implemented in gem5::ItsCommand, and gem5::ItsTranslation.

Referenced by reinit().

◆ name()

const std::string gem5::ItsProcess::name ( ) const

Returns the Gicv3Its name.

Mainly used for DPRINTS

Definition at line 80 of file gic_v3_its.cc.

References its, and gem5::Named::name().

◆ readDeviceTable()

uint64_t gem5::ItsProcess::readDeviceTable ( Yield yield,
uint32_t  device_id 
)
protected

◆ readIrqCollectionTable()

uint64_t gem5::ItsProcess::readIrqCollectionTable ( Yield yield,
uint32_t  collection_id 
)
protected

◆ readIrqTranslationTable()

uint64_t gem5::ItsProcess::readIrqTranslationTable ( Yield yield,
const Addr  itt_base,
uint32_t  event_id 
)
protected

◆ reinit()

void gem5::ItsProcess::reinit ( )
protected

Definition at line 73 of file gic_v3_its.cc.

References coroutine, and main().

Referenced by gem5::ItsCommand::ItsCommand(), and gem5::ItsTranslation::ItsTranslation().

◆ run()

ItsAction gem5::ItsProcess::run ( PacketPtr  pkt)

Definition at line 86 of file gic_v3_its.cc.

References coroutine.

Referenced by gem5::Gicv3Its::runProcessAtomic(), and gem5::Gicv3Its::runProcessTiming().

◆ terminate()

void gem5::ItsProcess::terminate ( Yield yield)
protected

◆ writeDeviceTable()

void gem5::ItsProcess::writeDeviceTable ( Yield yield,
uint32_t  device_id,
DTE  dte 
)
protected

◆ writeIrqCollectionTable()

void gem5::ItsProcess::writeIrqCollectionTable ( Yield yield,
uint32_t  collection_id,
CTE  cte 
)
protected

◆ writeIrqTranslationTable()

void gem5::ItsProcess::writeIrqTranslationTable ( Yield yield,
const Addr  itt_base,
uint32_t  event_id,
ITTE  itte 
)
protected

Member Data Documentation

◆ coroutine

std::unique_ptr<Coroutine> gem5::ItsProcess::coroutine
private

Definition at line 400 of file gic_v3_its.hh.

Referenced by reinit(), and run().

◆ its

Gicv3Its& gem5::ItsProcess::its
protected

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

Generated on Tue Sep 21 2021 12:27:43 for gem5 by doxygen 1.8.17