Packages

p

firrtl

options

package options

Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. options
  2. AnyRef
  3. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. case class Dependency[+A <: DependencyAPI[_]](id: Either[Class[_ <: A], A with Singleton]) extends Product with Serializable
  2. trait DependencyAPI[A <: DependencyAPI[A]] extends AnyRef

    Mixin that defines dependencies between TransformLikes (hereafter referred to as "transforms")

    Mixin that defines dependencies between TransformLikes (hereafter referred to as "transforms")

    This trait forms the basis of the Dependency API of the Chisel/FIRRTL Hardware Compiler Framework. Dependencies are defined in terms of prerequisistes, optional prerequisites, optional prerequisites of, and invalidates. A prerequisite is a transform that must run before this transform. An optional prerequisites is transform that should run before this transform if the other transform is a target (or the prerequisite of a target). An optional prerequisite of is an optional prerequisite injected into another transform. Finally, invalidates define the set of transforms whose effects this transform undos/invalidates. (Invalidation then implies that a transform that is invalidated by this transform and needed by another transform will need to be re-run.)

    This Dependency API only defines dependencies. A concrete DependencyManager is expected to be used to statically resolve a linear ordering of transforms that satisfies dependency requirements.

    A

    some transform

  3. trait DependencyManager[A, B <: TransformLike[A] with DependencyAPI[B]] extends TransformLike[A] with DependencyAPI[B]

    A TransformLike that resolves a linear ordering of dependencies based on requirements.

    A TransformLike that resolves a linear ordering of dependencies based on requirements.

    A

    the type over which this transforms

    B

    the type of the TransformLike

  4. case class DependencyManagerException(message: String, cause: Throwable = null) extends RuntimeException with Product with Serializable

    An exception arising from an in a DependencyManager

  5. trait DoNotTerminateOnExit extends AnyRef

    OptionParser mixin that causes the OptionParser to not call exit (call sys.exit) if the --help option is passed

  6. trait DuplicateHandling extends OptionParser[AnnotationSeq]

    A modified OptionParser with mutable termination and additional checks

  7. trait ExceptOnError extends AnyRef

    OptionParser mixin that converts to OptionsException

    OptionParser mixin that converts to OptionsException

    Scopt, by default, will print errors to stderr, e.g., invalid arguments will do this. However, a Stage uses StageUtils.dramaticError. By converting this to an OptionsException, a Stage can then catch the error an convert it to an OptionsException that a Stage can get at.

  8. sealed trait ExitCode extends AnyRef

    The supertype of all exit codes

  9. sealed trait ExitFailure extends ExitCode

    An ExitCode indicative of failure.

    An ExitCode indicative of failure. This must be non-zero and should not conflict with a reserved exit code.

  10. trait HasShellOptions extends AnyRef

    Indicates that this class/object includes options (but does not add these as a registered class)

  11. trait IdentityLike[A] extends AnyRef

    Mix-in that makes a TransformLike guaranteed to be an identity function on some type.

    Mix-in that makes a TransformLike guaranteed to be an identity function on some type.

    A

    the transformed type

  12. case class InputAnnotationFileAnnotation(file: String) extends NoTargetAnnotation with StageOption with Product with Serializable

    Holds a filename containing one or more annotations.Annotation to be read

    Holds a filename containing one or more annotations.Annotation to be read

  13. class OptionsException extends IllegalArgumentException

    Indicate an error related to a bad Annotation or it's command line option equivalent.

    Indicate an error related to a bad Annotation or it's command line option equivalent. This exception is always caught and converted to an error message by a Stage. Do not use this for communicating generic exception information.

  14. trait OptionsView[T] extends AnyRef

    Type class defining a "view" of an AnnotationSeq

    Type class defining a "view" of an AnnotationSeq

    T

    the type to which this viewer converts an AnnotationSeq to

  15. case class OutputAnnotationFileAnnotation(file: String) extends NoTargetAnnotation with StageOption with Product with Serializable

    An explicit output _annotation_ file to write to

    An explicit output _annotation_ file to write to

    • set with -foaf/--output-annotation-file
  16. trait Phase extends TransformLike[AnnotationSeq] with DependencyAPI[Phase]

    A mathematical transformation of an AnnotationSeq.

    A mathematical transformation of an AnnotationSeq.

    A Phase forms one unit in the Chisel/FIRRTL Hardware Compiler Framework (HCF). The HCF is built from a sequence of Phases applied to an AnnotationSeq. Note that a Phase may consist of multiple phases internally.

  17. class PhaseException extends RuntimeException

    Indicate a generic error in a Phase

  18. class PhaseManager extends DependencyManager[AnnotationSeq, Phase] with Phase

    A Phase that will ensure that some other Phases and their prerequisites are executed.

    A Phase that will ensure that some other Phases and their prerequisites are executed.

    This tries to determine a phase ordering such that an AnnotationSeq output is produced that has had all of the requested Phase target transforms run without having them be invalidated.

  19. class PhasePrerequisiteException extends PhaseException

    Indicates that a Phase is missing some mandatory information.

    Indicates that a Phase is missing some mandatory information. This likely occurs either if a user ran something out of order or if the compiler did not run things in the correct order.

  20. trait PreservesAll[A <: DependencyAPI[A]] extends AnyRef

    A trait indicating that no invalidations occur, i.e., all previous transforms are preserved

    A trait indicating that no invalidations occur, i.e., all previous transforms are preserved

    A

    some TransformLike

  21. case class ProgramArgsAnnotation(arg: String) extends NoTargetAnnotation with StageOption with Product with Serializable

    Additional arguments

    Additional arguments

    • set with any trailing option on the command line
  22. trait RegisteredLibrary extends HasShellOptions

    A class that includes options that should be exposed as a group at the top level.

    A class that includes options that should be exposed as a group at the top level.

    Note

    To complete registration, include an entry in src/main/resources/META-INF/services/firrtl.options.RegisteredLibrary

  23. trait RegisteredTransform extends HasShellOptions

    A Transform that includes an option that should be exposed at the top level.

    A Transform that includes an option that should be exposed at the top level.

    Note

    To complete registration, include an entry in src/main/resources/META-INF/services/firrtl.options.RegisteredTransform

  24. class Shell extends AnyRef

    A utility for working with command line options

  25. final class ShellOption[A] extends AnyRef

    Contains information about a Shell command line option

  26. abstract class Stage extends Phase

    A Stage represents one stage in the FIRRTL hardware compiler framework.

    A Stage represents one stage in the FIRRTL hardware compiler framework. A Stage is, conceptually, a Phase that includes a command line interface.

    The FIRRTL compiler is a stage as well as any frontend or backend that runs before/after FIRRTL. Concretely, Chisel is a Stage as is FIRRTL's Verilog emitter. Each stage performs a mathematical transformation on an AnnotationSeq where some input annotations are processed to produce different annotations. Command line options may be pulled in if available.

  27. final class StageError extends Error

    Indicates that a Stage or Phase has run into a situation where it cannot continue.

  28. class StageMain extends AnyRef

    Provides a main method for a Stage

  29. sealed trait StageOption extends AnyRef
  30. class StageOptions extends AnyRef

    Options that every stage shares

  31. case class TargetDirAnnotation(directory: String = ".") extends NoTargetAnnotation with StageOption with Product with Serializable

    Holds the name of the target directory

    Holds the name of the target directory

  32. trait TransformLike[A] extends LazyLogging

    A polymorphic mathematical transform

    A polymorphic mathematical transform

    A

    the transformed type

  33. trait Translator[A, B] extends TransformLike[A]

    A TransformLike that internally translates the input type to some other type, transforms the internal type, and converts back to the original type.

    A TransformLike that internally translates the input type to some other type, transforms the internal type, and converts back to the original type.

    This is intended to be used to insert a TransformLike parameterized by type B into a sequence of TransformLikes parameterized by type A.

    A

    the type of the TransformLike

    B

    the internal type

  34. trait Unserializable extends AnyRef

    An annotation that should not be serialized automatically WriteOutputAnnotations.

    An annotation that should not be serialized automatically WriteOutputAnnotations. This usually means that this is an annotation that is used only internally to a Stage.

Value Members

  1. object Dependency extends Serializable
  2. object DependencyManagerUtils
  3. object ExitSuccess extends ExitCode

    ExitCode indicating success

  4. object GeneralError extends ExitFailure

    An exit code indicating a general, non-specific error

  5. object InputAnnotationFileAnnotation extends HasShellOptions with Serializable
  6. object OptionsHelpException extends Exception with Product with Serializable
  7. object OutputAnnotationFileAnnotation extends HasShellOptions with Serializable
  8. object PhaseManager
  9. object ProgramArgsAnnotation extends Serializable
  10. implicit object StageOptionsView extends OptionsView[StageOptions]
  11. object StageUtils

    Utilities related to working with a Stage

  12. object TargetDirAnnotation extends HasShellOptions with Serializable
  13. object Viewer

    A shim to manage multiple "views" of an AnnotationSeq

  14. object WriteDeletedAnnotation extends NoTargetAnnotation with StageOption with HasShellOptions with Product with Serializable

    If this Annotation exists in an AnnotationSeq, then a WriteOutputAnnotations will include DeletedAnnotations when it writes to a file.

    If this Annotation exists in an AnnotationSeq, then a WriteOutputAnnotations will include DeletedAnnotations when it writes to a file.

    • set with '--write-deleted'

Inherited from AnyRef

Inherited from Any

Ungrouped