cores/clocks/lattice_ecp5: Rename ECP5Delay to ECP5DynamicDelay and adapt style for consistency.

litex/soc/cores/clock/__init__.py

@@ -12,7 +12,7 @@ from litex.soc.cores.clock.intel_cyclone10 import Cyclone10LPPLL
 
 # Lattice
 from litex.soc.cores.clock.lattice_ice40 import iCE40PLL
-from litex.soc.cores.clock.lattice_ecp5  import ECP5PLL, ECP5Delay
+from litex.soc.cores.clock.lattice_ecp5  import ECP5PLL, ECP5DynamicDelay
 from litex.soc.cores.clock.lattice_nx    import NXOSCA, NXPLL
 
 # Efinix

litex/soc/cores/clock/lattice_ecp5.py

@@ -10,7 +10,7 @@ from migen.genlib.resetsync import AsyncResetSynchronizer
 
 from litex.soc.cores.clock.common import *
 
-# Lattice / ECP5 -----------------------------------------------------------------------------------
+# Lattice / ECP5 PLL -------------------------------------------------------------------------------
 
 class ECP5PLL(Module):
     nclkouts_max    = 4
@@ -166,50 +166,60 @@ class ECP5PLL(Module):
                 self.params["attr"].append((f"FREQUENCY_PIN_CLKO{n_to_l[n]}", str(f/1e6)))
         self.specials += Instance("EHXPLLL", **self.params)
 
+# Lattice / ECP5 Dynamic Delay ---------------------------------------------------------------------
 
-class ECP5Delay(Module):
+class ECP5DynamicDelay(Module):
-    # from ECP5 docs
+    tap_delay = 25e-12
-    delay_step_s = 25e-12
+    ntaps     = 128
-    n_steps = 128
 
-    def __init__(self):
+    def __init__(self, i=None, o=None, taps=None):
-        self.i = Signal()
+        self.i    = Signal() if i is None else i
-        self.o = Signal()
+        self.o    = Signal() if o is None else o
-        self.value = Signal(max=self.n_steps)
+        self.taps = Signal(max=self.ntaps) if taps is None else taps
 
-    def do_finalize(self):
+        # # #
-        rst = Signal()
-        move = Signal()
-        current_value = Signal(max=self.n_steps)
 
-        self.specials += Instance(
+        rst       = Signal()
-            "DELAYF",
+        move      = Signal()
-            p_DEL_MODE="USER_DEFINED",
+        done      = Signal()
-            p_DEL_VALUE=self.value.reset,
+        change    = Signal()
-            i_A=self.i,
+        curr_taps = Signal(max=self.ntaps)
-            o_Z=self.o,
+
-            i_LOADN=~(ResetSignal() | rst),
+        # DELAYF Instance.
-            i_MOVE=move,
+        self.specials += Instance("DELAYF",
-            i_DIRECTION=0,
+            p_DEL_MODE  = "USER_DEFINED",
-            o_CFLAG=Signal()
+            p_DEL_VALUE = self.taps.reset,
+            i_A         = self.i,
+            o_Z         = self.o,
+            i_LOADN     = ~(ResetSignal() | rst),
+            i_MOVE      = move,
+            i_DIRECTION = 0,
+            o_CFLAG     = Signal()
         )
 
-        self.submodules.fsm = fsm = FSM()
+        # FSM.
-        fsm.act("WAIT",
+        self.comb += done.eq(  self.taps == curr_taps)
-                If(self.value != current_value,
+        self.comb += change.eq(self.taps != curr_taps)
-                   NextState('RST'))
+        self.submodules.fsm = fsm = FSM(reset_state="IDLE")
+        fsm.act("IDLE",
+            If(change,
+                NextState("DELAYF-RST")
+            )
+        )
+        fsm.act("DELAYF-RST",
+            rst.eq(1),
+            NextValue(move,      0),
+            NextValue(curr_taps, 0),
+            NextState("DELAYF-MOVE")
+        )
+        fsm.act("DELAYF-MOVE",
+             If(done,
+                NextValue(move, 0),
+                NextState("IDLE")
+            ).Else(
+                NextValue(move, ~move),
+                If(move,
+                    NextValue(curr_taps, curr_taps + 1)
                 )
-        fsm.act("RST",
+            )
-                rst.eq(1),
+        )
-                NextValue(current_value, 0),
-                NextState("MOVE")
-                )
-        fsm.act("MOVE",
-                If(current_value == self.value,
-                   NextValue(move, 0),
-                   NextState("WAIT")
-                ).Else(
-                   NextValue(move, ~move),
-                   If(move,
-                      NextValue(current_value, current_value + 1)),
-                ))

test/test_clock.py

@@ -130,8 +130,9 @@ class TestClock(unittest.TestCase):
         pll.create_clkout(ClockDomain("clkout4"), 175e6)
         pll.compute_config()
 
-    def test_ecp5_delay(self):
+    def test_ecp5_dynamic_delay(self):
-        delay = ECP5Delay()
+        delay = ECP5DynamicDelay(i=Signal(), o=Signal(), taps=Signal(7))
+        delay = ECP5DynamicDelay()
 
     # Lattice / NX
     def test_nxpll(self):