https://github.com/nathsou/hdl-env

Dev container for development and simulation of the Nandland Go and Alchitry Cu FPGA Boards using open source software.
https://github.com/nathsou/hdl-env

alchitry alchitry-cu devcontainer docker fpga ice40 nandland open-source yosys

Last synced: about 1 month ago
JSON representation

Dev container for development and simulation of the Nandland Go and Alchitry Cu FPGA Boards using open source software.

• Host: GitHub
• URL: https://github.com/nathsou/hdl-env
• Owner: nathsou
• Created: 2024-06-15T21:59:44.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2024-06-18T20:47:08.000Z (6 months ago)
• Last Synced: 2024-10-11T20:42:53.672Z (2 months ago)
• Topics: alchitry, alchitry-cu, devcontainer, docker, fpga, ice40, nandland, open-source, yosys
• Language: Verilog
• Homepage:
• Size: 22.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# NandLand Go / Alchitry Cu Dev Container

[Dev container](https://containers.dev/) set up for development, synthesis & place and route, and simulation of the [NandLand Go](https://nandland.com/the-go-board/) and [Alchitry Cu](https://alchitry.com/boards/cu) FPGA development boards.

## Tools

- [Yosys](https://github.com/YosysHQ/yosys) for synthesis

- [NextPNR](https://github.com/YosysHQ/nextpnr) for place and route

- [Icestorm](https://github.com/YosysHQ/icestorm) for programming the FPGA

- [Icarus Verilog](https://github.com/steveicarus/iverilog) for simulation

- [Cocotb](https://github.com/cocotb/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:

```bash

cd projects/chapter02/go

gen_bitstream go . switchtes_to_leds.v

iceprog artifacts/switches_to_leds.bin

```

For the Alchitry Cu:

```bash

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.

```bash

cd projects/chapter05/and_gate

make

```