README.md

NandLand Go / Alchitry Cu Dev Container

Dev container set up for development, synthesis & place and route, and simulation of the NandLand Go and Alchitry Cu FPGA development boards.

Tools

• Yosys for synthesis
• NextPNR for place and route
• Icestorm for programming the FPGA
• Icarus Verilog for simulation
• Cocotb for testbenches

Usage

Open the project in VSCode, open the command palette and select Dev Containers: Reopen in Container. This will open the project in a container with all the necessary tools installed and example projects.

Generate a bitstream file

NandLand Go Board:

cd projects/chapter02/go
gen_bitstream go . switchtes_to_leds.v
iceprog artifacts/switches_to_leds.bin

For the Alchitry Cu:

cd projects/chapter02/cu
gen_bitstream cu . rst_to_leds.v
iceprog artifacts/rst_to_leds.bin

Run a simulation

Testbenches can be run using cocotb and Icarus Verilog which are already installed in the container.

cd projects/chapter05/and_gate
make