summaryrefslogtreecommitdiff
path: root/src/main/scala/chisel3/util/Reg.scala
blob: 89381c11b29a6154278646c7499ae288c498d0ff (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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
// SPDX-License-Identifier: Apache-2.0

package chisel3.util

import chisel3._

object RegEnable {

  /** Returns a register with the specified next, update enable gate, and no reset initialization.
    *
    * @example {{{
    * val regWithEnable = RegEnable(nextVal, ena)
    * }}}
    */
  def apply[T <: Data](
    @deprecatedName('next, "Chisel 3.5") next:     T,
    @deprecatedName('enable, "Chisel 3.5") enable: Bool
  ): T = {
    val r = Reg(chiselTypeOf(next))
    when(enable) { r := next }
    r
  }

  /** Returns a register with the specified next, update enable gate, and reset initialization.
    *
    * @example {{{
    * val regWithEnableAndReset = RegEnable(nextVal, 0.U, ena)
    * }}}
    */
  def apply[T <: Data](
    @deprecatedName('next, "Chisel 3.5") next:     T,
    @deprecatedName('init, "Chisel 3.5") init:     T,
    @deprecatedName('enable, "Chisel 3.5") enable: Bool
  ): T = {
    val r = RegInit(init)
    when(enable) { r := next }
    r
  }
}

object ShiftRegister {

  /** Returns the n-cycle delayed version of the input signal.
    *
    * @param in input to delay
    * @param n number of cycles to delay
    * @param en enable the shift
    *
    * @example {{{
    * val regDelayTwo = ShiftRegister(nextVal, 2, ena)
    * }}}
    */
  def apply[T <: Data](
    @deprecatedName('in, "Chisel 3.5") in: T,
    @deprecatedName('n, "Chisel 3.5") n:   Int,
    @deprecatedName('en, "Chisel 3.5") en: Bool = true.B
  ): T = ShiftRegisters(in, n, en).lastOption.getOrElse(in)

  /** Returns the n-cycle delayed version of the input signal with reset initialization.
    *
    * @param in input to delay
    * @param n number of cycles to delay
    * @param resetData reset value for each register in the shift
    * @param en enable the shift
    *
    * @example {{{
    * val regDelayTwoReset = ShiftRegister(nextVal, 2, 0.U, ena)
    * }}}
    */
  def apply[T <: Data](
    @deprecatedName('in, "Chisel 3.5") in:               T,
    @deprecatedName('n, "Chisel 3.5") n:                 Int,
    @deprecatedName('resetData, "Chisel 3.5") resetData: T,
    @deprecatedName('en, "Chisel 3.5") en:               Bool
  ): T =
    ShiftRegisters(in, n, resetData, en).lastOption.getOrElse(in)
}

object ShiftRegisters {

  /** Returns a sequence of delayed input signal registers from 1 to n.
    *
    * @param in input to delay
    * @param n  number of cycles to delay
    * @param en enable the shift
    */
  def apply[T <: Data](
    @deprecatedName('in, "Chisel 3.5") in: T,
    @deprecatedName('n, "Chisel 3.5") n:   Int,
    @deprecatedName('en, "Chisel 3.5") en: Bool = true.B
  ): Seq[T] =
    Seq.iterate(in, n + 1)(util.RegEnable(_, en)).drop(1)

  /** Returns delayed input signal registers with reset initialization from 1 to n.
    *
    * @param in        input to delay
    * @param n         number of cycles to delay
    * @param resetData reset value for each register in the shift
    * @param en        enable the shift
    */
  def apply[T <: Data](
    @deprecatedName('in, "Chisel 3.5") in:               T,
    @deprecatedName('n, "Chisel 3.5") n:                 Int,
    @deprecatedName('resetData, "Chisel 3.5") resetData: T,
    @deprecatedName('en, "Chisel 3.5") en:               Bool
  ): Seq[T] =
    Seq.iterate(in, n + 1)(util.RegEnable(_, resetData, en)).drop(1)
}