Intel® FPGA AI Suite: SoC Design Example User Guide

ID 768979
Date 4/05/2023

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

5.2. Building the Bootable SD Card Image (.wic)

To create a bootable SD Card image (.wic file), the following components must be built:
  • Yocto Image
  • Yocto SDK Toolchain
  • Arm Cross-Compiled OpenVINO
  • Arm Cross-Compiled Intel® FPGA AI Suite Runtime Plugin
  • Arm Cross-Compiled Demonstration Applications
  • FPGA .sof/.rbf files

The script performs the complete build process and combines all the necessary components into an SD card image that can be written to an SD card. For steps required to write an SD card image to an SD card, refer to Writing the SD Card Image (.wic) to an SD Card.

The SD card image is based on Yocto (

You must have a build system that meets the minimum build requirements. For details, refer to

The commands to install the required packages are shown in Installing HPS Disk Image Build Prerequisites.

To perform the build, run the following commands:
cd $COREDLA_WORK\runtime
./ -f <bitstream_directory> -o <output_directory> -u
The following diagram illustrates the overall build process performed by the script:
Figure 2.  Intel® FPGA AI Suite SoC Design Example Build Process

Build the Yocto boot SD card image and Yocto SDK toolchain

The Intel® FPGA AI Suite Soc design example uses the Yocto Project Poky Distribution.

The Yocto image is based on the Intel® Arria® 10 Golden System Reference Designs, which you can find at the following URL:

To customize the Yocto Poky distribution, modify the recipes found in layer $COREDLA_ROOT/hps/ed4/yocto/meta-intel-coredla.

More details can be found in Yocto Build and Runtime Linux Environment.

The defined Yocto Image recipe is coredla-image and can be found in $COREDLA_ROOT/hps/ed4/yocto/meta-intel-coredla/recipes-image/

A Yocto SDK is also built as part of the build and this SDK is used in subsequent build steps to cross-compile the software for the Arm HPS subsystem:
  • Intel® Arria® 10 :


The SD card image (WIC file) is in the following location:
  • Intel® Arria® 10 :


By default, the script builds Yocto from scratch. However, if a prebuilt Yocto build folder is available, you can specify the prebuilt Yocto folder via the -y option as follows:
  -o <OUTPUT_DIR> -u

This -y option loads the Yocto SDK from <PREBUILT_YOCTO_DIR>/build/tmp/deploy/sdk/ and the .wic image from <PREBUILT_YOCTO_DIR>/build/tmp/deploy/images/arria10/ without rerunning a Yocto build.

Build the HPS Packages

The HPS packages are built by the script.

This script cross-compiles OpenCV, OpenVINO, and the Arm-based OpenVINO™ runtime plugin.

Build the runtime

The runtimes are built by the script.

This script cross-compiles the OpenVINO™ Intel® FPGA AI Suite runtime plugin and demonstration applications for the SoC devices.

Update the SD card image

The SD card image is updated by the script.

This script takes the output products from the previous build steps and builds a bootable SD Card image.

The software binaries are installed to the Ext4 partition under the /home/root/app directory. The RTL fit_spl_fpga.itb file is copied to the Fat32 partition.

The SD card image is updated only if you specify the -u option of the command along with the location of the FPGA bitstream directory through the -f option.

You can skip updating the SD card while building the rest of the SoC Example Design by omitting the -f and -u options:
./ -o <OUTPUT_DIR>
When you skip updating the SD card image, you can build bitstreams and an HPS image (Yocto, HPS packages, Intel® FPGA AI Suite runtime) concurrently. You can update the SD card image (.wic file) image after all the files are ready: