258 lines
9.4 KiB
Python
258 lines
9.4 KiB
Python
#
|
|
# This file is part of LiteX-Boards.
|
|
#
|
|
# Copyright (c) 2020 Shinken Sanada <sanadashinken@gmail.com>
|
|
# SPDX-License-Identifier: BSD-2-Clause
|
|
|
|
from litex.build.generic_platform import *
|
|
from litex.build.xilinx import Xilinx7SeriesPlatform
|
|
from litex.build.openocd import OpenOCD
|
|
|
|
# IOs ----------------------------------------------------------------------------------------------
|
|
|
|
# IOs specific to V1 of the board.
|
|
_io_v1 = [
|
|
# Reset (Key1 button).
|
|
("cpu_reset", 0, Pins("J8"), IOStandard("LVCMOS33")),
|
|
|
|
# Clock.
|
|
("clk50" , 0, Pins("M22"), IOStandard("LVCMOS33")),
|
|
|
|
# Leds.
|
|
("user_led", 0, Pins("J6"), IOStandard("LVCMOS33")),
|
|
("user_led", 1, Pins("H6"), IOStandard("LVCMOS33")),
|
|
]
|
|
|
|
# IOs specific to V2 of the board.
|
|
_io_v2 = [
|
|
# Reset (Key1 button).
|
|
("cpu_reset", 0, Pins("M6"), IOStandard("LVCMOS33")),
|
|
|
|
# Clock.
|
|
("clk50" , 0, Pins("M21"), IOStandard("LVCMOS33")),
|
|
|
|
# Leds.
|
|
("user_led", 0, Pins("V16"), IOStandard("LVCMOS33")),
|
|
("user_led", 1, Pins("V17"), IOStandard("LVCMOS33")),
|
|
|
|
# SD-Card.
|
|
("sdcard", 0,
|
|
Subsignal("data", Pins("M5 M7 H6 J6")),
|
|
Subsignal("cmd", Pins("J8")),
|
|
Subsignal("clk", Pins("L4")),
|
|
Subsignal("cd", Pins("N6")),
|
|
Misc("SLEW=FAST"),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
]
|
|
|
|
# IOs specific to V3 of the board.
|
|
_io_v3 = [
|
|
# Reset (Key1 button).
|
|
("cpu_reset", 0, Pins("M6"), IOStandard("LVCMOS33")),
|
|
|
|
# Clock.
|
|
("clk50" , 0, Pins("M21"), IOStandard("LVCMOS33")),
|
|
|
|
# Leds.
|
|
("user_led", 0, Pins("G21"), IOStandard("LVCMOS33")),
|
|
("user_led", 1, Pins("G20"), IOStandard("LVCMOS33")),
|
|
|
|
# SD-Card.
|
|
("sdcard", 0,
|
|
Subsignal("data", Pins("M5 M7 H6 J6")),
|
|
Subsignal("cmd", Pins("J8")),
|
|
Subsignal("clk", Pins("L4")),
|
|
Subsignal("cd", Pins("N6")),
|
|
Misc("SLEW=FAST"),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
]
|
|
|
|
# IO commons to both versions of the board.
|
|
_io_common = [
|
|
# Key0 button (Key1 is used as cpu reset and is version specific).
|
|
("user_btn", 0, Pins("H7"), IOStandard("LVCMOS33")),
|
|
|
|
# Serial.
|
|
("serial", 0,
|
|
Subsignal("tx", Pins("E3")),
|
|
Subsignal("rx", Pins("F3")),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
|
|
# SPIFlash.
|
|
("spiflash", 0,
|
|
Subsignal("cs_n", Pins("P18")),
|
|
Subsignal("clk", Pins("H13")),
|
|
Subsignal("mosi", Pins("R14")),
|
|
Subsignal("miso", Pins("R15")),
|
|
Subsignal("wp", Pins("P14")),
|
|
Subsignal("hold", Pins("N14")),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
("spiflash4x", 0,
|
|
Subsignal("cs_n", Pins("P18")),
|
|
Subsignal("clk", Pins("H13")),
|
|
Subsignal("dq", Pins("R14 R15 P14 N14")),
|
|
IOStandard("LVCMOS33")
|
|
),
|
|
|
|
# DDR3 SDRAM.
|
|
("ddram", 0,
|
|
Subsignal("a", Pins(
|
|
"E17 G17 F17 C17 G16 D16 H16 E16",
|
|
"H14 F15 F20 H15 C18 G15"),
|
|
IOStandard("SSTL135")),
|
|
Subsignal("ba", Pins("B17 D18 A17"), IOStandard("SSTL135")),
|
|
Subsignal("ras_n", Pins("A19"), IOStandard("SSTL135")),
|
|
Subsignal("cas_n", Pins("B19"), IOStandard("SSTL135")),
|
|
Subsignal("we_n", Pins("A18"), IOStandard("SSTL135")),
|
|
# cs_n is only wired on V1 of the board but E22 is unconnected on V2
|
|
# so leaving this here shouldn't hurt
|
|
Subsignal("cs_n", Pins("E22"), IOStandard("SSTL135")),
|
|
Subsignal("dm", Pins("A22 C22"), IOStandard("SSTL135")),
|
|
Subsignal("dq", Pins(
|
|
"D21 C21 B22 B21 D19 E20 C19 D20",
|
|
"C23 D23 B24 B25 C24 C26 A25 B26"),
|
|
IOStandard("SSTL135"),
|
|
Misc("IN_TERM=UNTUNED_SPLIT_40")),
|
|
Subsignal("dqs_p", Pins("B20 A23"),
|
|
IOStandard("DIFF_SSTL135"),
|
|
Misc("IN_TERM=UNTUNED_SPLIT_40")),
|
|
Subsignal("dqs_n", Pins("A20 A24"),
|
|
IOStandard("DIFF_SSTL135"),
|
|
Misc("IN_TERM=UNTUNED_SPLIT_40")),
|
|
Subsignal("clk_p", Pins("F18"), IOStandard("DIFF_SSTL135")),
|
|
Subsignal("clk_n", Pins("F19"), IOStandard("DIFF_SSTL135")),
|
|
Subsignal("cke", Pins("E18"), IOStandard("SSTL135")),
|
|
Subsignal("odt", Pins("G19"), IOStandard("SSTL135")),
|
|
Subsignal("reset_n", Pins("H17"), IOStandard("SSTL135")),
|
|
Misc("SLEW=FAST"),
|
|
),
|
|
|
|
# GMII Ethernet.
|
|
("eth_clocks", 0,
|
|
Subsignal("tx", Pins("M2")),
|
|
Subsignal("gtx", Pins("U1")),
|
|
Subsignal("rx", Pins("P4")),
|
|
IOStandard("LVCMOS33")
|
|
),
|
|
("eth", 0,
|
|
Subsignal("rst_n", Pins("R1")),
|
|
Subsignal("mdio", Pins("H1")),
|
|
Subsignal("mdc", Pins("H2")),
|
|
Subsignal("rx_dv", Pins("L3")),
|
|
Subsignal("rx_er", Pins("U5")),
|
|
Subsignal("rx_data", Pins("M4 N3 N4 P3 R3 T3 T4 T5")),
|
|
Subsignal("tx_en", Pins("T2")),
|
|
Subsignal("tx_er", Pins("J1")),
|
|
Subsignal("tx_data", Pins("R2 P1 N2 N1 M1 L2 K2 K1")),
|
|
Subsignal("col", Pins("U4")),
|
|
Subsignal("crs", Pins("U2")),
|
|
IOStandard("LVCMOS33")
|
|
),
|
|
|
|
# HDMI out.
|
|
("hdmi_out", 0,
|
|
Subsignal("clk_p", Pins("D4"), IOStandard("TMDS_33")),
|
|
Subsignal("clk_n", Pins("C4"), IOStandard("TMDS_33")),
|
|
Subsignal("data0_p", Pins("E1"), IOStandard("TMDS_33")),
|
|
Subsignal("data0_n", Pins("D1"), IOStandard("TMDS_33")),
|
|
Subsignal("data1_p", Pins("F2"), IOStandard("TMDS_33")),
|
|
Subsignal("data1_n", Pins("E2"), IOStandard("TMDS_33")),
|
|
Subsignal("data2_p", Pins("G2"), IOStandard("TMDS_33")),
|
|
Subsignal("data2_n", Pins("G1"), IOStandard("TMDS_33")),
|
|
Subsignal("scl", Pins("B2"), IOStandard("LVCMOS33")),
|
|
Subsignal("sda", Pins("A2"), IOStandard("LVCMOS33")),
|
|
Subsignal("hdp", Pins("A3"), IOStandard("LVCMOS33")),
|
|
Subsignal("cec", Pins("B1"), IOStandard("LVCMOS33")),
|
|
),
|
|
]
|
|
|
|
# Connectors ---------------------------------------------------------------------------------------
|
|
|
|
_connectors = [
|
|
("j10", " D5 G5 G7 G8 E5 E6 D6 G6"),
|
|
("j11", " H4 F4 A4 A5 J4 G4 B4 B5"),
|
|
("j12", "AB26 AC26 AB24 AC24 AA24 AB25 AA22 AA23",
|
|
" Y25 AA25 W25 Y26 Y22 Y23 W21 Y21",
|
|
" V26 W26 U25 U26 V24 W24 V23 W23",
|
|
" V18 W18 U22 V22 U21 V21 T20 U20",
|
|
" T19 U19"),
|
|
("jp2", " H21 H22 K21 J21 H26 G26 G25 F25",
|
|
" G20 G21 F23 E23 E26 D26 E25 D25"),
|
|
("jp3", " AF7 AE7 AD8 AC8 AF9 AE9 AD10 AC10",
|
|
"AA11 AB11 AF11 AE11 AD14 AC14 AF13 AE13",
|
|
"AD12 AC12"),
|
|
]
|
|
|
|
# PMODS --------------------------------------------------------------------------------------------
|
|
|
|
def sdcard_pmod_io(pmod):
|
|
return [
|
|
# SDCard PMOD:
|
|
# - https://store.digilentinc.com/pmod-microsd-microsd-card-slot/
|
|
("spisdcard", 0,
|
|
Subsignal("clk", Pins(f"{pmod}:3")),
|
|
Subsignal("mosi", Pins(f"{pmod}:1"), Misc("PULLUP True")),
|
|
Subsignal("cs_n", Pins(f"{pmod}:0"), Misc("PULLUP True")),
|
|
Subsignal("miso", Pins(f"{pmod}:2"), Misc("PULLUP True")),
|
|
Misc("SLEW=FAST"),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
("sdcard", 0,
|
|
Subsignal("data", Pins(f"{pmod}:2 {pmod}:4 {pmod}:5 {pmod}:0"), Misc("PULLUP True")),
|
|
Subsignal("cmd", Pins(f"{pmod}:1"), Misc("PULLUP True")),
|
|
Subsignal("clk", Pins(f"{pmod}:3")),
|
|
Subsignal("cd", Pins(f"{pmod}:6")),
|
|
Misc("SLEW=FAST"),
|
|
IOStandard("LVCMOS33"),
|
|
),
|
|
]
|
|
_sdcard_pmod_io = sdcard_pmod_io("j10") # SDCARD PMOD on J10.
|
|
def ps2_pmod_io(pmod):
|
|
return [
|
|
("ps2kbd", 0, Pins(f"{pmod}:0 {pmod}:2"), IOStandard("LVCMOS33")), # data, clk
|
|
]
|
|
_ps2_pmod_io = ps2_pmod_io("j11") # PS2 PMOD on top line of J11
|
|
|
|
# Platform -----------------------------------------------------------------------------------------
|
|
|
|
class Platform(Xilinx7SeriesPlatform):
|
|
default_clk_name = "clk50"
|
|
default_clk_period = 1e9/50e6
|
|
|
|
def __init__(self, revision=1, speedgrade=-2, toolchain="vivado"):
|
|
# Check Speedgrade.
|
|
if speedgrade not in [-1,-2]:
|
|
raise ValueError(f"Speedgrade {speedgrade} unsupported.")
|
|
# Create IOs and extend to with board's revision specific IOs.
|
|
io = _io_common
|
|
io.extend({
|
|
1 : _io_v1,
|
|
2 : _io_v2,
|
|
3 : _io_v3,
|
|
}[revision])
|
|
# Create Platform.
|
|
Xilinx7SeriesPlatform.__init__(self, f"xc7a100t{speedgrade}fgg676", io, _connectors, toolchain=toolchain)
|
|
|
|
self.toolchain.bitstream_commands = \
|
|
["set_property BITSTREAM.CONFIG.SPI_BUSWIDTH 4 [current_design]"]
|
|
self.toolchain.additional_commands = \
|
|
["write_cfgmem -force -format bin -interface spix4 -size 16 "
|
|
"-loadbit \"up 0x0 {build_name}.bit\" -file {build_name}.bin"]
|
|
|
|
self.add_platform_command("set_property INTERNAL_VREF 0.675 [get_iobanks 16]")
|
|
if revision == 1:
|
|
self.add_platform_command("set_property CLOCK_DEDICATED_ROUTE FALSE [get_nets clk50_IBUF]")
|
|
self.add_platform_command("set_property CFGBVS VCCO [current_design]")
|
|
self.add_platform_command("set_property CONFIG_VOLTAGE 3.3 [current_design]")
|
|
|
|
def create_programmer(self):
|
|
return OpenOCD("openocd_xc7_ft232.cfg", "bscan_spi_xc7a100t.bit")
|
|
|
|
def do_finalize(self, fragment):
|
|
Xilinx7SeriesPlatform.do_finalize(self, fragment)
|
|
self.add_period_constraint(self.lookup_request("clk50", loose=True), 1e9/50e6)
|