openvino/docs/install_guides/PAC_Configure_2018R5.md

Configuration Guide for Intel® Distribution of OpenVINO™ toolkit 2018R5 and the Intel® Programmable Acceleration Card with Intel® Arria® 10 FPGA GX on CentOS*

Get Started

The following describes the set-up of the Intel® Distribution of OpenVINO™ toolkit on CentOS* 7.4. This is based upon a completely fresh install of CentOS 7.4 with developer tools included. This document was written for the Intel® Distribution of OpenVINO™ toolkit 2018 R5 release and may be largely applicable for later versions. Official Intel® documentation for the install process can be found in the following locations and it is highly recommended that these are read, especially for new users. This document serves as a guide, and in some cases, adds additional detail, specifically for an install with sudo privileges on CentOS 7.4.

Intel® Acceleration Stack for FPGAs Quick Start Guide

OpenCL™ on Intel® PAC Quick Start Guide

Installing the Intel® Distribution of OpenVINO™ toolkit for Linux*

(Optional): Install NTFS support for transferring large installers if already downloaded on another machine.

sudo yum -y install epel-release

sudo yum -y install ntfs-3g

Install Intel® PAC and the Intel® Programmable Acceleration Card Stack

1. Download version 1.1 of the Acceleration Stack for Runtime from the Intel FPGA Acceleration Hub. This downloads as a10_gx_pac_ias_1_1_pv_rte_installer.tar.gz. Let it download to ~/Downloads.

2. Create a new directory to install to:

mkdir -p ~/tools/intelrtestack

3. Untar and launch the installer:

cd ~/Downloads

tar xf a10_gx_pac_ias_1_1_pv_rte_installer.tar.gz

cd a10_gx_pac_ias_1_1_pv_rte_installer

sudo ./setup.sh

4. Select Y to install OPAE and accept license and when asked, specify ~/tools/intelrtestack as the install path. During the installation there should be a message stating the directory already exists as it was created in the first command above. Select Y to install to this directory. If this message is not seen, it suggests that there was a typo when entering the install location.

5. Tools are installed to the following directories:

   • Intel® Quartus® software Programmer: ~/tools/inteltrestack/intelFPGA_pro/qprogrammer
   • OpenCL™ Run Time Environment: ~/tools/intelrtestack/intelFPGA_pro/aclrte-linux64
   • Intel® Acceleration Stack for FPGAs: ~/tools/intelrtestack/a10_gx_pac_ias_1_1_pv

6. Install E10/E40 Software Patch

source ~/tools/intelrtestack/init_env.sh

cd $OPAE_PLATFORM_ROOT/hw

sudo wget https://www.intel.com/content/dam/altera-www/global/en_US/others/solutions/acceleration-hub/a10_gx_pac_ias_1_1_pv_eth.patch

sudo patch -s -p0 < a10_gx_pac_ias_1_1_pv_eth.patch

7. Check the version of the FPGA Interface Manager firmware on the PAC board.

sudo fpgainfo fme

8. If the reported Pr Interface Id is not 9926ab6d-6c92-5a68-aabc-a7d84c545738 then follow the instructions in section 4 of the Intel® Acceleration Stack for FPGAs Quick Start Guide to update the FME.

9. Run the built in self-test to verify operation of the Acceleration Stack and Intel® PAC in a non-virtualized environment.

sudo sh -c "echo 20 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages"

sudo fpgabist $OPAE_PLATFORM_ROOT/hw/samples/nlb_mode_3/bin/nlb_mode_3.gbs

Extract and Verify the Intel® Acceleration Stack for FPGAs OpenCL™ BSP

1. Extract the BSP

cd $OPAE_PLATFORM_ROOT/opencl

sudo tar xf opencl_bsp.tar.gz

2. Create an initialization script ~/init_openvino.sh with the following content that can be run upon opening a new terminal or rebooting. This will source the script ran above as well as setting up the OpenCL™ environment.

source \$HOME/tools/intelrtestack/init_env.sh

export CL_CONTEXT_COMPILER_MODE_ALTERA=3

export CL_CONTEXT_COMPILER_MODE_INTELFPGA=3

export INTELFPGAOCLSDKROOT="\$HOME/tools/intelrtestack/intelFPGA_pro/aclrte-linux64"

export ALTERAOCLSDKROOT="\$INTELFPGAOCLSDKROOT"

export AOCL_BOARD_PACKAGE_ROOT="\$OPAE_PLATFORM_ROOT/opencl/opencl_bsp"

\$AOCL_BOARD_PACKAGE_ROOT/linux64/libexec/setup_permissions.sh```
```sh
source $INTELFPGAOCLSDKROOT/init_opencl.sh

3. Source the script:

source ~/init_openvino.sh

4. Some of the settings made in the child scripts need a reboot to take effect. Reboot the machine and source the script again. Note that this script should be sourced each time a new terminal is opened for use with the Intel® Acceleration Stack for FPGAs and Intel® Distribution of OpenVINO™ toolkit.

source ~/init_openvino.sh

5. Install the OpenCL™ driver:

cd ~

sudo -E ./tools/intelrtestack/intelFPGA_pro/aclrte-linux64/bin/aocl install

Select Y when asked to install the BSP. Note that the following warning can be safely ignored.

WARNING: install not implemented.  Please refer to DCP Quick Start User Guide.

6. Program the Intel® PAC board with a pre-compiled .aocx file (OpenCL™ based FPGA bitstream).

cd \$OPAE_PLATFORM_ROOT/opencl

aocl program acl0 hello_world.aocx

7. Build and run the Hello World application:

sudo tar xf exm_opencl_hello_world_x64_linux.tgz

sudo chmod -R a+w hello_world

cd hello_world

make

cp ../hello_world.aocx ./bin

./bin/host

Add Intel® Distribution of OpenVINO™ toolkit with FPGA Support to Environment Variables

1. To run the Intel® Distribution of OpenVINO™ toolkit, add the last four commands to the ~/init_openvino.sh script. The previous content is shown as well.

source \$HOME/tools/intelrtestack/init_env.sh
export CL_CONTEXT_COMPILER_MODE_ALTERA=3
export CL_CONTEXT_COMPILER_MODE_INTELFPGA=3
export INTELFPGAOCLSDKROOT="\$HOME/tools/intelrtestack/intelFPGA_pro/aclrte-linux64"
export ALTERAOCLSDKROOT="\$INTELFPGAOCLSDKROOT"
export AOCL_BOARD_PACKAGE_ROOT="\$OPAE_PLATFORM_ROOT/opencl/opencl_bsp"
\$AOCL_BOARD_PACKAGE_ROOT/linux64/libexec/setup_permissions.sh
source $INTELFPGAOCLSDKROOT/init_opencl.sh
export IE_INSTALL="/opt/intel/openvino/deployment_tools"
source \$IE_INSTALL/../bin/setupvars.sh
export PATH="\$PATH:\$HOME/inference_engine_samples/intel64/Release"
alias mo="python3.6 \$IE_INSTALL/model_optimizer/mo.py"

2. Source the script

source ~/init_openvino.sh

Program a Bitstream

The bitstream you program should correspond to the topology you want to deploy. In this section, you program a SqueezeNet bitstream and deploy the classification sample with a SqueezeNet model.

Important

: Only use bitstreams from the installed version of the Intel® Distribution of OpenVINO™ toolkit. Bitstreams from older versions of the Intel® Distribution of OpenVINO™ toolkit are incompatible with later versions. For example, you cannot use the 1-0-1_RC_FP16_Generic bitstream, when the Intel® Distribution of OpenVINO™ toolkit supports the 2-0-1_RC_FP16_Generic bitstream.

There are different folders for each FPGA card type which were downloaded in the Intel® Distribution of OpenVINO™ toolkit package. For the Intel® Programmable Acceleration Card with Intel® Arria® 10 FPGA GX, the pre-trained bitstreams are in the /opt/intel/openvino/bitstreams/a10_dcp_bitstreams directory. This example uses a SqueezeNet bitstream with low precision for the classification sample.

Program the bitstream for Intel® Programmable Acceleration Card with Intel® Arria® 10 FPGA GX:

aocl program acl0 /opt/intel/openvino/bitstreams/a10_dcp_bitstreams/5-0_RC_FP11_SqueezeNet.aocx

Use the Intel® Distribution of OpenVINO™ toolkit

1. Run inference with the Intel® Distribution of OpenVINO™ toolkit independent of the demo scripts using the SqueezeNet model that was download by the scripts. For convenience, copy the necessary files to a local directory. If the workstation has been rebooted or a new terminal is opened, source the script above first.

mkdir ~/openvino_test

cd ~/openvino_test

cp ~/openvino_models/classification/squeezenet/1.1/caffe/squeezenet1.1.* .

cp ~/openvino_models/ir/squeezenet1.1/squeezenet1.1.labels .

2. Note that the squeezenet1.1.labels file contains the classes used by ImageNet and is included here so that the inference results show text rather than classification numbers. Convert the model with the Model Optimizer. Note that the command below uses the alias defined in the script above and is not referred to in other documentation.

mo --input_model squeezenet1.1.caffemodel

3. Now run Inference on the CPU using one of the built in Inference Engine samples:

classification_sample_async -m squeezenet1.1.xml -i $IE_INSTALL/demo/car.png

4. Add the -d option to run on FPGA:

classification_sample_async -m squeezenet1.1.xml -i $IE_INSTALL/demo/car.png -d HETERO:FPGA,CPU

5. Increase the number of iterations with the -ni option to reduce the impact of initialization:

classification_sample_async -m squeezenet1.1.xml -i $IE_INSTALL/demo/car.png -d HETERO:FPGA,CPU -ni 100

Congratulations, You are done with the Intel® Distribution of OpenVINO™ toolkit installation for FPGA. To learn more about how the Intel® Distribution of OpenVINO™ toolkit works, the Hello World tutorial and are other resources are provided below.

Hello World Face Detection Tutorial

Use the Intel® Distribution of OpenVINO™ toolkit with FPGA Hello World Face Detection Exercise to learn more about how the software and hardware work together.

Additional Resources

Intel® Distribution of OpenVINO™ toolkit home page: https://software.intel.com/en-us/openvino-toolkit

Intel® Distribution of OpenVINO™ toolkit documentation: https://docs.openvinotoolkit.org

Inference Engine FPGA plugin documentation: https://docs.openvinotoolkit.org/latest/_docs_IE_DG_supported_plugins_FPGA.html