Troubleshooting

Although it is rare, sometimes you may encounter issues running the Efinity software. This topic describes some issues and how to debug the problem.

Table 1. Efinity GUI Does Not Open
Platform Solution
Windows The Efinity software GUI uses QT, which has a known bug for non-English language fonts. If a font with a name containing trailing spaces (e.g., "SDC-Sadeh Fat " or "BC C39 2 to 1 HD ") is installed on your computer, the Efinity software will not open. Uninstall the font to fix this problem. See related forum topic.
Your proxy settings may cause the software to fail to run. See Proxy Settings.
Linux You can have this problem if your system has /usr/lib64/libffi.so.8 installed. Instead, use /usr/lib64/libffi.so.6. See related forum topic.
Your proxy settings may cause the software to fail to run. See Proxy Settings.
If you are using the Wayland display server and have problems with the Efinity GUI, set this environment variable to help troubleshoot: export QT_QPA_PLATFORM=xcb.
Table 2. IP Catalog and PLL Clock Calculator GUI Window Visibility Issues
Platform Solution
Linux Observed in 2025.2.288.2.10 (See related forum topic.)
In some new releases of Linux (e.g., Debian 13 and Ubuntu 26), the system libstdc++ library may be more recent than the version shipped with the Efinity software. As a result, some Efinity tools may fail to load. To work around this issue, backup and rename <Efinity install>/lib/libstdc++.so.6 and restart the Efinity software.
Table 3. Efinity Crashes During Synthesis
Platform Solution
Windows Observed in 2024.2 (See related forum topic.)
If you have the Sophos antivirus software on your computer, it may prevent Efinity synthesis from running. To solve this issue, disable the antivirus software, add Efinity to the Sophos exclusion list, or set the environment variable TCMALLOC_DISABLE_REPLACEMENT to 1 before starting the Efinity GUI or the flow from the command line. (Setting this environment variable comes at a cost of reducing the performance advantages in 2024.2 vs. 2024.1).
The command-line commands are: 
<Efinity path>\2024.2\bin\setup.bat
set TCMALLOC_DISABLE_REPLACEMENT=1
efinity
If the TCMALLOC_DISABLE_REPLACEMENT setting does not fix the issue, try running the software in Windows 8 compatibility mode. This mode increases the compile time.
Table 4. Cannot Connect to Board after Installing the USB Driver
Platform Solution
Linux If, after installing the USB driver, the USB permissions appear to be wrong or do not work, verify that the file 80-efx-pgm.rules exists in the /etc/udev/rules.d/ directory. If the file is not there, try re-running the install_usb_driver.sh command, or, if required, manually copy the <Efinity directory>/bin/80-efx-pgm.rules file to the /etc/udev/rules.d/ directory.
Table 5. IP Manager RPC Server Not Connected
Platform Solution
Windows The IP Manager creates and uses server instances for inter-process communication. If no ports are available for use, it shows the message "IP Manager RPC Server Not Connected" in the Console. Refer to "Resolving IP Manager Issues" in the Efinity Software User Guide for details on how to resolve the problem.
Table 6. IP Manager Cannot Generate Files
Platform Solution
Windows Some IP cores require a Java 64-bit runtime environment. Starting with OpenJDK v24, Java includes checks that cause the IP Manager to fail to generate files. To work around this issue, install one of the versions of Java shown in Hardware and Software Requirements.

Turn on Debug Messages

To help diagnose an issue, turn on Efinity debug messages and send them to Efinix support in the forum.

  1. Open the file <path>/efinity/<version>/bin/lc.ini.
  2. In the Disable debug logging in all categories section, change all of the settings from false to true.
  3. Save.
  4. Run the Efinity software. Debug messages are saved to log files (efinity.log and efinity_console.log). The files are saved in:
    • Linux—/home/<user name>/.efinity
    • Windows—C:\Users\<user name>\.efinity
  5. Send the messages to Efinix support in the forum https://forum.efinix.net.
Note: For software versions before v2025.1, the Efinity software saved log files in these directories:
  • Linux: /home/<username>/.local/share/efinity/log
  • Windows: C:\Users\<username>\AppData\Local\efinity\log
The AppData directory is a hidden folder. To view it, you need to select the Show hidden files, folders, and drives option (Folder Options > View tab > Hidden files and folders).