coreblocks.frontend package

Subpackages

• coreblocks.frontend.decoder package
  • Submodules
  • coreblocks.frontend.decoder.decode_stage module
  • coreblocks.frontend.decoder.instr_decoder module
  • coreblocks.frontend.decoder.instr_description module
  • coreblocks.frontend.decoder.rvc module
  • Module contents
• coreblocks.frontend.fetch package
  • Submodules
  • coreblocks.frontend.fetch.fetch module
  • Module contents

Submodules

coreblocks.frontend.frontend module

class coreblocks.frontend.frontend.CoreFrontend

Bases: Elaboratable

Frontend of the core.

Attributes

consume_instr: Method

Consume a single decoded instruction.

resume_from_exception: Method

Resume the frontend from the given PC after an exception.

stall: Method

Stall and flush the frontend.

__init__(*, gen_params: GenParams, instr_bus: BusMasterInterface)

class coreblocks.frontend.frontend.RollbackTagger

Bases: Elaboratable

Provides rollback_tag field for instructions leaving the Frontend and decides on which instructions a checkpoint should be created.

rollback_tag is used to identify new instructions fetched after each rollback. Instructions from previous rollback are flushed internally in Frontend (and this module), but this is needed to differentiate from instructions that left Frontend earlier.

Requires get_instr and push_instr methods

__init__(gen_params: GenParams) → None

coreblocks.frontend.frontend_params module

class coreblocks.frontend.frontend_params.FrontendParams

Bases: object

__init__(gen_params: GenParams)

fb_addr(pc: amaranth.hdl._ast.Value | int | enum.Enum | amaranth.hdl._ast.ValueCastable) → Value

Returns the fetch block address of a given PC.

fb_instr_idx(pc: amaranth.hdl._ast.Value | int | enum.Enum | amaranth.hdl._ast.ValueCastable) → Value

Returns the index of an instruction in a fetch block for a given instruction PC.

pc_from_fb(fb_addr: amaranth.hdl._ast.Value | int | enum.Enum | amaranth.hdl._ast.ValueCastable, fb_instr_idx: int | amaranth.hdl._ast.Value) → Value

For a given fetch block address and an instruction index, returns the instruction’s PC.

coreblocks.frontend.stall_controller module

class coreblocks.frontend.stall_controller.StallController

Bases: Elaboratable

The stall controller is responsible for managing all stall/unstall signals that may be triggered in the core and based on them deciding if and where the frontend should be resumed.

Attributes

stall_unsafeMethod

Signals that the frontend should be stalled because an unsafe (i.e. causing difficult to handle side effects) instruction was just fetched.

stall_exceptionMethod

Signals that the frontend should be stalled because of an exception.

stall_guardMethod

A non-exclusive method whose readiness denotes if the frontend is currently stalled.

resume_from_exception: Method

Signals that the backend handled the exception and the frontend can be resumed.

redirect_frontendMethod (bodyless)

A method that will be called when the frontend needs to be redirected. Should be always ready.

__init__(gen_params: GenParams)

Module contents