openMemristorPDK Guide
Guide · Section 1 · Introduction to FOSS · Part 4 · about 4 min to read

Digital tools

Simulate bits, look at them as waveforms, turn Verilog into logic gates, and turn the gates into a chip layout.

One tab per program

Pick a program

Each tab says what the program does, where this guide uses it, who makes it, and how to check and install it.

Icarus Verilog

Simulates digital circuits written in Verilog.

Verilog describes digital circuits as text: registers, logic, clocks. Icarus Verilog (iverilog) compiles that text and runs it, writing every signal's ones and zeros over time into a .vcd file. It is quick: no voltages, just bits.

Runs on
Inside the container
Used in this guide
A digital twin in Verilog and A controller made of real logic gates.
Made by
Stephen Williams and contributors.
License
GNU GPL 2.0
Website
steveicarus.github.io/iverilog

Is it there?

Type this in a container terminal:

$ iverilog -V

Install it outside the container

Inside the container it is already installed: nothing to do. These commands are only for using it on your own Ubuntu, without the container.

$ sudo apt install -y iverilog

GTKWave

Shows digital signals as waveforms.

Opens the .vcd file Icarus Verilog writes and draws each signal as a line going up and down over time, like a logic analyser. You pick the signals, zoom in, and read off when a bit changes.

Runs on
Inside the container
Used in this guide
A digital twin in Verilog.
Made by
Tony Bybell and contributors.
License
GNU GPL 2.0
Website
gtkwave.sourceforge.net

Is it there?

Type this in a container terminal:

$ gtkwave --version

Install it outside the container

Inside the container it is already installed: nothing to do. These commands are only for using it on your own Ubuntu, without the container.

$ sudo apt install -y gtkwave

Yosys

Turns Verilog into real logic gates.

This step is called synthesis. Yosys reads a Verilog description and builds the same behaviour out of the logic gates a factory offers (here IHP's standard cells: NAND, flip-flops and so on), then counts them and their area.

Runs on
Inside the container
Used in this guide
A controller made of real logic gates (65 gates) and, inside LibreLane, From gates to a chip layout.
Made by
Claire Wolf and YosysHQ.
License
ISC
Website
yosyshq.net/yosys

Is it there?

Type this in a container terminal:

$ yosys -V

Install it outside the container

Inside the container it is already installed: nothing to do. These commands are only for using it on your own Ubuntu, without the container.

$ sudo apt install -y yosys

OpenROAD and LibreLane

From logic gates to a finished chip layout, automatically.

OpenROAD places the gates on the chip, builds the clock wiring, routes every wire and checks the timing (with OpenSTA). LibreLane is the recipe that runs the whole chain in order: Yosys, OpenROAD, then the Magic and KLayout DRC and the Netgen LVS, and collects the reports. One command goes from Verilog to a GDS file the factory could build. LibreLane continues OpenLane 2.

Runs on
Inside the container
Used in this guide
From gates to a chip layout.
Made by
OpenROAD: a project started at UC San Diego in 2018. LibreLane: the open-source silicon community, from OpenLane.
License
BSD 3-clause (OpenROAD), Apache 2.0 (LibreLane)
Website
librelane.readthedocs.io

Is it there?

Type this in a container terminal:

$ librelane --version

Install it outside the container

Inside the container it is already installed: nothing to do. These commands are only for using it on your own Ubuntu, without the container.

Use the container. OpenROAD is large and hard to build, and LibreLane needs every other program on this page at the right version: the container already has them all, tested together.