Add Mercury dev board to mibuild (http://www.micro-nova.com/mercury/)

m-labs · Jun 28, 2015 · 3ea7ef8 · 3ea7ef8
1 parent f03c232
commit 3ea7ef8
Showing 1 changed file with 146 additions and 0 deletions.
diff --git a/mibuild/platforms/mercury.py b/mibuild/platforms/mercury.py
@@ -0,0 +1,146 @@
+# This file is Copyright (c) 2015 William D. Jones <thor0505@comcast.net>
+# 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))