Hardware and Software Requirements

General Requirements

Efinity full release: 64-bit operating system, at least dual-core
Your preferred text editor such as Notepad, gVim, Visual Studio

Machine memory requirements (when compiling Efinity designs):

Table 1. Machine Memory RequirementsThese requirements assume up to 16 threads, and include 4 GB for the operating system and background applications.
Product	Model	Memory
Trion	T4, T8, T13, T20, T35	8 GB
Trion	T55, T85, T120	8 GB
Titanium	Ti35, Ti60, Ti85, Ti90, Ti120, Ti135, Ti180	8 GB
Titanium	Ti165, Ti240, Ti375	8 GB
Topaz	Tz50, Tz75, Tz100, Tz110, Tz170	8 GB
Topaz	Tz200, Tz325	8 GB

Windows Requirements

Efinity full release or Windows Standalone Programmer: Windows 10 or later, 64-bit operating system
Microsoft Visual C++ 2022 x64 runtime library (or latest version) redistributable https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170
Zadig software to install USB drivers see Installing the Windows USB Driver
Java 64-bit runtime environment; required for configuring some IP cores in the IP Manager (e.g., Sapphire SoC). Efinix has tested the following versions for compatibility:
- https://www.java.com/en/download/manual.jsp (Java 8)
- https://developers.redhat.com/products/openjdk/download (OpenJDK 8 or 11)
Note: You may also use other Java software platforms that are available in the market. However, there is a known issue with OpenJDK v24 and higher (see Troubleshooting).

Note: The path <drive>:\Windows\System32 must exist in %PATH% if you have a customized environment variable.

Linux Requirements

Supported operating systems:

Ubuntu v20.04 or later
Red Hat Enterprise v8.8 or later

Additional software you need to install:

Libraries:
- Ubuntu v20.04^¹—apt install libxcb-cursor0
- Red Hat—yum install xcb-util-cursor
Linux X11 or Wayland windowing system (for Efinity® GUI)
Java 64-bit runtime environment (8 or higher), required for configuring some IP cores in the IP Manager (e.g., Sapphire SoC). Follow the instructions on the Ubuntu web site or Red Hat web site to install it. Your path environment variable should include the Java executable.
Udev device manager for Efinix USB programming cable see Installing the Linux USB Driver

Running the Efinity software on Ubuntu in a virtual machine or using Windows WSL requires these additional libraries:

Table 2. Using Efinity and Ubuntu in VM or WSL
Platform	Ubuntu Version	Required Libraries
VM	20.04	sudo apt install libxcb-cursor0 libnss3 libasound2 libxkbfile1 -y
VM	22.04 24.04	No additional libraries required.^¹
WSL v2.3, v2.4²	20.04	sudo apt update sudo apt install libxcb-cursor0 libnss3 libasound2 libxkbfile1 sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxkbcommon-x11-0 libegl1 libxdamage1^³
	22.04	sudo apt update apt install libxcb-cursor0 libnss3 libasound2 libxkbfile1
	24.04	sudo apt update sudo apt install libxcb-cursor0 libnss3 libasound2t64 libxkbfile1 sudo apt install libxcb-xinerama0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-render-util0 libxcb-shape0 libxkbcommon-x11-0^³

Note: Efinix recommends increasing the memory reservation for your WSL2 machine to avoid degraded performance or out of memory situations. Refer to https://learn.microsoft.com/en-us/windows/wsl/wsl-config#wslconfig.

Installing iVerilog

Icarus Verilog (iVerilog) is a free Verilog simulation tool you can use to compile and simulate Verilog HDL source code. The software is available as source code or as pre-compiled binaries.

Windows installation:

To download the simulator: bleyer.org/icarus

Note: The latest versions of iVerilog are bundled with the GTKWave software, so you only need to download 1 file to get both tools. Refer to the bleyer.org/icarus website for more information.

To download the simulator source code: github.com/steveicarus/iverilog

Linux installation:

Refer to the Installation Guide for steps to obtain, compile and install Icarus Verilog: steveicarus.github.io/iverilog/

Note: Efinix recommends iVerilog version 11.0 or later.

Installing GTKWave

GTKWave is an open-source tool that analyzes post-simulation dumpfiles and displays the results in a graphical interface. It includes a waveform viewer and RTL source code navigator. You can use GTKWave with the iVerilog simulator to analyze and debug your simulation model, or to view any VCD waveform.

Windows installation:

You can read more at gtkwave.sourceforge.net.

Note: If you have downloaded and installed the iverilog setup file (bundled with GTKWave), you do not need to install a separate standalone GTKWave.

To download and run the latest Windows version, follow these steps:

You can browse for the software files at gtkwave - Browse Files at Sourceforge.net. The Windows files are situated lower down the page.
Unzip the downloaded file.
Run the program by executing gtkwave.exe in the <install dir>/bin directory.

Tip: Windows users: Add the tool paths (C:\iverilog\bin\ and C:\iverilog\gtkwave\bin\) to your system Environment Variables path to ensure the software launches correctly.

Linux installation:

Linux users can use the following commands:

sudo apt-get update
sudo apt-get install gtkwave

¹ The official LTS images for v22.04 and v24.04 include the libxcb-cursor0 library by default.

² For the Bitstream Security Key Generator and JTAG SVF Player, you need to set an environment variable. See Table 1.

³ You can also use the the command sudo apt install qtwayland5, however, it installs more libraries than you need, which may not be desired.