| SDx Version used for AFI Development | Compatible SDAccel Runtime |
|---|---|
| 2017.4 | Runtime installed by sourcing "sdaccel_setup.sh" while using HDK Ver 1.4.X when environment variable RELEASE_VER=2017.4 |
| 2018.2 | AWS FPGA Developer AMI 1.5.0 ( XRT is pre-installed) or Runtime installed with XRT Version 2.1.0 |
| 2018.3 | AWS FPGA Developer AMI 1.6.0 ( XRT is pre-installed) or Runtime installed with XRT Version 2.1.0 |
-
Please note Amazon Linux 2 or Amazon Linux are not supported by Xilinx XRT at this time. Please use Centos/RHEL or Ubuntu when using Xilinx XRT Runtimes for the AFIs generated using Xilinx SDx 2018.2 and 2018.3 toolsets.
-
Launch an F1 instance using an Amazon Linux AMI or Centos 7
-
Install the required updates
$ sudo yum update
- Reboot your Runtime Instance to ensure all updates are running.
- Install the required packages
$ sudo yum install git
$ sudo yum install gcc
$ sudo yum install gcc-c++
$ sudo yum install kernel-headers
$ sudo yum install kernel-devel
$ sudo yum --enablerepo=epel install ocl-icd ocl-icd-devel opencl-headers
$ sudo mkdir -p /etc/OpenCL/vendors/
- Launch an F1 instance using an Ubuntu 16.04 LTS
- Install the required updates
$ sudo apt-get update
- Reboot your Runtime Instance to ensure all updates are running.
- Install the required packages
$ sudo apt-get install gcc
$ sudo apt-get install g++
$ sudo apt-get install make
$ sudo apt-get install linux-headers-`uname -r`
$ sudo apt-get install linux-libc-dev
$ sudo apt-get install ocl-icd-dev ocl-icd-libopencl1 opencl-headers ocl-icd-opencl-dev
$ sudo mkdir -p /etc/OpenCL/vendors/
-
Using an instance running FPGA Developer AMI or an on-premises machine with access to a Xilinx SDAccel Tools Installation, first source $AWS_FPGA_REPO_DIR/sdaccel_setup.sh and then run following commands:
-
if using Ubuntu or debian distribution set GLIBPATH env variable to Ubuntu. If using any other OS distribution set GLIBPATH to default.
-
set env variable 'XLNXRTE' to intended runtime install directory path.
$ export GLIBPATH= <Ubuntu or default -- see note above>
$ export XLNXRTE=<your runtime install directory path>
$ mkdir -p $XLNXRTE/runtime/platforms/$(DSA)/driver
$ mkdir -p $XLNXRTE/lib/lnx64.o
$ mkdir -p $XLNXRTE/runtime/bin
$ mkdir -p $XLNXRTE/runtime/lib/x86_64
$ cp $SDACCEL_DIR/userspace/src2/libxrt-aws.so $XLNXRTE/runtime/platforms/xilinx_aws-vu9p-f1-04261818_dynamic_5_0/driver/
$ cp $SDACCEL_DIR/tools/awssak2/xbsak $XLNXRTE/runtime/bin/
$ cp $XIILNX_SDX/lib/lnx64.o/$GLIBPATH/libstdc++.so* xlnxrte/lib/x86_64/
$ cp $XIILNX_SDX/runtime/bin/xclbinsplit xlnxrte/runtime/bin/
$ cp $XIILNX_SDX/runtime/bin/xclbincat xlnxrte/runtime/bin/
$ cp $SDACCEL_DIR/aws_platform/xilinx_aws-vu9p-f1-04261818_dynamic_5_0/sw/lib/x86_64/libxilinxopencl.so $XLNXRTE/runtime/lib/x86_64/
$ cp /opt/Xilinx/SDx/2017.4.rte.dyn/setup.sh $XLNXRTE/
$ cp /opt/Xilinx/SDx/2017.4.rte.dyn/setup.csh $XLNXRTE/
- You may need to update path in $XLNXRTE/setup.sh and $XLNXRTE/setup.csh script to match your runtime instance.
- Copy $XLNXRTE directory created to $HOME on your Runtime Instance.
Please refer installing Xilinx SDx 2018.2 XRT for instructions on how to install XRT on your AMI.
Please refer installing Xilinx SDx 2018.3 XRT for instructions on how to install runtime on your AMI.
- Log back on to the Runtime Instance:
$ export XILINX_SDX=$HOME/$XLNXRTE
- You should be able to run your FPGA accelerated application as described here, without needing to launch a new F1 instance
- Once you have your application running you should be able to create a Runtime AMI based your Runtime Instance as specified here.
- Please see Section 5 of the AWS Marketplace Seller's Guide for more details.