Remove Deprecated Usages of chisel3.Driver, CircuitForm

[seldridge]

Converts all tests to not use Chisel 3.3/FIRRTL 1.3 deprecated features, including:

• ChiselStage methods are used instead of those in the BackendCompilationUtilities trait, e.g., for elaboration
• Any custom transforms in tests are converted to use the Dependency API
• All usages of chisel3.Driver are removed

In doing this, a new utility is added to extract a specific cause type from a stack trace:

• A new utility, extractCause[A <: Throwable : ClassTag], is added that rethrows a nested A if it exists

A few deprecations are added:

• Some lingering Driver infrastructure (e.g., ChiselExecutionResult) is deprecated

Related issue:

Type of change: other enhancement

Impact: no functional change

Development Phase: implementation

Release Notes

None.

[chick]

Ouch, And I thought reviewing Firrtl PR #1700 was bad.
There are couple nits but this looks ready to go to me.

[ucbjrl]

Unfortunately, this commit (and its 3.3.x backport #1492) appear to cause chisel-testers to break:

 ...
[info] ScalaTest
[info] Run completed in 2 minutes, 25 seconds.
[info] Total number of tests run: 110
[info] Suites: completed 48, aborted 0
[info] Tests: succeeded 100, failed 10, canceled 0, ignored 1, pending 0
[info] *** 10 TESTS FAILED ***
[error] Failed: Total 110, Failed 10, Errors 0, Passed 100, Ignored 1
[error] Failed tests:
[error] 	examples.DecoupledAdderTester
[error] 	examples.SmallOdds4TesterSpec
[error] 	examples.SmallOdds3TesterSpec
[error] 	examples.DynamicMemorySearchTester
[error] 	examples.MaxNSpec
[error] 	examples.GCDTester
[error] 	examples.DecoupledRealGCDTester
[error] 	examples.HelloSpec
[error] 	examples.AdderTester
[error] 	examples.RouterUnitTesterSpec
[error] (Test / test) sbt.TestsFailedException: Tests unsuccessful
[error] Total time: 196 s (03:16), completed Jun 23, 2020, 4:45:43 PM

Compilation exited abnormally with code 1 at Tue Jun 23 16:45:44

with failures such as:

[info]   firrtl.passes.PassExceptions: firrtl.passes.CheckInitialization$RefNotInitializedException:  @[DecoupledAdder.scala 65:33] : [module DecoupledAdderTests]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.in.valid <= VOID
[info] firrtl.passes.CheckInitialization$RefNotInitializedException:  @[DecoupledAdder.scala 65:33] : [module DecoupledAdderTests]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.in.bits.b <= VOID
[info] firrtl.passes.CheckInitialization$RefNotInitializedException:  @[DecoupledAdder.scala 65:33] : [module DecoupledAdderTests]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.in.bits.a <= VOID
[info] firrtl.passes.CheckInitialization$RefNotInitializedException:  @[DecoupledAdder.scala 65:33] : [module DecoupledAdderTests]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.out.ready <= VOID
[info] firrtl.passes.PassException: 4 errors detected!

[info]   firrtl.passes.PassExceptions: firrtl.passes.CheckInitialization$RefNotInitializedException:  @[GCDUnitTest.scala 45:33] : [module GCDUnitTester]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.a <= VOID
[info] firrtl.passes.CheckInitialization$RefNotInitializedException:  @[GCDUnitTest.scala 45:33] : [module GCDUnitTester]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.b <= VOID
[info] firrtl.passes.CheckInitialization$RefNotInitializedException:  @[GCDUnitTest.scala 45:33] : [module GCDUnitTester]  Reference device_under_test is not fully initialized.
[info]    : device_under_test.io.e <= VOID
[info] firrtl.passes.PassException: 3 errors detected!
[info]   ...

[seldridge]

@ucbjrl: I think this was only related to changes to the TesterDriver. I've narrowly reverted just that change in #1496.

And thanks for catching the regression!