5.3.1. Additional Software Prerequisites for the PCIe-based Design Example for Agilex™ 7 Devices
The kernel driver for the Terasic BSP must be installed according to instructions provided by Terasic. Follow the instructions that follow, or contact your Terasic representative for additional details.
A copy of the verified Terasic kernel driver is distributed as a separate file: DE10_Agilex_revC_linux_BSP_21.2.zip. Obtain this file from your Terasic representative.
Ubuntu* Kernel Prerequisites
uname -r
Terasic Kernel Driver Software Prerequisites
To install the Terasic kernel driver, install the following software dependencies:
- Quartus® Prime Pro Edition Programmer and Tools Version 22.4 or later.
The instructions in this document assume that Quartus® Prime Pro Edition Version 24.2 is used.
Download the software from the Additional Software tab at the following URL: https://www.intel.com/content/www/us/en/software-kit/current/657471.html.
- Intel® FPGA RTE for OpenCL™ Version 21.2.
Download the software from RTE tab at the following URL: https://www.intel.com/content/www/us/en/software-kit/670235/intel-fpga-sdk-for-opencl-pro-edition-software-version-21-2.html.
- Intel® FPGA Download Cable II (formerly USB-Blaster II) Driver for Linux.
Configuration steps are available the following URL: https://www.intel.com/content/www/us/en/support/programmable/support-resources/download/dri-usb-b-lnx.html
export PATH="$PATH:"<path to Quartus Programmer installation folder>/qprogrammer/quartus/bin
Your system must recognize the Intel® FPGA Download Cable II to install the Terasic kernel driver and program your board.
$ jtagconfig 1) DE10-Agilex [1-11.1] C24A0DD AGFB014R24(A|B)The list index number ("1" in the example) is also the cable number, which can be used to reprogram the board in Terasic Driver Installation.
Terasic Driver Installation
- Set up the environment with the following command:
source <full path to opencl rte installation>/init_opencl.sh
- Unzip the board support package in the current directory and set up the following environment variables (The value $PWD in the commands that follow must correspond to the directory in which the BSP packages was unzipped):
tmp1=$PWD/DE10_Agilex_revC_linux_BSP_21.2/de10_agilex export AOCL_BOARD_PACKAGE_ROOT=$tmp1 tmp1=$ALTERAOCLSDKROOT/host/linux64/lib tmp2=$AOCL_BOARD_PACKAGE_ROOT/linux64/lib export LD_LIBRARY_PATH=$tmp1:$tmp2:$LD_LIBRARY_PATH
- Install the driver with the following command:
aocl install
- Rescan the PCIe bus or reboot the system to program the board. To verify that the driver bonds to the card, program the testing bitstream to the board with the following command:
quartus_pgm -c <cable_number> -m jtag \ -o "p;$AOCL_BOARD_PACKAGE_ROOT/bringup/B2E2_8GBx4/top.sof"
- Perform a soft reboot of your host system for the system to recognize the Terasic* DE10-Agilex Development Board:
reboot
You can verify that the board is recognized by the host system with the following command:lspci | grep Altera
If you do not see the board information when scanning the PCIe bus, try rebooting your system or reinstalling the board. In some cases, you might need to move the card to a different PCIe slot.
For more details and information about the Terasic kernel driver, refer to the Terasic OpenCL BSP Guide, DE10-Agilex_OpenCL_21.2.pdf, in the kernel driver package.
Ubuntu* Kernel Update Requirements
If you update your Ubuntu* kernel, you must reinstall the Terasic kernel driver.
Bitstream Generation Requirements
If you plan to use only the precompiled bitstreams supplied with the FPGA AI Suite, then no further steps are required.
If you plan to generate bitstreams corresponding to custom FPGA AI Suite IP architectures for the PCIe-based example design for Agilex™ 7 devices, then you must install Quartus® Prime Pro Edition Version 24.2 and setup your PATH environment variable.
For Quartus® Prime Pro Edition Version 24.2 prerequisites and installation instructions, refer to Intel FPGA Software Installation and Licensing .
Download the Quartus® Prime Pro Edition software from the following URL: https://www.intel.com/content/www/us/en/software-kit/current/657471.html
Bitstream generation works with Quartus® Prime Pro Edition Version 24.2, even though the Terasic driver requires Intel® FPGA RTE for OpenCL™ Version 21.2.
export PATH="$PATH:"~/intelFPGA_pro/quartus_24.2/qsys/bin/ export PATH="$PATH:"~/intelFPGA_pro/quartus_24.2/quartus/bin/
Reboot Requirements
quartus_pgm -c <cable_number> -m jtag \ –o "p;$AOCL_BOARD_PACKAGE_ROOT/bringup/B2E2_8GBx4/top.sof"
After you successfully install the board, continue by installing the compiler and IP generation tool as described in Installing the FPGA AI Suite Compiler and IP Generation Tools.