add LenExpand module, tidyup on docstring

[soc.git] / src / soc / experiment / pi2ls.py

diff --git a/src/soc/experiment/pi2ls.py b/src/soc/experiment/pi2ls.py
index ac2936bb107035b5c9eccd31b9a2edfef059ecba..9be33016c7793682544239d6dab7fb20b074ec02 100644 (file)
--- a/src/soc/experiment/pi2ls.py
+++ b/src/soc/experiment/pi2ls.py
@@ -1,29 +1,34 @@
-"""
-    PortInterface                LoadStoreUnitInterface
+"""PortInterface to LoadStoreUnitInterface adapter
+
+    PortInterface   LoadStoreUnitInterface
+    -------------   ----------------------
 
-    is_ld_i/1                    x_ld_i
-    is_st_i/1                    x_st_i
+    is_ld_i/1       x_ld_i
+    is_st_i/1       x_st_i
 
-    data_len/4                   x_mask/16  (translate using LenExpand)
+    data_len/4      x_mask/16  (translate using LenExpand)
 
-    busy_o/1                     most likely to be x_busy_o
-    go_die_i/1                   rst?
-    addr.data/48                 x_addr_i[4:] (x_addr_i[:4] goes into LenExpand)
-    addr.ok/1                    probably x_valid_i & ~x_stall_i
+    busy_o/1        most likely to be x_busy_o
+    go_die_i/1      rst?
+    addr.data/48    x_addr_i[4:] (x_addr_i[:4] goes into LenExpand)
+    addr.ok/1       probably x_valid_i & ~x_stall_i
 
-    addr_ok_o/1                  no equivalent.  *might* work using x_stall_i
-    addr_exc_o/2(?)              m_load_err_o and m_store_err_o
+    addr_ok_o/1     no equivalent.  *might* work using x_stall_i
+    addr_exc_o/2(?) m_load_err_o and m_store_err_o
 
-    ld.data/64                   m_ld_data_o
-    ld.ok/1                      probably implicit, when x_busy drops low
-    st.data/64                   x_st_data_i
-    st.ok/1                      probably kinda redundant, set to x_st_i
+    ld.data/64      m_ld_data_o
+    ld.ok/1         probably implicit, when x_busy drops low
+    st.data/64      x_st_data_i
+    st.ok/1         probably kinda redundant, set to x_st_i
 """
 
 from soc.minerva.units.loadstore import LoadStoreUnitInterface
 from soc.experiment.pimem import PortInterface
+from soc.scoreboard.addr_match import LenExpand
+
 from nmigen import Elaboratable, Module, Signal
 
+
 class Pi2LSUI(Elaboratable):
 
     def __init__(self, name, regwid=64, addrwid=48):
@@ -32,4 +37,6 @@ class Pi2LSUI(Elaboratable):
 
     def elaborate(self, platform):
         m = Module()
+        m.submodules.lenexp = lenexp = LenExpand(4, 8)
+
         return m