FPGA AI Suite: PCIe-based Design Example User Guide

ID 768977
Date 7/31/2024
Public
Document Table of Contents

6.1.1. Build Script Options

Table 5.  Build Script Options
Option Description
-a, --archs Path to FPGA AI Suite IP Architecture Description File
--build-dir

Path to hardware build directory where BSP infrastructure and generated RTL will be located.

(default: coredla/pcie_ed/platform/build_synth)

--build Option to perform compilation of the PCIe* design using Quartus® Prime after instantiation (default: False).
-d, --archs-dir Path to directory that contains Architecture Description Files for you to interactively choose from (alternative to ‘-a’)
-ed, --example-design-id

To build for the Terasic DE10-Agilex board, specify 3.

(default: 3)

-n, --num-instances

Number of IP instances to build (default: 2).

For the Terasic DE10-Agilex board, this number must be 1, 2, 3, or 4.

--num-paths Number of top critical paths to report after compiling the design (default: 2000).
-q, --quiet Run script quietly without printing the output of underlying scripts to the terminal.
--qor-modules List of internal modules (instance names) from inside the IP to include in the QoR summary report.
-s, --seed Seed to be used in compiling the design (default: 1).
--unlicensed/licensed
This option is passed to the dla_create_ip tool to tell the tool to generate either an unlicensed or licensed copy of the FPGA AI Suite:
  • Unlicensed IP: Unlicensed IP has a limit of 10000 inferences. After 10000 inferences, the unlicensed IP refuses to perform any additional inference and a bit in the CSR is set. For details about the CSR bit, refer to DMA Descriptor Queue in FPGA AI Suite IP Reference Manual .
  • Licensed IP: Licensed IP has no inference limitation.

If you do not have a license but generate licensed IP, Quartus® Primesoftware cannot generate a bitstream.

If neither option is specified, then the dla_create_ip tool queries the lmutil license manager to determine the correct option.

--wsl This option sets the build script to run such that the final Quartus® Prime compilation runs in the Windows* environment. After the script sets up the compilation, it prints the instructions to complete the compilation on Windows*.
Restriction: Only supported within a WSL 2 environment and for the DE10-Agilex example design.
--finalize
Restriction: This option can be used only when following the instructions provided by the build script run with the --wsl option.