#!/usr/bin/env python3 # # This file is part of LiteX-Boards. # # Copyright (c) 2021 Florent Kermarrec # Copyright (c) 2022 Lukas F. Hartmann, MNT Research GmbH # SPDX-License-Identifier: BSD-2-Clause from migen import * from litex.gen import LiteXModule from litex_boards.platforms import mnt_rkx7 from litex.soc.cores.clock import * from litex.soc.integration.soc_core import * from litex.soc.integration.soc import SoCRegion from litex.soc.integration.builder import * from litex.soc.interconnect.csr import * from litex.soc.interconnect.axi import * from litex.soc.interconnect.wishbone import * from litex.soc.cores.bitbang import I2CMaster from litex.soc.cores.gpio import GPIOOut from litex.soc.cores.video import VideoDVIPHY from litex.soc.cores.usb_ohci import USBOHCI from migen.fhdl.specials import Tristate from litedram.modules import IS43TR16512B from litedram.phy import s7ddrphy from liteeth.phy.s7rgmii import LiteEthPHYRGMII # CRG ---------------------------------------------------------------------------------------------- class _CRG(LiteXModule): def __init__(self, platform, sys_clk_freq): self.rst = Signal() self.cd_sys = ClockDomain() self.cd_sys4x = ClockDomain() self.cd_idelay = ClockDomain() self.cd_dvi = ClockDomain(reset_less=True) self.cd_usb = ClockDomain() clkin = platform.request("clk100") self.pll = pll = S7MMCM(speedgrade=-2) self.comb += pll.reset.eq(self.rst) # Main clock input (100MHz) pll.register_clkin(clkin, 100e6) pll.create_clkout(self.cd_sys, sys_clk_freq) pll.create_clkout(self.cd_sys4x, 4*sys_clk_freq) pll.create_clkout(self.cd_idelay, 200e6) # Ignore sys_clk to pll.clkin path created by SoC's rst. platform.add_false_path_constraints(self.cd_sys.clk, pll.clkin) # USB clock pll.create_clkout(self.cd_usb, 48e6) self.pll2 = pll2 = S7MMCM(speedgrade=-2) self.comb += pll2.reset.eq(self.rst) pll2.register_clkin(clkin, 100e6) # DVI/HDMI pixel clock pll2.create_clkout(self.cd_dvi, 80e6) # display wants 162e6, but we can underclock platform.add_false_path_constraints(self.cd_sys.clk, pll2.clkin) self.idelayctrl = S7IDELAYCTRL(self.cd_idelay) # BaseSoC ------------------------------------------------------------------------------------------ class BaseSoC(SoCCore): mem_map = {**SoCCore.mem_map, **{ # FIXME: ends up as 0x7f000000 in linux "video_framebuffer": 0x3f000000, "usb_ohci": 0xc0000000, }} def __init__(self, sys_clk_freq=int(100e6), with_ethernet=True, with_etherbone=False, with_spi_flash=True, with_usb_host=False, **kwargs): platform = mnt_rkx7.Platform() # CRG -------------------------------------------------------------------------------------- self.crg = _CRG(platform, sys_clk_freq) # SoCCore ---------------------------------------------------------------------------------- SoCCore.__init__(self, platform, sys_clk_freq, ident="LiteX SoC on MNT-RKX7", **kwargs) # DDR3 SDRAM ------------------------------------------------------------------------------- if not self.integrated_main_ram_size: self.ddrphy = s7ddrphy.K7DDRPHY(platform.request("ddram"), memtype = "DDR3", nphases = 4, sys_clk_freq = sys_clk_freq) self.add_sdram("sdram", phy = self.ddrphy, module = IS43TR16512B(sys_clk_freq, "1:4"), size = 0x40000000, l2_cache_size = kwargs.get("l2_size", 8192), # TBD: is L2 really necessary? ) # SPI Flash -------------------------------------------------------------------------------- if with_spi_flash: from litespi.modules import W25Q128JV from litespi.opcodes import SpiNorFlashOpCodes as Codes self.add_spi_flash(mode="4x", module=W25Q128JV(Codes.READ_1_1_4), rate="1:1", with_master=True) # Ethernet / Etherbone --------------------------------------------------------------------- if with_ethernet or with_etherbone: self.ethphy = LiteEthPHYRGMII( clock_pads = self.platform.request("eth_clocks"), pads = self.platform.request("eth")) platform.add_platform_command("set_property CLOCK_DEDICATED_ROUTE FALSE [get_nets {{main_ethphy_eth_rx_clk_ibuf}}]") platform.add_platform_command("set_property CLOCK_DEDICATED_ROUTE FALSE [get_nets {{soclinux_ethphy_eth_rx_clk_ibuf}}]") if with_ethernet: self.add_ethernet(phy=self.ethphy, dynamic_ip=True, software_debug=False) if with_etherbone: self.add_etherbone(phy=self.ethphy) # GPIO ------------------------------------------------------------------------------------- # Controllable as faux "leds" # These are reset pins of various chips # We toggle them in LiteX BIOS reset_signals = platform.request("resets") self.comb += reset_signals.eq(Signal(6, reset=0b111111)) gpio_signals = platform.request("gpio") self.leds = GPIOOut(gpio_signals) # Additional I2C Ports --------------------------------------------------------------------- self.i2c0 = I2CMaster(platform.request("i2c", 0)) self.i2c1 = I2CMaster(platform.request("i2c", 1)) self.i2c2 = I2CMaster(platform.request("i2c", 2)) # JTAG ------------------------------------------------------------------------------------- #self.add_jtagbone() # Backlight -------------------------------------------------------------------------------- # Motherboard display connector backlight, currently unused (the new backlight signals # are on the 50pin RGB->eDP connector) backlight = platform.request("backlight") self.comb += backlight.en.eq(Signal(reset=1)) self.comb += backlight.pwm.eq(Signal(reset=1)) # eDP -------------------------------------------------------------------------------------- video_timings = ("1920x1080@rkx7", { "pix_clk" : 162e6, "h_active" : 1920, "h_blanking" : 159, # off by one in vtg "h_sync_offset" : 40, "h_sync_width" : 40, "v_active" : 1080, "v_blanking" : 32, "v_sync_offset" : 4, "v_sync_width" : 4, }) self.videophy = VideoDVIPHY(platform.request("edp"), clock_domain="dvi") self.add_video_framebuffer(phy=self.videophy, timings=video_timings, clock_domain="dvi") # HDMI ------------------------------------------------------------------------------------- # Untested: 2x VideoDVIPHYs and framebuffers in parallel #self.videophy = VideoDVIPHY(platform.request("hdmi"), clock_domain="dvi") # USB Host --------------------------------------------------------------------------------- if with_usb_host: self.usb_ohci = USBOHCI(platform, platform.request("usb")) self.bus.add_slave("usb_ohci_ctrl", self.usb_ohci.wb_ctrl, region=SoCRegion(origin=self.mem_map["usb_ohci"], size=0x100000, cached=False)) self.dma_bus.add_master("usb_ohci_dma", master=self.usb_ohci.wb_dma) self.comb += self.cpu.interrupt[16].eq(self.usb_ohci.interrupt) # LiteScope UART self.add_uartbone(name="litescope_serial") # LiteScope Analyzer (optional) # analyzer_signals = [ # ulpi_data.din, # utmi.linestate, # utmi.txvalid, # utmi.rxerror, # utmi.rxvalid, # usb_ulpi.dir, # usb_ulpi.stp, # usb_ulpi.nxt, # usbh_dbg_state, # ulpi_dbg_state, # usb_host_intr, # usb_host_dbg_intr, # ] # from litescope import LiteScopeAnalyzer # self.analyzer = LiteScopeAnalyzer(analyzer_signals, # depth = 256, # clock_domain = "ulpi", # csr_csv = "analyzer.csv") # Build -------------------------------------------------------------------------------------------- def main(): from litex.soc.integration.soc import LiteXSoCArgumentParser parser = LiteXSoCArgumentParser(description="LiteX SoC on MNT-RKX7") target_group = parser.add_argument_group(title="Target options") target_group.add_argument("--build", action="store_true", help="Build design.") target_group.add_argument("--load", action="store_true", help="Load bitstream.") target_group.add_argument("--sys-clk-freq", default=100e6, help="System clock frequency.") target_group.add_argument("--with-spi-flash", action="store_true", default=True, help="Enable SPI Flash (MMAPed).") target_group.add_argument("--with-usb-host", action="store_true", default=False, help="Enable USB host support.") sdopts = target_group.add_mutually_exclusive_group() sdopts.add_argument("--with-spi-sdcard", action="store_true", help="Enable SPI-mode SDCard support.") sdopts.add_argument("--with-sdcard", action="store_true", default=True, help="Enable SDCard support.") ethopts = target_group.add_mutually_exclusive_group() ethopts.add_argument("--with-ethernet", action="store_true", default=True, help="Enable Ethernet support.") ethopts.add_argument("--with-etherbone", action="store_true", help="Enable Etherbone support.") builder_args(parser) soc_core_args(parser) args = parser.parse_args() soc = BaseSoC( sys_clk_freq = int(float(args.sys_clk_freq)), with_ethernet = args.with_ethernet, with_etherbone = args.with_etherbone, with_spi_flash = args.with_spi_flash, with_usb_host = args.with_usb_host, **soc_core_argdict(args) ) if args.with_spi_sdcard: soc.add_spi_sdcard() if args.with_sdcard: soc.add_sdcard() args.csr_csv="csr.csv" builder = Builder(soc, **builder_argdict(args)) if args.build: builder.build() if args.load: prog = soc.platform.create_programmer() prog.load_bitstream(builder.get_bitstream_filename(mode="sram")) if __name__ == "__main__": main()