AN 1008: Using the FPGA AI Suite Docker* Image

Download PDF
ID 820119
Date 4/25/2025
Public

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