litex-boards/litex_boards/platforms/mercury_xu5.py

from litex.build.generic_platform import *
from litex.build.xilinx import XilinxPlatform, VivadoProgrammer

# IOs ----------------------------------------------------------------------------------------------

_io = [
    ("clk100", 0,
        Subsignal("n", Pins("AD4"), IOStandard("DIFF_SSTL12_DCI")),
        Subsignal("p", Pins("AD5"), IOStandard("DIFF_SSTL12_DCI")),
    ),

    ("clk100_gtr", 0,
        Subsignal("p", Pins("C21"), IOStandard("DIFF_SSTL12")),
        Subsignal("n", Pins("C22"), IOStandard("DIFF_SSTL12")),
    ),

    ("clk27_gtr", 0,
        Subsignal("p", Pins("A21"), IOStandard("DIFF_SSTL12")),
        Subsignal("n", Pins("A22"), IOStandard("DIFF_SSTL12")),
    ),

    ("clk33", 0, Pins("AD4"), IOStandard("SSTL12")),

    ("cpu_reset", 0, Pins("N19"), IOStandard("LVCMOS33")),

    ("user_led", 0, Pins("H2"),   IOStandard("LVCMOS18")),
    ("user_led", 1, Pins("P9"),   IOStandard("LVCMOS18")),
    ("user_led", 2, Pins("K5"),   IOStandard("LVCMOS18")),

    ("serial", 0,
        Subsignal("rx", Pins("AA10")),  # Module connector A: A60 (Meccury PE1: "IO B" connector 32)
        Subsignal("tx", Pins("AA11")),  # Module connector A: A58 (Meccury PE1: "IO B" connector 31)
        IOStandard("LVCMOS33"),
    ),

    ("ddram", 0,  # TODO: remove Misc with default settings
        Subsignal("a",       Pins(
            "AC4 AC3 AB4 AB3 AB2 AC2 AB1 AC1",
            "AB5 AG4 AH4 AG3 AH3 AE3"),         IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("we_n",    Pins("AF3"),       IOStandard("SSTL12_DCI"),  # A14
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("cas_n",   Pins("AE2"),       IOStandard("SSTL12_DCI"),  # A15
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("ras_n",   Pins("AF2"),       IOStandard("SSTL12_DCI"),  # A16
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("ba",      Pins("AH1 AF1"),   IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        #  Subsignal("bg",      Pins("AG1 AD9"),   IOStandard("SSTL12_DCI"),
        Subsignal("bg",      Pins("AG1"),   IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("cs_n",    Pins("AH9"),       IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=SDR"),
        ),
        Subsignal("act_n",   Pins("AH2"),       IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("dm",      Pins("AC9 AG9"),   IOStandard("POD12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            #  Misc("EQUALIZATION=EQ_LEVEL2"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("dq",      Pins(
            "AB6 AC6 AE9 AE8 AB8 AC8 AB7 AC7",
            "AE5 AF5 AF8 AG8 AH8 AH7 AF7 AF6"), IOStandard("POD12_DCI"),
            Misc("PRE_EMPHASIS=RDRV_240"),
            Misc("EQUALIZATION=EQ_LEVEL2"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
            Misc("ODT=RTT_40"),
        ),
        Subsignal("dqs_p",   Pins("AD7 AG6"),   IOStandard("DIFF_POD12_DCI"),
            Misc("PRE_EMPHASIS=RDRV_240"),
            Misc("EQUALIZATION=EQ_LEVEL2"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
            Misc("ODT=RTT_40"),
        ),
        Subsignal("dqs_n",   Pins("AE7 AG5"),   IOStandard("DIFF_POD12_DCI"),
            Misc("PRE_EMPHASIS=RDRV_240"),
            Misc("EQUALIZATION=EQ_LEVEL2"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
            Misc("ODT=RTT_40"),
        ),
        Subsignal("clk_p",   Pins("AD2"),       IOStandard("DIFF_SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("clk_n",   Pins("AD1"),       IOStandard("DIFF_SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("cke",     Pins("AH6"),       IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("odt",     Pins("AE4"),       IOStandard("SSTL12_DCI"),
            Misc("OUTPUT_IMPEDANCE=RDRV_40_40"),
            Misc("DATA_RATE=DDR"),
        ),
        Subsignal("reset_n", Pins("G4"),        IOStandard("LVCMOS18"),
            Misc("DRIVE=8"),
        ),
        Misc("SLEW=FAST"),
    ),
]

# Connectors ---------------------------------------------------------------------------------------

_connectors = []

# Platform -----------------------------------------------------------------------------------------

class Platform(XilinxPlatform):
    default_clk_name = "clk100"
    default_clk_period = 1e9/100e6

    def __init__(self):
        XilinxPlatform.__init__(self, "xczu2eg-sfvc784-1-i", _io, _connectors, toolchain="vivado")

    def create_programmer(self):
        return VivadoProgrammer()

    def do_finalize(self, fragment):
        XilinxPlatform.do_finalize(self, fragment)
        self.add_platform_command("set_property BITSTREAM.CONFIG.OVERTEMPSHUTDOWN ENABLE [current_design]")
        self.add_platform_command("set_property BITSTREAM.CONFIG.UNUSEDPIN PULLNONE [current_design]")
        self.add_platform_command("set_property INTERNAL_VREF 0.600 [get_iobanks 64]")