Required Software

Note

If you’re taking this workshop as a class, the toolchains are provided on the USB disk.

Fomu requires specialized software. This software is provided for GNU/Linux, macOS, and Windows, via Fomu Toolchain. Debian packages are also available for Raspberry Pi.

To install the software, extract it somewhere on your computer, then open up a terminal window and add that directory to your PATH:

 export PATH=[path-to-toolchain]/bin:$PATH

If you use PowerShell as your terminal;

$ENV:PATH = "[path-to-toolchain]\bin;" + $ENV:PATH

If you use cmd.exe as your terminal;

 PATH=[path-to-toolchain]\bin;%PATH%

Examples in VHDL on Fomu and Mixed HDL on Fomu use ghdl-yosys-plugin, which looks for standard libraries in the path used when GHDL was configured/built. Therefore, when the toolchain is extracted to an arbitrary location, GHDL_PREFIX needs to be set:

 export GHDL_PREFIX=[path-to-toolchain]/lib/ghdl

If you use PowerShell as your terminal;

$ENV:GHDL_PREFIX = "[path-to-toolchain]\lib\ghdl"

If you use cmd.exe as your terminal;

 GHDL_PREFIX=[path-to-toolchain]\lib\ghdl

To confirm installation, run the yosys command and confirm you get the following output;

$ yosys

 /----------------------------------------------------------------------------\
 |                                                                            |
 |  yosys -- Yosys Open SYnthesis Suite                                       |
 |                                                                            |
 |  Copyright (C) 2012 - 2018  Clifford Wolf <clifford@clifford.at>           |
 |                                                                            |
 |  Permission to use, copy, modify, and/or distribute this software for any  |
 |  purpose with or without fee is hereby granted, provided that the above    |
 |  copyright notice and this permission notice appear in all copies.         |
 |                                                                            |
 |  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES  |
 |  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF          |
 |  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR   |
 |  ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES    |
 |  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN     |
 |  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF   |
 |  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.            |
 |                                                                            |
 \----------------------------------------------------------------------------/

 Yosys 78b30bbb1102047585d1a2eac89b1c7f5ca7344e (git sha1 41d9173, gcc 5.5.0-12ubuntu1~14.04 -fPIC -Os)

yosys>

Type exit to quit yosys.

Note

See the README of Fomu Toolchain for a complete list of the tools included in the toolchain.