package experimental
Package for experimental features, which may have their API changed, be removed, etc.
Because its contents won't necessarily have the same level of stability and support as non-experimental, you must explicitly import this package to use its contents.
- Alphabetic
- By Inheritance
- experimental
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
Type Members
-
final
class
Analog extends Element
Data type for representing bidirectional bitvectors of a given width
Data type for representing bidirectional bitvectors of a given width
Analog support is limited to allowing wiring up of Verilog BlackBoxes with bidirectional (inout) pins. There is currently no support for reading or writing of Analog types within Chisel code.
Given that Analog is bidirectional, it is illegal to assign a direction to any Analog type. It is legal to "flip" the direction (since Analog can be a member of aggregate types) which has no effect.
Analog types are generally connected using the bidirectional attach mechanism, but also support limited bulkconnect
<>
. Analog types are only allowed to be bulk connected *once* in a given module. This is to prevent any surprising consequences of last connect semantics.- Note
This API is experimental and subject to change
-
abstract
class
BaseModule extends HasId
Abstract base class for Modules, an instantiable organizational unit for RTL.
- class BundleLiteralException extends ChiselException
-
trait
ChiselAnnotation extends AnyRef
Interface for Annotations in Chisel
Interface for Annotations in Chisel
Defines a conversion to a corresponding FIRRTL Annotation
- type ChiselEnum = EnumFactory
- final case class ChiselLegacyAnnotation extends ChiselAnnotation with RunFirrtlTransform with Product with Serializable
- implicit final class ChiselRange extends AnyVal
-
type
ClonePorts = internal.BaseModule.ClonePorts
A record containing the results of CloneModuleAsRecord The apply method is retrieves the element with the supplied name.
- type Direction = ActualDirection
- case class DoubleParam(value: Double) extends Param with Product with Serializable
- abstract class EnumFactory extends AnyRef
- abstract class EnumType extends Element
-
abstract
class
ExtModule extends BaseBlackBox
Defines a black box, which is a module that can be referenced from within Chisel, but is not defined in the emitted Verilog.
Defines a black box, which is a module that can be referenced from within Chisel, but is not defined in the emitted Verilog. Useful for connecting to RTL modules defined outside Chisel.
A variant of BlackBox, this has a more consistent naming scheme in allowing multiple top-level IO and does not drop the top prefix.
Some design require a differential input clock to clock the all design. With the xilinx FPGA for example, a Verilog template named IBUFDS must be integrated to use differential input:
IBUFDS #(.DIFF_TERM("TRUE"), .IOSTANDARD("DEFAULT")) ibufds ( .IB(ibufds_IB), .I(ibufds_I), .O(ibufds_O) );
To instantiate it, a BlackBox can be used like following:
import chisel3._ import chisel3.experimental._ // Example with Xilinx differential buffer IBUFDS class IBUFDS extends ExtModule(Map("DIFF_TERM" -> "TRUE", // Verilog parameters "IOSTANDARD" -> "DEFAULT" )) { val O = IO(Output(Clock())) val I = IO(Input(Clock())) val IB = IO(Input(Clock())) }
- Note
The parameters API is experimental and may change
Example: -
sealed
class
FixedPoint extends Bits with Num[FixedPoint] with HasBinaryPoint
A sealed class representing a fixed point number that has a bit width and a binary point The width and binary point may be inferred.
A sealed class representing a fixed point number that has a bit width and a binary point The width and binary point may be inferred.
IMPORTANT: The API provided here is experimental and may change in the future.
-
trait
HasBinaryPoint extends AnyRef
Chisel types that have binary points support retrieving literal values as
Double
orBigDecimal
- case class IntParam(value: BigInt) extends Param with Product with Serializable
-
sealed
class
Interval extends Bits with Num[Interval] with HasBinaryPoint
A sealed class representing a fixed point number that has a range, an additional parameter that can determine a minimum and maximum supported value.
A sealed class representing a fixed point number that has a range, an additional parameter that can determine a minimum and maximum supported value. The range can be used to reduce the required widths particularly in primitive operations with other Intervals, the canonical example being
val one = 1.I val six = Seq.fill(6)(one).reduce(_ + _)
A UInt computed in this way would require a Width binary point The width and binary point may be inferred.
IMPORTANT: The API provided here is experimental and may change in the future.
-
trait
NoChiselNamePrefix extends AnyRef
Do not name instances of this type in chiselName
Do not name instances of this type in chiselName
By default,
chiselName
will includeval
names of instances of annotated classes as a prefix in final naming. Mixing in this trait to aclass
,object
, or anonymousclass
instances will exclude theval
name fromchiselName
naming.import chisel3._ import chisel3.experimental.{chiselName, NoChiselNamePrefix} // Note that this is not a Module @chiselName class Counter(w: Int) { val myReg = RegInit(0.U(w.W)) myReg := myReg + 1.U } @chiselName class MyModule extends Module { val io = IO(new Bundle { val out = Output(UInt(8.W)) }) // Name of myReg will be "counter0_myReg" val counter0 = new Counter(8) // Name of myReg will be "myReg" val counter1 = new Counter(8) with NoChiselNamePrefix io.out := counter0.myReg + counter1.myReg }
Example: -
sealed abstract
class
Param extends AnyRef
Parameters for BlackBoxes
-
sealed
trait
PrivateType extends AnyRef
Use PrivateObject to force users to specify width and binaryPoint by name
-
case class
RawParam(value: String) extends Param with Product with Serializable
Unquoted String
-
trait
RunFirrtlTransform extends ChiselAnnotation
Mixin for ChiselAnnotation that instantiates an associated FIRRTL Transform when this Annotation is present during a run of Driver.execute.
Mixin for ChiselAnnotation that instantiates an associated FIRRTL Transform when this Annotation is present during a run of Driver.execute. Automatic Transform instantiation is *not* supported when the Circuit and Annotations are serialized before invoking FIRRTL.
- case class StringParam(value: String) extends Param with Product with Serializable
-
macro
class
chiselName extends internal.naming.chiselName
Experimental macro for naming Chisel hardware values
Experimental macro for naming Chisel hardware values
By default, Chisel uses reflection for naming which only works for public fields of
Bundle
andModule
classes. Applying this macro annotation to aclass
orobject
enables Chisel to name any hardware values within the annotatedclass
orobject.
- Annotations
- @compileTimeOnly( ... )
import chisel3._ import chisel3.experimental.chiselName @chiselName class MyModule extends Module { val io = IO(new Bundle { val in = Input(UInt(8.W)) val out = Output(UInt(8.W)) }) def createReg(): Unit = { // @chiselName allows Chisel to name this Reg val myReg = RegInit(io.in) io.out := myReg } createReg() }
Example: -
macro
class
dump extends internal.naming.dump
- Annotations
- @compileTimeOnly( ... )
-
macro
class
treedump extends internal.naming.treedump
- Annotations
- @compileTimeOnly( ... )
Value Members
- val Direction: ActualDirection.type
- implicit def fromBigIntToIntParam(x: BigInt): IntParam
- implicit def fromDoubleToDoubleParam(x: Double): DoubleParam
- implicit def fromIntToIntParam(x: Int): IntParam
- implicit def fromLongToIntParam(x: Long): IntParam
- implicit def fromStringToStringParam(x: String): StringParam
- val requireIsChiselType: internal.requireIsChiselType.type
- val requireIsHardware: internal.requireIsHardware.type
-
object
Analog
Object that provides factory methods for Analog objects
Object that provides factory methods for Analog objects
- Note
This API is experimental and subject to change
- object BundleLiterals
- object CloneModuleAsRecord
-
object
DataMirror
Experimental hardware construction reflection API
- object EnumAnnotations
-
object
FixedPoint extends NumObject
Factory and convenience methods for the FixedPoint class IMPORTANT: The API provided here is experimental and may change in the future.
- object IO
-
object
Interval extends NumObject
Factory and convenience methods for the Interval class IMPORTANT: The API provided here is experimental and may change in the future.
- object annotate
- object attach
-
object
doNotDedup
Marks that a module to be ignored in Dedup Transform in Firrtl pass
Marks that a module to be ignored in Dedup Transform in Firrtl pass
def fullAdder(a: UInt, b: UInt, myName: String): UInt = { val m = Module(new Module { val io = IO(new Bundle { val a = Input(UInt(32.W)) val b = Input(UInt(32.W)) val out = Output(UInt(32.W)) }) override def desiredName = "adder_" + myNname io.out := io.a + io.b }) doNotDedup(m) m.io.a := a m.io.b := b m.io.out } class AdderTester extends Module with ConstantPropagationTest { val io = IO(new Bundle { val a = Input(UInt(32.W)) val b = Input(UInt(32.W)) val out = Output(Vec(2, UInt(32.W))) }) io.out(0) := fullAdder(io.a, io.b, "mod1") io.out(1) := fullAdder(io.a, io.b, "mod2") }
- Note
Calling this on Data creates an annotation that Chisel emits to a separate annotations file. This file must be passed to FIRRTL independently of the
.fir
file. The execute methods in chisel3.Driver will pass the annotations to FIRRTL automatically.
Example:
Deprecated Value Members
-
val
withClock: chisel3.withClock.type
- Annotations
- @deprecated
- Deprecated
(Since version 3.2) Use the version in chisel3._
-
val
withClockAndReset: chisel3.withClockAndReset.type
- Annotations
- @deprecated
- Deprecated
(Since version 3.2) Use the version in chisel3._
-
val
withReset: chisel3.withReset.type
- Annotations
- @deprecated
- Deprecated
(Since version 3.2) Use the version in chisel3._