aboutsummaryrefslogtreecommitdiff
path: root/src/main/scala/firrtl/EmissionOption.scala
blob: 530cc6215c118873d34639feeee13d371b1d1ea6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
// SPDX-License-Identifier: Apache-2.0

package firrtl

import firrtl.annotations.{MemoryLoadFileType, NoTargetAnnotation}

/**
  * Base type for emission customization options
  * NOTE: all the following traits must be mixed with SingleTargetAnnotation[T <: Named]
  *       in order to be taken into account in the Emitter
  */
trait EmissionOption

/** Control how register initialization code is emitted */
case class CustomDefaultRegisterEmission(
  override val useInitAsPreset:      Boolean,
  override val disableRandomization: Boolean)
    extends RegisterEmissionOption
    with NoTargetAnnotation

/** Customize how memory initialization code is emitted */
case class CustomDefaultMemoryEmission(override val initValue: MemoryInitValue)
    extends MemoryEmissionOption
    with NoTargetAnnotation

/** Emission customization options for memories */
trait MemoryEmissionOption extends EmissionOption {
  def initValue: MemoryInitValue = MemoryRandomInit
}

/** Emission customization option for memory initialization */
sealed trait MemoryInitValue
case object MemoryNoInit extends MemoryInitValue
case object MemoryRandomInit extends MemoryInitValue
case class MemoryScalarInit(value: BigInt) extends MemoryInitValue
case class MemoryArrayInit(values: Seq[BigInt]) extends MemoryInitValue
case class MemoryFileInlineInit(filename: String, hexOrBinary: MemoryLoadFileType.FileType) extends MemoryInitValue

/** default Emitter behavior for memories */
case object MemoryEmissionOptionDefault extends MemoryEmissionOption

/** Emission customization options for registers */
trait RegisterEmissionOption extends EmissionOption {

  /** when true the reset init value will be used to emit a bitstream preset */
  def useInitAsPreset: Boolean = false

  /** when true the initial randomization is disabled for this register */
  def disableRandomization: Boolean = false
}

/** default Emitter behavior for registers */
case object RegisterEmissionOptionDefault extends RegisterEmissionOption

/** Emission customization options for IO ports */
trait PortEmissionOption extends EmissionOption

/** default Emitter behavior for IO ports */
case object PortEmissionOptionDefault extends PortEmissionOption

/** Emission customization options for wires */
trait WireEmissionOption extends EmissionOption

/** default Emitter behavior for wires */
case object WireEmissionOptionDefault extends WireEmissionOption

/** Emission customization options for nodes */
trait NodeEmissionOption extends EmissionOption

/** default Emitter behavior for nodes */
case object NodeEmissionOptionDefault extends NodeEmissionOption

/** Emission customization options for connect */
trait ConnectEmissionOption extends EmissionOption

/** default Emitter behavior for connect */
case object ConnectEmissionOptionDefault extends ConnectEmissionOption