83 lines
2.4 KiB
Python
83 lines
2.4 KiB
Python
from typing import TYPE_CHECKING, Union
|
|
from systemrdl.node import Node, SignalNode, FieldNode
|
|
from systemrdl.rdltypes import AccessType
|
|
|
|
if TYPE_CHECKING:
|
|
from ..exporter import RegblockExporter
|
|
|
|
class HwifBase:
|
|
"""
|
|
Defines how the hardware input/output signals are generated:
|
|
- Field outputs
|
|
- Field inputs
|
|
- Signal inputs (except those that are promoted to the top)
|
|
"""
|
|
|
|
def __init__(self, exporter:'RegblockExporter', top_node:'Node', package_name:str):
|
|
self.exporter = exporter
|
|
self.top_node = top_node
|
|
self.package_name = package_name
|
|
|
|
|
|
def get_package_declaration(self) -> str:
|
|
"""
|
|
If this hwif requires a package, generate the string
|
|
"""
|
|
return ""
|
|
|
|
|
|
@property
|
|
def port_declaration(self) -> str:
|
|
"""
|
|
Returns the declaration string for all I/O ports in the hwif group
|
|
"""
|
|
raise NotImplementedError()
|
|
|
|
#---------------------------------------------------------------------------
|
|
# hwif utility functions
|
|
#---------------------------------------------------------------------------
|
|
def has_value_input(self, obj: Union[FieldNode, SignalNode]) -> bool:
|
|
"""
|
|
Returns True if the object infers an input wire in the hwif
|
|
"""
|
|
if isinstance(obj, FieldNode):
|
|
return obj.get_property("hw") in {AccessType.rw, AccessType.w}
|
|
elif isinstance(obj, SignalNode):
|
|
raise NotImplementedError # TODO:
|
|
else:
|
|
raise RuntimeError
|
|
|
|
|
|
def has_value_output(self, obj: FieldNode) -> bool:
|
|
"""
|
|
Returns True if the object infers an output wire in the hwif
|
|
"""
|
|
return obj.get_property("hw") in {AccessType.rw, AccessType.r}
|
|
|
|
|
|
def get_input_identifier(self, obj) -> str:
|
|
"""
|
|
Returns the identifier string that best represents the input object.
|
|
|
|
if obj is:
|
|
Field: the fields input value port
|
|
Signal: signal input value
|
|
TODO: finish this
|
|
|
|
raises an exception if obj is invalid
|
|
"""
|
|
raise NotImplementedError()
|
|
|
|
|
|
def get_output_identifier(self, obj) -> str:
|
|
"""
|
|
Returns the identifier string that best represents the output object.
|
|
|
|
if obj is:
|
|
Field: the fields output value port
|
|
TODO: finish this
|
|
|
|
raises an exception if obj is invalid
|
|
"""
|
|
raise NotImplementedError()
|