Wide FIFO (#23)

kuznia-rdzeni · Dec 11, 2024 · 326ae78 · 326ae78
1 parent f9278cc
commit 326ae78
Show file tree

Hide file tree

Showing 21 changed files with 486 additions and 24 deletions.
diff --git a/.doctrees/api.doctree b/.doctrees/api.doctree
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
diff --git a/.doctrees/transactron.lib.doctree b/.doctrees/transactron.lib.doctree
diff --git a/.doctrees/transactron.utils.amaranth_ext.doctree b/.doctrees/transactron.utils.amaranth_ext.doctree
diff --git a/_sources/transactron.utils.amaranth_ext.rst.txt b/_sources/transactron.utils.amaranth_ext.rst.txt
@@ -28,6 +28,14 @@ transactron.utils.amaranth\_ext.functions module
    :undoc-members:
    :show-inheritance:
 
+transactron.utils.amaranth\_ext.shifter module
+----------------------------------------------
+
+.. automodule:: transactron.utils.amaranth_ext.shifter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 Module contents
 ---------------
 

diff --git a/api.html b/api.html
@@ -168,7 +168,7 @@ <h2>transactron<a class="headerlink" href="#transactron" title="Permalink to thi
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/development-environment.html b/development-environment.html
@@ -181,7 +181,7 @@ <h3>tprof.py<a class="headerlink" href="#tprof-py" title="Permalink to this head
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/genindex.html b/genindex.html
@@ -151,6 +151,8 @@ <h2 id="_">_</h2>
         <li><a href="transactron.lib.html#transactron.lib.fifo.BasicFifo.__init__">(transactron.lib.fifo.BasicFifo method)</a>
 </li>
         <li><a href="transactron.lib.html#transactron.lib.fifo.Semaphore.__init__">(transactron.lib.fifo.Semaphore method)</a>
+</li>
+        <li><a href="transactron.lib.html#transactron.lib.fifo.WideFifo.__init__">(transactron.lib.fifo.WideFifo method)</a>
 </li>
         <li><a href="transactron.lib.html#transactron.lib.logging.HardwareLogger.__init__">(transactron.lib.logging.HardwareLogger method)</a>
 </li>
@@ -418,6 +420,8 @@ <h2 id="C">C</h2>
       <li><a href="transactron.lib.html#transactron.lib.transformers.ConnectAndMapTrans">ConnectAndMapTrans (class in transactron.lib.transformers)</a>
 </li>
       <li><a href="transactron.lib.html#transactron.lib.connectors.ConnectTrans">ConnectTrans (class in transactron.lib.connectors)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.functions.const_of">const_of() (in module transactron.utils.amaranth_ext.functions)</a>
 </li>
       <li><a href="transactron.lib.html#transactron.lib.storage.ContentAddressableMemory">ContentAddressableMemory (class in transactron.lib.storage)</a>
 </li>
@@ -694,6 +698,14 @@ <h2 id="G">G</h2>
       <li><a href="transactron.utils.html#transactron.utils.gen.GeneratedLog">GeneratedLog (class in transactron.utils.gen)</a>
 </li>
       <li><a href="transactron.utils.html#transactron.utils.gen.GenerationInfo">GenerationInfo (class in transactron.utils.gen)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.generic_shift_left">generic_shift_left() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.generic_shift_right">generic_shift_right() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.generic_shift_vec_left">generic_shift_vec_left() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.generic_shift_vec_right">generic_shift_vec_right() (in module transactron.utils.amaranth_ext.shifter)</a>
 </li>
       <li><a href="transactron.core.html#transactron.core.transaction_base.TransactionBase.get">get() (transactron.core.transaction_base.TransactionBase class method)</a>
 
@@ -707,12 +719,12 @@ <h2 id="G">G</h2>
         <li><a href="transactron.utils.html#transactron.utils.dependencies.DependencyContext.get">(transactron.utils.dependencies.DependencyContext class method)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="transactron.testing.html#transactron.testing.testbenchio.TestbenchIO.get_call_result">get_call_result() (transactron.testing.testbenchio.TestbenchIO method)</a>
 </li>
       <li><a href="transactron.utils.html#transactron.utils.transactron_helpers.get_caller_class_name">get_caller_class_name() (in module transactron.utils.transactron_helpers)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="transactron.lib.html#transactron.lib.dependencies.DependencyManager.get_dependency">get_dependency() (transactron.lib.dependencies.DependencyManager method)</a>
 
       <ul>
@@ -1034,6 +1046,8 @@ <h2 id="M">M</h2>
         <li><a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.elaboratables">transactron.utils.amaranth_ext.elaboratables</a>
 </li>
         <li><a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.functions">transactron.utils.amaranth_ext.functions</a>
+</li>
+        <li><a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.shifter">transactron.utils.amaranth_ext.shifter</a>
 </li>
         <li><a href="transactron.utils.html#module-transactron.utils.assign">transactron.utils.assign</a>
 </li>
@@ -1188,11 +1202,19 @@ <h2 id="R">R</h2>
 </li>
       <li><a href="transactron.utils.html#transactron.utils.assign.AssignType.RHS">RHS (transactron.utils.assign.AssignType attribute)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="transactron.core.html#transactron.core.transaction_base.Priority.RIGHT">RIGHT (transactron.core.transaction_base.Priority attribute)</a>
 </li>
       <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.elaboratables.RingMultiPriorityEncoder">RingMultiPriorityEncoder (class in transactron.utils.amaranth_ext.elaboratables)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.rotate_left">rotate_left() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.rotate_right">rotate_right() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.rotate_vec_left">rotate_vec_left() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.rotate_vec_right">rotate_vec_right() (in module transactron.utils.amaranth_ext.shifter)</a>
 </li>
       <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.elaboratables.RoundRobin">RoundRobin (class in transactron.utils.amaranth_ext.elaboratables)</a>
 </li>
@@ -1258,10 +1280,20 @@ <h2 id="S">S</h2>
 </li>
       <li><a href="transactron.testing.html#transactron.testing.testbenchio.TestbenchIO.set_inputs">set_inputs() (transactron.testing.testbenchio.TestbenchIO method)</a>
 </li>
-      <li><a href="transactron.utils.html#transactron.utils.data_repr.signed_to_int">signed_to_int() (in module transactron.utils.data_repr)</a>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.functions.shape_of">shape_of() (in module transactron.utils.amaranth_ext.functions)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.shift_left">shift_left() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.shift_right">shift_right() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.shift_vec_left">shift_vec_left() (in module transactron.utils.amaranth_ext.shifter)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="transactron.utils.amaranth_ext.html#transactron.utils.amaranth_ext.shifter.shift_vec_right">shift_vec_right() (in module transactron.utils.amaranth_ext.shifter)</a>
+</li>
+      <li><a href="transactron.utils.html#transactron.utils.data_repr.signed_to_int">signed_to_int() (in module transactron.utils.data_repr)</a>
+</li>
       <li><a href="transactron.utils.html#transactron.utils.transactron_helpers.silence_mustuse">silence_mustuse() (in module transactron.utils.transactron_helpers)</a>
 </li>
       <li><a href="transactron.lib.html#transactron.lib.dependencies.SimpleKey">SimpleKey (class in transactron.lib.dependencies)</a>
@@ -1511,15 +1543,15 @@ <h2 id="T">T</h2>
         <li><a href="transactron.lib.html#module-transactron.lib.buttons">module</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li>
     transactron.lib.connectors
 
       <ul>
         <li><a href="transactron.lib.html#module-transactron.lib.connectors">module</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li>
     transactron.lib.dependencies
 
@@ -1686,6 +1718,13 @@ <h2 id="T">T</h2>
 
       <ul>
         <li><a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.functions">module</a>
+</li>
+      </ul></li>
+      <li>
+    transactron.utils.amaranth_ext.shifter
+
+      <ul>
+        <li><a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.shifter">module</a>
 </li>
       </ul></li>
       <li>
@@ -1794,6 +1833,8 @@ <h2 id="W">W</h2>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="transactron.lib.html#transactron.lib.fifo.WideFifo">WideFifo (class in transactron.lib.fifo)</a>
+</li>
       <li><a href="transactron.lib.html#transactron.lib.metrics.MetricRegisterModel.width">width (transactron.lib.metrics.MetricRegisterModel attribute)</a>
 </li>
   </ul></td>
@@ -1809,7 +1850,7 @@ <h2 id="W">W</h2>
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/index.html b/index.html
@@ -129,7 +129,7 @@ <h1>Transactron<a class="headerlink" href="#transactron" title="Permalink to thi
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/modules.html b/modules.html
@@ -154,7 +154,7 @@ <h1>transactron<a class="headerlink" href="#transactron" title="Permalink to thi
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/objects.inv b/objects.inv
diff --git a/py-modindex.html b/py-modindex.html
@@ -282,6 +282,11 @@ <h1>Python Module Index</h1>
        <td>&#160;&#160;&#160;
        <a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.functions"><code class="xref">transactron.utils.amaranth_ext.functions</code></a></td><td>
        <em></em></td></tr>
+     <tr class="cg-1">
+       <td></td>
+       <td>&#160;&#160;&#160;
+       <a href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.shifter"><code class="xref">transactron.utils.amaranth_ext.shifter</code></a></td><td>
+       <em></em></td></tr>
      <tr class="cg-1">
        <td></td>
        <td>&#160;&#160;&#160;
@@ -333,7 +338,7 @@ <h1>Python Module Index</h1>
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/search.html b/search.html
@@ -91,7 +91,7 @@
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/searchindex.js b/searchindex.js
diff --git a/transactions.html b/transactions.html
@@ -400,7 +400,7 @@ <h3>Transaction and method nesting<a class="headerlink" href="#transaction-and-m
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/transactron.core.html b/transactron.core.html
@@ -977,7 +977,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>
 

diff --git a/transactron.html b/transactron.html
@@ -128,6 +128,7 @@ <h2>Subpackages<a class="headerlink" href="#subpackages" title="Permalink to thi
 <li class="toctree-l4"><a class="reference internal" href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.coding">transactron.utils.amaranth_ext.coding module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.elaboratables">transactron.utils.amaranth_ext.elaboratables module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.functions">transactron.utils.amaranth_ext.functions module</a></li>
+<li class="toctree-l4"><a class="reference internal" href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext.shifter">transactron.utils.amaranth_ext.shifter module</a></li>
 <li class="toctree-l4"><a class="reference internal" href="transactron.utils.amaranth_ext.html#module-transactron.utils.amaranth_ext">Module contents</a></li>
 </ul>
 </li>
@@ -745,7 +746,7 @@ <h2>Submodules<a class="headerlink" href="#submodules" title="Permalink to this
 
   <div role="contentinfo">
     <p>&#169; Copyright Kuźnia Rdzeni, 2024.
-      <span class="lastupdated">Last updated on 17:22 2024-12-03.
+      <span class="lastupdated">Last updated on 16:26 2024-12-11.
       </span></p>
   </div>