This release includes two portions: HDK for developing Amazon FPGA Image (AFI), and SDK for using AFI on FPGA-enabled EC2 instances such as F1.

Execute git clone http://github.com/aws/aws-fpga to download this HDK+SDK release to your EC2 Instance or local server.

The Release Notes document covers the list of supported features, programming environment, and known restrictions.

NOTE: The HDK and SDK are tested and supported for Linux operating systems, for the time being, other OSs haven't been tested by AWS

Please click the "Watch" button in GitHub upper right corner to stay posted.

The HDK directory is recommended for developers wanting to start building Amazon FPGA Images (AFI). It includes the development environment, simulation, build and AFI creation scripts. The HDK can be installed on any server or EC2 instance. AWS recommends the use of the FPGA Developer AMI on AWS Marketplace. The HDK is not required if you are using a pre-built AFI and not planning to build your own AFI.

Execute source ./hdk_setup.sh to setup the environment variables required by the rest of the HDK scripts.

The SDK directory includes the drivers and runtime environment required by any EC2 Instance running on F1. It includes the drivers and tools to interact with pre-built AFIs that are loaded to EC2 F1 FPGAs. The SDK is not required during the AFI development process; it is only required once the AFI is loaded onto an F1 instance.

By following the next few steps, you would have downloaded the HDK, compiled and built one of the example Custom Logic (CL) designs included in this HDK, and registered it with AWS. You can run these steps on any EC2 instance, with C4 and M4 being the recommended instance types for performance.

• AWS FPGA HDK and SDK run in Linux environment only.
• If you can not access GitHub repository, please request access permission from your AWS representative.
• The build stage uses Xilinx's Vivado tool set. You should have an installed Vivado and Vivado License Manager (See Release Notes for details on the version).
• Executing aws s3 <action> and aws ec2 create-fpga-image require having AWS CLI installed, having an active AWS account, and the server/instance has been configured with your credentials and AWS region via aws configure command line.
• AWS offers FPGA Developer AMI with all Xilinx's Vivado tools and AWS CLI pre-installed.

NOTE: The DCP generation (Step 7) can take up to several hours to complete. We recommend that you initiate the generation in a way that prevents interruption. For example, if working on a remote machine, we recommend using window management tools such as screen to mitigate potential network disconnects.

$ git clone https://github.com/aws/aws-fpga # Step 1: Download the HDK and SDK code $ cd aws-fpga # Step 2: Move to the root directory $ source hdk_setup.sh # Step 3: Set up the HDK environment variables $ cd hdk/cl/examples/cl_simple # Step 4: Change directory to one of the provided examples $ export CL_DIR=$(pwd) # Step 5: Define this directory as the root for the CL design $ cd build/scripts # Step 6: The build directory for synthesizing, placement, timing etc $ source aws_build_dcp_from_cl.sh # Step 7: Generate a placed-and-routed design checkpoint (DCP) $ cd $CL_DIR/build/checkpoints/to_aws # Step 8: This directory includes the DCP file $ aws s3 mb s3://<bucket-name> # Step 9: Create an S3 bucket (choose a unique bucket name) $ aws s3 cp *.SH_CL_routed.dcp \ # Step 10: Upload the DCP file to S3 s3://<bucket-name>/cl_simple.dcp $ aws ec2 create-fpga-image \ # Step 11: Ingest the generated DCP to create an AFI --fpga-image-architecture xvu9p \ --shell-version 0x11241611 \ --fpga-pci-id deviceId=0x1d50,vendorId=0x6789,subsystemId=0x1d51,subsystemVendorId=0xfedc \ --input-storage-location Bucket=<bucket-name>,Key=cl_simple.dcp --name MyFirstDCP --logs-storage-location Bucket=<bucket-name>,Key=logs/ 

NOTE: The aws ec2 create-fpga-image command-line API is coming soon and subject to change.

Now that you have built an AFI, or if you want to use one of the example pre-built AFIs provided by AWS, you need to launch an EC2 F1 Instance, and install the SDK:

You can setup and install the SDK with the following few steps. Note that the first two steps may be skipped if you have already run them in the above HDK setup.

$ git clone https://github.com/aws/aws-fpga # Fetch the HDK and SDK code $ cd aws-fpga # Move to the root directory of the repository before running the next script $ source sdk_setup.sh # Set up the envronment variables, build and install the SDK 

NOTE: The sdk_setup.sh would install the FPGA management tools if they are not already available in /usr/bin. The sdk_setup.sh requires having gcc installed. if it is not installed, try running the next command to install it on Amazon Linux, Centos or Redhat distributions:

$ sudo yum groupinstall -y “Development Tools" 

The Getting started with CL examples guide provides step-by-step instructions to build an AFI from one of the provided examples, register it with AWS, and load it on an EC2 F1 instance.