summaryrefslogtreecommitdiff
path: root/src/main/scala/Chisel/CoreUtil.scala
blob: aaca404b9d9001eb340d04865ccdc6053c485f9d (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
// See LICENSE for license details.

package Chisel

import internal._
import internal.Builder.pushCommand
import firrtl._

object assert {
  /** Checks for a condition to be valid in the circuit at all times. If the
    * condition evaluates to false, the circuit simulation stops with an error.
    *
    * Does not fire when in reset (defined as the encapsulating Module's
    * reset). If your definition of reset is not the encapsulating Module's
    * reset, you will need to gate this externally.
    *
    * May be called outside of a Module (like defined in a function), so
    * functions using assert make the standard Module assumptions (single clock
    * and single reset).
    *
    * @param cond condition, assertion fires (simulation fails) when false
    * @param message optional message to print when the assertion fires
    */
  def apply(cond: Bool, message: String="") {
    when (!Builder.dynamicContext.currentModule.get.reset) {
      when(!cond) {
        if (message.isEmpty()) {
          printf(s"Assertion failed: (TODO: code / lineno)")
        } else {
          printf(s"Assertion failed: (TODO: code / lineno): $message")
        }
        pushCommand(Stop(Node(Builder.dynamicContext.currentModule.get.clock), 1))
      }
    }
  }
}

object printf {
  /** Prints a message in simulation.
    *
    * Does not fire when in reset (defined as the encapsulating Module's
    * reset). If your definition of reset is not the encapsulating Module's
    * reset, you will need to gate this externally.
    *
    * May be called outside of a Module (like defined in a function), so
    * functions using printf make the standard Module assumptions (single clock
    * and single reset).
    *
    * @param fmt printf format string
    * @param data format string varargs containing data to print
    */
  def apply(fmt: String, data: Bits*) {
    when (!Builder.dynamicContext.currentModule.get.reset) {
      pushCommand(Printf(Node(Builder.dynamicContext.currentModule.get.clock),
          fmt, data.map((d: Bits) => d.ref)))
    }
  }
}