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.