fetch buffer descriptor. More...

Public Member Functions
	FetchBufDesc ()

	~FetchBufDesc ()

void	allocateBuf (int fetch_depth, int cache_line_size, Wavefront *wf)
	allocate the fetch buffer space, and set the fetch depth (number of lines that may be buffered), fetch size (cache line size), and parent WF for this fetch buffer. More...

int	bufferedAndReservedLines () const

int	bufferedLines () const

int	bufferedBytes () const

int	reservedLines () const

bool	hasFreeSpace () const

void	flushBuf ()

Addr	nextFetchAddr ()

void	reserveBuf (Addr vaddr)
	reserve an entry in the fetch buffer for PC = vaddr, More...

uint8_t *	reservedBuf (Addr vaddr) const
	return a pointer to the raw fetch buffer data. More...

bool	isReserved (Addr vaddr) const
	returns true if there is an entry reserved for this address, and false otherwise More...

void	fetchDone (Addr vaddr)

bool	hasFetchDataToProcess () const
	checks if the buffer contains valid data. More...

void	decodeInsts ()
	each time the fetch stage is ticked, we check if there are any data in the fetch buffer that may be decoded and sent to the IB. More...

void	checkWaveReleaseBuf ()
	checks if the wavefront can release any of its fetch buffer entries. More...

void	decoder (TheGpuISA::Decoder *dec)

bool	pcBuffered (Addr pc) const

int	fetchBytesRemaining () const
	calculates the number of fetched bytes that have yet to be decoded. More...

Private Member Functions
void	decodeSplitInst ()

bool	splitDecode () const
	check if the next instruction to be processed out of the fetch buffer is split across the end/beginning of the fetch buffer. More...

Private Attributes
std::map< Addr, uint8_t * >	bufferedPCs
	the set of PCs (fetch addresses) that are currently buffered. More...

std::map< Addr, uint8_t * >	reservedPCs

std::deque< uint8_t * >	freeList
	represents the fetch buffer free list. More...

uint8_t *	bufStart
	raw instruction buffer. More...

uint8_t *	bufEnd

uint8_t *	readPtr
	pointer that points to the next chunk of inst data to be decoded. More...

int	fetchDepth

int	maxIbSize

int	maxFbSize

int	cacheLineSize

int	cacheLineBits

bool	restartFromBranch

Wavefront *	wavefront

TheGpuISA::Decoder *	_decoder

Detailed Description

fetch buffer descriptor.

holds buffered instruction data in the fetch unit.

Definition at line 68 of file fetch_unit.hh.

Constructor & Destructor Documentation

◆ FetchBufDesc()

FetchUnit::FetchBufDesc::FetchBufDesc ( )

inline

Definition at line 71 of file fetch_unit.hh.

◆ ~FetchBufDesc()

FetchUnit::FetchBufDesc::~FetchBufDesc ( )

inline

Definition at line 78 of file fetch_unit.hh.

References bufStart.

Member Function Documentation

◆ allocateBuf()

void FetchUnit::FetchBufDesc::allocateBuf	(	int	fetch_depth,
		int	cache_line_size,
		Wavefront *	wf
	)

allocate the fetch buffer space, and set the fetch depth (number of lines that may be buffered), fetch size (cache line size), and parent WF for this fetch buffer.

FetchBufDesc.

Definition at line 318 of file fetch_unit.cc.

References bufEnd, bufStart, cacheLineBits, cacheLineSize, fetchDepth, floorLog2(), freeList, ArmISA::i, isPowerOf2(), maxFbSize, Wavefront::maxIbSize, maxIbSize, panic_if, readPtr, and wavefront.

◆ bufferedAndReservedLines()

int FetchUnit::FetchBufDesc::bufferedAndReservedLines ( ) const

inline

Definition at line 91 of file fetch_unit.hh.

References bufferedLines(), and reservedLines().

◆ bufferedBytes()

int FetchUnit::FetchBufDesc::bufferedBytes ( ) const

inline

Definition at line 97 of file fetch_unit.hh.

References bufferedLines(), and cacheLineSize.

◆ bufferedLines()

int FetchUnit::FetchBufDesc::bufferedLines ( ) const

inline

Definition at line 96 of file fetch_unit.hh.

References bufferedPCs.

Referenced by bufferedAndReservedLines(), and bufferedBytes().

◆ checkWaveReleaseBuf()

void FetchUnit::FetchBufDesc::checkWaveReleaseBuf ( )

checks if the wavefront can release any of its fetch buffer entries.

this will occur when the WF's PC goes beyond any of the currently buffered cache lines.

we're using a std::map so the addresses are sorted. if this PC is not the oldest one in the map, we must be fetching from a newer block, and we can release the oldest PC's fetch buffer entry back to the free list.

Definition at line 475 of file fetch_unit.cc.

References DPRINTF, and roundDown().

◆ decodeInsts()

void FetchUnit::FetchBufDesc::decodeInsts ( )

each time the fetch stage is ticked, we check if there are any data in the fetch buffer that may be decoded and sent to the IB.

because we are modeling the fetch buffer as a circular buffer, it is possible that an instruction can straddle the end/beginning of the fetch buffer, so decodeSplitInsts() handles that case.

Definition at line 532 of file fetch_unit.cc.

References GPUStaticInst::disassemble(), DPRINTF, and GPUStaticInst::instSize().

◆ decoder()

void FetchUnit::FetchBufDesc::decoder ( TheGpuISA::Decoder * dec )

inline

Definition at line 162 of file fetch_unit.hh.

References _decoder.

◆ decodeSplitInst()

void FetchUnit::FetchBufDesc::decodeSplitInst ( )

private

Definition at line 570 of file fetch_unit.cc.

References GPUStaticInst::disassemble(), DPRINTF, ArmISA::i, and GPUStaticInst::instSize().

◆ fetchBytesRemaining()

int FetchUnit::FetchBufDesc::fetchBytesRemaining ( ) const

calculates the number of fetched bytes that have yet to be decoded.

Definition at line 619 of file fetch_unit.cc.

◆ fetchDone()

void FetchUnit::FetchBufDesc::fetchDone ( Addr vaddr )

this address should have an entry reserved in the fetch buffer already, however it should be invalid until the fetch completes.

Definition at line 444 of file fetch_unit.cc.

References DPRINTF, and MipsISA::vaddr.

◆ flushBuf()

void FetchUnit::FetchBufDesc::flushBuf ( )

free list may have some entries so we clear it here to avoid duplicates

Definition at line 342 of file fetch_unit.cc.

References DPRINTF, FetchUnit::fetchDepth, and ArmISA::i.

◆ hasFetchDataToProcess()

bool FetchUnit::FetchBufDesc::hasFetchDataToProcess ( ) const

checks if the buffer contains valid data.

this essentially tells fetch when there is data remaining that needs to be decoded into the WF's IB.

Definition at line 469 of file fetch_unit.cc.

◆ hasFreeSpace()

bool FetchUnit::FetchBufDesc::hasFreeSpace ( ) const

inline

Definition at line 99 of file fetch_unit.hh.

References freeList.

◆ isReserved()

bool FetchUnit::FetchBufDesc::isReserved ( Addr vaddr ) const

inline

returns true if there is an entry reserved for this address, and false otherwise

Definition at line 128 of file fetch_unit.hh.

References reservedPCs, and MipsISA::vaddr.

◆ nextFetchAddr()

Addr FetchUnit::FetchBufDesc::nextFetchAddr ( )

get the PC of the most recently fetched cache line, then return the address of the next line.

should not be trying to fetch a line that has already been fetched.

we do not have any buffered cache lines yet, so we assume this is the initial fetch, or the first fetch after a branch, and get the PC directly from the WF. in the case of a branch, we may not start at the beginning of a cache line, so we adjust the readPtr by the current PC's offset from the start of the line.

if we are here we have no buffered lines. in the case we flushed the buffer due to a branch, we may need to start fetching from some offset from the start of the fetch buffer, so we adjust for that here.

Definition at line 364 of file fetch_unit.cc.

References makeLineAddress().

◆ pcBuffered()

bool FetchUnit::FetchBufDesc::pcBuffered ( Addr pc ) const

inline

Definition at line 168 of file fetch_unit.hh.

References bufferedPCs, MipsISA::pc, and reservedPCs.

◆ reserveBuf()

void FetchUnit::FetchBufDesc::reserveBuf ( Addr vaddr )

reserve an entry in the fetch buffer for PC = vaddr,

we reserve buffer space, by moving it out of the free list, however we do not mark the buffered line as valid until the fetch unit for this buffer has receieved the response from the memory system.

Definition at line 419 of file fetch_unit.cc.

References DPRINTF, FetchUnit::fetchDepth, and MipsISA::vaddr.

◆ reservedBuf()

uint8_t* FetchUnit::FetchBufDesc::reservedBuf ( Addr vaddr ) const

inline

return a pointer to the raw fetch buffer data.

this allows the fetch pkt to use this data directly to avoid unnecessary memcpy and malloc/new.

Definition at line 114 of file fetch_unit.hh.

References reservedPCs, and MipsISA::vaddr.

◆ reservedLines()

int FetchUnit::FetchBufDesc::reservedLines ( ) const

inline

Definition at line 98 of file fetch_unit.hh.

References reservedPCs.

Referenced by bufferedAndReservedLines().

◆ splitDecode()

bool FetchUnit::FetchBufDesc::splitDecode ( ) const

private

check if the next instruction to be processed out of the fetch buffer is split across the end/beginning of the fetch buffer.

if a read of a raw instruction would go beyond the end of the fetch buffer, then we must perform a split decode.

Definition at line 607 of file fetch_unit.cc.

Member Data Documentation

◆ _decoder

TheGpuISA::Decoder* FetchUnit::FetchBufDesc::_decoder

private

Definition at line 233 of file fetch_unit.hh.

Referenced by decoder().

◆ bufEnd

uint8_t* FetchUnit::FetchBufDesc::bufEnd

private

Definition at line 216 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ bufferedPCs

std::map<Addr, uint8_t*> FetchUnit::FetchBufDesc::bufferedPCs

private

the set of PCs (fetch addresses) that are currently buffered.

bufferedPCs are valid, reservedPCs are waiting for their buffers to be filled with valid fetch data.

Definition at line 198 of file fetch_unit.hh.

Referenced by bufferedLines(), and pcBuffered().

◆ bufStart

uint8_t* FetchUnit::FetchBufDesc::bufStart

private

raw instruction buffer.

holds cache line data associated with the set of PCs (fetch addresses) that are buffered here.

Definition at line 215 of file fetch_unit.hh.

Referenced by allocateBuf(), and ~FetchBufDesc().

◆ cacheLineBits

int FetchUnit::FetchBufDesc::cacheLineBits

private

Definition at line 229 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ cacheLineSize

int FetchUnit::FetchBufDesc::cacheLineSize

private

Definition at line 228 of file fetch_unit.hh.

Referenced by allocateBuf(), and bufferedBytes().

◆ fetchDepth

int FetchUnit::FetchBufDesc::fetchDepth

private

Definition at line 223 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ freeList

std::deque<uint8_t*> FetchUnit::FetchBufDesc::freeList

private

represents the fetch buffer free list.

holds buffer space that is currently free. each pointer in this array must have enough space to hold a cache line. in reality we have one actual fetch buffer: 'bufStart', these pointers point to addresses within bufStart that are aligned to the cache line size.

Definition at line 209 of file fetch_unit.hh.

Referenced by allocateBuf(), and hasFreeSpace().

◆ maxFbSize

int FetchUnit::FetchBufDesc::maxFbSize

private

Definition at line 227 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ maxIbSize

int FetchUnit::FetchBufDesc::maxIbSize

private

Definition at line 225 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ readPtr

uint8_t* FetchUnit::FetchBufDesc::readPtr

private

pointer that points to the next chunk of inst data to be decoded.

Definition at line 221 of file fetch_unit.hh.

Referenced by allocateBuf().

◆ reservedPCs

std::map<Addr, uint8_t*> FetchUnit::FetchBufDesc::reservedPCs

private

Definition at line 199 of file fetch_unit.hh.

Referenced by isReserved(), pcBuffered(), reservedBuf(), and reservedLines().

◆ restartFromBranch

bool FetchUnit::FetchBufDesc::restartFromBranch

private

Definition at line 230 of file fetch_unit.hh.

◆ wavefront

Wavefront* FetchUnit::FetchBufDesc::wavefront

private

Definition at line 232 of file fetch_unit.hh.

Referenced by allocateBuf().

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

gpu-compute/fetch_unit.hh
gpu-compute/fetch_unit.cc

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FetchBufDesc()

◆ ~FetchBufDesc()

Member Function Documentation

◆ allocateBuf()

◆ bufferedAndReservedLines()

◆ bufferedBytes()

◆ bufferedLines()

◆ checkWaveReleaseBuf()

◆ decodeInsts()

◆ decoder()

◆ decodeSplitInst()

◆ fetchBytesRemaining()

◆ fetchDone()

◆ flushBuf()

◆ hasFetchDataToProcess()

◆ hasFreeSpace()

◆ isReserved()

◆ nextFetchAddr()

◆ pcBuffered()

◆ reserveBuf()

◆ reservedBuf()

◆ reservedLines()

◆ splitDecode()

Member Data Documentation

◆ _decoder

◆ bufEnd

◆ bufferedPCs

◆ bufStart

◆ cacheLineBits

◆ cacheLineSize

◆ fetchDepth

◆ freeList

◆ maxFbSize

◆ maxIbSize

◆ readPtr

◆ reservedPCs

◆ restartFromBranch

◆ wavefront