aboutsummaryrefslogtreecommitdiff
path: root/nmigen_boards/resources/interface.py
diff options
context:
space:
mode:
Diffstat (limited to 'nmigen_boards/resources/interface.py')
-rw-r--r--nmigen_boards/resources/interface.py147
1 files changed, 5 insertions, 142 deletions
diff --git a/nmigen_boards/resources/interface.py b/nmigen_boards/resources/interface.py
index df44d7b..3438c24 100644
--- a/nmigen_boards/resources/interface.py
+++ b/nmigen_boards/resources/interface.py
@@ -1,144 +1,7 @@
-from nmigen.build import *
+from amaranth_boards.resources.interface import *
+from amaranth_boards.resources.interface import __all__
-__all__ = [
- "UARTResource", "IrDAResource", "SPIResource", "I2CResource",
- "DirectUSBResource", "ULPIResource", "PS2Resource",
-]
-
-
-def UARTResource(*args, rx, tx, rts=None, cts=None, dtr=None, dsr=None, dcd=None, ri=None,
- conn=None, attrs=None, role=None):
- if any(line is not None for line in (rts, cts, dtr, dsr, dcd, ri)):
- assert role in ("dce", "dte")
- if role == "dte":
- dce_to_dte = "i"
- dte_to_dce = "o"
- else:
- dce_to_dte = "o"
- dte_to_dce = "i"
-
- io = []
- io.append(Subsignal("rx", Pins(rx, dir="i", conn=conn, assert_width=1)))
- io.append(Subsignal("tx", Pins(tx, dir="o", conn=conn, assert_width=1)))
- if rts is not None:
- io.append(Subsignal("rts", Pins(rts, dir=dte_to_dce, conn=conn, assert_width=1)))
- if cts is not None:
- io.append(Subsignal("cts", Pins(cts, dir=dce_to_dte, conn=conn, assert_width=1)))
- if dtr is not None:
- io.append(Subsignal("dtr", Pins(dtr, dir=dte_to_dce, conn=conn, assert_width=1)))
- if dsr is not None:
- io.append(Subsignal("dsr", Pins(dsr, dir=dce_to_dte, conn=conn, assert_width=1)))
- if dcd is not None:
- io.append(Subsignal("dcd", Pins(dcd, dir=dce_to_dte, conn=conn, assert_width=1)))
- if ri is not None:
- io.append(Subsignal("ri", Pins(ri, dir=dce_to_dte, conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource.family(*args, default_name="uart", ios=io)
-
-
-def IrDAResource(number, *, rx, tx, en=None, sd=None,
- conn=None, attrs=None):
- # Exactly one of en (active-high enable) or sd (shutdown, active-low enable) should
- # be specified, and it is mapped to a logic level en subsignal.
- assert (en is not None) ^ (sd is not None)
-
- io = []
- io.append(Subsignal("rx", Pins(rx, dir="i", conn=conn, assert_width=1)))
- io.append(Subsignal("tx", Pins(tx, dir="o", conn=conn, assert_width=1)))
- if en is not None:
- io.append(Subsignal("en", Pins(en, dir="o", conn=conn, assert_width=1)))
- if sd is not None:
- io.append(Subsignal("en", PinsN(sd, dir="o", conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource("irda", number, *io)
-
-
-def SPIResource(*args, cs_n, clk, copi, cipo, int=None, reset=None,
- conn=None, attrs=None, role="controller"):
- assert role in ("controller", "peripheral")
- assert copi is not None or cipo is not None # support unidirectional SPI
-
- io = []
- if role == "controller":
- io.append(Subsignal("cs", PinsN(cs_n, dir="o", conn=conn)))
- io.append(Subsignal("clk", Pins(clk, dir="o", conn=conn, assert_width=1)))
- if copi is not None:
- io.append(Subsignal("copi", Pins(copi, dir="o", conn=conn, assert_width=1)))
- if cipo is not None:
- io.append(Subsignal("cipo", Pins(cipo, dir="i", conn=conn, assert_width=1)))
- else: # peripheral
- io.append(Subsignal("cs", PinsN(cs_n, dir="i", conn=conn, assert_width=1)))
- io.append(Subsignal("clk", Pins(clk, dir="i", conn=conn, assert_width=1)))
- if copi is not None:
- io.append(Subsignal("copi", Pins(copi, dir="i", conn=conn, assert_width=1)))
- if cipo is not None:
- io.append(Subsignal("cipo", Pins(cipo, dir="oe", conn=conn, assert_width=1)))
- if int is not None:
- if role == "controller":
- io.append(Subsignal("int", Pins(int, dir="i", conn=conn)))
- else:
- io.append(Subsignal("int", Pins(int, dir="oe", conn=conn, assert_width=1)))
- if reset is not None:
- if role == "controller":
- io.append(Subsignal("reset", Pins(reset, dir="o", conn=conn)))
- else:
- io.append(Subsignal("reset", Pins(reset, dir="i", conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource.family(*args, default_name="spi", ios=io)
-
-
-def I2CResource(*args, scl, sda, conn=None, attrs=None):
- io = []
- io.append(Subsignal("scl", Pins(scl, dir="io", conn=conn, assert_width=1)))
- io.append(Subsignal("sda", Pins(sda, dir="io", conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource.family(*args, default_name="i2c", ios=io)
-
-
-def DirectUSBResource(*args, d_p, d_n, pullup=None, vbus_valid=None, conn=None, attrs=None):
-
- io = []
- io.append(Subsignal("d_p", Pins(d_p, dir="io", conn=conn, assert_width=1)))
- io.append(Subsignal("d_n", Pins(d_n, dir="io", conn=conn, assert_width=1)))
- if pullup:
- io.append(Subsignal("pullup", Pins(pullup, dir="o", conn=conn, assert_width=1)))
- if vbus_valid:
- io.append(Subsignal("vbus_valid", Pins(vbus_valid, dir="i", conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource.family(*args, default_name="usb", ios=io)
-
-
-def ULPIResource(*args, data, clk, dir, nxt, stp, rst=None,
- clk_dir='i', rst_invert=False, attrs=None, conn=None):
- assert clk_dir in ('i', 'o',)
-
- io = []
- io.append(Subsignal("data", Pins(data, dir="io", conn=conn, assert_width=8)))
- io.append(Subsignal("clk", Pins(clk, dir=clk_dir, conn=conn, assert_width=1)))
- io.append(Subsignal("dir", Pins(dir, dir="i", conn=conn, assert_width=1)))
- io.append(Subsignal("nxt", Pins(nxt, dir="i", conn=conn, assert_width=1)))
- io.append(Subsignal("stp", Pins(stp, dir="o", conn=conn, assert_width=1)))
- if rst is not None:
- io.append(Subsignal("rst", Pins(rst, dir="o", invert=rst_invert,
- conn=conn, assert_width=1)))
- if attrs is not None:
- io.append(attrs)
- return Resource.family(*args, default_name="usb", ios=io)
-
-
-def PS2Resource(*args, clk, dat, conn=None, attrs=None):
- ios = []
-
- ios.append(Subsignal("clk", Pins(clk, dir="i", conn=conn, assert_width=1))),
- ios.append(Subsignal("dat", Pins(dat, dir="io", conn=conn, assert_width=1))),
-
- if attrs is not None:
- ios.append(attrs)
-
- return Resource.family(*args, default_name="ps2", ios=ios)
+import warnings
+warnings.warn("instead of nmigen_boards.resources.interface, use amaranth_boards.resources.interface",
+ DeprecationWarning, stacklevel=2)