@@ -7,8 +7,7 @@ This document provides instructions on how to execute the provided FPGA-accelera
1.[Demonstration Application Overview](#overview)
2.[AWS Prerequisites](#prerequisites)
*[AWS Account, F1/EC2 Instances, On-Premises, AWS IAM Permissions, AWS CLI and S3 Setup](#iss)
*[Github and Environment Setup](#gitsetenv)
3.[Build the host application, Xilinx FPGA binary and verify you are ready for FPGA acceleration](#createapp)
3.[Obtain application files and prepare the instance for execution of the accelerated application](#createapp)
*[Emulate the code](#emu)
*[Software Emulation](#swemu)
*[Hardware Emulation](#hwemu)
...
...
@@ -44,14 +43,21 @@ If you do not already have an AWS account, you should follow these steps to esta
* When selecting a region to deploy the instance, choose US East (N. Virginia).
* Select the f1.2xlarge instance and keep the default configuration settings.
* Before completing the process you will be asked to create a new key pair or use an existing one. Select a new key pair and save the file \*.pem file. You need to keep this file in a safe place as it is your "passport" to accessing remotely the AWS instance.
* Important: if you are using a *nix based machine as your access environment
* Important: if you are using a *nix based machine as your access environment, make sure that the \*.pem file has 600 permissions.
* Launch the instance.
* If this is the first time you launch an F1 instance, you will be prompted that you need to be granted permission to launch an EC2 f1.2xlarge instance (increase limit request to 1) in the specified region. The application process is simple and you will be granted the limit increase typically within a day from Amazon.
* Follow the [On-Premises Instructions](../hdk/docs/on_premise_licensing_help.md) to purchase and install a license from Xilinx.
* Setup AWS IAM permissions for creating FPGA Images (CreateFpgaImage and DescribeFpgaImages). [EC2 API Permissions are described in more detail](http://docs.aws.amazon.com/AWSEC2/latest/APIReference/ec2-api-permissions.html). It is highly recommended that you validate your AWS IAM permissions prior to proceeding with this quick start. By calling the [DescribeFpgaImages API](../hdk/docs/describe_fpga_images.md) you can check that your IAM permissions are correct.
*[Setup AWS CLI and S3 Bucket](docs/Setup_AWS_CLI_and_S3_Bucket.md) to enable AFI creation.
* Install optional [packages](packages.txt) required to run all examples. If you do not install these packages, some examples may not work properly. The setup scripts will warn you of any missing packages.
* Additional dependencies may get flagged during the AWS SDAccel scripts as warnings or errors.
<aname="createapp"></a>
# Obtain application files and prepare the instance for execution of the accelerated application
To obtain all required files for the demonstration application, clone this repository: