Fetch class handles both single threaded and SMT fetch. More...

#include <fetch.hh>

Classes
struct	FetchStatGroup
class	FetchTranslation
class	FinishTranslationEvent
class	IcachePort
	IcachePort class for instruction fetch. More...
struct	Stalls
	Source of possible stalls. More...

Public Types
enum	FetchStatus { Active , Inactive }
	Overall fetch status. More...
enum	ThreadStatus { Running , Idle , Squashing , Blocked , Fetching , TrapPending , QuiescePending , ItlbWait , IcacheWaitResponse , IcacheWaitRetry , IcacheAccessComplete , FTQEmpty , NoGoodAddr }
	Individual thread status. More...

Public Member Functions
	Fetch (CPU *_cpu, const BaseO3CPUParams &params)
	Fetch constructor.
std::string	name () const
	Returns the name of fetch.
void	regProbePoints ()
	Registers probes.
void	setTimeBuffer (TimeBuffer< TimeStruct > *time_buffer)
	Sets the main backwards communication time buffer pointer.
void	setActiveThreads (std::list< ThreadID > *at_ptr)
	Sets pointer to list of active threads.
void	setFetchQueue (TimeBuffer< FetchStruct > *fq_ptr)
	Sets pointer to time buffer used to communicate to the next stage.
void	setBACandFTQPtr (BAC bac_ptr, FTQ ftq_ptr)
	Sets pointer to branch address calculation stage and FTQ.
void	startupStage ()
	Initialize stage.
void	clearStates (ThreadID tid)
	Clear all thread-specific states.
void	recvReqRetry ()
	Handles retrying the fetch access.
void	processCacheCompletion (PacketPtr pkt)
	Processes cache completion event.
void	drainResume ()
	Resume after a drain.
void	drainSanityCheck () const
	Perform sanity checks after a drain.
bool	isDrained () const
	Has the stage drained?
void	takeOverFrom ()
	Takes over from another CPU's thread.
void	drainStall (ThreadID tid)
	Stall the fetch stage after reaching a safe drain point.
void	wakeFromQuiesce ()
	Tells fetch to wake up from a quiesce instruction.
void	deactivateThread (ThreadID tid)
	For priority-based fetch policies, need to keep update priorityList.
void	squashFromCommit (const PCStateBase &new_pc, const InstSeqNum seq_num, DynInstPtr squashInst, ThreadID tid)
	Squashes a specific thread and resets the PC.
void	tick ()
	Ticks the fetch stage, processing all inputs signals and fetching as many instructions as possible.
bool	checkSignalsAndUpdate (ThreadID tid)
	Checks all input signals and updates the status as necessary.
void	fetch (bool &status_change)
	Does the actual fetching of instructions and passing them on to the next stage.
Addr	fetchBufferAlignPC (Addr addr)
	Align a PC to the start of a fetch buffer block.
RequestPort &	getInstPort ()

Public Attributes
InstDecoder *	decoder [MaxThreads]
	The decoder.

Protected Attributes
gem5::o3::Fetch::FetchStatGroup	fetchStats

Private Member Functions
void	resetStage ()
	Reset this pipeline stage.
void	switchToActive ()
	Changes the status of this stage to active, and indicates this to the CPU.
void	switchToInactive ()
	Changes the status of this stage to inactive, and indicates this to the CPU.
bool	fetchCacheLine (Addr vaddr, ThreadID tid, Addr pc)
	Fetches the cache line that contains the fetch PC.
void	finishTranslation (const Fault &fault, const RequestPtr &mem_req)
bool	checkInterrupt (Addr pc)
	Check if an interrupt is pending and that we need to handle.
void	doSquash (const PCStateBase &new_pc, const DynInstPtr squashInst, ThreadID tid)
	Squashes a specific thread and resets the PC.
void	squashFromDecode (const PCStateBase &new_pc, const DynInstPtr squashInst, const InstSeqNum seq_num, ThreadID tid)
	Squashes a specific thread and resets the PC.
void	bacResteer (const PCStateBase &new_pc, ThreadID tid)
	Signal BAC to redirect.
bool	checkStall (ThreadID tid) const
	Checks if a thread is stalled.
bool	ftqReady (ThreadID tid, bool &status_change)
	Checks if the FTQ is ready.
FetchStatus	updateFetchStatus ()
	Updates overall fetch stage status; to be called at the end of each cycle.
DynInstPtr	buildInst (ThreadID tid, StaticInstPtr staticInst, StaticInstPtr curMacroop, const PCStateBase &this_pc, const PCStateBase &next_pc, bool trace)
ThreadID	getFetchingThread ()
	Returns the appropriate thread to fetch, given the fetch policy.
ThreadID	roundRobin ()
	Returns the appropriate thread to fetch using a round robin policy.
ThreadID	iqCount ()
	Returns the appropriate thread to fetch using the IQ count policy.
ThreadID	lsqCount ()
	Returns the appropriate thread to fetch using the LSQ count policy.
ThreadID	branchCount ()
	Returns the appropriate thread to fetch using the branch count policy.
void	pipelineIcacheAccesses (ThreadID tid)
	Pipeline the next I-cache access to the current one.
void	profileStall (ThreadID tid)
	Profile the reasons of fetch stall.

Private Attributes
FetchStatus	_status
	Fetch status.
ThreadStatus	fetchStatus [MaxThreads]
	Per-thread status.
SMTFetchPolicy	fetchPolicy
	Fetch policy.
std::list< ThreadID >	priorityList
	List that has the threads organized by priority.
ProbePointArg< DynInstPtr > *	ppFetch
	Probe points.
ProbePointArg< RequestPtr > *	ppFetchRequestSent
	To probe when a fetch request is successfully sent.
Random::RandomPtr	rng = Random::genRandom()
CPU *	cpu
	Pointer to the O3CPU.
TimeBuffer< TimeStruct > *	timeBuffer
	Time buffer interface.
TimeBuffer< TimeStruct >::wire	fromDecode
	Wire to get decode's information from backwards time buffer.
TimeBuffer< TimeStruct >::wire	fromRename
	Wire to get rename's information from backwards time buffer.
TimeBuffer< TimeStruct >::wire	fromIEW
	Wire to get iew's information from backwards time buffer.
TimeBuffer< TimeStruct >::wire	fromCommit
	Wire to get commit's information from backwards time buffer.
TimeBuffer< TimeStruct >::wire	toBAC
	Wire used to write any information backward to BAC.
TimeBuffer< FetchStruct >::wire	toDecode
	Wire used to write any information heading to decode.
BAC *	bac
	BPredict.
FTQ *	ftq
	Fetch Target Queue.
std::unique_ptr< PCStateBase >	pc [MaxThreads]
Addr	fetchOffset [MaxThreads]
StaticInstPtr	macroop [MaxThreads]
bool	delayedCommit [MaxThreads]
	Can the fetch stage redirect from an interrupt on this instruction?
RequestPtr	memReq [MaxThreads]
	Memory request used to access cache.
bool	wroteToTimeBuffer
	Variable that tracks if fetch has written to the time buffer this cycle.
int	numInst
	Tracks how many instructions has been fetched this cycle.
Stalls	stalls [MaxThreads]
	Tracks which stages are telling fetch to stall.
const bool	decoupledFrontEnd
	Enables the decoupled front-end.
const Cycles	decodeToFetchDelay
	Decode to fetch delay.
const Cycles	renameToFetchDelay
	Rename to fetch delay.
const Cycles	iewToFetchDelay
	IEW to fetch delay.
const Cycles	commitToFetchDelay
	Commit to fetch delay.
const unsigned	fetchWidth
	The width of fetch in instructions.
const unsigned	decodeWidth
	The width of decode in instructions.
bool	cacheBlocked
	Is the cache blocked?
PacketPtr	retryPkt
	The packet that is waiting to be retried.
ThreadID	retryTid
	The thread that is waiting on the cache to tell fetch to retry.
Addr	cacheBlkSize
	Cache block size.
unsigned	fetchBufferSize
	The size of the fetch buffer in bytes.
Addr	fetchBufferMask
	Mask to align a fetch address to a fetch buffer boundary.
uint8_t *	fetchBuffer [MaxThreads]
	The fetch data that is being fetched and buffered.
Addr	fetchBufferPC [MaxThreads]
	The PC of the first instruction loaded into the fetch buffer.
unsigned	fetchQueueSize
	The size of the fetch queue in micro-ops.
std::deque< DynInstPtr >	fetchQueue [MaxThreads]
	Queue of fetched instructions.
bool	fetchBufferValid [MaxThreads]
	Whether or not the fetch buffer data is valid.
int	instSize
	Size of instructions.
Counter	lastIcacheStall [MaxThreads]
	Icache stall statistics.
std::list< ThreadID > *	activeThreads
	List of Active Threads.
ThreadID	numThreads
	Number of threads.
ThreadID	numFetchingThreads
	Number of threads that are actively fetching.
ThreadID	threadFetched
	Thread ID being fetched.
bool	interruptPending
	Checks if there is an interrupt pending.
IcachePort	icachePort
	Instruction port.
bool	issuePipelinedIfetch [MaxThreads]
	Set to true if a pipelined I-cache request should be issued.
FinishTranslationEvent	finishTranslationEvent
	Event used to delay fault generation of translation faults.
const unsigned	maxFTPerCycle
const unsigned	maxTakenPredPerCycle

Detailed Description

Fetch class handles both single threaded and SMT fetch.

Its width is specified by the parameters; each cycle it tries to fetch that many instructions. It supports using a branch predictor to predict direction and targets. It supports the idling functionality of the CPU by indicating to the CPU when it is active and inactive.

Definition at line 82 of file fetch.hh.

Member Enumeration Documentation

◆ FetchStatus

enum gem5::o3::Fetch::FetchStatus

Overall fetch status.

Used to determine if the CPU can deschedule itsef due to a lack of activity.

Enumerator
Active
Inactive

Definition at line 166 of file fetch.hh.

◆ ThreadStatus

enum gem5::o3::Fetch::ThreadStatus

Individual thread status.

Enumerator
Running
Idle
Squashing
Blocked
Fetching
TrapPending
QuiescePending
ItlbWait
IcacheWaitResponse
IcacheWaitRetry
IcacheAccessComplete
FTQEmpty
NoGoodAddr

Definition at line 173 of file fetch.hh.

Constructor & Destructor Documentation

◆ Fetch()

gem5::o3::Fetch::Fetch	(	CPU *	_cpu,
		const BaseO3CPUParams &	params )

Fetch constructor.

Definition at line 81 of file fetch.cc.

References bac, cacheBlkSize, commitToFetchDelay, cpu, decoder, decodeToFetchDelay, decodeWidth, decoupledFrontEnd, delayedCommit, fatal, fetchBuffer, fetchBufferMask, fetchBufferPC, fetchBufferSize, fetchBufferValid, fetchOffset, fetchPolicy, fetchQueueSize, fetchStats, fetchStatus, fetchWidth, finishTranslationEvent, ftq, gem5::ArmISA::i, icachePort, Idle, iewToFetchDelay, instSize, gem5::InvalidThreadID, issuePipelinedIfetch, lastIcacheStall, macroop, maxFTPerCycle, maxTakenPredPerCycle, gem5::o3::MaxThreads, gem5::o3::MaxWidth, memReq, numFetchingThreads, numThreads, pc, renameToFetchDelay, retryPkt, retryTid, and stalls.

Referenced by bacResteer(), buildInst(), checkSignalsAndUpdate(), checkStall(), doSquash(), fetch(), fetchCacheLine(), gem5::o3::Fetch::FetchStatGroup::FetchStatGroup(), gem5::o3::Fetch::FetchTranslation::FetchTranslation(), finishTranslation(), gem5::o3::Fetch::FinishTranslationEvent::FinishTranslationEvent(), gem5::o3::Fetch::IcachePort::IcachePort(), pipelineIcacheAccesses(), processCacheCompletion(), profileStall(), squashFromCommit(), squashFromDecode(), tick(), and wakeFromQuiesce().

Member Function Documentation

◆ bacResteer()

void gem5::o3::Fetch::bacResteer	(	const PCStateBase &	new_pc,
		ThreadID	tid )

private

Signal BAC to redirect.

Definition at line 766 of file fetch.cc.

References DPRINTF, Fetch(), ftq, gem5::ArmISA::set, and toBAC.

Referenced by fetch().

◆ branchCount()

ThreadID gem5::o3::Fetch::branchCount ( )

private

Returns the appropriate thread to fetch using the branch count policy.

Definition at line 1570 of file fetch.cc.

References gem5::InvalidThreadID, and panic.

Referenced by getFetchingThread().

◆ buildInst()

DynInstPtr gem5::o3::Fetch::buildInst	(	ThreadID	tid,
		StaticInstPtr	staticInst,
		StaticInstPtr	curMacroop,
		const PCStateBase &	this_pc,
		const PCStateBase &	next_pc,
		bool	trace )

private

Definition at line 1009 of file fetch.cc.

References cpu, gem5::curTick(), delayedCommit, DPRINTF, Fetch(), fetchQueue, fetchQueueSize, fetchWidth, gem5::RefCountingPtr< T >::get(), gem5::PCStateBase::instAddr(), gem5::StaticInst::numDestRegs(), gem5::o3::DynInst::Arrays::numDests, numInst, gem5::StaticInst::numSrcRegs(), and gem5::o3::DynInst::Arrays::numSrcs.

Referenced by fetch(), and finishTranslation().

◆ checkInterrupt()

bool gem5::o3::Fetch::checkInterrupt ( Addr pc )

inlineprivate

Check if an interrupt is pending and that we need to handle.

Definition at line 304 of file fetch.hh.

References interruptPending, and pc.

Referenced by fetch(), and fetchCacheLine().

◆ checkSignalsAndUpdate()

bool gem5::o3::Fetch::checkSignalsAndUpdate ( ThreadID tid )

Checks all input signals and updates the status as necessary.

Returns: : Returns if the status has changed due to input signals.

Definition at line 923 of file fetch.cc.

References Blocked, checkStall(), decoupledFrontEnd, DPRINTF, Fetch(), fetchStatus, fromCommit, fromDecode, ftq, FTQEmpty, IcacheWaitResponse, IcacheWaitRetry, ItlbWait, QuiescePending, Running, squashFromCommit(), squashFromDecode(), Squashing, stalls, and TrapPending.

Referenced by tick().

◆ checkStall()

bool gem5::o3::Fetch::checkStall ( ThreadID tid ) const

private

Checks if a thread is stalled.

Definition at line 777 of file fetch.cc.

References cpu, DPRINTF, Fetch(), and stalls.

Referenced by checkSignalsAndUpdate(), and processCacheCompletion().

◆ clearStates()

void gem5::o3::Fetch::clearStates ( ThreadID tid )

Clear all thread-specific states.

Definition at line 300 of file fetch.cc.

References cpu, delayedCommit, fetchBufferPC, fetchBufferValid, fetchOffset, fetchQueue, fetchStatus, gem5::ArmISA::i, macroop, memReq, pc, gem5::o3::removeCommThreadInsts(), Running, gem5::ArmISA::set, and stalls.

◆ deactivateThread()

void gem5::o3::Fetch::deactivateThread ( ThreadID tid )

For priority-based fetch policies, need to keep update priorityList.

Definition at line 507 of file fetch.cc.

References priorityList.

◆ doSquash()

void gem5::o3::Fetch::doSquash	(	const PCStateBase &	new_pc,
		const DynInstPtr	squashInst,
		ThreadID	tid )

private

Squashes a specific thread and resets the PC.

Definition at line 714 of file fetch.cc.

References cacheBlocked, decoder, delayedCommit, DPRINTF, Fetch(), fetchOffset, fetchQueue, fetchStats, fetchStatus, IcacheWaitResponse, gem5::PCStateBase::instAddr(), gem5::InvalidThreadID, ItlbWait, macroop, memReq, pc, retryPkt, retryTid, gem5::ArmISA::set, and Squashing.

Referenced by squashFromCommit(), and squashFromDecode().

◆ drainResume()

void gem5::o3::Fetch::drainResume ( )

Resume after a drain.

Definition at line 403 of file fetch.cc.

References gem5::ArmISA::i, numThreads, and stalls.

◆ drainSanityCheck()

void gem5::o3::Fetch::drainSanityCheck ( ) const

Perform sanity checks after a drain.

Definition at line 412 of file fetch.cc.

References cacheBlocked, fetchStatus, gem5::ArmISA::i, Idle, interruptPending, gem5::InvalidThreadID, isDrained(), memReq, numThreads, retryPkt, retryTid, and stalls.

◆ drainStall()

void gem5::o3::Fetch::drainStall ( ThreadID tid )

Stall the fetch stage after reaching a safe drain point.

The CPU uses this method to stop fetching instructions from a thread that has been drained. The drain stall is different from all other stalls in that it is signaled instantly from the commit stage (without the normal communication delay) when it has reached a safe point to drain from.

Definition at line 465 of file fetch.cc.

References cpu, DPRINTF, and stalls.

◆ fetch()

void gem5::o3::Fetch::fetch ( bool & status_change )

Does the actual fetching of instructions and passing them on to the next stage.

Parameters

status_change fetch() sets this variable if there was a status change (ie switching to IcacheMissStall).

Definition at line 1062 of file fetch.cc.

References bac, bacResteer(), gem5::PCStateBase::branching(), buildInst(), checkInterrupt(), gem5::PCStateBase::clone(), cpu, gem5::curTick(), decoder, decoupledFrontEnd, delayedCommit, DPRINTF, Fetch(), fetchBuffer, fetchBufferAlignPC(), fetchBufferPC, fetchBufferSize, fetchBufferValid, fetchCacheLine(), gem5::StaticInst::fetchMicroop(), fetchOffset, fetchQueue, fetchQueueSize, fetchStats, fetchStatus, fetchWidth, ftq, FTQEmpty, ftqReady(), getFetchingThread(), IcacheAccessComplete, IcacheWaitResponse, IcacheWaitRetry, Idle, gem5::PCStateBase::instAddr(), instSize, gem5::InvalidThreadID, gem5::StaticInst::isLastMicroop(), gem5::StaticInst::isMacroop(), gem5::isRomMicroPC(), issuePipelinedIfetch, ItlbWait, macroop, maxFTPerCycle, maxTakenPredPerCycle, gem5::PCStateBase::microPC(), numFetchingThreads, numInst, numThreads, pc, ppFetch, profileStall(), QuiescePending, Running, gem5::ArmISA::set, threadFetched, and wroteToTimeBuffer.

Referenced by gem5::o3::Fetch::FetchStatGroup::FetchStatGroup(), and tick().

◆ fetchBufferAlignPC()

Addr gem5::o3::Fetch::fetchBufferAlignPC ( Addr addr )

inline

Align a PC to the start of a fetch buffer block.

Definition at line 357 of file fetch.hh.

References gem5::X86ISA::addr, and fetchBufferMask.

Referenced by fetch(), fetchCacheLine(), and pipelineIcacheAccesses().

◆ fetchCacheLine()

bool gem5::o3::Fetch::fetchCacheLine	(	Addr	vaddr,
		ThreadID	tid,
		Addr	pc )

private

Fetches the cache line that contains the fetch PC.

Returns any fault that happened. Puts the data into the class variable fetchBuffer, which may not hold the entire fetched cache line.

Parameters

vaddr	The memory address that is being fetched from.
ret_fault	The fault reference that will be set to the result of the icache access.
tid	Thread id.
pc	The actual PC of the current instruction.

Returns: Any fault that occured.

Definition at line 533 of file fetch.cc.

References cacheBlocked, checkInterrupt(), cpu, delayedCommit, DPRINTF, gem5::BaseMMU::Execute, Fetch(), fetchBufferAlignPC(), fetchBufferSize, fetchStatus, gem5::Request::INST_FETCH, ItlbWait, memReq, gem5::NoFault, pc, and gem5::MipsISA::vaddr.

Referenced by fetch(), and pipelineIcacheAccesses().

◆ finishTranslation()

void gem5::o3::Fetch::finishTranslation	(	const Fault &	fault,
		const RequestPtr &	mem_req )

private

Definition at line 582 of file fetch.cc.

References _status, buildInst(), cacheBlocked, cpu, gem5::curTick(), gem5::Packet::dataDynamic(), DPRINTF, Fetch(), fetchBufferPC, fetchBufferSize, fetchBufferValid, fetchQueue, fetchQueueSize, fetchStats, fetchStatus, fetchWidth, finishTranslationEvent, icachePort, IcacheWaitResponse, IcacheWaitRetry, gem5::InvalidThreadID, ItlbWait, lastIcacheStall, memReq, gem5::NoFault, NoGoodAddr, gem5::nopStaticInstPtr, numInst, pc, ppFetchRequestSent, gem5::MemCmd::ReadReq, retryPkt, retryTid, TrapPending, updateFetchStatus(), warn, and wroteToTimeBuffer.

◆ ftqReady()

bool gem5::o3::Fetch::ftqReady	(	ThreadID	tid,
		bool &	status_change )

private

Checks if the FTQ is ready.

Always true for coupled frontend.

Definition at line 517 of file fetch.cc.

References decoupledFrontEnd, fetchStatus, ftq, and FTQEmpty.

Referenced by fetch().

◆ getFetchingThread()

ThreadID gem5::o3::Fetch::getFetchingThread ( )

private

Returns the appropriate thread to fetch, given the fetch policy.

Definition at line 1443 of file fetch.cc.

References activeThreads, branchCount(), fetchPolicy, fetchStatus, IcacheAccessComplete, Idle, gem5::InvalidThreadID, iqCount(), lsqCount(), numThreads, roundRobin(), and Running.

Referenced by fetch().

◆ getInstPort()

RequestPort & gem5::o3::Fetch::getInstPort ( )

inline

Definition at line 365 of file fetch.hh.

References icachePort.

◆ iqCount()

ThreadID gem5::o3::Fetch::iqCount ( )

private

Returns the appropriate thread to fetch using the IQ count policy.

Definition at line 1507 of file fetch.cc.

References activeThreads, fetchStatus, fromIEW, IcacheAccessComplete, Idle, gem5::InvalidThreadID, iqCount(), and Running.

Referenced by getFetchingThread(), and iqCount().

◆ isDrained()

bool gem5::o3::Fetch::isDrained ( ) const

Has the stage drained?

Definition at line 427 of file fetch.cc.

References Blocked, fetchQueue, fetchStatus, finishTranslationEvent, gem5::ArmISA::i, Idle, numThreads, and stalls.

Referenced by drainSanityCheck().

◆ lsqCount()

ThreadID gem5::o3::Fetch::lsqCount ( )

private

Returns the appropriate thread to fetch using the LSQ count policy.

Definition at line 1539 of file fetch.cc.

References activeThreads, fetchStatus, fromIEW, IcacheAccessComplete, Idle, gem5::InvalidThreadID, and Running.

Referenced by getFetchingThread().

◆ name()

std::string gem5::o3::Fetch::name ( ) const

Returns the name of fetch.

Definition at line 152 of file fetch.cc.

References cpu.

Referenced by gem5::o3::Fetch::IcachePort::IcachePort().

◆ pipelineIcacheAccesses()

void gem5::o3::Fetch::pipelineIcacheAccesses ( ThreadID tid )

private

Pipeline the next I-cache access to the current one.

Definition at line 1577 of file fetch.cc.

References decoder, DPRINTF, Fetch(), fetchBufferAlignPC(), fetchBufferPC, fetchBufferValid, fetchCacheLine(), fetchOffset, gem5::PCStateBase::instAddr(), gem5::isRomMicroPC(), issuePipelinedIfetch, gem5::PCStateBase::microPC(), and pc.

Referenced by tick().

◆ processCacheCompletion()

void gem5::o3::Fetch::processCacheCompletion ( PacketPtr pkt )

Processes cache completion event.

Definition at line 360 of file fetch.cc.

References Blocked, checkStall(), cpu, DPRINTF, Fetch(), fetchBuffer, fetchBufferSize, fetchBufferValid, fetchStats, fetchStatus, gem5::Packet::getConstPtr(), IcacheAccessComplete, IcacheWaitResponse, memReq, gem5::Packet::req, and switchToActive().

◆ profileStall()

void gem5::o3::Fetch::profileStall ( ThreadID tid )

private

Profile the reasons of fetch stall.

Definition at line 1606 of file fetch.cc.

References activeThreads, Blocked, cpu, DPRINTF, Fetch(), fetchStats, fetchStatus, FTQEmpty, IcacheWaitResponse, IcacheWaitRetry, ItlbWait, NoGoodAddr, QuiescePending, Squashing, stalls, and TrapPending.

Referenced by fetch().

◆ recvReqRetry()

void gem5::o3::Fetch::recvReqRetry ( )

Handles retrying the fetch access.

Definition at line 1406 of file fetch.cc.

References cacheBlocked, fetchStatus, icachePort, IcacheWaitResponse, IcacheWaitRetry, gem5::InvalidThreadID, ppFetchRequestSent, retryPkt, retryTid, and TrapPending.

◆ regProbePoints()

void gem5::o3::Fetch::regProbePoints ( )

Registers probes.

Definition at line 155 of file fetch.cc.

References cpu, ppFetch, and ppFetchRequestSent.

◆ resetStage()

void gem5::o3::Fetch::resetStage ( )

private

Reset this pipeline stage.

Definition at line 326 of file fetch.cc.

References _status, cacheBlocked, cpu, delayedCommit, fetchBufferPC, fetchBufferValid, fetchOffset, fetchQueue, fetchStatus, Inactive, interruptPending, macroop, memReq, numInst, numThreads, pc, priorityList, Running, gem5::ArmISA::set, stalls, and wroteToTimeBuffer.

Referenced by startupStage(), and takeOverFrom().

◆ roundRobin()

ThreadID gem5::o3::Fetch::roundRobin ( )

private

Returns the appropriate thread to fetch using a round robin policy.

Definition at line 1478 of file fetch.cc.

References fetchStatus, IcacheAccessComplete, Idle, gem5::InvalidThreadID, numThreads, priorityList, and Running.

Referenced by getFetchingThread().

◆ setActiveThreads()

void gem5::o3::Fetch::setActiveThreads ( std::list< ThreadID > * at_ptr )

Sets pointer to list of active threads.

Definition at line 266 of file fetch.cc.

References activeThreads.

◆ setBACandFTQPtr()

void gem5::o3::Fetch::setBACandFTQPtr	(	BAC *	bac_ptr,
		FTQ *	ftq_ptr )

Sets pointer to branch address calculation stage and FTQ.

Definition at line 272 of file fetch.cc.

References bac, and ftq.

◆ setFetchQueue()

void gem5::o3::Fetch::setFetchQueue ( TimeBuffer< FetchStruct > * fq_ptr )

Sets pointer to time buffer used to communicate to the next stage.

Definition at line 280 of file fetch.cc.

References gem5::TimeBuffer< T >::getWire(), and toDecode.

◆ setTimeBuffer()

void gem5::o3::Fetch::setTimeBuffer ( TimeBuffer< TimeStruct > * time_buffer )

Sets the main backwards communication time buffer pointer.

Definition at line 249 of file fetch.cc.

References commitToFetchDelay, decodeToFetchDelay, fromCommit, fromDecode, fromIEW, fromRename, iewToFetchDelay, renameToFetchDelay, timeBuffer, and toBAC.

◆ squashFromCommit()

void gem5::o3::Fetch::squashFromCommit	(	const PCStateBase &	new_pc,
		const InstSeqNum	seq_num,
		DynInstPtr	squashInst,
		ThreadID	tid )

Squashes a specific thread and resets the PC.

Also tells the CPU to remove any instructions that are not in the ROB. The source of this squash should be the commit stage.

Definition at line 702 of file fetch.cc.

References cpu, doSquash(), DPRINTF, and Fetch().

Referenced by checkSignalsAndUpdate().

◆ squashFromDecode()

void gem5::o3::Fetch::squashFromDecode	(	const PCStateBase &	new_pc,
		const DynInstPtr	squashInst,
		const InstSeqNum	seq_num,
		ThreadID	tid )

private

Squashes a specific thread and resets the PC.

Also tells the CPU to remove any instructions between fetch and decode that should be sqaushed.

Definition at line 689 of file fetch.cc.

References cpu, doSquash(), DPRINTF, and Fetch().

Referenced by checkSignalsAndUpdate().

◆ startupStage()

void gem5::o3::Fetch::startupStage ( )

Initialize stage.

Definition at line 287 of file fetch.cc.

References bac, ftq, priorityList, resetStage(), and switchToActive().

◆ switchToActive()

void gem5::o3::Fetch::switchToActive ( )

private

Changes the status of this stage to active, and indicates this to the CPU.

Definition at line 483 of file fetch.cc.

References _status, Active, cpu, DPRINTF, gem5::o3::CPU::FetchIdx, and Inactive.

Referenced by processCacheCompletion(), and startupStage().

◆ switchToInactive()

void gem5::o3::Fetch::switchToInactive ( )

private

Changes the status of this stage to inactive, and indicates this to the CPU.

Definition at line 495 of file fetch.cc.

References _status, Active, cpu, DPRINTF, gem5::o3::CPU::FetchIdx, and Inactive.

◆ takeOverFrom()

void gem5::o3::Fetch::takeOverFrom ( )

Takes over from another CPU's thread.

Definition at line 457 of file fetch.cc.

References cpu, and resetStage().

◆ tick()

void gem5::o3::Fetch::tick ( )

Ticks the fetch stage, processing all inputs signals and fetching as many instructions as possible.

Definition at line 825 of file fetch.cc.

References _status, activeThreads, checkSignalsAndUpdate(), cpu, decodeWidth, DPRINTF, Fetch(), fetch(), fetchQueue, fetchStats, fromCommit, gem5::FullSystem, gem5::ArmISA::i, interruptPending, issuePipelinedIfetch, numFetchingThreads, numInst, numThreads, pipelineIcacheAccesses(), rng, stalls, threadFetched, toDecode, updateFetchStatus(), and wroteToTimeBuffer.

◆ updateFetchStatus()

Fetch::FetchStatus gem5::o3::Fetch::updateFetchStatus ( )

private

Updates overall fetch stage status; to be called at the end of each cycle.

Definition at line 791 of file fetch.cc.

References _status, Active, activeThreads, cpu, DPRINTF, gem5::o3::CPU::FetchIdx, fetchStatus, IcacheAccessComplete, Inactive, Running, and Squashing.

Referenced by finishTranslation(), and tick().

◆ wakeFromQuiesce()

void gem5::o3::Fetch::wakeFromQuiesce ( )

Tells fetch to wake up from a quiesce instruction.

Definition at line 474 of file fetch.cc.

References DPRINTF, Fetch(), fetchStatus, and Running.

Member Data Documentation

◆ _status

FetchStatus gem5::o3::Fetch::_status

private

Fetch status.

Definition at line 192 of file fetch.hh.

Referenced by finishTranslation(), resetStage(), switchToActive(), switchToInactive(), tick(), and updateFetchStatus().

◆ activeThreads

std::list<ThreadID>* gem5::o3::Fetch::activeThreads

private

List of Active Threads.

Definition at line 519 of file fetch.hh.

Referenced by getFetchingThread(), iqCount(), lsqCount(), profileStall(), setActiveThreads(), tick(), and updateFetchStatus().

◆ bac

BAC* gem5::o3::Fetch::bac

private

BPredict.

Definition at line 421 of file fetch.hh.

Referenced by Fetch(), fetch(), setBACandFTQPtr(), and startupStage().

◆ cacheBlkSize

Addr gem5::o3::Fetch::cacheBlkSize

private

Cache block size.

Definition at line 487 of file fetch.hh.

Referenced by Fetch().

◆ cacheBlocked

bool gem5::o3::Fetch::cacheBlocked

private

Is the cache blocked?

If so no threads can access it.

Definition at line 478 of file fetch.hh.

Referenced by doSquash(), drainSanityCheck(), fetchCacheLine(), finishTranslation(), recvReqRetry(), and resetStage().

◆ commitToFetchDelay

const Cycles gem5::o3::Fetch::commitToFetchDelay

private

Commit to fetch delay.

Definition at line 469 of file fetch.hh.

Referenced by Fetch(), and setTimeBuffer().

◆ cpu

CPU* gem5::o3::Fetch::cpu

private

Pointer to the O3CPU.

Definition at line 396 of file fetch.hh.

Referenced by buildInst(), checkStall(), clearStates(), drainStall(), Fetch(), fetch(), fetchCacheLine(), gem5::o3::Fetch::FetchStatGroup::FetchStatGroup(), finishTranslation(), name(), processCacheCompletion(), profileStall(), regProbePoints(), resetStage(), squashFromCommit(), squashFromDecode(), switchToActive(), switchToInactive(), takeOverFrom(), tick(), and updateFetchStatus().

◆ decoder

InstDecoder* gem5::o3::Fetch::decoder[MaxThreads]

The decoder.

Definition at line 363 of file fetch.hh.

Referenced by doSquash(), Fetch(), fetch(), and pipelineIcacheAccesses().

◆ decodeToFetchDelay

const Cycles gem5::o3::Fetch::decodeToFetchDelay

private

Decode to fetch delay.

Definition at line 460 of file fetch.hh.

Referenced by Fetch(), and setTimeBuffer().

◆ decodeWidth

const unsigned gem5::o3::Fetch::decodeWidth

private

The width of decode in instructions.

Definition at line 475 of file fetch.hh.

Referenced by Fetch(), and tick().

◆ decoupledFrontEnd

const bool gem5::o3::Fetch::decoupledFrontEnd

private

Enables the decoupled front-end.

Definition at line 457 of file fetch.hh.

Referenced by checkSignalsAndUpdate(), Fetch(), fetch(), and ftqReady().

◆ delayedCommit

bool gem5::o3::Fetch::delayedCommit[MaxThreads]

private

Can the fetch stage redirect from an interrupt on this instruction?

Definition at line 433 of file fetch.hh.

Referenced by buildInst(), clearStates(), doSquash(), Fetch(), fetch(), fetchCacheLine(), and resetStage().

◆ fetchBuffer

uint8_t* gem5::o3::Fetch::fetchBuffer[MaxThreads]

private

The fetch data that is being fetched and buffered.

Definition at line 498 of file fetch.hh.

Referenced by Fetch(), fetch(), and processCacheCompletion().

◆ fetchBufferMask

Addr gem5::o3::Fetch::fetchBufferMask

private

Mask to align a fetch address to a fetch buffer boundary.

Definition at line 495 of file fetch.hh.

Referenced by Fetch(), and fetchBufferAlignPC().

◆ fetchBufferPC

Addr gem5::o3::Fetch::fetchBufferPC[MaxThreads]

private

The PC of the first instruction loaded into the fetch buffer.

Definition at line 501 of file fetch.hh.

Referenced by clearStates(), Fetch(), fetch(), finishTranslation(), pipelineIcacheAccesses(), and resetStage().

◆ fetchBufferSize

unsigned gem5::o3::Fetch::fetchBufferSize

private

The size of the fetch buffer in bytes.

The fetch buffer itself may be smaller than a cache line.

Definition at line 492 of file fetch.hh.

Referenced by Fetch(), fetch(), fetchCacheLine(), finishTranslation(), and processCacheCompletion().

◆ fetchBufferValid

bool gem5::o3::Fetch::fetchBufferValid[MaxThreads]

private

Whether or not the fetch buffer data is valid.

Definition at line 510 of file fetch.hh.

Referenced by clearStates(), Fetch(), fetch(), finishTranslation(), pipelineIcacheAccesses(), processCacheCompletion(), and resetStage().

◆ fetchOffset

Addr gem5::o3::Fetch::fetchOffset[MaxThreads]

private

Definition at line 428 of file fetch.hh.

Referenced by clearStates(), doSquash(), Fetch(), fetch(), pipelineIcacheAccesses(), and resetStage().

◆ fetchPolicy

SMTFetchPolicy gem5::o3::Fetch::fetchPolicy

private

Fetch policy.

Definition at line 198 of file fetch.hh.

Referenced by Fetch(), and getFetchingThread().

◆ fetchQueue

std::deque<DynInstPtr> gem5::o3::Fetch::fetchQueue[MaxThreads]

private

Queue of fetched instructions.

Per-thread to prevent HoL blocking.

Definition at line 507 of file fetch.hh.

Referenced by buildInst(), clearStates(), doSquash(), fetch(), finishTranslation(), isDrained(), resetStage(), and tick().

◆ fetchQueueSize

unsigned gem5::o3::Fetch::fetchQueueSize

private

The size of the fetch queue in micro-ops.

Definition at line 504 of file fetch.hh.

Referenced by buildInst(), Fetch(), fetch(), and finishTranslation().

◆ fetchStats

gem5::o3::Fetch::FetchStatGroup gem5::o3::Fetch::fetchStats

protected

Referenced by doSquash(), Fetch(), fetch(), finishTranslation(), processCacheCompletion(), profileStall(), and tick().

◆ fetchStatus

ThreadStatus gem5::o3::Fetch::fetchStatus[MaxThreads]

private

Per-thread status.

Definition at line 195 of file fetch.hh.

Referenced by checkSignalsAndUpdate(), clearStates(), doSquash(), drainSanityCheck(), Fetch(), fetch(), fetchCacheLine(), finishTranslation(), ftqReady(), getFetchingThread(), iqCount(), isDrained(), lsqCount(), processCacheCompletion(), profileStall(), recvReqRetry(), resetStage(), roundRobin(), updateFetchStatus(), and wakeFromQuiesce().

◆ fetchWidth

const unsigned gem5::o3::Fetch::fetchWidth

private

The width of fetch in instructions.

Definition at line 472 of file fetch.hh.

Referenced by buildInst(), Fetch(), fetch(), and finishTranslation().

◆ finishTranslationEvent

FinishTranslationEvent gem5::o3::Fetch::finishTranslationEvent

private

Event used to delay fault generation of translation faults.

Definition at line 542 of file fetch.hh.

Referenced by Fetch(), finishTranslation(), and isDrained().

◆ fromCommit

TimeBuffer<TimeStruct>::wire gem5::o3::Fetch::fromCommit

private

Wire to get commit's information from backwards time buffer.

Definition at line 411 of file fetch.hh.

Referenced by checkSignalsAndUpdate(), setTimeBuffer(), and tick().

◆ fromDecode

TimeBuffer<TimeStruct>::wire gem5::o3::Fetch::fromDecode

private

Wire to get decode's information from backwards time buffer.

Definition at line 402 of file fetch.hh.

Referenced by checkSignalsAndUpdate(), and setTimeBuffer().

◆ fromIEW

TimeBuffer<TimeStruct>::wire gem5::o3::Fetch::fromIEW

private

Wire to get iew's information from backwards time buffer.

Definition at line 408 of file fetch.hh.

Referenced by iqCount(), lsqCount(), and setTimeBuffer().

◆ fromRename

TimeBuffer<TimeStruct>::wire gem5::o3::Fetch::fromRename

private

Wire to get rename's information from backwards time buffer.

Definition at line 405 of file fetch.hh.

Referenced by setTimeBuffer().

◆ ftq

FTQ* gem5::o3::Fetch::ftq

private

Fetch Target Queue.

Definition at line 424 of file fetch.hh.

Referenced by bacResteer(), checkSignalsAndUpdate(), Fetch(), fetch(), ftqReady(), setBACandFTQPtr(), and startupStage().

◆ icachePort

IcachePort gem5::o3::Fetch::icachePort

private

Instruction port.

Note that it has to appear after the fetch stage.

Definition at line 536 of file fetch.hh.

Referenced by Fetch(), finishTranslation(), getInstPort(), and recvReqRetry().

◆ iewToFetchDelay

const Cycles gem5::o3::Fetch::iewToFetchDelay

private

IEW to fetch delay.

Definition at line 466 of file fetch.hh.

Referenced by Fetch(), and setTimeBuffer().

◆ instSize

int gem5::o3::Fetch::instSize

private

Size of instructions.

Definition at line 513 of file fetch.hh.

Referenced by Fetch(), and fetch().

◆ interruptPending

bool gem5::o3::Fetch::interruptPending

private

Checks if there is an interrupt pending.

If there is, fetch must stop once it is not fetching PAL instructions.

Definition at line 533 of file fetch.hh.

Referenced by checkInterrupt(), drainSanityCheck(), resetStage(), and tick().

◆ issuePipelinedIfetch

bool gem5::o3::Fetch::issuePipelinedIfetch[MaxThreads]

private

Set to true if a pipelined I-cache request should be issued.

Definition at line 539 of file fetch.hh.

Referenced by Fetch(), fetch(), pipelineIcacheAccesses(), and tick().

◆ lastIcacheStall

Counter gem5::o3::Fetch::lastIcacheStall[MaxThreads]

private

Icache stall statistics.

Definition at line 516 of file fetch.hh.

Referenced by Fetch(), and finishTranslation().

◆ macroop

StaticInstPtr gem5::o3::Fetch::macroop[MaxThreads]

private

Definition at line 430 of file fetch.hh.

Referenced by clearStates(), doSquash(), Fetch(), fetch(), and resetStage().

◆ maxFTPerCycle

const unsigned gem5::o3::Fetch::maxFTPerCycle

private

Definition at line 545 of file fetch.hh.

Referenced by Fetch(), and fetch().

◆ maxTakenPredPerCycle

const unsigned gem5::o3::Fetch::maxTakenPredPerCycle

private

Definition at line 546 of file fetch.hh.

Referenced by Fetch(), and fetch().

◆ memReq

RequestPtr gem5::o3::Fetch::memReq[MaxThreads]

private

Memory request used to access cache.

Definition at line 436 of file fetch.hh.

Referenced by clearStates(), doSquash(), drainSanityCheck(), Fetch(), fetchCacheLine(), finishTranslation(), processCacheCompletion(), and resetStage().

◆ numFetchingThreads

ThreadID gem5::o3::Fetch::numFetchingThreads

private

Number of threads that are actively fetching.

Definition at line 525 of file fetch.hh.

Referenced by Fetch(), fetch(), and tick().

◆ numInst

int gem5::o3::Fetch::numInst

private

Tracks how many instructions has been fetched this cycle.

Definition at line 444 of file fetch.hh.

Referenced by buildInst(), fetch(), finishTranslation(), resetStage(), and tick().

◆ numThreads

ThreadID gem5::o3::Fetch::numThreads

private

Number of threads.

Definition at line 522 of file fetch.hh.

Referenced by drainResume(), drainSanityCheck(), Fetch(), fetch(), getFetchingThread(), isDrained(), resetStage(), roundRobin(), and tick().

◆ pc

std::unique_ptr<PCStateBase> gem5::o3::Fetch::pc[MaxThreads]

private

Definition at line 426 of file fetch.hh.

Referenced by checkInterrupt(), clearStates(), doSquash(), Fetch(), fetch(), fetchCacheLine(), finishTranslation(), pipelineIcacheAccesses(), and resetStage().

◆ ppFetch

ProbePointArg<DynInstPtr>* gem5::o3::Fetch::ppFetch

private

Probe points.

Definition at line 204 of file fetch.hh.

Referenced by fetch(), and regProbePoints().

◆ ppFetchRequestSent

ProbePointArg<RequestPtr>* gem5::o3::Fetch::ppFetchRequestSent

private

To probe when a fetch request is successfully sent.

Definition at line 206 of file fetch.hh.

Referenced by finishTranslation(), recvReqRetry(), and regProbePoints().

◆ priorityList

std::list<ThreadID> gem5::o3::Fetch::priorityList

private

List that has the threads organized by priority.

Definition at line 201 of file fetch.hh.

Referenced by deactivateThread(), resetStage(), roundRobin(), and startupStage().

◆ renameToFetchDelay

const Cycles gem5::o3::Fetch::renameToFetchDelay

private

Rename to fetch delay.

Definition at line 463 of file fetch.hh.

Referenced by Fetch(), and setTimeBuffer().

◆ retryPkt

PacketPtr gem5::o3::Fetch::retryPkt

private

The packet that is waiting to be retried.

Definition at line 481 of file fetch.hh.

Referenced by doSquash(), drainSanityCheck(), Fetch(), finishTranslation(), and recvReqRetry().

◆ retryTid

ThreadID gem5::o3::Fetch::retryTid

private

The thread that is waiting on the cache to tell fetch to retry.

Definition at line 484 of file fetch.hh.

Referenced by doSquash(), drainSanityCheck(), Fetch(), finishTranslation(), and recvReqRetry().

◆ rng

Random::RandomPtr gem5::o3::Fetch::rng = Random::genRandom()

private

Definition at line 208 of file fetch.hh.

Referenced by tick().

◆ stalls

Stalls gem5::o3::Fetch::stalls[MaxThreads]

private

Tracks which stages are telling fetch to stall.

Definition at line 454 of file fetch.hh.

Referenced by checkSignalsAndUpdate(), checkStall(), clearStates(), drainResume(), drainSanityCheck(), drainStall(), Fetch(), isDrained(), profileStall(), resetStage(), and tick().

◆ threadFetched

ThreadID gem5::o3::Fetch::threadFetched

private

Thread ID being fetched.

Definition at line 528 of file fetch.hh.

Referenced by fetch(), and tick().

◆ timeBuffer

TimeBuffer<TimeStruct>* gem5::o3::Fetch::timeBuffer

private

Time buffer interface.

Definition at line 399 of file fetch.hh.

Referenced by setTimeBuffer().

◆ toBAC

TimeBuffer<TimeStruct>::wire gem5::o3::Fetch::toBAC

private

Wire used to write any information backward to BAC.

Definition at line 414 of file fetch.hh.

Referenced by bacResteer(), and setTimeBuffer().

◆ toDecode

TimeBuffer<FetchStruct>::wire gem5::o3::Fetch::toDecode

private

Wire used to write any information heading to decode.

Definition at line 418 of file fetch.hh.

Referenced by setFetchQueue(), and tick().

◆ wroteToTimeBuffer

bool gem5::o3::Fetch::wroteToTimeBuffer

private

Variable that tracks if fetch has written to the time buffer this cycle.

Used to tell CPU if there is activity this cycle.

Definition at line 441 of file fetch.hh.

Referenced by fetch(), finishTranslation(), resetStage(), and tick().

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

cpu/o3/fetch.hh
cpu/o3/fetch.cc

Classes

Public Types

Public Member Functions

Public Attributes

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ FetchStatus

◆ ThreadStatus

Constructor & Destructor Documentation

◆ Fetch()

Member Function Documentation

◆ bacResteer()

◆ branchCount()

◆ buildInst()

◆ checkInterrupt()

◆ checkSignalsAndUpdate()

◆ checkStall()

◆ clearStates()

◆ deactivateThread()

◆ doSquash()

◆ drainResume()

◆ drainSanityCheck()

◆ drainStall()

◆ fetch()

◆ fetchBufferAlignPC()

◆ fetchCacheLine()

◆ finishTranslation()

◆ ftqReady()

◆ getFetchingThread()

◆ getInstPort()

◆ iqCount()

◆ isDrained()

◆ lsqCount()

◆ name()

◆ pipelineIcacheAccesses()

◆ processCacheCompletion()

◆ profileStall()

◆ recvReqRetry()

◆ regProbePoints()

◆ resetStage()

◆ roundRobin()

◆ setActiveThreads()

◆ setBACandFTQPtr()

◆ setFetchQueue()

◆ setTimeBuffer()

◆ squashFromCommit()

◆ squashFromDecode()

◆ startupStage()

◆ switchToActive()

◆ switchToInactive()

◆ takeOverFrom()

◆ tick()

◆ updateFetchStatus()

◆ wakeFromQuiesce()

Member Data Documentation

◆ _status

◆ activeThreads

◆ bac

◆ cacheBlkSize

◆ cacheBlocked

◆ commitToFetchDelay

◆ cpu

◆ decoder

◆ decodeToFetchDelay

◆ decodeWidth

◆ decoupledFrontEnd

◆ delayedCommit

◆ fetchBuffer

◆ fetchBufferMask

◆ fetchBufferPC

◆ fetchBufferSize

◆ fetchBufferValid

◆ fetchOffset

◆ fetchPolicy

◆ fetchQueue

◆ fetchQueueSize

◆ fetchStats