Skip to content

Overview

Register File.

TODO: example

Classes:

Name Description
Field

Field.

Word

Word.

Words

Set of Words.

Addrspace

Address Space.

SigExprTuple

Used for Guard Management.

GrdSlcTuple

Used for Guard Management.

UcdpRegfMod

Register File.

FieldIoType

Field IO Type.

Functions:

Name Description
get_in_regf

Calculate whether field is in regf.

check_field

Check for Corner Cases On Field.

filter_busacc

Bus accessible Fields.

filter_regf_flipflops

In-Regf Flop Fields.

filter_regf_consts

In-Regf Constant Fields.

filter_buswrite

Writable Bus Fields.

filter_buswriteonce

Write-Once Bus Fields.

filter_busread

Bus-Readable Fields.

filter_busrdmod

Modify-on-read Fields in Regf.

filter_busgrderr

Fields with conditional Modify Access.

filter_coreacc

Core-Accessible Fields.

filter_coreread

Core-Readable Fields.

filter_incore_buswr

Bus-written in-core fields.

get_regfiotype

Determine IO-Type for fields in addrspace.

get_regfwordiotype

Determine IO-Type for words in addrspace.

get_regfportname

Determine Name of Portname.

Field

Bases: Field

Field.

Methods:

Name Description
from_word

Create Field Containing Word.

Attributes:

Name Type Description
portgroups tuple[str, ...] | None

Portgroups.

in_regf bool

Implementation within Regf.

upd_prio Prio | None

Update Priority: None, 'b'us or 'c'core.

upd_strb bool

Update strobe towards core.

upd_grps tuple[str, ...] | None

Update strobe portgroups.

wr_guard str | None

Write guard name (must be unique).

guard_err GrdErrMode

Bus error on write to guarded/write-once field.

signame str

Signal Basename to Core.

route Routeables | None

Optional Route.

is_alias bool

Used as Alias for Wordio.

bus_prio bool

Update prioriy for bus.

valname str

Reference to Current Value.

corewrname str

Reference to Value towards Core.

portgroups class-attribute instance-attribute

portgroups = None

Portgroups.

in_regf instance-attribute

in_regf

Implementation within Regf.

upd_prio class-attribute instance-attribute

upd_prio = None

Update Priority: None, 'b'us or 'c'core.

upd_strb class-attribute instance-attribute

upd_strb = False

Update strobe towards core.

upd_grps class-attribute instance-attribute

upd_grps = None

Update strobe portgroups.

wr_guard class-attribute instance-attribute

wr_guard = None

Write guard name (must be unique).

guard_err class-attribute instance-attribute

guard_err = None

Bus error on write to guarded/write-once field.

signame instance-attribute

signame

Signal Basename to Core.

route class-attribute instance-attribute

route = None

Optional Route.

is_alias class-attribute instance-attribute

is_alias = False

Used as Alias for Wordio.

bus_prio property

bus_prio

Update prioriy for bus.

valname cached property

valname

Reference to Current Value.

corewrname cached property

corewrname

Reference to Value towards Core.

from_word staticmethod

from_word(word, **kwargs)

Create Field Containing Word.

Word

Bases: Word

Word.

Attributes:

Name Type Description
portgroups tuple[str, ...] | None

Default Portgroups for Fields.

in_regf bool | None

Default Implementation within Regf.

upd_prio Prio | None

Update Priority: None, 'b'us or 'c'core.

upd_strb WordStrb

Update strobe towards core.

upd_grps tuple[str, ...] | None

Update strobe portgroups.

wr_guard str | None

Write guard name (must be unique).

guard_err GrdErrMode

Bus error on write to word with guarded/write-once fields.

wordio bool

Create Word-Based Interface Towards Core.

fieldio bool

Create Field-Based Interface Towards Core.

portgroups class-attribute instance-attribute

portgroups = None

Default Portgroups for Fields.

in_regf class-attribute instance-attribute

in_regf = None

Default Implementation within Regf.

upd_prio class-attribute instance-attribute

upd_prio = None

Update Priority: None, 'b'us or 'c'core.

upd_strb class-attribute instance-attribute

upd_strb = False

Update strobe towards core.

upd_grps class-attribute instance-attribute

upd_grps = None

Update strobe portgroups.

wr_guard class-attribute instance-attribute

wr_guard = None

Write guard name (must be unique).

guard_err class-attribute instance-attribute

guard_err = None

Bus error on write to word with guarded/write-once fields.

wordio class-attribute instance-attribute

wordio = False

Create Word-Based Interface Towards Core.

fieldio class-attribute instance-attribute

fieldio = True

Create Field-Based Interface Towards Core.

Words

Bases: Words

Set of Words.

Addrspace

Bases: Addrspace

Address Space.

Attributes:

Name Type Description
portgroups tuple[str, ...] | None

Default Portgroups for Words.

in_regf bool | None

Default Implementation within Regf.

upd_prio Prio | None

Update Priority: None, 'bus' or 'core'.

upd_strb bool

Update strobe towards core.

upd_grps tuple[str, ...] | None

Update strobe portgroups.

wr_guard str | None

Write guard name (must be unique).

guard_err GrdErrMode

Bus error on write to words with guarded/write-once fields.

addr_width int

Returns derived Address Width for Addrspace.

portgroups class-attribute instance-attribute

portgroups = None

Default Portgroups for Words.

in_regf class-attribute instance-attribute

in_regf = None

Default Implementation within Regf.

upd_prio class-attribute instance-attribute

upd_prio = None

Update Priority: None, 'bus' or 'core'.

upd_strb class-attribute instance-attribute

upd_strb = False

Update strobe towards core.

upd_grps class-attribute instance-attribute

upd_grps = None

Update strobe portgroups.

wr_guard class-attribute instance-attribute

wr_guard = None

Write guard name (must be unique).

guard_err class-attribute instance-attribute

guard_err = None

Bus error on write to words with guarded/write-once fields.

addr_width cached property

addr_width

Returns derived Address Width for Addrspace.

SigExprTuple

Bases: NamedTuple

Used for Guard Management.

GrdSlcTuple

Bases: NamedTuple

Used for Guard Management.

UcdpRegfMod

Bases: ATailoredMod

Register File.

Methods:

Name Description
add_word

Add Word.

add_words

Add Words.

add_soft_rst

Add Soft Reset.

get_overview

Overview.

get_addrspaces

Yield Address Space.

Attributes:

Name Type Description
width int

Width in Bits.

depth int

Number of words.

slicing PositiveInt | SliceWidths | None

Use sliced write enables (of same or individual widths).

portgroups tuple[str, ...] | None

Default Portgroups for Words.

in_regf bool | None

Default Implementation within Regf.

upd_prio Prio | None

Update Priority: None, 'bus' or 'core'.

upd_strb bool

Update strobe towards core.

wr_guard str | None

Write guard name (must be unique).

guard_err GrdErrMode

Bus error on write to words with guarded/write-once fields.

addrspace Addrspace

Address Space.

regfiotype DynamicStructType

IO-Type With All Field-Wise Core Signals .

regfwordiotype DynamicStructType

IO-Type With All Word-Wise Core Signals .

memiotype MemIoType

Memory IO-Type.

width class-attribute instance-attribute

width = 32

Width in Bits.

depth class-attribute instance-attribute

depth = 1024

Number of words.

slicing class-attribute instance-attribute

slicing = None

Use sliced write enables (of same or individual widths).

portgroups class-attribute instance-attribute

portgroups = None

Default Portgroups for Words.

in_regf class-attribute instance-attribute

in_regf = None

Default Implementation within Regf.

upd_prio class-attribute instance-attribute

upd_prio = None

Update Priority: None, 'bus' or 'core'.

upd_strb class-attribute instance-attribute

upd_strb = False

Update strobe towards core.

wr_guard class-attribute instance-attribute

wr_guard = None

Write guard name (must be unique).

guard_err class-attribute instance-attribute

guard_err = None

Bus error on write to words with guarded/write-once fields.

addrspace cached property

addrspace

Address Space.

regfiotype cached property

regfiotype

IO-Type With All Field-Wise Core Signals .

regfwordiotype cached property

regfwordiotype

IO-Type With All Word-Wise Core Signals .

memiotype cached property

memiotype

Memory IO-Type.

add_word

add_word(*args, **kwargs)

Add Word.

add_words

add_words(*args, **kwargs)

Add Words.

add_soft_rst

add_soft_rst(soft_reset='soft_rst_i')

Add Soft Reset.

Calling w/o argument results in adding input 'soft_rst_i. Calling with a string will be treated as soft reset input port name and checked for name and type conformance. calling with a string '.' will use this field as soft reset.

get_overview

get_overview()

Overview.

get_addrspaces

get_addrspaces(defines=None)

Yield Address Space.

FieldIoType

Bases: DynamicStructType

Field IO Type.

get_in_regf

get_in_regf(bus, core)

Calculate whether field is in regf.

check_field

check_field(wordname, field)

Check for Corner Cases On Field.

filter_busacc

filter_busacc(field)

Bus accessible Fields.

filter_regf_flipflops

filter_regf_flipflops(field)

In-Regf Flop Fields.

filter_regf_consts

filter_regf_consts(field)

In-Regf Constant Fields.

filter_buswrite

filter_buswrite(field)

Writable Bus Fields.

filter_buswriteonce

filter_buswriteonce(field)

Write-Once Bus Fields.

filter_busread

filter_busread(field)

Bus-Readable Fields.

filter_busrdmod

filter_busrdmod(field)

Modify-on-read Fields in Regf.

filter_busgrderr

filter_busgrderr(field)

Fields with conditional Modify Access.

filter_coreacc

filter_coreacc(field)

Core-Accessible Fields.

filter_coreread

filter_coreread(field)

Core-Readable Fields.

filter_incore_buswr

filter_incore_buswr(field)

Bus-written in-core fields.

get_regfiotype

get_regfiotype(addrspace, sliced_en=False)

Determine IO-Type for fields in addrspace.

get_regfwordiotype

get_regfwordiotype(addrspace, sliced_en=False)

Determine IO-Type for words in addrspace.

get_regfportname

get_regfportname(field, direction=OUT)

Determine Name of Portname.