AN 1008: Using the FPGA AI Suite Docker* Image

Download PDF
ID 820119
Date 4/25/2025
Public
Document Table of Contents x
1. Using the FPGA AI Suite Docker Image Overview 2. FPGA AI Suite Docker Image Requirements 3. Setting Up the FPGA AI Suite Docker Image 4. Running the FPGA AI Suite Docker* Container 5. Containerized FPGA AI Suite SoC Design Example Quick-Start Tutorial 6. AN 1008: Using the FPGA AI Suite Docker* Image Document Revision History
1. Using the FPGA AI Suite Docker Image Overview
2. FPGA AI Suite Docker Image Requirements
3. Setting Up the FPGA AI Suite Docker Image
4. Running the FPGA AI Suite Docker* Container
5. Containerized FPGA AI Suite SoC Design Example Quick-Start Tutorial
6. AN 1008: Using the FPGA AI Suite Docker* Image Document Revision History

4. Running the FPGA AI Suite Docker* Container

After setting up the Docker* image, you can run the container.

If you have an FPGA development kit, ensure that the board is connected to power and that the UART/JTAG cables are connected to the host machine where you will run the container.

To run the FPGA AI Suite Docker* image:
  1. Start your Docker* client, if it is not yet started.
  2. Start a Windows command prompt session.
  3. In the command prompt session, run one of the following commands:
    • If you do not have an FPGA board and want to run a software-only flow, run the following command:
      docker container run --name fpga-ai-suite-2025.1 -p 22:22 -it -v 
C:\Users\<username>\<path-to-share>:/mnt/host alterafpga/fpgaaisuite-v2025.1:latest
    • [FPGA] If you have an FPGA development kit, run the following command:
      docker container run --device=/dev/ttyUSB0 --name fpga-ai-suite-2025.1 -p 22:22 -it -v 
C:\Users\<username>\<path-to-share>:/mnt/host alterafpga/fpgaaisuite-v2025.1:latest
    When the container starts, you should see the following output: 
    [setupvars.sh] OpenVINO environment initialized
export COREDLA_VERSION=1
export COREDLA_GCC=/usr/bin/gcc
export COREDLA_ROOT='/opt/altera/fpga_ai_suite_2025.1/dla'
  4. [FPGA] To see the FPGA development kit in the container, run the following command:
    lsusb
    The FPGA development kit should appears as a UART device as indicate in bold text the following example lsusb command output: 
    fpga-ai-suite-2025.1@3e5bd678f34e:~$ lsusb
Bus 002 Device 001: ID 1d6b:0003
Bus 001 Device 002: ID 0403:6001 FTDI FT232R USB UART
Bus 001 Device 001: ID 1d6b:0002
  5. [FPGA] Confirm that the FPGA development kit device was passed to the container in the /dev folder with the following command:
    ls /dev/ttyUSB*
    If the device was correctly passed to the container, the output should appear similar to the following example output: 
    ttyUSB0
Level Two Title