* Fix ChiselStage and Builder handling of logging (#3895)

Previously, object circt.stage.ChiselStage was ignoring the Logger.
Also, Chisel was not creating its own logger scope which could lead to
clobbering of the Console when running invoking Chisel in the same
process multiple times.

Fix various places we had to workaround this behavior and fix tests
checking --log-level debug.

(cherry picked from commit 88d147d9

)

# Conflicts:
#	src/main/scala/circt/stage/ChiselStage.scala

* Resolve backport conflicts

* Make logger annotations unserializable

Change logger annotations to mix-in the Unserializable trait so that they
will not emitted by a stage.  These annotations are not intended to be
seen by CIRCT and these should be stripped from the output FIRRTL text.

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

---------

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>
Co-authored-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>

(cherry picked from commit 62291553

)

Co-authored-by: qimingchu <1346550347@qq.com>

Extends BorginUtils.bore (and related) to work where the source is a
probe.  Currently, if a user tries to do this, they will get an error
about being unable to probe a probe because the old code would
unconditionally wrap whatever the source was in `Probe`/`RWProbe`.  Change
this to not wrap if the source is already a probe.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
(cherry picked from commit 67f51b88

)

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

* Support serializing Annotations to a Writer

Previous API serializing to a String is limited by JVM max size of 2 GiB
Strings.

* Serialize to Writer instead of String in WriteOutputAnnotations

(cherry picked from commit 736f1a72

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

Change the way ChiselSim moves files to track and not move files which may
be duplicated in both the default black box filelist and in the main
CIRCT-produced filelist.  Previously, this was working because a java.nio
exception was being ignored.  However, this may have been hiding bugs
where the filelist was actually pointing at a file that did not exist.

This commit also does some heavy cleanup of the code for moving files to only
use java.nio methods as opposed to relying on doing string manipulations of
paths.  The logic is intended to be the exact same as before.

Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
(cherry picked from commit 61df8bbf

)

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

Fix an incorrect assumption in ChiselSim that a 'filelist.f' will exist
that includes all modules, _including blackboxes_, in the design.  Change
this to try to also copy files from the black box filelist.  This makes
ChiselSim work with CIRCT 1.66 and earlier (which put everything in
'filelist.f') and CIRCT 1.66+ (which does not include blackboxes in
'filelist.f').

Note that this is intended as a temporary solution until FIRRTL has a rock
solid ABI that is implemented by CIRCT where all modules can be discovered
under an arbitrary public module.

See CIRCT changes here: https://github.com/llvm/circt/pull/6729



Signed-off-by: Schuyler Eldridge <schuyler.eldridge@sifive.com>
(cherry picked from commit 9448d326

)

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

* Print an optional Printable passed to stop ops (#3886)

(cherry picked from commit 109ee9ec

)

* Resolve binary compatibility issues

---------

Co-authored-by: Nandor Licker <nandor.licker@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>

(cherry picked from commit 036dd5ea

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

* Add `suggestName` method to `HasTarget` (#3881)

(cherry picked from commit c161fccd

)

* Waive binary compatibility issues

---------

Co-authored-by: Deborah Soung <debs@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>

This allows users to get a ClassType for use in other Property types,
which is especially useful when constructing aggregate Property types
of a specific Class.

(cherry picked from commit 8a02fb34

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

(cherry picked from commit e513da57

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

Co-authored-by: jackkoenig <jackkoenig@users.noreply.github.com>

(cherry picked from commit 68eb2486

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

* Use "dep" instead of deprecated "lib"
* Add _root_ to `import circt.stage.ChiselStage`
  * Also add comment describing how this disambiguates from
    chisel3.util.circt when the user does `import chisel3.util._`
* Bump versions in Github workflows

(cherry picked from commit 589f1067

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

(cherry picked from commit a0ac3fd2

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

* debump to sbt 1.9.7 (#3852)

(cherry picked from commit 0c9ebccf

)

# Conflicts:
#	docs/src/installation.md

* Delete docs/src/installation.md

---------

Co-authored-by: Deborah Soung <debs@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>

This adds an API for integer Property shift right.

(cherry picked from commit 32840808

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

(cherry picked from commit 1ff43c93

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

This adds an API for integer Property multiplication.

(cherry picked from commit 4d7ebd91

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

This allows Properties to be used to build up expressions in terms of input Properties and literals.

(cherry picked from commit 11844a40

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

(cherry picked from commit 4f1f4a77

)

Co-authored-by: Deborah Soung <debs@sifive.com>

(cherry picked from commit 41dd2671

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

(cherry picked from commit 8f0196fa

)

Co-authored-by: Deborah Soung <debs@sifive.com>

(cherry picked from commit 84a21f8a

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

(cherry picked from commit d21a6635

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

This is in addition to the existing support in
Definition.apply. Sometimes it is not possible to use
Definition.apply, for example, if you plan to bore ports through the
Class being constructed. The new DynamicObject.apply method supports
this, and creates a DynamicObject from the newly elaborated Class.

(cherry picked from commit 04535d32

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>
Co-authored-by: Jack Koenig <koenig@sifive.com>

(cherry picked from commit b3b5ab19

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

This adds support for BoringUtils.bore to bore and connect Property
ports.

(cherry picked from commit 178d8f06

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

* Support isProperty query in DataMirror. (#3783)

This adds an API to DataMirror to query if a Data is a Property.

(cherry picked from commit 3b27dcdb

)

# Conflicts:
#	src/test/scala/chiselTests/reflect/DataMirrorSpec.scala

* Fix backport merge conflict.

---------

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

Since we override litOption to always be None, we need to override
isLit to check the Binding.

(cherry picked from commit 7be47bb4

)

Co-authored-by: Mike Urbach <mike.urbach@sifive.com>

(cherry picked from commit d8991c55

)

Co-authored-by: Megan Wachs <megan@sifive.com>

Previously, it was not calling .ref. It was thus not properly:
1. Checking that the clock is bound hardware
2. Checking that the clock is visible in the current scope
3. Reifying the clock if its a view

Note that RegInit() was already correctly calling .ref.

(cherry picked from commit 1c348c55

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

Module's logic that creates the implicit clock and implicit reset within
the Module's body is now implemented in new traits that users are free
to mix in to RawModule. There are also now virtual methods implicitClock
and implicitReset that the user can override to change what clock or
reset is used.

(cherry picked from commit abc96e20

)

Co-authored-by: Jack Koenig <koenig@sifive.com>

Users are now able to check whether a Data is visible from the
current context via `chisel.reflect.DataMirror.isVisible`.

* Bump versions
* It now tabs every line included in the Release Notes section of
  the PR template

Also fix website API doc link generation, links prior to 3.5.4 are not
valid (that is when we started publishing the unidoc properly so that it
gets picked up by javadoc.io and the like).

Co-authored-by: jackkoenig <jackkoenig@users.noreply.github.com>

Using `Output()` shouldn't drop important type information,
only override the specified direction to force alignment.

Until #3647 is addressed, use `cloneTypeFull` to get the expected behavior.
The cloned direction information is unnecessary but is
overridden by the coerced direction.

cc #3647.

Co-authored-by: Jack Koenig <koenig@sifive.com>