From 3ea7ef81a96f498e5560c1d27329777e2d69b828 Mon Sep 17 00:00:00 2001 From: "William D. Jones" Date: Sat, 20 Jun 2015 18:47:24 -0400 Subject: [PATCH] Add Mercury dev board to mibuild (http://www.micro-nova.com/mercury/) --- mibuild/platforms/mercury.py | 146 +++++++++++++++++++++++++++++++++++ 1 file changed, 146 insertions(+) create mode 100644 mibuild/platforms/mercury.py diff --git a/mibuild/platforms/mercury.py b/mibuild/platforms/mercury.py new file mode 100644 index 000000000..fa294bcf8 --- /dev/null +++ b/mibuild/platforms/mercury.py @@ -0,0 +1,146 @@ +# This file is Copyright (c) 2015 William D. Jones +# License: BSD + +from mibuild.generic_platform import * +from mibuild.xilinx import XilinxPlatform +from mibuild.xilinx.programmer import XC3SProg + + +_io = [ + ("clk50", 0, Pins("P43"), IOStandard("LVCMOS33")), + + ("user_btn", 0, Pins("P41"), IOStandard("LVTTL")), + + # The serial interface and flash memory have a shared SPI bus. + # FPGA is secondary + ("spiserial", 0, + Subsignal("cs_n", Pins("P39"), IOStandard("LVTTL")), + Subsignal("clk", Pins("P53"), IOStandard("LVTTL")), + Subsignal("mosi", Pins("P46"), IOStandard("LVTTL")), + Subsignal("miso", Pins("P51"), IOStandard("LVTTL")) + ), + + # FPGA is primary + ("spiflash", 0, + Subsignal("cs_n", Pins("P27"), IOStandard("LVTTL")), + Subsignal("clk", Pins("P53"), IOStandard("LVTTL")), + Subsignal("mosi", Pins("P46"), IOStandard("LVTTL")), + Subsignal("miso", Pins("P51"), IOStandard("LVTTL")) + ), + + ("spiflash2x", 0, + Subsignal("cs_n", Pins("P27")), + Subsignal("clk", Pins("P53")), + Subsignal("dq", Pins("P46", "P51")), + IOStandard("LVTTL"), Misc("SLEW=FAST") + ), + + # ADC over SPI- FPGA is primary + ("adc", 0, + Subsignal("cs_n", Pins("P12"), IOStandard("LVTTL")), + Subsignal("clk", Pins("P9"), IOStandard("LVTTL")), + Subsignal("mosi", Pins("P10"), IOStandard("LVTTL")), + Subsignal("miso", Pins("P21"), IOStandard("LVTTL")) + ), + + # GPIO control- SRAM and connectors are shared: these pins control how + # to access each. Recommended to combine with gpio_sram_bus extension, + # since these pins are related but not exposed on connectors. + ("gpio_ctl", 0, + Subsignal("ce_n", Pins("P3")), # Memory chip-enable. Called MEM_CEN + # in schematic. + Subsignal("bussw_oe_n", Pins("P30")), # 5V tolerant GPIO is shared + # w/ memory using this pin. + IOStandard("LVTTL"), Misc("SLEW=FAST") + ) +] + +# Perhaps define some connectors as having a specific purpose- i.e. a 5V GPIO +# bus with data, peripheral-select, and control signals? +_connectors = [ + ("GPIO", """P59 P60 P61 P62 P64 P57 + P56 P52 P50 P49 P85 P84 + P83 P78 P77 P65 P70 P71 + P72 P73 P5 P4 P6 P98 + P94 P93 P90 P89 P88 P86"""), # 5V I/O- LVTTL + ("DIO", "P20 P32 P33 P34 P35 P36 P37"), # Fast 3.3V IO (Directly attached + # to FPGA)- LVCMOS33 + ("CLKIO", "P40 P44"), # Clock IO (Can be used as GPIO)- LVCMOS33 + ("INPUT", "P68 P97 P7 P82"), # Input-only pins- LVCMOS33 + ("LED", "P13 P15 P16 P19") # LEDs can be used as pins as well- LVTTL. +] + +# Some default useful extensions- use platform.add_extension() to use, e.g. +# from mibuild.platforms import mercury +# plat = mercury.Platform() +# plat.add_extension(mercury.gpio_sram) + +# SRAM and 5V-tolerant I/O share a parallel bus on 200k gate version. The SRAM +# controller needs to take care of switching the bus between the two. Meant to +# be Cat() into one GPIO bus, and combined with gpio_ctl. +gpio_sram = [ + ("gpio_sram_bus", 0, + Subsignal("a", Pins("""GPIO:0 GPIO:1 GPIO:2 GPIO:3 + GPIO:4 GPIO:5 GPIO:6 GPIO:7 + GPIO:8 GPIO:9 GPIO:10 GPIO:11 + GPIO:12 GPIO:13 GPIO:14 GPIO:15 + GPIO:16 GPIO:17 GPIO:18 GPIO:19""")), + # A19 is actually unused- free for GPIO + # 8-bit data bus + Subsignal("d", Pins("""GPIO:20 GPIO:21 GPIO:22 GPIO:23 + GPIO:24 GPIO:25 GPIO:26 GPIO:27""")), + Subsignal("we_n", Pins("GPIO:28")), + Subsignal("unused", Pins("GPIO:29")), # Only used by GPIO. + # Subsignal("oe_n", Pins()), # If OE wasn't tied to ground on Mercury, + # this pin would be here. + IOStandard("LVTTL"), Misc("SLEW=FAST") + ) +] + +# The "serial port" is in fact over SPI. The creators of the board provide a +# VHDL file for talking over this interface. In light of space constraints and +# the fact that both the FT245RL and FPGA can BOTH be SPI primaries, however, +# it may be necessary to sacrifice two "high-speed" (DIO, INPUT) pins instead. +serial = [ + ("serial", 0, + Subsignal("tx", Pins("DIO:0"), IOStandard("LVCMOS33")), # FTDI D1 + Subsignal("rx", Pins("INPUT:0"), IOStandard("LVCMOS33")) + ) # FTDI D0 +] + +leds = [ + ("user_led", 0, Pins("LED:0"), IOStandard("LVTTL")), + ("user_led", 1, Pins("LED:1"), IOStandard("LVTTL")), + ("user_led", 2, Pins("LED:2"), IOStandard("LVTTL")), + ("user_led", 3, Pins("LED:3"), IOStandard("LVTTL")) +] + +# See: http://www.micro-nova.com/mercury-baseboard/ +# Not implemented yet. +baseboard = [ +] + + +class Platform(XilinxPlatform): + default_clk_name = "clk50" + default_clk_period = 20 + + def __init__(self, device="xc3s200a-4-vq100", programmer="xc3sprog"): + XilinxPlatform.__init__(self, device, _io, _connectors) + # Small device- optimize for AREA instead of SPEED (LM32 runs at about + # 60-65MHz in AREA configuration). + self.toolchain.xst_opt = """-ifmt MIXED +-use_new_parser yes +-opt_mode AREA +-register_balancing yes""" + + def create_programmer(self): + raise NotImplementedError + # Not actually supported right now- add FT245RL support to xc3sprog. + # Alternatively, use the JTAG pins instead of USB with another + # supported programmer. + if self.programmer == "xc3sprog": + return XC3SProg("mercury", "bscan_spi_mercury.bit") + else: + raise ValueError("""{} programmer is not + supported""".format(programmer))