io: Add source-synchronous IO modules

Signed-off-by: Alex Forencich <alex@alexforencich.com>

rtl/io/taxi_ssio_sdr_in.sv

@@ -0,0 +1,134 @@
+// SPDX-License-Identifier: CERN-OHL-S-2.0
+/*
+
+Copyright (c) 2016-2025 FPGA Ninja, LLC
+
+Authors:
+- Alex Forencich
+
+*/
+
+`resetall
+`timescale 1ns / 1ps
+`default_nettype none
+
+/*
+ * Generic source synchronous SDR input
+ */
+module taxi_ssio_sdr_in #
+(
+    // simulation (set to avoid vendor primitives)
+    parameter logic SIM = 1'b0,
+    // vendor ("GENERIC", "XILINX", "ALTERA")
+    parameter VENDOR = "XILINX",
+    // device family
+    parameter FAMILY = "virtex7",
+    // Width of register in bits
+    parameter WIDTH = 1
+)
+(
+    input  wire logic              input_clk,
+
+    input  wire logic [WIDTH-1:0]  input_d,
+
+    output wire logic              output_clk,
+
+    output wire logic [WIDTH-1:0]  output_q
+);
+
+wire clk_int;
+wire clk_io;
+
+if (!SIM && VENDOR == "XILINX") begin
+    // Xilinx/AMD device support
+
+    if (FAMILY == "virtex6" || FAMILY == "virtex7" || FAMILY == "kintex7" || FAMILY == "artix7") begin
+        // BUFIO + BUFR
+        // virtex6, virtex7, kintex7, artix7, zynq
+
+        assign clk_int = input_clk;
+
+        // pass through RX clock to input buffers
+        BUFIO
+        clk_bufio (
+            .I(clk_int),
+            .O(clk_io)
+        );
+
+        // pass through RX clock to logic
+        BUFR #(
+            .BUFR_DIVIDE("BYPASS")
+        )
+        clk_bufr (
+            .I(clk_int),
+            .O(output_clk),
+            .CE(1'b1),
+            .CLR(1'b0)
+        );
+
+    end else if (FAMILY == "spartan6") begin
+        // BUFIO2 + BUFG
+        // spartan6
+
+        // pass through RX clock to input buffers
+        BUFIO2 #(
+            .DIVIDE(1),
+            .DIVIDE_BYPASS("TRUE"),
+            .I_INVERT("FALSE"),
+            .USE_DOUBLER("FALSE")
+        )
+        clk_bufio (
+            .I(input_clk),
+            .DIVCLK(clk_int),
+            .IOCLK(clk_io),
+            .SERDESSTROBE()
+        );
+
+        // pass through RX clock to MAC
+        BUFG
+        clk_bufg (
+            .I(clk_int),
+            .O(output_clk)
+        );
+
+    end else begin
+        // BUFG only
+        // virtexu, kintexu, virtexuplus, virtexuplusHBM, virtexuplus58g, kintexuplus, zynquplus, zynquplusRFSOC
+
+        // buffer RX clock
+        BUFG
+        clk_bufg (
+            .I(input_clk),
+            .O(clk_int)
+        );
+
+        // pass through RX clock to logic and input buffers
+        assign clk_io = clk_int;
+        assign output_clk = clk_int;
+
+    end
+
+end else begin
+    // generic/simulation implementation (no vendor primitives)
+
+    // pass through RX clock to input buffers
+    assign clk_io = input_clk;
+
+    // pass through RX clock to logic
+    assign clk_int = input_clk;
+    assign output_clk = clk_int;
+
+end
+
+(* IOB = "TRUE" *)
+logic [WIDTH-1:0] output_q_reg = '0;
+
+assign output_q = output_q_reg;
+
+always_ff @(posedge clk_io) begin
+    output_q_reg <= input_d;
+end
+
+endmodule
+
+`resetall