Usage: chisel [options] [
Shell Options
-td, --target-dir
Work directory (default: '.')
-faf, --annotation-file
An input annotation file
-foaf, --output-annotation-file
An output annotation file
--show-registrations print discovered registered libraries and transforms
--help prints this usage text
Logging Options
-ll, --log-level {error|warn|info|debug|trace}
Set global logging verbosity (default: None
-cll, --class-log-level
Set per-class logging verbosity
--log-file
-lcn, --log-class-names Show class names and log level in logging output
Chisel Front End Options
-chnrf, --no-run-firrtl Do not run the FIRRTL compiler (generate FIRRTL IR from Chisel and exit)
--full-stacktrace Show full stack trace when an exception is thrown
--throw-on-first-error Throw an exception on the first error instead of continuing
--warn:reflective-naming
Warn when reflective naming changes the name of signals (3.6 migration)
--chisel-output-file
Write Chisel-generated FIRRTL to this file (default:
--module
The name of a Chisel module to elaborate (module must be in the classpath)
FIRRTL Compiler Options
-i, --input-file
-I, --input-directory
A directory of FIRRTL files
-o, --output-file
The output FIRRTL file
--info-mode
Source file info handling mode (default: use)
--firrtl-source
An input FIRRTL circuit string
-fct, --custom-transforms
Run these transforms during compilation
--change-name-case
Convert all FIRRTL names to a specific case
-X, --compiler
The FIRRTL compiler to use (default: verilog)
-E, --emit-circuit
Run the specified circuit emitter (all modules in one file)
-P, --emit-circuit-protobuf
Run the specified circuit emitter generating a Protocol Buffer format
-e, --emit-modules
Run the specified module emitter (one file per module)
-p, --emit-modules-protobuf
Run the specified module emitter (one protobuf per module)
--emission-options
Options to disable random initialization for memory and registers
--no-dedup Do NOT dedup modules
--warn:no-scala-version-deprecation
(deprecated, this option does nothing)
--pretty:no-expr-inlining
Disable expression inlining
--dont-fold
--target:fpga Choose compilation strategies that generally favor FPGA targets
--start-from
--no-cse Disable common subexpression elimination
--allow-unrecognized-annotations
Allow annotation files to contain unrecognized annotations
--wave-viewer-script
FIRRTL Transform Options
--no-dce Disable dead code elimination
--no-check-comb-loops Disable combinational loop checking
-fil, --inline
Inline selected modules
-clks, --list-clocks -c:
List which signal drives each clock of every descendent of specified modules
--no-asa Disable assert submodule assumptions
--no-constant-propagation
Disable constant propagation elimination
freechips.rocketchip.linting.LintReporter
--lint [*]|[
Enable linting for specified rules, where * is all rules. Available rules: anon-regs,trunc-widths,conflicting-module-names.
--lint-options (strict|warn)[,displayTotal=
Customize linting options, including strict/warn or number of violations displayed.
freechips.rocketchip.linting.rule.LintAnonymousRegisters
--lint-whitelist:anon-regs
Enable linting anonymous registers for all files except provided files.
freechips.rocketchip.linting.rule.LintTruncatingWidths
--lint-whitelist:trunc-widths
Enable linting anonymous registers for all files except provided files.
freechips.rocketchip.linting.rule.LintConflictingModuleNames
--lint-whitelist:conflicting-module-names
Enable linting anonymous registers for all files except provided files.
AspectLibrary
--with-aspect
The name/class of an aspect to compile with (must be a class/object without arguments!)
treadle
--tr-write-vcd writes vcd execution log, filename will be based on top-name
--tr-vcd-show-underscored-vars
vcd output by default does not show var that start with underscore, this overrides that
--tr-verbose makes the treadle very verbose
--tr-allow-cycle will try to run when firrtl contains combinational loops
--tr-random-seed
sets the seed for Treadle's random number generator
--tr-show-firrtl-at-load
show the low firrtl source treadle is using to build simulator
--tr-save-firrtl-at-load
save the low firrtl source treadle is using to build simulator
--tr-dont-run-lower-compiler-on-load
Deprecated: This option has no effect and will be removed in treadle 1.4
--tr-validif-random validIf returns random value when condition is false
--tr-rollback-buffers
number of rollback buffers, 0 is no buffers, default is 0
--tr-mem-to-vcd
--tr-clock-info
--tr-symbols-to-watch
symbol[,symbol[...]
--tr-reset-name
--tr-randomize-at-startup
makes treadle do it's own randomization of circuit at startup
--tr-call-reset-at-startup
makes treadle do it's own reset at startup, usually for internal use only
--tr-add-rocket-black-boxes
add in the black boxes needed to simulate rocket
--tr-prefix-printf-with-walltime
Adds a string "[
--tr-firrtl-source-string
a serialized firrtl circuit, mostly used internally
-tfsf, --tr-firrtl-source-file
specify treadle repl source file
--tr-ignore-formal-assumes
Will ignore Forma Assume statements
--tr-enable-coverage
Enables automatic line coverage on tests
MemLib Options
-firw, --infer-rw Enable read/write port inference for memories
-frsq, --repl-seq-mem -c:
Blackbox and emit a configuration file for each sequential memory
-gmv, --gen-mem-verilog
Blackbox and emit a Verilog behavior model for each sequential memory