circt::FirMemLowering Class Reference

FIR memory lowering helper. More...

#include <FirMemLowering.h>

Collaboration diagram for circt::FirMemLowering:

Public Types
using	UniqueConfigs = llvm::MapVector< FirMemConfig, SmallVector< seq::FirMemOp, 1 > >
	A vector of unique FirMemConfigs and all the FirMemOps that use it. More...
using	MemoryConfig = std::tuple< FirMemConfig *, hw::HWModuleGeneratedOp, seq::FirMemOp >
	Information required to lower a single memory in a module. More...

Public Member Functions
	FirMemLowering (ModuleOp circuit)
UniqueConfigs	collectMemories (ArrayRef< hw::HWModuleOp > modules)
	Groups memories by their kind from the whole design. More...
void	lowerMemoriesInModule (hw::HWModuleOp module, ArrayRef< MemoryConfig > mems)
	Lowers a group of memories from the same module. More...
hw::HWModuleGeneratedOp	createMemoryModule (FirMemConfig &mem, ArrayRef< seq::FirMemOp > memOps)
	Creates the generated module for a given configuration. More...

Private Member Functions
FirMemConfig	collectMemory (seq::FirMemOp op)
	Determine the exact parametrization of the memory that should be generated for a given FirMemOp. More...
FlatSymbolRefAttr	getOrCreateSchema ()
	Find the schema or create it if it does not exist. More...

Private Attributes
MLIRContext *	context
ModuleOp	circuit
SymbolCache	symbolCache
Namespace	globalNamespace
DenseMap< hw::HWModuleOp, size_t >	moduleIndex
hw::HWGeneratorSchemaOp	schemaOp

Detailed Description

FIR memory lowering helper.

Definition at line 65 of file FirMemLowering.h.

Member Typedef Documentation

MemoryConfig

using circt::FirMemLowering::MemoryConfig = std::tuple<FirMemConfig *, hw::HWModuleGeneratedOp, seq::FirMemOp>

Information required to lower a single memory in a module.

Definition at line 72 of file FirMemLowering.h.

UniqueConfigs

using circt::FirMemLowering::UniqueConfigs = llvm::MapVector<FirMemConfig, SmallVector<seq::FirMemOp, 1> >

A vector of unique FirMemConfigs and all the FirMemOps that use it.

Definition at line 68 of file FirMemLowering.h.

Constructor & Destructor Documentation

FirMemLowering()

FirMemLowering::FirMemLowering

(

ModuleOp

circuit

)

Definition at line 20 of file FirMemLowering.cpp.

References circt::Namespace::add(), circt::SymbolCacheBase::addDefinitions(), circuit, globalNamespace, moduleIndex, and symbolCache.

Member Function Documentation

collectMemories()

FirMemLowering::UniqueConfigs FirMemLowering::collectMemories

(

ArrayRef< hw::HWModuleOp >

modules

)

Groups memories by their kind from the whole design.

Collect the memories in a list of HW modules.

Definition at line 33 of file FirMemLowering.cpp.

References context.

collectMemory()

FirMemConfig FirMemLowering::collectMemory ( seq::FirMemOp  op )

private

Determine the exact parametrization of the memory that should be generated for a given FirMemOp.

Definition at line 71 of file FirMemLowering.cpp.

References circt::FirMemConfig::dataWidth, circt::FirMemConfig::depth, circt::FirMemConfig::initFilename, circt::FirMemConfig::initIsBinary, circt::FirMemConfig::initIsInline, lookThroughWires(), circt::FirMemConfig::maskBits, circt::FirMemConfig::numReadPorts, circt::FirMemConfig::numReadWritePorts, circt::FirMemConfig::numWritePorts, circt::FirMemConfig::outputFile, circt::FirMemConfig::prefix, circt::FirMemConfig::readLatency, circt::FirMemConfig::readUnderWrite, circt::FirMemConfig::writeClockIDs, circt::FirMemConfig::writeLatency, and circt::FirMemConfig::writeUnderWrite.

createMemoryModule()

HWModuleGeneratedOp FirMemLowering::createMemoryModule	(	FirMemConfig &	mem,
		ArrayRef< seq::FirMemOp >	memOps
	)

Creates the generated module for a given configuration.

Create the HWModuleGeneratedOp for a single memory parametrization.

Definition at line 143 of file FirMemLowering.cpp.

References builder, context, circt::FirMemConfig::dataWidth, circt::FirMemConfig::depth, circt::calyx::direction::get(), getOrCreateSchema(), globalNamespace, circt::FirMemConfig::initFilename, circt::FirMemConfig::initIsBinary, circt::FirMemConfig::initIsInline, Input, circt::FirMemConfig::maskBits, moduleIndex, circt::Namespace::newName(), circt::FirMemConfig::numReadPorts, circt::FirMemConfig::numReadWritePorts, circt::FirMemConfig::numWritePorts, Output, circt::FirMemConfig::outputFile, circt::FirMemConfig::prefix, circt::FirMemConfig::readLatency, circt::FirMemConfig::readUnderWrite, toVector(), circt::FirMemConfig::writeClockIDs, circt::FirMemConfig::writeLatency, and circt::FirMemConfig::writeUnderWrite.

getOrCreateSchema()

FlatSymbolRefAttr FirMemLowering::getOrCreateSchema ( )

private

Find the schema or create it if it does not exist.

Definition at line 114 of file FirMemLowering.cpp.

References builder, circuit, circt::calyx::direction::get(), and schemaOp.

Referenced by createMemoryModule().

lowerMemoriesInModule()

void FirMemLowering::lowerMemoriesInModule	(	hw::HWModuleOp	module,
		ArrayRef< MemoryConfig >	mems
	)

Lowers a group of memories from the same module.

Replace all FirMemOps in an HW module with an instance of the corresponding generated module.

Definition at line 304 of file FirMemLowering.cpp.

References builder, inputs, outputs, and width.

Member Data Documentation

circuit

ModuleOp circt::FirMemLowering::circuit

private

Definition at line 104 of file FirMemLowering.h.

Referenced by FirMemLowering(), and getOrCreateSchema().

context

MLIRContext* circt::FirMemLowering::context

private

Definition at line 103 of file FirMemLowering.h.

Referenced by collectMemories(), and createMemoryModule().

globalNamespace

Namespace circt::FirMemLowering::globalNamespace

private

Definition at line 107 of file FirMemLowering.h.

Referenced by createMemoryModule(), and FirMemLowering().

moduleIndex

DenseMap<hw::HWModuleOp, size_t> circt::FirMemLowering::moduleIndex

private

Definition at line 109 of file FirMemLowering.h.

Referenced by createMemoryModule(), and FirMemLowering().

schemaOp

hw::HWGeneratorSchemaOp circt::FirMemLowering::schemaOp

private

Definition at line 111 of file FirMemLowering.h.

Referenced by getOrCreateSchema().

symbolCache

SymbolCache circt::FirMemLowering::symbolCache

private

Definition at line 106 of file FirMemLowering.h.

Referenced by FirMemLowering().

---

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

• /home/runner/work/circt-www/circt-www/circt_src/lib/Conversion/SeqToSV/FirMemLowering.h
• /home/runner/work/circt-www/circt-www/circt_src/lib/Conversion/SeqToSV/FirMemLowering.cpp