nmigen_boards/atlys.py

   1 import subprocess
   2 import textwrap
   3
   4 from nmigen.build import *
   5 from nmigen.vendor.xilinx_spartan_3_6 import *
   6 from .resources import *
   7
   8
   9 __all__ = ["AtlysPlatform"]
  10
  11
  12 class AtlysPlatform(XilinxSpartan6Platform):
  13     """Platform file for Digilent Atlys Spartan 6 board.
  14     https://reference.digilentinc.com/reference/programmable-logic/atlys/start"""
  15
  16     device  = "xc6slx45"
  17     package = "csg324"
  18     speed   = "3"
  19
  20     def __init__(self, *, JP12="2V5", **kwargs):
  21         super().__init__(**kwargs)
  22
  23         assert JP12 in ["2V5", "3V3"]
  24         self._JP12 = JP12
  25
  26     def bank2_iostandard(self):
  27         return "LVCMOS25" if self._JP12 == "2V5" else "LVCMOS33"
  28
  29     default_clk = "clk100"
  30     default_rst = "rst"
  31     resources   = [
  32         Resource("rst",    0, PinsN("T15", dir="i"), Attrs(IOSTANDARD=bank2_iostandard)), # RESET
  33         Resource("clk100", 0, Pins("L15",  dir="i"),
  34                  Clock(100e6), Attrs(IOSTANDARD="LVCMOS33")),                             # GCLK
  35
  36         Resource("led",    0, Pins("U18",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD0
  37         Resource("led",    1, Pins("M14",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD1
  38         Resource("led",    2, Pins("N14",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD2
  39         Resource("led",    3, Pins("L14",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD3
  40         Resource("led",    4, Pins("M13",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD4
  41         Resource("led",    5, Pins("D4",   dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD5
  42         Resource("led",    6, Pins("P16",  dir="o"), Attrs(IOSTANDARD="LVCMOS33")),       # LD6
  43         Resource("led",    7, Pins("N12",  dir="o"), Attrs(IOSTANDARD=bank2_iostandard)), # LD7
  44
  45         Resource("button", 0, Pins("N4",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # BTNU
  46         Resource("button", 1, Pins("P4",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # BTNL
  47         Resource("button", 2, Pins("P3",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # BTND
  48         Resource("button", 3, Pins("F6",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # BTNR
  49         Resource("button", 4, Pins("F5",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # BTNC
  50
  51         Resource("switch", 0, Pins("A10",  dir="i"), Attrs(IOSTANDARD="LVCMOS33")),       # SW0
  52         Resource("switch", 1, Pins("D14",  dir="i"), Attrs(IOSTANDARD="LVCMOS33")),       # SW1
  53         Resource("switch", 2, Pins("C14",  dir="i"), Attrs(IOSTANDARD="LVCMOS33")),       # SW2
  54         Resource("switch", 3, Pins("P15",  dir="i"), Attrs(IOSTANDARD="LVCMOS33")),       # SW3
  55         Resource("switch", 4, Pins("P12",  dir="i"), Attrs(IOSTANDARD=bank2_iostandard)), # SW4
  56         Resource("switch", 5, Pins("R5",   dir="i"), Attrs(IOSTANDARD=bank2_iostandard)), # SW5
  57         Resource("switch", 6, Pins("T5",   dir="i"), Attrs(IOSTANDARD=bank2_iostandard)), # SW6
  58         Resource("switch", 7, Pins("E4",   dir="i"), Attrs(IOSTANDARD="LVCMOS18")),       # SW7
  59
  60         UARTResource(0, rx="A16", tx="B16", attrs=Attrs(IOSTANDARD="LVCMOS33")), # J17/UART
  61
  62         Resource("ps2", 0, # PS/2 keyboard interface converted from J13 "HOST" USB connector
  63             Subsignal("clk",    Pins("P17", dir="i")),
  64             Subsignal("dat",    Pins("N15", dir="io")),
  65             Attrs(IOSTANDARD="LVCMOS33"),
  66         ),
  67         Resource("ps2", 1, # PS/2 mouse interface converted from J13 "HOST" USB connector
  68             Subsignal("clk",    Pins("N18", dir="i")),
  69             Subsignal("dat",    Pins("P18", dir="io")),
  70             Attrs(IOSTANDARD="LVCMOS33"),
  71         ),
  72
  73         *SPIFlashResources(0,
  74             cs="AE14", clk="AH18", mosi="AF14", miso="AF20", wp="AG21", hold="AG17",
  75             attrs=Attrs(IOSTANDARD="LVCMOS25", SLEW="FAST"),
  76         ),
  77
  78         Resource("ddr2", 0,
  79             Subsignal("clk",    DiffPairs("G3", "G1", dir="o"),
  80                                 Attrs(IOSTANDARD="DIFF_SSTL18_II", IN_TERM="NONE")),
  81             Subsignal("clk_en", Pins("H7", dir="o")),
  82             Subsignal("we",     PinsN("E3", dir="o")),
  83             Subsignal("ras",    PinsN("L5", dir="o")),
  84             Subsignal("cas",    PinsN("K5", dir="o")),
  85             Subsignal("a",      Pins("J7 J6 H5 L7 F3 H4 H3 H6 D2 D1 F4 D3 G6", dir="o")),
  86             Subsignal("ba",     Pins("F2 F1 E1", dir="o")),
  87             Subsignal("dqs",    DiffPairs("P2 L4", "P1 L3", dir="o"),
  88                                 Attrs(IOSTANDARD="DIFF_SSTL18_II")),
  89             Subsignal("dq",     Pins("L2 L1 K2 K1 H2 H1 J3 J1 M3 M1 N2 N1 T2 T1 U2 U1", dir="io")),
  90             Subsignal("dm",     Pins("K4 K3", dir="o")),
  91             Subsignal("odt",    Pins("K6", dir="o")),
  92             Attrs(IOSTANDARD="SSTL18_II", SLEW="FAST"),
  93         ),
  94
  95         Resource("eth_gmii", 0,
  96             Subsignal("rst",     PinsN("G13", dir="o")),
  97             Subsignal("int",     PinsN("L16", dir="o")),
  98             Subsignal("mdio",    Pins("N17", dir="io")),
  99             Subsignal("mdc",     Pins("F16", dir="o")), # Max 8.3MHz
 100             Subsignal("gtx_clk", Pins("L12", dir="o")),
 101             Subsignal("tx_clk",  Pins("K16", dir="i")),
 102             Subsignal("tx_en",   Pins("H15", dir="o")),
 103             Subsignal("tx_er",   Pins("G18", dir="o")),
 104             Subsignal("tx_data", Pins("H16 H13 K14 K13 J13 G14 H12 K12", dir="o")),
 105             Subsignal("rx_clk",  Pins("K15", dir="i")),
 106             Subsignal("rx_dv",   Pins("F17", dir="i"), Attrs(PULLDOWN="TRUE")),
 107             Subsignal("rx_er",   Pins("F18", dir="i")),
 108             Subsignal("rx_data", Pins("G16 H14 E16 F15 F14 E18 D16 D17", dir="i")),
 109             Subsignal("col",     Pins("C17", dir="i")),
 110             Subsignal("crs",     Pins("C18", dir="i")),
 111             Attrs(IOSTANDARD="LVCMOS33")
 112         ),
 113         Resource("eth_rgmii", 0,
 114             Subsignal("rst",     PinsN("G13", dir="o")),
 115             Subsignal("int",     PinsN("L16", dir="o")),
 116             Subsignal("mdio",    Pins("N17", dir="io")),
 117             Subsignal("mdc",     Pins("F16", dir="o")), # Max 8.3MHz
 118             Subsignal("tx_clk",  Pins("L12", dir="o")),
 119             Subsignal("tx_ctl",  Pins("H15", dir="o")),
 120             Subsignal("tx_data", Pins("H16 H13 K14 K13", dir="o")),
 121             Subsignal("rx_clk",  Pins("K15", dir="i")),
 122             Subsignal("rx_ctl",  Pins("F17", dir="i"), Attrs(PULLDOWN="TRUE")),
 123             Subsignal("rx_data", Pins("G16 H14 E16 F15", dir="i")),
 124             Attrs(IOSTANDARD="LVCMOS33")
 125         ),
 126         Resource("eth_mii", 0,
 127             Subsignal("rst",     PinsN("G13", dir="o")),
 128             Subsignal("int",     PinsN("L16", dir="o")),
 129             Subsignal("mdio",    Pins("N17", dir="io")),
 130             Subsignal("mdc",     Pins("F16", dir="o")), # Max 8.3MHz
 131             Subsignal("tx_clk",  Pins("K16", dir="i")),
 132             Subsignal("tx_en",   Pins("H15", dir="o")),
 133             Subsignal("tx_er",   Pins("G18", dir="o")),
 134             Subsignal("tx_data", Pins("H16 H13 K14 K13", dir="o")),
 135             Subsignal("rx_clk",  Pins("K15", dir="i")),
 136             Subsignal("rx_dv",   Pins("F17", dir="i"), Attrs(PULLDOWN="TRUE")),
 137             Subsignal("rx_er",   Pins("F18", dir="i")),
 138             Subsignal("rx_data", Pins("G16 H14 E16 F15", dir="i")),
 139             Subsignal("col",     Pins("C17", dir="i")),
 140             Subsignal("crs",     Pins("C18", dir="i")),
 141             Attrs(IOSTANDARD="LVCMOS33")
 142         ),
 143         # Device does not support RMII
 144         Resource("eth_tbi", 0,
 145             Subsignal("rst",     PinsN("G13", dir="o")),
 146             Subsignal("int",     PinsN("L16", dir="o")),
 147             Subsignal("mdio",    Pins("N17", dir="io")),
 148             Subsignal("mdc",     Pins("F16", dir="o")), # Max 8.3MHz
 149             Subsignal("tx_clk",  Pins("L12", dir="o")),
 150             Subsignal("tx_data", Pins("H16 H13 K14 K13 J13 G14 H12 K12 H15 G18", dir="o")),
 151             Subsignal("rx_clk",  Pins("K15 L12", dir="i")),
 152             Subsignal("rx_data", Pins("G16 H14 E16 F15 F14 E18 D16 D17 F17 F18", dir="i")),
 153             Subsignal("lpbk",    Pins("C17", dir="o"), Attrs(PULLDOWN="TRUE")),
 154             Subsignal("comma",   Pins("C18", dir="i")),
 155             Attrs(IOSTANDARD="LVCMOS33")
 156         ),
 157         Resource("eth_rtbi", 0,
 158             Subsignal("rst",     PinsN("G13", dir="o")),
 159             Subsignal("int",     PinsN("L16", dir="o")),
 160             Subsignal("mdio",    Pins("N17", dir="io")),
 161             Subsignal("mdc",     Pins("F16", dir="o")), # Max 8.3MHz
 162             Subsignal("tx_clk",  Pins("L12", dir="o")),
 163             Subsignal("tx_data", Pins("H16 H13 K14 K13 H15", dir="o")),
 164             Subsignal("rx_clk",  Pins("K15", dir="i")),
 165             Subsignal("rx_data", Pins("G16 H14 E16 F15 F17", dir="i")),
 166             Attrs(IOSTANDARD="LVCMOS33")
 167         ),
 168
 169         Resource("hdmi", 0, # J1, input only due to on board buffer, HDMI A connector
 170             Subsignal("scl",     Pins("C13"), Attrs(IOSTANDARD="I2C")),
 171             Subsignal("sda",     Pins("A13"), Attrs(IOSTANDARD="I2C")),
 172             Subsignal("clk",     DiffPairs("D11", "C11", dir="i")),
 173             Subsignal("d",       DiffPairs("G9 B11 B12", "F9 A11 A12", dir="i")),
 174             Attrs(IOSTANDARD="TMDS_33"),
 175         ),
 176         Resource("hdmi", 1, # J2, output only due to on board buffer, HDMI A connector
 177             Subsignal("scl",     Pins("D9"), Attrs(IOSTANDARD="I2C")),
 178             Subsignal("sda",     Pins("C9"), Attrs(IOSTANDARD="I2C")),
 179             Subsignal("clk",     DiffPairs("B6", "A6", dir="o")),
 180             Subsignal("d",       DiffPairs("D8 C7 B8", "C8 A7 A8", dir="o")),
 181             Attrs(IOSTANDARD="TMDS_33"),
 182         ),
 183         Resource("hdmi", 2, # J3, input only due to on board buffer, HDMI A connector
 184             Subsignal("scl",     Pins("M16"), Attrs(IOSTANDARD="I2C")),
 185             Subsignal("sda",     Pins("M18"), Attrs(IOSTANDARD="I2C")),
 186             Subsignal("clk",     DiffPairs("H17", "H18", dir="i")),
 187             Subsignal("d",       DiffPairs("K17 L17 J16", "K18 L18 J18", dir="i")),
 188             Attrs(IOSTANDARD="TMDS_33"),
 189         ),
 190         Resource("hdmi", 3, # JA, input/output as it is unbuffered, HDMI D connector
 191             Subsignal("scl",     Pins("C13"), Attrs(IOSTANDARD="I2C")),
 192             Subsignal("sda",     Pins("A13"), Attrs(IOSTANDARD="I2C")),
 193             Subsignal("clk",     DiffPairs("T9", "V9")),
 194             Subsignal("d",       DiffPairs("R3 T4 N5", "T3 V4 P6")),
 195             Attrs(IOSTANDARD="TMDS_33"),
 196         ),
 197
 198         Resource("ac97", 0,
 199             Subsignal("clk",     Pins("L13", dir="o")),
 200             Subsignal("sync",    Pins("U17", dir="o")),
 201             Subsignal("reset",   Pins("T17", dir="o")),
 202             Subsignal("sdo",     Pins("N18", dir="o")),
 203             Subsignal("sdi",     Pins("T18", dir="i")),
 204             Attrs(IOSTANDARD="LVCMOS33")
 205         ),
 206     ]
 207     connectors  = [
 208         Connector("pmod", 0, "T3 R3 P6 N5 - - V9 T9 V4 T4 - -"), # JB
 209
 210         Connector("vhdci", 0, # JC
 211             "U16 - U15 U13 - M11 R11 - T12 N10 - M10 U11 - R10 - - - - U10 - R8  M8  - U8  U7  - N7  T6  - R7  N6  - U5 "
 212             "V16 - V15 V13 - N11 T11 - V12 P11 - N9  V11 - T10 - - - - V10 - T8  N8  - V8  V7  - P8  V6  - T7  P7  - V5 "
 213         ),
 214     ]
 215
 216     def toolchain_program(self, products, name):
 217         with products.extract("{}.bit".format(name)) as bitfile:
 218             cmd = textwrap.dedent("""
 219                 setMode -bscan
 220                 setCable -port auto
 221                 addDevice -p 1 -file "{}"
 222                 program -p 1
 223                 exit
 224             """).format(bitfile).encode('utf-8')
 225             subprocess.run(["impact", "-batch"], input=cmd, check=True)
 226
 227
 228 if __name__ == "__main__":
 229     from .test.blinky import *
 230     AtlysPlatform().build(Blinky(), do_program=True)