// See LICENSE for license details. package chiselTests import chisel3._ import chisel3.experimental.{annotate, ChiselAnnotation, doNotDedup} import firrtl.FirrtlExecutionSuccess import firrtl.transforms.NoDedupAnnotation import org.scalatest.{FreeSpec, Matchers} class MuchUsedModule extends Module { val io = IO(new Bundle { val in = Input(UInt(16.W)) val out = Output(UInt(16.W)) }) io.out := io.in +% 1.U } class UsesMuchUsedModule(addAnnos: Boolean) extends Module { val io = IO(new Bundle { val in = Input(UInt(16.W)) val out = Output(UInt(16.W)) }) val mod0 = Module(new MuchUsedModule) val mod1 = Module(new MuchUsedModule) val mod2 = Module(new MuchUsedModule) val mod3 = Module(new MuchUsedModule) mod0.io.in := io.in mod1.io.in := mod0.io.out mod2.io.in := mod1.io.out mod3.io.in := mod2.io.out io.out := mod3.io.out if(addAnnos) { doNotDedup(mod1) doNotDedup(mod3) } } class AnnotationNoDedup extends FreeSpec with Matchers { // scalastyle:off line.size.limit "Firrtl provides transform that reduces identical modules to a single instance" - { "Annotations can be added which will prevent this deduplication for specific modules instances" in { Driver.execute(Array("-X", "low", "--target-dir", "test_run_dir"), () => new UsesMuchUsedModule(addAnnos = true)) match { case ChiselExecutionSuccess(_, _, Some(firrtlResult: FirrtlExecutionSuccess)) => val lowFirrtl = firrtlResult.emitted lowFirrtl should include ("module MuchUsedModule :") lowFirrtl should include ("module MuchUsedModule_1 :") lowFirrtl should include ("module MuchUsedModule_3 :") lowFirrtl should not include "module MuchUsedModule_2 :" lowFirrtl should not include "module MuchUsedModule_4 :" case _ => } } "Turning off these annotations dedups all the occurrences" in { Driver.execute(Array("-X", "low", "--target-dir", "test_run_dir"), () => new UsesMuchUsedModule(addAnnos = false)) match { case ChiselExecutionSuccess(_, _, Some(firrtlResult: FirrtlExecutionSuccess)) => val lowFirrtl = firrtlResult.emitted lowFirrtl should include ("module MuchUsedModule :") lowFirrtl should not include "module MuchUsedModule_1 :" lowFirrtl should not include "module MuchUsedModule_3 :" lowFirrtl should not include "module MuchUsedModule_2 :" lowFirrtl should not include "module MuchUsedModule_4 :" case _ => } } } // scalastyle:on line.size.limit }