Initial commit

Author: whitequark

.env.toolchain

@@ -0,0 +1,6 @@
+AMARANTH_USE_YOSYS=builtin
+YOSYS=yowasp-yosys
+NEXTPNR_ICE40=yowasp-nextpnr-ice40
+ICEPACK=yowasp-icepack
+NEXTPNR_ECP5=yowasp-nextpnr-ecp5
+ECPPACK=yowasp-ecppack

.gitignore

@@ -0,0 +1,12 @@
+# Python
+__pycache__/
+*.egg-info
+/dist
+
+# pdm
+/.pdm-plugins
+/.pdm-python
+/.venv
+
+# Amaranth
+/build*

README.md

@@ -0,0 +1,10 @@
+# amaranth-template-fpga
+
+TODO: write this section
+
+```shell
+$ pipx install pdm
+$ pdm install
+$ pdm run build_ice40
+$ pdm run build_ecp5
+```

pdm.lock

@@ -0,0 +1,19 @@
+[project]
+name = "amaranth-template-fpga"
+version = "0.0.0"
+description = "Template for a generic FPGA project using Amaranth"
+
+requires-python = "~=3.8"
+dependencies = [
+    "amaranth @ git+https://github.com/amaranth-lang/amaranth",
+    "amaranth-yosys",
+    "amaranth-boards @ git+https://github.com/amaranth-lang/amaranth-boards",
+    "yowasp-yosys",
+    "yowasp-nextpnr-ice40",
+    "yowasp-nextpnr-ecp5",
+]
+
+[tool.pdm.scripts]
+_.env_file = ".env.toolchain"
+build_ice40 = {call = "amaranth_template_fpga:build_ice40()"}
+build_ecp5 = {call = "amaranth_template_fpga:build_ecp5()"}

pyproject.toml

@@ -0,0 +1,27 @@
+from amaranth import *
+from amaranth_boards.icestick import ICEStickPlatform
+from amaranth_boards.versa_ecp5 import VersaECP5Platform
+
+
+class Blinky(Elaboratable):
+    def elaborate(self, platform):
+        m = Module()
+
+        led = platform.request("led", 0).o
+        timer = Signal(range(int(platform.default_clk_frequency//2)),
+                       reset=int(platform.default_clk_frequency//2) - 1)
+        with m.If(timer == 0):
+            m.d.sync += led.eq(~led)
+            m.d.sync += timer.eq(timer.reset)
+        with m.Else():
+            m.d.sync += timer.eq(timer - 1)
+
+        return m
+
+
+def build_ice40():
+    ICEStickPlatform().build(Blinky())
+
+
+def build_ecp5():
+    VersaECP5Platform().build(Blinky())