FPGA AI Suite: Getting Started Guide

ID 768970
Date 4/21/2025
Public
Document Table of Contents

4.2. Operating System Prerequisites

The FPGA AI Suite supports the following operating systems:
  • Red Hat* Enterprise Linux* 8.7
  • Red Hat* Enterprise Linux* 8.10
  • Ubuntu* 20.04 LTS

    Ubuntu* 20.04 LTS is supported natively and in a Windows* Subsystem for Linux 2 (WSL 2) environment.

    In a WSL 2 environment, only the FPGA AI Suite compiler and IP generation tools are supported.

    On Ubuntu* 20.04 LTS, FPGA AI Suite has additional prerequisites required to support the FPGA AI Suite design examples. For details, refer to Additional Ubuntu 20.04 LTS Requirements.

  • Ubuntu* 22.04 LTS

    Ubuntu* 22.04 LTS is supported only natively. It is not supported in a WSL 2 environment. For support in a WSL 2 environment, use Ubuntu* 20.04 LTS.

Important:

The PCIe-based design examples require specific versions operating systems. This is required only to use the specific PCIe example design listed. For the operating system requirements for the PCIe-based design examples, refer to the following table:

Table 4.  PCIe-Based Design Example Operating System Requirements
Design Example Operating System Requirement
PCIe-based design example for Agilex™ 7 devices Ubuntu* 20.04.5

For details about the operating system requirements for the PCIe-based design example, refer to PCIe-based Design Example Operating System Prerequisites.

Additional Ubuntu* 20.04 LTS Requirements

The FPGA AI Suite design examples require CMake 3.21 or later. The default version of CMake provided with Ubuntu* 20.04 LTS is too low.

Update your CMake version on Ubuntu* 20.04 LTS to a compatible version (CMake 3.31) by running the following commands:
sudo apt update

sudo apt install wget


wget https://apt.kitware.com/ubuntu/pool/main/c/cmake/\
cmake_3.31.6-0kitware1ubuntu20.04.1_amd64.deb

wget https://apt.kitware.com/ubuntu/pool/main/c/cmake/\
cmake-data_3.31.6-0kitware1ubuntu20.04.1_all.deb


sudo dpkg -i cmake-data_3.31.6-0kitware1ubuntu20.04.1_all.deb

sudo dpkg -i cmake_3.31.6-0kitware1ubuntu20.04.1_amd64.deb