Packages

o

firrtl

Utils

object Utils extends LazyLogging

Source
Utils.scala
Linear Supertypes
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. Utils
  2. LazyLogging
  3. AnyRef
  4. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. case class DeclarationNotFoundException(msg: String) extends FirrtlUserException with Product with Serializable
  2. type NodeMap = HashMap[String, Expression]

    Maps node name to value

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. val BoolType: UIntType
  5. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  6. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  7. def create_exps(e: Expression): Seq[Expression]
  8. def create_exps(n: String, t: Type): Seq[Expression]
  9. def dec2string(v: BigDecimal): String
  10. def diff(e1: Expression, e2: Expression): Seq[(Expression, Expression)]

    Walks two expression trees and returns a sequence of tuples of where they differ

  11. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  12. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  13. def error(str: String, cause: Throwable = null): Nothing
  14. def expandPrefixes(name: String, prefixDelim: String = "_"): Seq[String]

    Expand a name into its prefixes, e.g., 'foo_barbaz' becomes 'Seq[foo_, foo_bar, foo_barbaz]'. This can be used to produce better names when generating prefix unique names.

    Expand a name into its prefixes, e.g., 'foo_barbaz' becomes 'Seq[foo_, foo_bar, foo_barbaz]'. This can be used to produce better names when generating prefix unique names.

    name

    a signal name

    prefixDelim

    a prefix delimiter (default is "_")

    returns

    the signal name and any prefixes

  15. def expandRef(e: Expression): Seq[Expression]

    Like create_exps, but returns intermediate Expressions as well

  16. def field_flip(v: Type, s: String): Orientation
  17. def field_type(v: Type, s: String): Type
  18. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  19. def flow(e: Expression): Flow
  20. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  21. def getDeclaration(m: Module, expr: Expression): IsDeclaration

    Gets the root declaration of an expression

    Gets the root declaration of an expression

    m

    the firrtl.ir.Module to search

    expr

    the firrtl.ir.Expression that refers to some declaration

    returns

    the firrtl.ir.IsDeclaration of expr

    Exceptions thrown

    DeclarationNotFoundException if no declaration of expr is found

  22. def getGroundZero(tpe: GroundType): Expression

    Returns an Expression equal to zero for a given GroundType

    Returns an Expression equal to zero for a given GroundType

    Note

    Does not support AnalogType nor IntervalType

  23. def getKids(e: Expression): Seq[Expression]

    Returns children Expressions of e

  24. def getSIntWidth(s: BigInt): Int
  25. def getThrowable(maybeException: Option[Throwable], first: Boolean): Throwable

    Unwind the causal chain until we hit the initial exception (which may be the first).

    Unwind the causal chain until we hit the initial exception (which may be the first).

    maybeException

    - possible exception triggering the error,

    first

    - true if we want the first (eldest) exception in the chain,

    returns

    first or last Throwable in the chain.

  26. def getUIntWidth(u: BigInt): Int
  27. def get_field(v: Type, s: String): Field
  28. def get_flow(p: Port): Flow
  29. def get_flow(s: Statement): Flow
  30. def get_info(s: Statement): Info
  31. def get_point(e: Expression): Int
  32. def get_size(t: Type): Int
  33. def get_valid_points(t1: Type, t2: Type, flip1: Orientation, flip2: Orientation): Seq[(Int, Int)]
  34. def hasFlip(t: Type): Boolean

    Returns true if t, or any subtype, contains a flipped field

    Returns true if t, or any subtype, contains a flipped field

    t

    type firrtl.ir.Type to be checked

    returns

    if t contains firrtl.ir.Flip

  35. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native()
  36. def inline(nodeMap: NodeMap, stop: (String) ⇒ Boolean = x: String => false)(e: Expression): Expression

    Returns an inlined expression (replacing node references with values), stopping on a stopping condition or until the reference is not a node

  37. def isBitExtract(expr: Expression): Boolean

    Returns true if Expression is a Bits PrimOp, false otherwise

  38. def isBitExtract(op: PrimOp): Boolean

    Returns true if PrimOp is a BitExtraction, false otherwise

  39. def isCast(expr: Expression): Boolean

    Returns true if Expression is a casting PrimOp, false otherwise

  40. def isCast(op: PrimOp): Boolean

    Returns true if PrimOp is a cast, false otherwise

  41. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  42. def isTemp(str: String): Boolean
  43. def kind(e: Expression): Kind
  44. val logger: Logger
    Attributes
    protected
    Definition Classes
    LazyLogging
  45. def maskBigInt(value: BigInt, width: Int): BigInt

    Returns the value masked with the width.

    Returns the value masked with the width.

    This supports truncating negative values as well as values that are too wide for the width

  46. def max(a: BigInt, b: BigInt): BigInt
  47. def mergeRef(root: Expression, body: Expression): Expression

    Adds a root reference to some SubField/SubIndex chain

  48. def min(a: BigInt, b: BigInt): BigInt
  49. def module_type(m: DefModule): BundleType
  50. def mux_type(t1: Type, t2: Type): Type
  51. def mux_type(e1: Expression, e2: Expression): Type
  52. def mux_type_and_widths(t1: Type, t2: Type): Type
  53. def mux_type_and_widths(e1: Expression, e2: Expression): Type
  54. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  55. def niceName(depth: Int)(e: Expression): String
  56. def niceName(e: Expression): String

    Provide a nice name to create a temporary *

  57. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  58. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native()
  59. val one: UIntLiteral
  60. def pow_minus_one(a: BigInt, b: BigInt): BigInt
  61. def splitRef(e: Expression): (WRef, Expression)

    Splits an Expression into root Ref and tail

    Splits an Expression into root Ref and tail

    Examples:
    1. Given: SubField(SubIndex(SubField(Ref("a", UIntType(IntWidth(32))), "b"), 2), "c") Returns: (Ref("a"), SubField(SubIndex(Ref("b"), 2), "c")) a.b[2].c -> (a, b[2].c)

    2. ,
    3. Given: SubField(SubIndex(Ref("b"), 2), "c") Returns: (Ref("b"), SubField(SubIndex(EmptyExpression, 2), "c")) b[2].c -> (b, EMPTY[2].c)

    Note

    This function only supports WRef, WSubField, and WSubIndex

  62. def squashEmpty(s: Statement): Statement

    Removes all firrtl.ir.EmptyStmt statements and condenses firrtl.ir.Block statements.

  63. def stmtToType(s: Statement): BundleType

    Creates a Bundle Type from a Stmt

  64. def sub_type(v: Type): Type
  65. def swap(f: Orientation): Orientation
  66. def swap(d: Direction): Direction
  67. def swap(g: Flow): Flow
  68. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  69. def throwInternalError(message: String = "", exception: Option[Exception] = None): Nothing

    Throw an internal error, possibly due to an exception.

    Throw an internal error, possibly due to an exception.

    message

    - possible string to emit,

    exception

    - possible exception triggering the error.

  70. def time[R](block: ⇒ R): (Double, R)
  71. def times(f1: Orientation, f2: Orientation): Orientation
  72. def times(flip: Orientation, g: Flow): Flow
  73. def times(g: Flow, flip: Orientation): Flow
  74. def times(d: Direction, g: Flow): Direction
  75. def times(g: Flow, d: Direction): Direction
  76. def times(d: Direction, flip: Orientation): Direction
  77. def toString(): String
    Definition Classes
    AnyRef → Any
  78. def toTarget(main: String, module: String)(expression: Expression): ReferenceTarget
  79. implicit def toWrappedExpression(x: Expression): WrappedExpression
  80. def to_dir(o: Orientation): Direction
  81. def to_dir(g: Flow): Direction
  82. def to_flip(g: Flow): Orientation
  83. def to_flip(d: Direction): Orientation
  84. def to_flow(d: Direction): Flow
  85. def trim(v: BigDecimal): BigDecimal
  86. val v_keywords: Set[String]
  87. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  88. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  89. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  90. val zero: UIntLiteral

Deprecated Value Members

  1. def get_flip(t: Type, i: Int, f: Orientation): Orientation
    Annotations
    @deprecated
    Deprecated

    (Since version FIRRTL 1.2) get_flip is fundamentally slow, use to_flip(flow(expr))

  2. def indent(str: String): String

    Indent the results of ir.FirrtlNode.serialize

    Indent the results of ir.FirrtlNode.serialize

    Annotations
    @deprecated
    Deprecated

    (Since version FIRRTL 1.4) Use ther new firrt.ir.Serializer instead.

Inherited from LazyLogging

Inherited from AnyRef

Inherited from Any

Ungrouped