firrtl.annotations

Members list

Type members

Deprecated classlikes

trait Annotation extends Product

Base type of auxiliary information

Base type of auxiliary information

Attributes

Companion
object
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
trait Product
trait Equals
class Object
trait Matchable
class Any
Known subtypes
class EmittedMLIR
class DesignAnnotation[DUT]
class RemapLayer
Show all
object Annotation

Attributes

Companion
trait
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
class Object
trait Matchable
class Any
Self type
Annotation.type
case class AnnotationClassNotFoundException(className: String) extends FirrtlUserException

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait Product
trait Equals
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all
case class AnnotationException(message: String) extends Exception

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
trait Product
trait Equals
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all
case class AnnotationFileNotFoundException(file: File) extends FirrtlUserException

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait Product
trait Equals
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
class Object
trait Matchable
class Any
Self type
trait CompleteTarget extends Target

Concretely points to a FIRRTL target, no generic selectors IsLegal

Concretely points to a FIRRTL target, no generic selectors IsLegal

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Target
trait Named
class Object
trait Matchable
class Any
Known subtypes
trait IsMember
trait IsComponent
trait IsModule
class ModuleTarget
Show all
final case class ComponentName(name: String, module: ModuleName) extends Named

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait Named
class Object
trait Matchable
class Any
Show all
case class GenericTarget(moduleOpt: Option[String], tokens: Vector[TargetToken]) extends Target

Represents incomplete or non-standard Targets

Represents incomplete or non-standard Targets

Value parameters

moduleOpt

Optional module name

tokens

TargetTokens to represent the target in a module

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait Target
trait Named
class Object
trait Matchable
class Any
Show all

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
JsonProtocol.scala
Supertypes
class Object
trait Matchable
class Any

Similar to HasSerializationHints but for types whose serialization classes need to be overridden

Similar to HasSerializationHints but for types whose serialization classes need to be overridden

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
JsonProtocol.scala
Supertypes
class Object
trait Matchable
class Any
case class InstanceTarget(module: String, path: Seq[(Instance, OfModule)], instance: String, ofModule: String) extends IsModule, IsComponent

Points to an instance declaration of a module (termed an ofModule)

Points to an instance declaration of a module (termed an ofModule)

Value parameters

instance

Name of the instance

module

Root module (e.g. the base module of this target)

ofModule

Name of the instance's module

path

Path through instance/ofModules

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait IsComponent
trait IsModule
trait IsMember
trait Target
trait Named
class Object
trait Matchable
class Any
Show all
case class InvalidAnnotationFileException(file: File, cause: FirrtlUserException = ...) extends FirrtlUserException

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait Product
trait Equals
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all
case class InvalidAnnotationJSONException(msg: String) extends FirrtlUserException

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait Product
trait Equals
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all
trait IsComponent extends IsMember

A component of a FIRRTL Module (e.g. cannot point to a ModuleTarget)

A component of a FIRRTL Module (e.g. cannot point to a ModuleTarget)

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait IsMember
trait Target
trait Named
class Object
trait Matchable
class Any
Show all
Known subtypes
trait IsMember extends CompleteTarget

A member of a FIRRTL Circuit Concrete Subclasses are: ModuleTarget, InstanceTarget, and ReferenceTarget

A member of a FIRRTL Circuit Concrete Subclasses are: ModuleTarget, InstanceTarget, and ReferenceTarget

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Target
trait Named
class Object
trait Matchable
class Any
Show all
Known subtypes
trait IsModule extends IsMember

References a module-like target (e.g. a ModuleTarget or an InstanceTarget)

References a module-like target (e.g. a ModuleTarget or an InstanceTarget)

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait IsMember
trait Target
trait Named
class Object
trait Matchable
class Any
Show all
Known subtypes
object JsonProtocol extends LazyLogging

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
JsonProtocol.scala
Supertypes
trait LazyLogging
class Object
trait Matchable
class Any
Self type
case class LoadMemoryAnnotation(target: ComponentName, fileName: String, hexOrBinary: MemoryLoadFileType = ..., originalMemoryNameOpt: Option[String] = ...) extends SingleTargetAnnotation[Named]

Firrtl implementation for load memory

Firrtl implementation for load memory

Value parameters

fileName

name of input file

hexOrBinary

use $readmemh or $readmemb

target

memory to load

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
LoadMemoryAnnotation.scala
Supertypes
trait Serializable
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
case class MemoryFileInlineAnnotation(target: ReferenceTarget, filename: String, hexOrBinary: FileType = ...) extends MemoryInitAnnotation

Initialize the target memory with inline readmem[hb] statement.

Initialize the target memory with inline readmem[hb] statement.

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
MemoryInitAnnotation.scala
Supertypes
trait Serializable
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Represents the initial value of the annotated memory. While not supported on normal ASIC flows, it can be useful for simulation and FPGA flows. This annotation is consumed by the verilog emitter.

Represents the initial value of the annotated memory. While not supported on normal ASIC flows, it can be useful for simulation and FPGA flows. This annotation is consumed by the verilog emitter.

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
MemoryInitAnnotation.scala
Supertypes
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
Known subtypes
sealed abstract class MemoryLoadFileType(val value: String)

Representation of the two types of readmem statements available in Verilog.

Representation of the two types of readmem statements available in Verilog.

Attributes

Companion
object
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
LoadMemoryAnnotation.scala
Supertypes
class Object
trait Matchable
class Any
Known subtypes
object Binary
object Hex

Attributes

Companion
class
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
LoadMemoryAnnotation.scala
Supertypes
trait Sum
trait Mirror
class Object
trait Matchable
class Any
Self type
final case class ModuleName(name: String) extends Named

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait Named
class Object
trait Matchable
class Any
Show all
case class ModuleTarget(module: String) extends IsModule

Target pointing to a FIRRTL firrtl.ir.DefModule

Target pointing to a FIRRTL firrtl.ir.DefModule

Value parameters

module

Name of the module

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait IsModule
trait IsMember
trait Target
trait Named
class Object
trait Matchable
class Any
Show all
sealed trait Named

Named classes associate an annotation with a component in a Firrtl circuit

Named classes associate an annotation with a component in a Firrtl circuit

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
class Object
trait Matchable
class Any
Known subtypes
class ModuleName
trait Target
trait IsMember
trait IsComponent
trait IsModule
class ModuleTarget
Show all

If an Annotation does not target any Named thing in the circuit, then all updates just return the Annotation itself

If an Annotation does not target any Named thing in the circuit, then all updates just return the Annotation itself

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
Known subtypes

Mix this in to override what class name is used for serialization

Mix this in to override what class name is used for serialization

Note that this breaks automatic deserialization.

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
JsonProtocol.scala
Supertypes
class Object
trait Matchable
class Any
case class ReferenceTarget(module: String, path: Seq[(Instance, OfModule)], ref: String, component: Seq[TargetToken]) extends IsComponent

Target pointing to a declared named component in a firrtl.ir.DefModule This includes: firrtl.ir.Port, firrtl.ir.DefWire, firrtl.ir.DefRegister, firrtl.ir.DefMemory, firrtl.ir.DefNode

Target pointing to a declared named component in a firrtl.ir.DefModule This includes: firrtl.ir.Port, firrtl.ir.DefWire, firrtl.ir.DefRegister, firrtl.ir.DefMemory, firrtl.ir.DefNode

Value parameters

component

Subcomponent of this reference, e.g. field or index

module

Name of the root module of this reference

path

Path through instance/ofModules

ref

Name of component

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Serializable
trait Product
trait Equals
trait IsComponent
trait IsMember
trait Target
trait Named
class Object
trait Matchable
class Any
Show all

An Annotation that targets a single Named thing

An Annotation that targets a single Named thing

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
Known subtypes
sealed trait Target extends Named

Refers to something in a FIRRTL firrtl.ir.Circuit. Used for Annotation targets.

Refers to something in a FIRRTL firrtl.ir.Circuit. Used for Annotation targets.

Can be in various states of completion/resolved:

  • Legal: TargetToken's in tokens are in an order that makes sense
  • Complete: moduleOpt is non-empty, and all Instance() are followed by OfModule()
  • Local: tokens does not refer to things through an instance hierarchy (no Instance() or OfModule() tokens)

Attributes

Companion
object
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
trait Named
class Object
trait Matchable
class Any
Known subtypes
trait IsMember
trait IsComponent
trait IsModule
class ModuleTarget
Show all
object Target

Attributes

Companion
trait
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Target.scala
Supertypes
class Object
trait Matchable
class Any
Self type
Target.type
sealed trait TargetToken

Building block to represent a Target of a FIRRTL component

Building block to represent a Target of a FIRRTL component

Attributes

Companion
object
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
TargetToken.scala
Supertypes
class Object
trait Matchable
class Any
Known subtypes
class Field
class Index
class Instance
class OfModule
class Ref
case object TargetToken

Object containing all TargetToken subclasses

Object containing all TargetToken subclasses

Attributes

Companion
trait
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
TargetToken.scala
Supertypes
trait Singleton
trait Product
trait Mirror
trait Serializable
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all
Self type
case class UnrecogizedAnnotationsException(msg: String) extends FirrtlUserException

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait Product
trait Equals
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all
case class UnrecognizedAnnotation(underlying: JValue) extends NoTargetAnnotation

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
Annotation.scala
Supertypes
trait Serializable
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all

Attributes

Companion
object
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
trait NoStackTrace
class RuntimeException
class Exception
class Throwable
trait Serializable
class Object
trait Matchable
class Any
Show all

Attributes

Companion
class
Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
AnnotationUtils.scala
Supertypes
class Object
trait Matchable
class Any
Self type
case class UnserializeableAnnotation(error: String, content: String) extends NoTargetAnnotation

Wrapper Annotation for Annotations that cannot be serialized

Wrapper Annotation for Annotations that cannot be serialized

Attributes

Deprecated
[Since version Chisel 7.0.0] All APIs in package firrtl are deprecated.
Source
JsonProtocol.scala
Supertypes
trait Serializable
trait Annotation
trait Product
trait Equals
class Object
trait Matchable
class Any
Show all