generate_afi.md

Table of contents (steps)
1. Create an AWS account
2. Generate SSH keys
3. Create S3 credential
4. Request access to Amazon EC2 F1 instances
5. Create an AMI instance
6. Configure S3 bucket
7. Setup development environment
8. Simulate the design
9. Build the hardware design
10. Generate the AFI
11. Program the FPGA
12. Compile the runtime of the design
13. Bookkeping the AFI

---

10. Generate the AFI

The Amazon FPGA Image or AFI is what it is used to program the FPGA or deploy the hardware

1. Make sure the final design (tar-file) and log file have been copied to the S3 bucket
2. Create a log file for monitoring AFI generation touch log-file.log
3. Copy log file to the s3 bucket aws s3 cp log-file.log s3://<your-s3-bucket>
4. Remove local log file rm log-file.log
5. Generate the AFI by running the following:

aws ec2 create-fpga-image --name <afi-name> \
                          --description <afi-description> \
                          --input-storage-location Bucket=<bucket-name>,Key=<path-to-tar-file> \
                          --logs-storage-location Bucket=<bucket-name>,Key=<path-to-log-file>

3. Copy and store the AFI and AGFI
4. Query if the AFI generation is done by aws ec2 describe-fpga-images --fpga-image-ids <AFI ID>
5. Wait until the AFI becomes available

{
    "FpgaImages": [
    {
        ...
        "State": {
            "Code": "available"
        },<
        ...
        "FpgaImageId": "afi-06d0ffc989feeea2a",
        ...
    }
    ]
}