Packages

c

chiseltest.backends.treadle

TreadleBackend

class TreadleBackend[T <: MultiIOModule] extends BackendInstance[T] with ThreadedBackend[T]

Linear Supertypes
ThreadedBackend[T], BackendInstance[T], BackendInterface, AnyRef, Any
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. TreadleBackend
  2. ThreadedBackend
  3. BackendInstance
  4. BackendInterface
  5. AnyRef
  6. Any
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Instance Constructors

  1. new TreadleBackend(dut: T, dataNames: Map[Data, String], combinationalPaths: Map[Data, Set[Data]], tester: TreadleTester)

Type Members

  1. sealed abstract class BaseTimescope extends AnyRef
    Definition Classes
    ThreadedBackend
  2. sealed trait HasOverridingPokes extends BaseTimescope
    Definition Classes
    ThreadedBackend
  3. sealed trait HasParent extends BaseTimescope
    Definition Classes
    ThreadedBackend
  4. case class PeekRecord(timescope: Timescope, time: TimeRegion, actionId: Int, deps: Map[Data, Option[Timescope]], trace: Throwable) extends Product with Serializable
    Definition Classes
    ThreadedBackend
  5. case class PokeRecord(time: TimeRegion, actionId: Int, value: BigInt, trace: Throwable) extends Product with Serializable
    Definition Classes
    ThreadedBackend
  6. class RootTimescope extends BaseTimescope with HasOverridingPokes
    Definition Classes
    ThreadedBackend
  7. class TesterThread extends AbstractTesterThread
    Attributes
    protected
    Definition Classes
    ThreadedBackend
  8. case class ThreadRootTimescope(parentTimescope: BaseTimescope, openedTime: TimeRegion, parentActionId: Int, thread: TesterThread) extends BaseTimescope with HasParent with Product with Serializable
    Definition Classes
    ThreadedBackend
  9. case class TimeRegion(timeslot: Int, region: Region) extends Product with Serializable
    Definition Classes
    ThreadedBackend
  10. class Timescope extends BaseTimescope with HasOverridingPokes with HasParent
    Definition Classes
    ThreadedBackend

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  4. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  5. val clockCounter: HashMap[Clock, Int]
    Attributes
    protected
  6. def clone(): AnyRef
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native() @HotSpotIntrinsicCandidate()
  7. def closeTimescope(timescope: Timescope): Map[Data, Option[BigInt]]

    Closes the specified timescope, returns a map of wires to values of any signals that need to be updated.

    Closes the specified timescope, returns a map of wires to values of any signals that need to be updated.

    Definition Classes
    ThreadedBackend
  8. val combinationalPaths: Map[Data, Set[Data]]
    Definition Classes
    TreadleBackend → ThreadedBackend
  9. val currentThread: Option[TesterThread]
    Attributes
    protected
    Definition Classes
    ThreadedBackend
  10. def currentTime: TimeRegion
    Definition Classes
    ThreadedBackend
  11. val currentTimestep: Int
    Definition Classes
    ThreadedBackend
  12. val dataNames: Map[Data, String]
  13. def debugLog(str: ⇒ String): Unit
  14. def doFork(runnable: () ⇒ Unit, name: Option[String], region: Option[Region]): TesterThread
    Definition Classes
    ThreadedBackend → BackendInterface
  15. def doJoin(threads: Seq[AbstractTesterThread], stepAfter: Option[Clock]): Unit
    Definition Classes
    ThreadedBackend → BackendInterface
  16. def doPeek(signal: Data, trace: Throwable): Unit

    Logs a peek operation for later checking.

    Logs a peek operation for later checking.

    Definition Classes
    ThreadedBackend
  17. def doPoke(signal: Data, value: BigInt, trace: Throwable): Unit

    Logs a poke operation for later checking.

    Logs a poke operation for later checking. Returns whether to execute it, based on priorities compared to other active pokes.

    Definition Classes
    ThreadedBackend
  18. def doTimescope(contents: () ⇒ Unit): Unit
    Definition Classes
    TreadleBackend → BackendInterface
  19. val driverSemaphore: Semaphore
    Attributes
    protected
    Definition Classes
    ThreadedBackend
  20. val dut: T
    Definition Classes
    TreadleBackend → ThreadedBackend
  21. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  22. def equals(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  23. def expectBits(signal: Data, value: BigInt, message: Option[String], stale: Boolean): Unit
    Definition Classes
    TreadleBackend → BackendInterface
  24. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  25. def getClock(clk: Clock): Boolean
    Attributes
    protected
  26. def getClockCycle(clk: Clock): Int
    Attributes
    protected
  27. def getModule: T
  28. def getParentTraceElements: Seq[StackTraceElement]

    Returns the stack trace elements of parent threads.

    Returns the stack trace elements of parent threads. If currently in the root thread, returns empty. TODO: refactor this, figure out how to do this in a structurally cleaner way

    Definition Classes
    ThreadedBackend → BackendInterface
  29. def getSinkClocks(signal: Data): Set[Clock]

    Returns set of clocks associated with sinks of the signal

    Returns set of clocks associated with sinks of the signal

    Definition Classes
    TreadleBackend → BackendInterface
  30. def getSourceClocks(signal: Data): Set[Clock]

    Returns set of clocks associated with sources of the signal

    Returns set of clocks associated with sources of the signal

    Definition Classes
    TreadleBackend → BackendInterface
  31. def getVar(key: Any): Option[Any]

    Returns the value associated with the key in a per-test map.

    Returns the value associated with the key in a per-test map.

    Definition Classes
    BackendInterface
  32. def hashCode(): Int
    Definition Classes
    AnyRef → Any
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  33. val idleCycles: Map[Clock, Int]
    Definition Classes
    ThreadedBackend
  34. val idleLimits: Map[Clock, Int]
    Definition Classes
    ThreadedBackend
  35. val interruptedException: ConcurrentLinkedQueue[Throwable]
    Attributes
    protected
    Definition Classes
    ThreadedBackend
  36. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  37. val lastClockValue: HashMap[Clock, Boolean]
    Attributes
    protected
  38. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  39. def newTimescope(): Timescope

    Creates a new timescope in the current thread.

    Creates a new timescope in the current thread.

    Definition Classes
    ThreadedBackend
  40. final def notify(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  41. final def notifyAll(): Unit
    Definition Classes
    AnyRef
    Annotations
    @native() @HotSpotIntrinsicCandidate()
  42. def peekBits(signal: Data, stale: Boolean): BigInt

    Returns the current value on a wire.

    Returns the current value on a wire. If stale is true, returns the current combinational value (after previous pokes have taken effect). If stale is false, returns the value at the beginning of the current cycle.

    Definition Classes
    TreadleBackend → BackendInterface
  43. def peekClock(signal: Clock): Boolean

    Read the value of a clock.

    Read the value of a clock.

    Definition Classes
    TreadleBackend → BackendInterface
  44. def pokeBits(signal: Data, value: BigInt): Unit

    Writes a value to a writable wire.

    Writes a value to a writable wire. Throws an exception if write is not writable.

    Definition Classes
    TreadleBackend → BackendInterface
  45. def pokeClock(signal: Clock, value: Boolean): Unit

    Writes a value to a clock.

    Writes a value to a clock.

    Definition Classes
    TreadleBackend → BackendInterface
  46. def resolveName(signal: Data): String
    Attributes
    protected
  47. val rootTimescope: Option[RootTimescope]
    Definition Classes
    ThreadedBackend
  48. def run(testFn: (T) ⇒ Unit): Unit

    Runs of tests are wrapped in this, for any special setup/teardown that needs to happen.

    Runs of tests are wrapped in this, for any special setup/teardown that needs to happen. Takes the test function, which takes the module used as the testing interface. TesterContext setup is done externally.

    Internal API

    Definition Classes
    TreadleBackend → BackendInstance
  49. def runThreads(clocks: Set[Clock]): Unit

    Runs the specified threads, blocking this thread while those are running.

    Runs the specified threads, blocking this thread while those are running. Newly formed threads or unblocked join threads will also run. Returns a list of threads run (either passed in, newly forked, or joined) that are waiting on a clock edge.

    TODO: uses shared schedule state, as an optimization (so that control doesn't need to return to the driver thread between runs. But control still needs to return to the calling thread between timesteps. TODO: this provides a separation which isolates the threading infrastructure from clock control, but there are other structures which accomplish the same thing.

    Attributes
    protected
    Definition Classes
    ThreadedBackend
  50. def scheduler(): Unit

    Invokes the thread scheduler, which should be done anytime a thread needs to pass time.

    Invokes the thread scheduler, which should be done anytime a thread needs to pass time. Prior to this call: caller should add itself to the blocked / joined threads list (unless terminating). After this call: caller should block on its semaphore (unless terminating). currentThread will no longer be valid.

    Unblocks the next thread to be run, possibly also also stepping time via advanceTime(). When there are no more active threads, unblocks the driver thread via driverSemaphore.

    Attributes
    protected
    Definition Classes
    ThreadedBackend
  51. def setTimeout(signal: Clock, cycles: Int): Unit

    Sets the timeout of the clock: the number of cycles the clock can advance without some non-nop poke operation.

    Sets the timeout of the clock: the number of cycles the clock can advance without some non-nop poke operation. Setting cycles=0 disables the timeout. Setting cycles=1 means every cycle must have some non-nop poke operation. Resets the idle counter associated with the specified clock.

    Definition Classes
    ThreadedBackend → BackendInterface
  52. def setVar(key: Any, value: Any): Unit

    Sets the value associated with a key in a per-test map.

    Sets the value associated with a key in a per-test map.

    Definition Classes
    BackendInterface
  53. def step(signal: Clock, cycles: Int): Unit

    Advances the target clock by one cycle.

    Advances the target clock by one cycle.

    Definition Classes
    TreadleBackend → BackendInterface
  54. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  55. val testMap: HashMap[Any, Any]
    Attributes
    protected
    Definition Classes
    BackendInterface
  56. def threadFinished(thread: TesterThread): Unit

    Called on thread completion to remove this thread from the running list.

    Called on thread completion to remove this thread from the running list. Does not terminate the thread, does not schedule the next thread.

    Attributes
    protected
    Definition Classes
    ThreadedBackend
  57. def timestep(): Unit

    Starts a new timestep, checking if there were any conflicts on the previous timestep (and throwing exceptions if there were).

    Starts a new timestep, checking if there were any conflicts on the previous timestep (and throwing exceptions if there were).

    Definition Classes
    ThreadedBackend
  58. def toString(): String
    Definition Classes
    AnyRef → Any
  59. val verbose: Boolean
  60. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  61. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... ) @native()
  62. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  63. object TimescopeUtils
    Definition Classes
    ThreadedBackend
  64. object schedulerState
    Definition Classes
    ThreadedBackend

Deprecated Value Members

  1. def finalize(): Unit
    Attributes
    protected[lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] ) @Deprecated @deprecated
    Deprecated

    (Since version ) see corresponding Javadoc for more information.

Inherited from ThreadedBackend[T]

Inherited from BackendInstance[T]

Inherited from BackendInterface

Inherited from AnyRef

Inherited from Any

Ungrouped