litex-boards/litex_boards/platforms/lattice_certuspro_nx_evn.py

#
# This file is part of LiteX-Boards.
#
# Copyright (c) 2024 Enjoy-Digital <enjoy-digital.fr>
# SPDX-License-Identifier: BSD-2-Clause

from litex.build.generic_platform import *
from litex.build.lattice import LatticeNexusPlatform
from litex.build.openfpgaloader import OpenFPGALoader

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

_io = [
    # 5. CertusPro-NX Clock Sources
    ("clk125",  0, Pins("N25"), IOStandard("LVCMOS33")), # JP15: open
    ("clk12",   0, Pins("R4"),  IOStandard("LVCMOS33")), # JP6: close
    ("clkresv", 0, Pins("R6"),  IOStandard("LVCMOS33")), # DNI, JP18: open

    # Disable Clk Signals
    ("resv_clk_dis",   0, Pins("R7"),  IOStandard("LVCMOS33")),
    ("clk125_clk_dis", 0, Pins("J23"), IOStandard("LVCMOS33")),

    # 7.2. General Purpose Push Buttons - all logic zero when pressed
    ("programn", 0, Pins("G4"), IOStandard("LVCMOS18")), # SW2
    ("user_btn", 0, Pins("J5"), IOStandard("LVCMOS18")), # SW1
    ("user_btn", 1, Pins("J2"), IOStandard("LVCMOS18")), # SW4
    ("user_btn", 2, Pins("J3"), IOStandard("LVCMOS18")), # SW5

    # 7.1. DIP Switch
    ("user_dip_btn", 0, Pins("K8"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 1, Pins("K7"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 2, Pins("K6"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 3, Pins("K4"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 4, Pins("K3"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 5, Pins("K2"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 6, Pins("J7"), IOStandard("LVCMOS18")),
    ("user_dip_btn", 7, Pins("J6"), IOStandard("LVCMOS18")),

    # 6.1 UART Topology (JP1/JP2: close, JP4/JP5: open)
    ("serial", 0,
        Subsignal("rx", Pins("L2")),
        Subsignal("tx", Pins("L1")),
        IOStandard("LVCMOS33")
    ),

    # 7.3. General Purpose LEDs (Inverted)
    ("user_led",  0, Pins("N5"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  1, Pins("N6"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  2, Pins("N7"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  3, Pins("N8"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  4, Pins("L6"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  5, Pins("N9"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  6, Pins("L8"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  7, Pins("M9"), IOStandard("LVCMOS33")), # Bank 1 Green
    ("user_led",  8, Pins("N1"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led",  9, Pins("N2"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 10, Pins("N3"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 11, Pins("M1"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 12, Pins("M2"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 13, Pins("M3"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 14, Pins("L3"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 15, Pins("N4"), IOStandard("LVCMOS33")), # Bank 1 Yellow
    ("user_led", 16, Pins("T4"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 17, Pins("T5"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 18, Pins("R6"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 19, Pins("T7"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 20, Pins("U8"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 21, Pins("T8"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 22, Pins("R9"), IOStandard("LVCMOS33")), # Bank 1 Red
    ("user_led", 23, Pins("P9"), IOStandard("LVCMOS33")), # Bank 1 Red

    # 6.1 I2C Topology (connected to the FTDI with JP4/JP5
    ("i2c", 0,
        Subsignal("scl", Pins("M7")),
        Subsignal("sda", Pins("M6")),
        IOStandard("LVCMOS33"),
    ),

    # 6.3 SPI Topology
    ("spiflash", 0,
        Subsignal("cs_n", Pins("H3")),
        Subsignal("clk",  Pins("G6")),
        Subsignal("mosi", Pins("H7")),
        Subsignal("miso", Pins("H6")),
        Subsignal("wp",   Pins("K5")),
        Subsignal("hold", Pins("H4")),
        IOStandard("LVCMOS18")
    ),

    ("spiflash4x", 0,
        Subsignal("cs_n", Pins("H3")),
        Subsignal("clk",  Pins("G6")),
        Subsignal("dq",   Pins("H7 H6 K5 H4")),
        IOStandard("LVCMOS18")
    ),

    # HyperRAM
    ("hyperram", 0,
        Subsignal("dq",    Pins("V18 W19 AB19 AB20 AB21 AB18 AA17 W18"), IOStandard("LVCMOS18H")),
        Subsignal("rwds",  Pins("V19"),  IOStandard("LVCMOS18H")),
        Subsignal("cs_n",  Pins("AA18"), IOStandard("LVCMOS18H")),
        Subsignal("rst_n", Pins("AB17"), IOStandard("LVCMOS18H")),
        Subsignal("clk",   Pins("Y19"),  IOStandard("LVDS")),
        # Subsignal("clk_n", Pins("Y18"), IOStandard("LVDS")),
        Misc("SLEWRATE=FAST")
    ),
    ("hyperram", 1,
        Subsignal("dq",    Pins("V22 AA20 V21 U21 U20 Y22 AA22 AA21"), IOStandard("LVCMOS18H")),
        Subsignal("rwds",  Pins("Y21"),  IOStandard("LVCMOS18H")),
        Subsignal("cs_n",  Pins("AA19"), IOStandard("LVCMOS18H")),
        Subsignal("rst_n", Pins("U18"),  IOStandard("LVCMOS18H")),
        Subsignal("clk",   Pins("W22"),  IOStandard("LVDS")),
        # Subsignal("clk_n", Pins("W21"), IOStandard("LVDS")),
        Misc("SLEWRATE=FAST")
    ),
]

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

_connectors = [
    # Table 6.2 PMOD Header
    # PMOD signal number:
    #          1    2   3   4   7   8   9   10
    ("PMOD0", "Y1   W2  V3  V1  Y2  W3  W1  V2"), # J5
    ("PMOD1", "V7   V6  V5  V4  V8  W7  W6  W5"), # J4
    ("PMOD2", "AA4 AB3 AA2 AA1  W4  Y4 AB2 AB1"), # J6

    # FIXME SMA Header, FMC, TP and RPi Board header
]

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

class Platform(LatticeNexusPlatform):
    default_clk_name   = "clk125"
    default_clk_period = 1e9/125e6

    def __init__(self, device="LFCPNX", toolchain="radiant", **kwargs):
        assert device in ["LFCPNX"]
        LatticeNexusPlatform.__init__(self, device + "-100-9LFG672C", _io, _connectors, toolchain=toolchain, **kwargs)
        self.add_platform_command("ldc_set_sysconfig {{MASTER_SPI_PORT=SERIAL}}")
        # Evaluation mode (with free license)
        self.toolchain.set_prj_strategy_opts({"bit_ip_eval": "true"})

    def create_programmer(self):
        return OpenFPGALoader()