coreblocks.func_blocks.fu package

Subpackages

• coreblocks.func_blocks.fu.fpu package
  • Submodules
  • coreblocks.func_blocks.fu.fpu.fpu_common module
  • coreblocks.func_blocks.fu.fpu.fpu_error_module module
  • coreblocks.func_blocks.fu.fpu.fpu_rounding_module module
  • coreblocks.func_blocks.fu.fpu.lza module
  • Module contents
• coreblocks.func_blocks.fu.lsu package
  • Submodules
  • coreblocks.func_blocks.fu.lsu.dummyLsu module
  • coreblocks.func_blocks.fu.lsu.lsu_atomic_wrapper module
  • coreblocks.func_blocks.fu.lsu.lsu_requester module
  • coreblocks.func_blocks.fu.lsu.pma module
  • Module contents
• coreblocks.func_blocks.fu.unsigned_multiplication package
  • Submodules
  • coreblocks.func_blocks.fu.unsigned_multiplication.common module
  • coreblocks.func_blocks.fu.unsigned_multiplication.fast_recursive module
  • coreblocks.func_blocks.fu.unsigned_multiplication.pipelined module
  • coreblocks.func_blocks.fu.unsigned_multiplication.sequence module
  • coreblocks.func_blocks.fu.unsigned_multiplication.shift module
  • Module contents

Submodules

coreblocks.func_blocks.fu.alu module

class coreblocks.func_blocks.fu.alu.ALUComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = True, zba_enable: bool = False, zbb_enable: bool = False, zicond_enable: bool = False) → None

decoder_manager: AluFn

get_decoder_manager()

get_module(gen_params: GenParams) → FuncUnit

result_fifo: bool = True

zba_enable: bool = False

zbb_enable: bool = False

zicond_enable: bool = False

class coreblocks.func_blocks.fu.alu.AluFuncUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, alu_fn=<coreblocks.func_blocks.fu.alu.AluFn object>)

coreblocks.func_blocks.fu.div_unit module

class coreblocks.func_blocks.fu.div_unit.DivComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = False, decoder_manager: ~coreblocks.func_blocks.fu.div_unit.DivFn = <coreblocks.func_blocks.fu.div_unit.DivFn object>, ipc: int = 3) → None

decoder_manager: DivFn = <coreblocks.func_blocks.fu.div_unit.DivFn object>

get_module(gen_params: GenParams) → FuncUnit

ipc: int = 3

result_fifo: bool = False

class coreblocks.func_blocks.fu.div_unit.DivFn

Bases: DecoderManager

class Fn

Bases: IntFlag

DIV = 1

DIVU = 2

REM = 4

REMU = 8

__new__(value)

get_instructions() → Sequence[tuple]

Method providing list of valid instruction.

Returns

returnSequence[tuple]

List of implemented instructions, each following format: (IntFlag, OpType, Funct3 (optional), Funct7 (optional))

class coreblocks.func_blocks.fu.div_unit.DivUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, ipc: int = 4, div_fn=<coreblocks.func_blocks.fu.div_unit.DivFn object>)

coreblocks.func_blocks.fu.div_unit.get_input(arg: View) → tuple[amaranth.hdl._ast.Value, amaranth.hdl._ast.Value]

coreblocks.func_blocks.fu.exception module

class coreblocks.func_blocks.fu.exception.ExceptionFuncUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, unit_fn=<coreblocks.func_blocks.fu.exception.ExceptionUnitFn object>)

class coreblocks.func_blocks.fu.exception.ExceptionUnitComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = True, decoder_manager: ~coreblocks.func_blocks.fu.exception.ExceptionUnitFn = <coreblocks.func_blocks.fu.exception.ExceptionUnitFn object>) → None

decoder_manager: ExceptionUnitFn = <coreblocks.func_blocks.fu.exception.ExceptionUnitFn object>

get_module(gen_params: GenParams) → FuncUnit

result_fifo: bool = True

coreblocks.func_blocks.fu.jumpbranch module

class coreblocks.func_blocks.fu.jumpbranch.JumpBranchFuncUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, jb_fn=<coreblocks.func_blocks.fu.jumpbranch.JumpBranchFn object>)

class coreblocks.func_blocks.fu.jumpbranch.JumpComponent

Bases: FunctionalComponentParams

__init__(decoder_manager: ~coreblocks.func_blocks.fu.jumpbranch.JumpBranchFn = <coreblocks.func_blocks.fu.jumpbranch.JumpBranchFn object>, *, result_fifo: bool = False) → None

decoder_manager: JumpBranchFn = <coreblocks.func_blocks.fu.jumpbranch.JumpBranchFn object>

get_module(gen_params: GenParams) → FuncUnit

coreblocks.func_blocks.fu.mul_unit module

class coreblocks.func_blocks.fu.mul_unit.MulComponent

Bases: FunctionalComponentParams

__init__(mul_unit_type: ~coreblocks.func_blocks.fu.mul_unit.MulType, *, result_fifo: bool = False, decoder_manager: ~coreblocks.func_blocks.fu.mul_unit.MulFn = <coreblocks.func_blocks.fu.mul_unit.MulFn object>, dsp_width: int = 32) → None

decoder_manager: MulFn = <coreblocks.func_blocks.fu.mul_unit.MulFn object>

dsp_width: int = 32

get_module(gen_params: GenParams) → FuncUnit

mul_unit_type: MulType

result_fifo: bool = False

class coreblocks.func_blocks.fu.mul_unit.MulFn

Bases: DecoderManager

Hot wire enum of 5 different multiplication operations.

class Fn

Bases: IntFlag

MUL = 1

MULH = 2

MULHSU = 8

MULHU = 4

__new__(value)

get_instructions() → Sequence[tuple]

Method providing list of valid instruction.

Returns

returnSequence[tuple]

List of implemented instructions, each following format: (IntFlag, OpType, Funct3 (optional), Funct7 (optional))

class coreblocks.func_blocks.fu.mul_unit.MulType

Bases: IntEnum

Enum of different multiplication units types

RECURSIVE_MUL = 2

Fastest way of multiplying using only one cycle, but costly in terms of resources.

SEQUENCE_MUL = 1

Uses single DSP unit for multiplication, which makes balance between performance and cost.

SHIFT_MUL = 0

The cheapest multiplication unit in terms of resources, it uses Russian Peasants Algorithm.

__new__(value)

class coreblocks.func_blocks.fu.mul_unit.MulUnit

Bases: FuncUnit, Elaboratable

Module responsible for handling every kind of multiplication based on selected unsigned integer multiplication module. It uses standard FuncUnitLayout.

Attributes

issue: Method(i=gen.get(FuncUnitLayouts).issue)

Method used for requesting computation.

push_result: Method(i=gen.get(FuncUnitLayouts).push_result)

Method called for pushing result of requested computation.

__init__(gen_params: ~coreblocks.params.genparams.GenParams, mul_type: ~coreblocks.func_blocks.fu.mul_unit.MulType, dsp_width: int = 32, mul_fn=<coreblocks.func_blocks.fu.mul_unit.MulFn object>)

Parameters

gen_params: GenParams

Core generation parameters.

coreblocks.func_blocks.fu.priv module

class coreblocks.func_blocks.fu.priv.PrivilegedFn

Bases: DecoderManager

class Fn

Bases: IntFlag

FENCEI = 2

MRET = 1

WFI = 4

__new__(value)

get_instructions() → Sequence[tuple]

Method providing list of valid instruction.

Returns

returnSequence[tuple]

List of implemented instructions, each following format: (IntFlag, OpType, Funct3 (optional), Funct7 (optional))

class coreblocks.func_blocks.fu.priv.PrivilegedFuncUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, priv_fn=<coreblocks.func_blocks.fu.priv.PrivilegedFn object>)

class coreblocks.func_blocks.fu.priv.PrivilegedUnitComponent

Bases: FunctionalComponentParams

__init__(decoder_manager: ~coreblocks.func_blocks.fu.priv.PrivilegedFn = <coreblocks.func_blocks.fu.priv.PrivilegedFn object>, *, result_fifo: bool = False) → None

decoder_manager: PrivilegedFn = <coreblocks.func_blocks.fu.priv.PrivilegedFn object>

get_module(gp: GenParams) → FuncUnit

coreblocks.func_blocks.fu.shift_unit module

class coreblocks.func_blocks.fu.shift_unit.ShiftFuncUnit

Bases: FuncUnit, Elaboratable

__init__(gen_params: ~coreblocks.params.genparams.GenParams, shift_unit_fn=<coreblocks.func_blocks.fu.shift_unit.ShiftUnitFn object>)

class coreblocks.func_blocks.fu.shift_unit.ShiftUnitComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = True, zbb_enable: bool = False) → None

decoder_manager: ShiftUnitFn

get_decoder_manager()

get_module(gen_params: GenParams) → FuncUnit

result_fifo: bool = True

zbb_enable: bool = False

coreblocks.func_blocks.fu.zbc module

class coreblocks.func_blocks.fu.zbc.ClMultiplier

Bases: Elaboratable

Module for computing carry-less product

Attributes

i1: Signal(unsigned(n)), in

First factor.

i2: Signal(unsigned(n)), in

Second factor.

result: Signal(unsigned(n * 2)), out

Result.

reset: Signal(1), in

Setting this signal to 1 will start a new computation with provided inputs

busy: Signal(1), out

Set to 1 while a computation is in progress

__init__(bit_width: int, recursion_depth: int)

Parameters

bit_width: int

Bit width of inputs

recursion_depth: int

Depth of recursive submodules for parallel computation (assumes bit_width to be a power of 2)

iterative_module()

recursive_module()

class coreblocks.func_blocks.fu.zbc.ZbcComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = False, decoder_manager: ~coreblocks.func_blocks.fu.zbc.ZbcFn = <coreblocks.func_blocks.fu.zbc.ZbcFn object>, recursion_depth: int = 3) → None

decoder_manager: ZbcFn = <coreblocks.func_blocks.fu.zbc.ZbcFn object>

get_module(gen_params: GenParams) → FuncUnit

recursion_depth: int = 3

class coreblocks.func_blocks.fu.zbc.ZbcFn

Bases: DecoderManager

class Fn

Bases: IntFlag

CLMUL = 1

CLMULH = 2

CLMULR = 4

__new__(value)

classmethod get_instructions() → Sequence[tuple]

Method providing list of valid instruction.

Returns

returnSequence[tuple]

List of implemented instructions, each following format: (IntFlag, OpType, Funct3 (optional), Funct7 (optional))

class coreblocks.func_blocks.fu.zbc.ZbcUnit

Bases: FuncUnit, Elaboratable

Module responsible for executing Zbc instructions (carry-less multiplication)

Attributes

issue: Method(i=FuncUnitLayouts.issue)

Method used for requesting computation.

push_result: Method(i=FuncUnitLayouts.push_result)

Method called for pushing result of requested computation.

__init__(gen_params: GenParams, recursion_depth: int, zbc_fn: ZbcFn)

coreblocks.func_blocks.fu.zbs module

class coreblocks.func_blocks.fu.zbs.Zbs

Bases: Elaboratable

Module responsible for executing Zbs instructions.

Attributes

function: ZbsFunction, in

Function to be executed.

in1: Signal(xlen), in

First input.

in2: Signal(xlen), in

Second input.

__init__(gen_params: ~coreblocks.params.genparams.GenParams, function=<coreblocks.func_blocks.fu.zbs.ZbsFunction object>)

Parameters

gen_paramsGenParams

Core generation parameters.

functionZbsFunction

Decoder manager to decode instruction.

class coreblocks.func_blocks.fu.zbs.ZbsComponent

Bases: FunctionalComponentParams

__init__(*, result_fifo: bool = True, decoder_manager: ~coreblocks.func_blocks.fu.zbs.ZbsFunction = <coreblocks.func_blocks.fu.zbs.ZbsFunction object>) → None

decoder_manager: ZbsFunction = <coreblocks.func_blocks.fu.zbs.ZbsFunction object>

get_module(gen_params: GenParams) → FuncUnit

result_fifo: bool = True

class coreblocks.func_blocks.fu.zbs.ZbsFunction

Bases: DecoderManager

Enum of Zbs functions.

class Fn

Bases: IntFlag

BCLR = 1

BEXT = 2

BINV = 4

BSET = 8

__new__(value)

get_instructions() → Sequence[tuple]

Method providing list of valid instruction.

Returns

returnSequence[tuple]

List of implemented instructions, each following format: (IntFlag, OpType, Funct3 (optional), Funct7 (optional))

class coreblocks.func_blocks.fu.zbs.ZbsUnit

Bases: FuncUnit, Elaboratable

Module responsible for executing Zbs instructions.

Attributes

issue: Method(i=FuncUnitLayouts.issue)

Method used for requesting computation.

push_result: Method(i=FuncUnitLayouts.push_result)

Method called for pushing result of requested computation.

__init__(gen_params: ~coreblocks.params.genparams.GenParams, zbs_fn=<coreblocks.func_blocks.fu.zbs.ZbsFunction object>)

Module contents