adjust slew rate to slowest/fastest global setting

Author: Oron Port

compiler/ir/src/main/scala/dfhdl/compiler/ir/annotation.scala

@@ -85,6 +85,21 @@ object constraints:
       ).filter(_.nonEmpty).mkString(", ")
       s"""@deviceID($params)"""
   end DeviceID
+  final case class DeviceInfo(
+      slewRateSlowest: ConfigN[Int],
+      slewRateFastest: ConfigN[Int]
+  ) extends GlobalConstraint
+      derives CanEqual, ReadWriter:
+    protected def `prot_=~`(that: HWAnnotation)(using MemberGetSet): Boolean = this == that
+    lazy val getRefs: List[DFRef.TwoWayAny] = Nil
+    def copyWithNewRefs(using RefGen): this.type = this
+    def codeString(using Printer): String =
+      val params = List(
+        csParam("slewRateSlowest", slewRateSlowest),
+        csParam("slewRateFastest", slewRateFastest)
+      ).filter(_.nonEmpty).mkString(", ")
+      s"""@deviceInfo($params)"""
+  end DeviceInfo
   final case class DeviceProperties(properties: Map[String, String]) extends GlobalConstraint
       derives ReadWriter:
     protected def `prot_=~`(that: HWAnnotation)(using MemberGetSet): Boolean = this == that
@@ -264,7 +279,8 @@ object constraints:
           case SchmittTrigger =>
             throw new IllegalArgumentException("Found unexpected use of SchmittTrigger.")
     enum SlewRate extends StableEnum, HasCodeString derives CanEqual, ReadWriter:
-      case SLOW, FAST
+      case SLOWEST, FASTEST
+      case CUSTOM(value: Int)
       def codeString(using Printer): String = "io.SlewRate." + this.toString
     enum PullMode extends StableEnum, HasCodeString derives CanEqual, ReadWriter:
       case UP, DOWN

core/src/main/scala/dfhdl/hw/annotation.scala

@@ -78,6 +78,12 @@ object constraints:
       ir.constraints.DeviceID(vendor, deviceName, partName, deviceVersion)
   object deviceID:
     export ir.constraints.DeviceID.Vendor
+  final case class deviceInfo(
+      slewRateSlowest: ir.ConfigN[Int] = None,
+      slewRateFastest: ir.ConfigN[Int] = None
+  ) extends GlobalConstraint:
+    val asIR: ir.constraints.DeviceInfo =
+      ir.constraints.DeviceInfo(slewRateSlowest, slewRateFastest)
   final case class deviceProperties(properties: (String, String)*) extends GlobalConstraint:
     val asIR: ir.constraints.DeviceProperties = ir.constraints.DeviceProperties(properties.toMap)
   final case class toolOptions(options: (String, String)*) extends GlobalConstraint:

lib/src/main/scala/dfhdl/platforms/resources/Led.scala

@@ -11,7 +11,7 @@ object Led:
     private val pullMode = if (activeState == Led.On) IO.PullMode.DOWN else IO.PullMode.UP
     injectConstraint(IO(
       standard = IO.Standard.LVCMOS,
-      slewRate = IO.SlewRate.SLOW,
+      slewRate = IO.SlewRate.SLOWEST,
       unusedPullMode = pullMode
     ))
     injectConstraint(Timing.Ignore(maxFreqMinPeriod = 100.Hz))

lib/src/main/scala/dfhdl/platforms/resources/SevenSegDisplay.scala

@@ -24,7 +24,7 @@ object SevenSegDisplay:
   enum Segment extends Encoded.Toggle:
     case Off, On
   object Segment:
-    @io(standard = io.Standard.LVCMOS, slewRate = io.SlewRate.SLOW)
+    @io(standard = io.Standard.LVCMOS, slewRate = io.SlewRate.SLOWEST)
     @timing.ignore(maxFreqMinPeriod = 200.us)
     protected[SevenSegDisplay] class Resource private[Segment] (val activeState: Segment)
         extends ToggleIO[Segment]
@@ -38,7 +38,7 @@ object SevenSegDisplay:
       private val pullMode = if (activeState == Select.Enabled) IO.PullMode.DOWN else IO.PullMode.UP
       injectConstraint(IO(
         standard = IO.Standard.LVCMOS,
-        slewRate = IO.SlewRate.SLOW,
+        slewRate = IO.SlewRate.SLOWEST,
         unusedPullMode = pullMode
       ))
       injectConstraint(Timing.Ignore(maxFreqMinPeriod = 200.us))

lib/src/main/scala/dfhdl/tools/toolsCore/QuartusPrime.scala

@@ -154,6 +154,9 @@ class QuartusPrimeProjectPhysicalConstraintsPrinter(using
   val pro: Boolean = designDB.top.dclMeta.annotations.collectFirst {
     case constraints.DeviceID(vendor = constraints.DeviceID.Vendor.AlteraIntel(pro)) => pro
   }.get
+  val deviceInfo: constraints.DeviceInfo = designDB.top.dclMeta.annotations.collectFirst {
+    case constraint: constraints.DeviceInfo => constraint
+  }.getOrElse(throw new IllegalArgumentException("No device info found"))
 
   def qsf_get_ports(port: DFVal.Dcl, constraint: constraints.SigConstraint): String =
     val portName = port.getName
@@ -201,9 +204,14 @@ class QuartusPrimeProjectPhysicalConstraintsPrinter(using
     portConstraint.slewRate.foreach { slewRate =>
       // TODO: what about other slew rate values?
       val slewRateStr = slewRate match
-        case constraints.IO.SlewRate.SLOW => "0"
-        case constraints.IO.SlewRate.FAST => "2"
-      addInstanceAssignment("SLEW_RATE", "2")
+        case constraints.IO.SlewRate.SLOWEST => deviceInfo.slewRateSlowest.getOrElse(
+            throw new IllegalArgumentException("Slowest slew rate not found in device info")
+          ).toString
+        case constraints.IO.SlewRate.FASTEST => deviceInfo.slewRateFastest.getOrElse(
+            throw new IllegalArgumentException("Fastest slew rate not found in device info")
+          ).toString
+        case constraints.IO.SlewRate.CUSTOM(value) => value.toString
+      addInstanceAssignment("SLEW_RATE", slewRateStr)
     }
 
     // Drive strength constraint

lib/src/main/scala/dfhdl/tools/toolsCore/Vivado.scala

@@ -225,8 +225,10 @@ class VivadoProjectConstraintsPrinter(using
     // Slew rate constraint
     portConstraint.slewRate.foreach { slewRate =>
       val slewRateStr = slewRate match
-        case constraints.IO.SlewRate.SLOW => "SLOW"
-        case constraints.IO.SlewRate.FAST => "FAST"
+        case constraints.IO.SlewRate.SLOWEST       => "SLOW"
+        case constraints.IO.SlewRate.FASTEST       => "FAST"
+        case constraints.IO.SlewRate.CUSTOM(value) =>
+          throw new IllegalArgumentException(s"Custom slew rate is not supported in Vivado.")
       addToDict("SLEW", slewRateStr)
     }