From b76f7e6e071475bf9c5d5f86580d223b76c0608a Mon Sep 17 00:00:00 2001
From: Florent Kermarrec <florent@enjoy-digital.fr>
Date: Tue, 24 May 2016 06:56:58 +0200
Subject: [PATCH] frontend/crossbar: add skeleton/descroption for port
 downconverters/upconverters

---
 litedram/frontend/crossbar.py | 52 +++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/litedram/frontend/crossbar.py b/litedram/frontend/crossbar.py
index 11ff9b3..38d9ecf 100644
--- a/litedram/frontend/crossbar.py
+++ b/litedram/frontend/crossbar.py
@@ -8,8 +8,12 @@ from litex.soc.interconnect import stream
 
 from litedram.common import *
 
+
 class LiteDRAMAsyncAdapter(Module):
     def __init__(self, port_from, port_to):
+        assert port_from.aw == port_to.aw
+        assert port_from.dw == port.to.dw
+
         aw = port_from.aw
         dw = port_from.dw
         cd_from = port_from.cd
@@ -42,6 +46,54 @@ class LiteDRAMAsyncAdapter(Module):
         ]
 
 
+class _LiteDRAMDownConverter(Module):
+    """LiteDRAM port DownConverter
+
+    This module reduces user port data width to fit controller data width.
+    With N = port_from.dw/port_to.dw:
+    - Address is adapted (multiplied by N + internal increments)
+    - A single write from the user is splitted and generate N writes to the
+    controller.
+    - Reads generates N reads on the controller and returned datas are regroup
+    into a single data presented to the user.
+    """
+    def __init__(self, port_from, port_to):
+        assert port_from.cd == port_to.cd
+        assert port_from.dw > port_to.dw
+
+        # # #
+
+
+class _LiteDRAMUpConverter(Module):
+    """LiteDRAM port UpConverter
+
+    This module increase user port data width to fit controller data width.
+    With N = port_to.dw/port_from.dw:
+    - Address is adapted (divided by N)
+    - N writes and read from user are regrouped in a single one to the controller
+    (when possible, ie when consecutive and bursting)
+    """
+    def __init__(self, port_from, port_to):
+        assert port_from.cd == port_to.cd
+        assert port_from.dw < port_to.dw
+
+        # # #
+
+
+class LiteDRAMConverter(Module):
+    def __init__(self, port_from, port_to):
+        assert port_from.cd == port_to.cd
+
+        # # #
+
+        if port_from.dw > port_to.dw:
+            converter = _LiteDRAMDownConverter(port_from, port_to)
+            self.submodules += converter
+        elif port_from.dw < port.to.dw:
+            converter = _LiteDRAMUpConverter(port_from, port_to)
+            self.submodules += converter
+
+
 class LiteDRAMCrossbar(Module):
     def __init__(self, controller, cba_shift):
         self.controller = controller