build: efinix: add Topaz support

add support for Topaz.

Signed-off-by: Fin Maaß <f.maass@vogl-electronic.com>

Author: maass-hamburg

litex/build/efinix/common.py

@@ -195,7 +195,7 @@ def __init__(self, i, o_p, o_n):
         io_pad  = platform.get_pad_name(o_p) # need real pad name
         io_prop = platform.get_pin_properties(o_p)
 
-        if platform.family == "Titanium":
+        if platform.family in ["Titanium", "Topaz"]:
             # _p has _P_ and _n has _N_ followed by an optional function
             # lvds block needs _PN_
             pad_split = io_pad.split('_')
@@ -240,7 +240,7 @@ def __init__(self, i_p, i_n, o):
         io_pad  = platform.get_pad_name(i_p) # need real pad name
         io_prop = platform.get_pin_properties(i_p)
 
-        if platform.family == "Titanium":
+        if platform.family in ["Titanium", "Topaz"]:
             # _p has _P_ and _n has _N_ followed by an optional function
             # lvds block needs _PN_
             pad_split = io_pad.split('_')

litex/build/efinix/dbparser.py

@@ -20,9 +20,10 @@
 # Efinix Database Parser ---------------------------------------------------------------------------
 
 class EfinixDbParser:
-    def __init__(self, efinity_path, device):
+    def __init__(self, efinity_path, device, family):
         self.efinity_db_path = efinity_path + '/pt/db/'
         self.device = device
+        self.family = family
 
     def get_device_map(self, device):
         with open(self.efinity_db_path + 'devicemap.csv') as f:
@@ -110,7 +111,7 @@ def get_pll_inst_from_gpio_inst(self, dmap, inst):
                         if i == None:
                             continue
                         if (i == inst) or (inst + '.' in i):
-                            refclk_no = 0 if self.device[:2] != "Ti" else c.get('index')
+                            refclk_no = 0 if self.family == "Trion" else c.get('index')
                             if c.get('index') == '3':
                                 refclk_no = 1
                             return (p.get('name'), refclk_no)

litex/build/efinix/ifacewriter.py

@@ -319,13 +319,13 @@ def generate_pll(self, block, partnumber, verbose=True):
             else:
                 cmd += 'design.set_property("{}","CLKOUT{}_PHASE_SETTING","{}","PLL")\n'.format(name, i, clock[2] // 45)
 
-        # Titanium has always a feedback (local: CLK0, CORE: any output)
+        # Titanium/Topaz has always a feedback (local: CLK0, CORE: any output)
         if block["version"] == "V3":
             feedback_clk = block["feedback"]
             cmd += 'design.set_property("{}", "FEEDBACK_MODE", "{}", "PLL")\n'.format(name, "LOCAL" if feedback_clk < 1 else "CORE")
             cmd += 'design.set_property("{}", "FEEDBACK_CLK", "CLK{}", "PLL")\n'.format(name, 0 if feedback_clk < 1 else feedback_clk)
 
-        # auto_calc_pll_clock is always working with Titanium and only working when feedback is unused for Trion
+        # auto_calc_pll_clock is always working with Titanium/Topaz and only working when feedback is unused for Trion
         if block["feedback"] == -1 or block["version"] == "V3":
             cmd += "target_freq = {\n"
             for i, clock in enumerate(block["clk_out"]):
@@ -438,7 +438,7 @@ def generate_lvds(self, block, verbose=True):
                 rst_pin = rst_pin.name
 
             cmd.append('design.create_block("{}", block_type="{}", tx_mode="{}")'.format(name, block_type, tx_mode))
-            if self.platform.family == "Titanium":
+            if self.platform.family in ["Titanium", "Topaz"]:
                 cmd.append('design.set_property("{}", "TX_DELAY",     "{}",         "{}")'.format(name, delay, block_type))
                 cmd.append('design.set_property("{}", "TX_DIFF_TYPE", "LVDS",       "{}")'.format(name, block_type))
                 cmd.append('design.set_property("{}", "TX_HALF_RATE", "{}",         "{}")'.format(name, half_rate, block_type))
@@ -484,7 +484,7 @@ def generate_lvds(self, block, verbose=True):
                     delay_inc = delay_inc.name
 
             cmd.append('design.create_block("{}", block_type="{}", rx_conn_type="{}")'.format(name, block_type, rx_mode))
-            if self.platform.family == "Titanium":
+            if self.platform.family in ["Titanium", "Topaz"]:
                 cmd.append('design.set_property("{}", "GBUF",           "",   "{}")'.format(name, block_type))
                 cmd.append('design.set_property("{}", "RX_DBG_PIN",     "",   "{}")'.format(name, block_type))
                 cmd.append('design.set_property("{}", "RX_TERM_PIN",    "{}", "{}")'.format(name, term, block_type))

litex/build/efinix/platform.py

@@ -34,6 +34,8 @@ def __init__(self, *args, iobank_info=None, toolchain="efinity", spi_mode="activ
         self.clks         = {}
         if self.device[:2] == "Ti":
             self.family = "Titanium"
+        elif self.device[:2] == "Tz":
+            self.family = "Topaz"
         else:
             self.family = "Trion"
 
@@ -51,7 +53,7 @@ def __init__(self, *args, iobank_info=None, toolchain="efinity", spi_mode="activ
         else:
             raise ValueError(f"Unknown toolchain {toolchain}")
 
-        self.parser = EfinixDbParser(self.efinity_path, self.device)
+        self.parser = EfinixDbParser(self.efinity_path, self.device, self.family)
         self.pll_available = self.parser.get_block_instance_names('pll')
         self.pll_used = []
 

litex/soc/cores/jtag.py

@@ -431,7 +431,7 @@ def __init__(self, jtag=None, device=None, data_width=8, clock_domain="sys", cha
             elif device[:5] == "LFE5U":
                 jtag = ECP5JTAG()
             # Efinix
-            elif device[:2] == "Ti":
+            elif device[:2] in ["Ti", "Tz"]:
                 jtag = EfinixJTAG(platform)
             # Altera/Intel.
             elif AlteraJTAG.get_primitive(device) is not None: