* Add FirtoolBinaryPath option

* Format

* Add Scaladoc

* Add HasShellOptions

* Fix build

* Update src/main/scala/circt/stage/Annotations.scala

Co-authored-by: Schuyler Eldridge <schuyler.eldridge@gmail.com>

* Register shell option

---------

Co-authored-by: Schuyler Eldridge <schuyler.eldridge@gmail.com>

Also make line comments work on lines with filter-action pairs.

It causes issues in downstream codebases and really adding it just isn't
worth the pain.

Warnings have been assigned unique integers to use as identifiers for
purposes of documentation and configuration.

New CLI option --warn-conf accepts a comma-separated sequence of
<filter>:<action> pairs for customizing warnings.

Supported filters are:
* any          - matches all warnings
* id=<integer> - matches warnings with the integer id
* src=<glob>   - matches warnings where <glob> matches the warning
                 source file

id and src filters can be combined with &.

Supported actions are:
* :s - suppress the warning
* :w - report the warning as a warning (default behavior)
* :e - error on the warning

For example, the new Vec dynamic width matching warning can be
suppressed for source files in src/main/scala while all other warnings
elevated to errors with:
  --warn-conf "id=4&src=src/main/scala/**:s,any:e"

The is also --warn-conf-file which works similarly to --warn-conf except
the <filter>:<action> pairs are newline separated in a file. # is used
for line comments.

* clean up pkg code

* pad force statements

* adding width known check

* fixing checks and adding test case for unknown wire width force

* error out on probes of unknown width

* fixing check

Co-authored-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>

Add a simple test that `take(0)` return a zero width wire.

This moves name sanitation a little earlier and ensures that the
sanitized names are use more consistently throughout Chisel internals.

This fixes a bug in D/I where unsanitary names would lead to a crash.

* Update BoringUtils.bore to not add a port when boring from a port.

When drilling from the original source, if it's already a port, just
use it directly. Added a simple test from this behavior.

Also removed an errant println in the BoringUtilsSpec while updating
it.

Closes https://github.com/chipsalliance/chisel/issues/3401

.

* Updates from PR review.

---------

Co-authored-by: mergify[bot] <37929162+mergify[bot]@users.noreply.github.com>

Also add mill to CI.

[svsim] Don't redirect simulation stderr to a pipe (#3403)

This PR adds new APIs for the SRAM module to instantiate a number of ports connected to individual clocks. This allows the creation of memories driven by multiple clocks, for use cases like clock domain crossover.

This was previously deprecated, and in most cases results in an error
downstream anyway.

It's an error in most cases already, and in the cases it isn't, make it
a warning. Also fix a crash that could occur when viewing a non-Data
containing non-hardware Data.

This is not a functional bug. The recursive form of reify for Element
would use the .topBinding from the wrong argument, so it would recurse
an extra time, but it would ultimately converge to the right value.

5.0.0 is now an official release so i think we should be prompting for different milestones on our PRs

* Avoid emitting 'const const' for const vecs of const elements

* Handle vecs of vecs without intermediate const

* log2 functions
* unsignedBitLength

Change the FIRRTL serializer to use literal identifiers if any identifiers
begin with a leading digit.  This is a FIRRTL 3.0.0 feature that
simplifies parsing.

This enables literal identifier emission anywhere.  However, this code
path is only reachable via MixedVec due to mangling of numeric names to
add a leading underscore in all other circumstances.  In the future, this
commit will enable removing this restriction and switching to literal
identifiers when this happens.

No changes are made to annotation targets.  E.g., the literal identifier,
"wire `42`" in circuit "Foo" and module "Bar" is still referred to by a
local target "~Foo|Bar>42".  This is intentional (for now).  Targets don't
have parsing ambiguity like FIRRTL text and the name of this wire is still
"42" not "`42`".  It follows that the storage of this name in FIRRTL IR is
not changed.  This is the same way that this is handled in CIRCT.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>

Use new FIRRTL 3.0.0 syntaxes:

  - `a <= b` is now `connect a, b`
  - `c is invalid` is now `invalidate c`
  - a register with a reset is now `regreset`
  - `UInt("b101010")` is now `UInt(0b101010)`

Update the stated version of the FIRRTL emitted to 3.0.0.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>

* Fix probe read for bundles

* Remove unwanted commented code

* scalafmt

* Revert Data.scala change

Fixes #3363.

This will speed up the typical test flow by separating the execution
driven tests out.

Also rename the file containing VecIntegrationSpec to match the class
name.

Subclasses of OpaqueType can override errorOnAsUInt to make it an
elaboration time error if .asUInt is called on an instance of the
particular type (including when nested inside of an Aggregate). This
closes a large loophole in the OpaqueType API.

The previous link is no longer working.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>