gem5::ItsProcess Class Reference

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:

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.
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
Gicv3Its &	its

Private Attributes
std::unique_ptr< Coroutine >	coroutine

Additional Inherited Members
Public Attributes inherited from gem5::Packet::SenderState
SenderState *	predecessor

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

using gem5::ItsProcess::Coroutine = gem5::Coroutine<PacketPtr, ItsAction>

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

using gem5::ItsProcess::Yield = Coroutine::CallerType

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

Definition at line 94 of file gic_v3_its.cc.

References gem5::ArmISA::a, gem5::X86ISA::addr, gem5::context_switch_task_id::DMA, gem5::Coroutine< Arg, Ret >::CallerType::get(), gem5::Packet::getSize(), its, gem5::MemCmd::ReadReq, gem5::Gicv3Its::requestorId, gem5::SEND_REQ, and gem5::ItsAction::type.

Referenced by gem5::ItsCommand::readCommand(), readDeviceTable(), readIrqCollectionTable(), and readIrqTranslationTable().

doWrite()

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

protected

Definition at line 118 of file gic_v3_its.cc.

References gem5::ArmISA::a, gem5::X86ISA::addr, gem5::context_switch_task_id::DMA, gem5::Coroutine< Arg, Ret >::CallerType::get(), gem5::Packet::getSize(), its, gem5::Gicv3Its::requestorId, gem5::SEND_REQ, gem5::ItsAction::type, and gem5::MemCmd::WriteReq.

Referenced by writeDeviceTable(), writeIrqCollectionTable(), and writeIrqTranslationTable().

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

Definition at line 186 of file gic_v3_its.cc.

References gem5::X86ISA::base, gem5::Gicv3Its::DEVICE_TABLE, doRead(), DPRINTF, its, and gem5::Gicv3Its::pageAddress().

Referenced by gem5::ItsCommand::clear(), gem5::ItsCommand::discard(), gem5::ItsCommand::doInt(), gem5::ItsCommand::inv(), gem5::ItsCommand::mapi(), gem5::ItsCommand::mapti(), gem5::ItsCommand::movi(), and gem5::ItsTranslation::translateLPI().

readIrqCollectionTable()

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

protected

Definition at line 212 of file gic_v3_its.cc.

References gem5::X86ISA::base, gem5::Gicv3Its::COLLECTION_TABLE, doRead(), DPRINTF, its, and gem5::Gicv3Its::pageAddress().

Referenced by gem5::ItsCommand::clear(), gem5::ItsCommand::discard(), gem5::ItsCommand::doInt(), gem5::ItsCommand::inv(), gem5::ItsCommand::invall(), gem5::ItsCommand::movi(), and gem5::ItsTranslation::translateLPI().

readIrqTranslationTable()

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

protected

Definition at line 199 of file gic_v3_its.cc.

References doRead(), and DPRINTF.

Referenced by gem5::ItsCommand::clear(), gem5::ItsCommand::discard(), gem5::ItsCommand::doInt(), gem5::ItsCommand::inv(), gem5::ItsCommand::mapi(), gem5::ItsCommand::mapti(), gem5::ItsCommand::movi(), and gem5::ItsTranslation::translateLPI().

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

Definition at line 142 of file gic_v3_its.cc.

References gem5::ArmISA::a, gem5::TERMINATE, and gem5::ItsAction::type.

Referenced by gem5::ItsCommand::clear(), gem5::ItsCommand::discard(), gem5::ItsCommand::doInt(), gem5::ItsCommand::inv(), gem5::ItsCommand::invall(), gem5::ItsCommand::main(), gem5::ItsTranslation::main(), gem5::ItsCommand::mapc(), gem5::ItsCommand::mapd(), gem5::ItsCommand::mapi(), gem5::ItsCommand::mapti(), gem5::ItsCommand::movi(), and gem5::ItsTranslation::translateLPI().

writeDeviceTable()

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

protected

Definition at line 152 of file gic_v3_its.cc.

References gem5::X86ISA::base, gem5::Gicv3Its::DEVICE_TABLE, doWrite(), DPRINTF, its, and gem5::Gicv3Its::pageAddress().

Referenced by gem5::ItsCommand::mapd().

writeIrqCollectionTable()

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

protected

Definition at line 174 of file gic_v3_its.cc.

References gem5::X86ISA::base, gem5::Gicv3Its::COLLECTION_TABLE, doWrite(), DPRINTF, its, and gem5::Gicv3Its::pageAddress().

Referenced by gem5::ItsCommand::mapc().

writeIrqTranslationTable()

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

protected

Definition at line 163 of file gic_v3_its.cc.

References doWrite(), and DPRINTF.

Referenced by gem5::ItsCommand::discard(), gem5::ItsCommand::mapi(), gem5::ItsCommand::mapti(), and gem5::ItsCommand::movi().

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

Definition at line 397 of file gic_v3_its.hh.

Referenced by gem5::ItsCommand::clear(), gem5::ItsCommand::collectionOutOfRange(), gem5::ItsCommand::deviceOutOfRange(), gem5::ItsCommand::discard(), gem5::ItsCommand::doInt(), doRead(), doWrite(), gem5::ItsCommand::idOutOfRange(), gem5::ItsCommand::inv(), gem5::ItsCommand::invall(), gem5::ItsCommand::ItsCommand(), gem5::ItsTranslation::ItsTranslation(), gem5::ItsCommand::main(), gem5::ItsTranslation::main(), gem5::ItsCommand::mapc(), gem5::ItsCommand::mapd(), gem5::ItsCommand::mapi(), gem5::ItsCommand::mapti(), gem5::ItsCommand::movall(), gem5::ItsCommand::movi(), name(), gem5::ItsCommand::readCommand(), readDeviceTable(), readIrqCollectionTable(), gem5::ItsCommand::sizeOutOfRange(), gem5::ItsTranslation::translateLPI(), writeDeviceTable(), writeIrqCollectionTable(), gem5::ItsCommand::~ItsCommand(), and gem5::ItsTranslation::~ItsTranslation().

---

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

• dev/arm/gic_v3_its.hh
• dev/arm/gic_v3_its.cc