spinal.lib.misc.plugin.ServiceDemo.scala Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of spinalhdl-tester_2.11 Show documentation
SpinalHDL-tester
The newest version!
package spinal.lib.misc.plugin

import spinal.core._
import spinal.core.fiber.Lock
import spinal.lib.misc.plugin._


object Example1 extends App{

  // Let's define a Component with a PluginHost instance
  class SubComponent extends Component {
    val host = new PluginHost()
  }

  // Let's define a plugin which create a register
  class StatePlugin extends FiberPlugin {
    // during build new Area { body } will run the body of code in the Fiber build phase, in the context of the PluginHost
    val logic = during build new Area {
      val signal = Reg(UInt(32 bits))
    }
  }

  // Let's define a plugin which will make the StatePlugin's register increment
  class DriverPlugin extends FiberPlugin {
    // We define how to get the instance of StatePlugin in the PluginHost
    lazy val sp = host[StatePlugin].logic.get

    val logic = during build new Area {
      // Generate the increment hardware
      sp.signal := sp.signal + 1
    }
  }

  class TopLevel extends Component {
    val sub = new SubComponent()

    // Here we create plugins and embed them in sub.host
    sub.host.asHostOf(
      new DriverPlugin(),
      new StatePlugin()
    )
  }

  SpinalVerilog(new TopLevel).printRtl()
}

object Example2 extends App{
  class SubComponent extends Component {
    val host = new PluginHost()
  }

  class StatePlugin extends FiberPlugin {
    val logic = during build new Area {
      val signal = Reg(UInt(32 bits))
    }
  }

  class DriverPlugin extends FiberPlugin {
    lazy val sp = host[StatePlugin].logic.get
    val hostLockX = Lock()

    // incrementBy will be set by others plugin at elaboration time
    var incrementBy = 0
    val logic = during build new Area {
      hostLockX.await()
      // Generate the incrementer hardware
      sp.signal := sp.signal + incrementBy
    }
  }

  // Let's define a plugin which will modify the DriverPlugin.incrementBy variable because letting it elaborate its hardware
  class SetupPlugin extends FiberPlugin {
    def dp = host[DriverPlugin]
    // during setup { body } will run the body of code in the Fiber setup phase (it is before the Fiber build phase)
    during setup {
      // Prevent the DriverPlugin from executing its build's body (until release() is called)
      dp.hostLock.retain()
    }
    val logic = during build new Area {
      // Let's mutate DriverPlugin.incrementBy
      dp.incrementBy += 1

      // Allows the DriverPlugin to execute its build's body
      dp.hostLock.release()
    }
  }

  class TopLevel extends Component {
    val sub = new SubComponent()

    sub.host.asHostOf(
      new DriverPlugin(),
      new StatePlugin(),
      new SetupPlugin(),
      new SetupPlugin()
    )
  }

  SpinalVerilog(new TopLevel).printRtl()
}