aboutsummaryrefslogtreecommitdiff
path: root/amaranth_boards/tang_primer_20k.py
diff options
context:
space:
mode:
Diffstat (limited to 'amaranth_boards/tang_primer_20k.py')
-rw-r--r--amaranth_boards/tang_primer_20k.py269
1 files changed, 269 insertions, 0 deletions
diff --git a/amaranth_boards/tang_primer_20k.py b/amaranth_boards/tang_primer_20k.py
new file mode 100644
index 0000000..86f100f
--- /dev/null
+++ b/amaranth_boards/tang_primer_20k.py
@@ -0,0 +1,269 @@
+import os
+import subprocess
+
+from amaranth.build import *
+from amaranth.vendor import GowinPlatform
+
+from .resources import *
+
+
+__all__ = [
+ "TangPrimer20kPlatform",
+ "TangPrimer20kLitePlatform",
+ "TangPrimer20kDockPlatform",
+]
+
+
+class TangPrimer20kPlatform(GowinPlatform):
+ part = "GW2A-LV18PG256C8/I7"
+ family = "GW2A-18C"
+ default_clk = "clk27"
+ resources = [
+ Resource("clk27", 0, Pins("H11", dir="i"),
+ Clock(27e6), Attrs(IO_TYPE="LVCMOS33")),
+
+ UARTResource(0, rx="T13", tx="M11",
+ attrs=Attrs(PULL_MODE="UP", IO_TYPE="LVCMOS33")),
+
+ *SPIFlashResources(0, cs_n="M9", clk="L10", cipo="P10", copi="R10",
+ attrs=Attrs(IO_TYPE="LVCMOS33")),
+
+ *SDCardResources(0, clk="N10", cmd="R14", cd="D15",
+ dat0="M8", dat1="M7", dat2="M10", dat3="N11",
+ attrs=Attrs(IO_TYPE="LVCMOS33")),
+
+ DDR3Resource(0, rst_n="B9", clk_p="J1", clk_n="J3", clk_en="J2",
+ cs_n="P5", we_n="L2", ras_n="R4", cas_n="R6",
+ a="F7 A4 D6 F8 C4 E6 B1 D8 A5 F9 K3 B7 A3 C8",
+ ba="H4 D3 H5", dqs_p="G2 J5", dqs_n="G3 K6",
+ dq="G5 F5 F4 F3 E2 C1 E1 B3 M3 K4 N2 L1 P4 H3 R1 M2",
+ dm="G1 K5", odt="R3",
+ attrs=Attrs(IO_TYPE="SSTL15"),
+ diff_attrs=Attrs(IO_TYPE="SSTL15D")),
+
+ # ZIF connector on core board
+ Resource("spi_lcd", 0,
+ Subsignal("bl", PinsN("P12", dir="o")),
+ Subsignal("rst", PinsN("G13", dir="o")),
+ Subsignal("rs", Pins("J13", dir="o")),
+ Subsignal("cs", PinsN("C16", dir="o")),
+ Subsignal("clk", Pins("F12", dir="o")),
+ Subsignal("copi", Pins("L15", dir="o")),
+ Attrs(IO_TYPE="LVCMOS33")),
+ ]
+
+ connectors = [
+ # GND, 5V, 3V3 are power pins
+ # V01 and V7 are IO bank voltages, tied to 3V3 by R5 and R9 (resp.)
+ Connector("sodimm", 0,
+ # GND GND 5V 5V 5V 5V GND GND NC ( 1- 10)
+ " T13 - - - - - - - - - "
+ # NC GND GND NC NC NC GND GND ( 11- 20)
+ " M11 - - - T10 - - - - - "
+ # NC 3V3 NC 3V3 GND GND ( 21- 30)
+ " - - - - - - T6 R16 P6 P16"
+ # GND GND GND GND ( 31- 40)
+ " - - T7 P16 R8 N15 - - T8 N16"
+ # GND GND GND ( 41- 50)
+ " P8 N14 - L16 T9 L14 P9 - - K15"
+ # GND GND GND ( 51- 60)
+ " P11 K14 T11 - - K16 R11 J15 T12 - "
+ # GND GND ( 61- 70)
+ " - H16 R12 H14 P13 - R13 G16 T14 H15"
+ # GND GND ( 71- 80)
+ " - - M15 L13 M14 K11 F13 K12 G12 K13"
+ # NC NC NC ( 81- 90)
+ " T15 - J16 H13 J14 J12 - - G14 H12"
+ # NC NC NC NC ( 91-100)
+ " G15 G11 - - F14 B10 F16 A13 - - "
+ # NC NC NC NC NC NC (101-110)
+ "E15 - D14 - - - A15 - B14 - "
+ # NC NC NC NC NC NC NC (111-120)
+ " - - A14 - B13 - - - C12 - "
+ # NC NC NC GND GND (121-130)
+ " B12 - A12 - C11 - - - B11 E16"
+ # GND GND NC GND GND (131-140)
+ " A11 F15 - - C10 C13 - - - D16"
+ # NC GND GND GND (141-150)
+ " - E14 B8 - - C9 C6 A9 A7 - "
+ # GND GND GND (151-160)
+ " - L12 A6 J11 - - C7 E9 D7 E8 "
+ # GND GND V01 V01 GND GND V7 (161-170)
+ " - - T2 - T3 - - - T4 - "
+ # GND GND V7 GND GND (171-180)
+ " T5 - - - N6 F10 N7 - - D11"
+ # GND GND NC NC GND GND (181-190)
+ " N9 D10 R9 - - E10 - - - - "
+ # GND GND NC NC (191-200)
+ " N8 R7 L9 P7 - - - M6 - L8 "
+ # NC NC NC NC (201-204)
+ " - - - - "
+ )
+ ]
+
+ def toolchain_prepare(self, fragment, name, **kwargs):
+ overrides = {
+ "add_options":
+ "set_option -use_mspi_as_gpio 1 -use_sspi_as_gpio 1"
+ " -use_ready_as_gpio 1 -use_done_as_gpio 1",
+ "gowin_pack_opts":
+ "--mspi_as_gpio --sspi_as_gpio --ready_as_gpio --done_as_gpio",
+ }
+ return super().toolchain_prepare(fragment, name, **overrides, **kwargs)
+
+ def toolchain_program(self, products, name):
+ with products.extract("{}.fs".format(name)) as bitstream_filename:
+ subprocess.check_call(
+ ["openFPGALoader", "-b", "tangprimer20k", bitstream_filename])
+
+
+class TangPrimer20kLitePlatform(TangPrimer20kPlatform):
+ resources = TangPrimer20kPlatform.resources + [
+ *ButtonResources(pins={0: "T10"}, invert=True,
+ attrs=Attrs(IO_TYPE="LVCMOS33")),
+ *ButtonResources(pins={1: "T2"}, invert=True,
+ attrs=Attrs(IO_TYPE="LVCMOS15")),
+
+ *SwitchResources(pins="D7 C7",
+ attrs=Attrs(PULL_MODE="NONE", IO_TYPE="LVCMOS15")),
+ ]
+
+ connectors = TangPrimer20kPlatform.connectors + [
+ # top left, top right, bottom left, bottom right
+ Connector("pmod", 0, "L8 P7 E10 D11 - - M6 R7 D10 F10 - -"),
+ Connector("pmod", 1, "T6 T7 T8 T9 - - P6 R8 P8 P9 - -"),
+ Connector("pmod", 2, "F15 D16 C9 L12 - - E16 E14 A9 J11 - -"),
+ Connector("pmod", 3, "R16 P16 N16 L16 - - P15 N15 N14 L14 - -"),
+
+ # 0 on top, 1 on bottom, odd/even rows
+ Connector("gpio", 0,
+ " - - N6 N7 B11 A12 L9 N8 R9 N9 " # ( 1-10)
+ "A6 A7 C6 B8 C10 - A11 C11 B12 C12" # (11-20)
+ "B13 A14 B14 A15 D14 E15 F16 F14 G15 G14" # (21-30)
+ "J14 J16 G12 F13 M14 M15 T14 R13 P13 R12" # (31-40)
+ ),
+ Connector("gpio", 1,
+ " - - - - - - T5 - T3 T4 " # ( 1-10)
+ " - - E9 E8 T15 C13 T13 M11 B10 A13" # (11-20)
+ "H12 G11 H13 J12 K12 K13 L13 K11 R11 T12" # (21-30)
+ "P11 T11 G16 H15 H16 H14 K16 J15 K15 K14" # (31-40)
+ ),
+ ]
+
+
+class TangPrimer20kDockPlatform(TangPrimer20kPlatform):
+ resources = TangPrimer20kPlatform.resources + [
+ *LEDResources(pins="C13 A13 N16 N14 L14 L16", invert=True,
+ attrs=Attrs(IO_TYPE="LVCMOS33")),
+
+ # WS2812 RGB LED
+ Resource("ws2812", 0, Pins("T9", dir="o"),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ *ButtonResources(pins={0: "T10"}, invert=True,
+ attrs=Attrs(IO_TYPE="LVCMOS33")),
+ *ButtonResources(pins={1: "T3", 2: "T2", 3: "D7", 4: "C7"}, invert=True,
+ attrs=Attrs(IO_TYPE="LVCMOS15")),
+
+ *SwitchResources(pins={0: "B10"},
+ attrs=Attrs(PULL_MODE="DOWN", IO_TYPE="LVCMOS33")),
+ *SwitchResources(pins={1: "E9", 2: "E8", 3: "T4", 4: "T5"},
+ attrs=Attrs(PULL_MODE="DOWN", IO_TYPE="LVCMOS15")),
+
+ Resource("eth_clk50", 0, Pins("A9", dir="i"),
+ Clock(50e6), Attrs(IO_TYPE="LVCMOS33")),
+ Resource("eth_rmii", 0,
+ Subsignal("rst", PinsN("F10", dir="o")),
+ Subsignal("mdio", Pins("F16", dir="io")),
+ Subsignal("mdc", Pins("F14", dir="o")),
+ Subsignal("tx_en", Pins("E16", dir="o")),
+ Subsignal("tx_data", Pins("D16 E14", dir="o")),
+ Subsignal("rx_crs", Pins("M6", dir="i")),
+ Subsignal("rx_er", Pins("L8" , dir="i")),
+ Subsignal("rx_data", Pins("F15 C9", dir="i")),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ ULPIResource(0, data="G11 H12 J12 H13 T14 R13 P13 R12",
+ clk="T15", dir="K12", nxt="K13", stp="K11",
+ rst="F10", rst_invert=True,
+ attrs=Attrs(PULL_MODE="NONE", IO_TYPE="LVCMOS33")),
+
+ Resource("hdmi", 0,
+ Subsignal("clk", DiffPairs(p="G16", n="H15", dir="o")),
+ Subsignal("d", DiffPairs(p="H14 J15 K14", n="H16 K16 K15", dir="o")),
+ Subsignal("hdp", Pins("J11", dir="i"),
+ Attrs(IO_TYPE="LVCMOS33")),
+ Subsignal("cec", Pins("L12", dir="io"),
+ Attrs(IO_TYPE="LVCMOS33")),
+ Subsignal("sda", Pins("F14", dir="io"),
+ Attrs(IO_TYPE="LVCMOS33")),
+ Subsignal("scl", Pins("F16", dir="io"),
+ Attrs(IO_TYPE="LVCMOS33")),
+ Attrs(PULL_MODE="NONE")),
+
+ # labeled DISPLAY or RGB LCD
+ Resource("lcd", 0,
+ Subsignal("bl", Pins("E10", dir="o")),
+ Subsignal("clk", Pins("R9", dir="o")),
+ Subsignal("de", Pins("E15", dir="o")),
+ Subsignal("hs", PinsN("A15", dir="o")),
+ Subsignal("vs", PinsN("D14", dir="o")),
+ Subsignal("r", Pins("L9 N8 N9 N7 N6", dir="o")),
+ Subsignal("g", Pins("D11 A11 B11 P7 R7 D10", dir="o")),
+ Subsignal("b", Pins("B12 C12 B13 A14 B14", dir="o")),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ # labeled CAM or DVP
+ Resource("dvp", 0,
+ Subsignal("d",
+ Pins("T12 T11 P11 R11 M15 M14 J16 J14", dir="i")),
+ Subsignal("scl", Pins("F14", dir="io")),
+ Subsignal("sda", Pins("F16", dir="io")),
+ Subsignal("pclk", Pins("F13", dir="i")),
+ Subsignal("xclk", Pins("G12", dir="o")),
+ Subsignal("rst", PinsN("L13", dir="o")),
+ Subsignal("vs", Pins("G15", dir="i")),
+ Subsignal("pwdn", Pins("C10", dir="o")),
+ Subsignal("hs", Pins("G14", dir="i")),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ # labeled TP or CTP
+ Resource("lcd_touch", 0,
+ Subsignal("sda", Pins("F14", dir="io")),
+ Subsignal("scl", Pins("F16", dir="io")),
+ Subsignal("int", Pins("C11", dir="i")),
+ Subsignal("rst", PinsN("A12", dir="o")),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ # labeled GPIO or MIC ARRAY
+ Resource("mic_i2s", 0,
+ Subsignal("sd", Pins("P8 T8 R8 T7", dir="i")),
+ Subsignal("ws", Pins("P6", dir="i")),
+ Subsignal("clk", Pins("T6", dir="i")),
+ Attrs(IO_TYPE="LVCMOS33")),
+ Resource("mic_led", 0,
+ Subsignal("clk", Pins("P9", dir="o")),
+ Subsignal("dat", Pins("T9", dir="o")),
+ Attrs(IO_TYPE="LVCMOS33")),
+
+ # 3.5mm audio via PT8211
+ Resource("dac_i2s", 0,
+ Subsignal("sd", Pins("P15", dir="o")),
+ Subsignal("ws", Pins("P16", dir="o")),
+ Subsignal("clk", Pins("N15", dir="o")),
+ Subsignal("pa_en", Pins("R16", dir="o")),
+ Attrs(PULL_MODE="UP", IO_TYPE="LVCMOS33"))
+ ]
+
+ connectors = TangPrimer20kPlatform.connectors + [
+ # top left to top right
+ Connector("pmod", 0, "B11 D11 N7 N8 - - A11 N6 N9 L9 - -"),
+ Connector("pmod", 1, "E15 A15 A14 C12 - - D14 B14 B13 B12 - -"),
+ Connector("pmod", 2, "P11 R11 M15 J16 - - T11 T12 M14 J14 - -"),
+ Connector("pmod", 3, "P6 T7 P8 T9 - - T6 R8 T8 P9 - -"),
+ ]
+
+
+if __name__ == "__main__":
+ from .test.blinky import *
+ TangPrimer20kDockPlatform().build(Blinky(), do_program=True)
generated by cgit v1.2.3 (git 2.25.1) at 2025-12-26 15:08:53 +0000