Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -145,3 +145,12 @@ docs-rtd/build/*
*.tmp
**/example_projects/
*.pb

# Runtime AMI BUilder
developer_resources/runtime_ami_builder/.DS_Store
developer_resources/runtime_ami_builder/.eslintcache
developer_resources/runtime_ami_builder/build
developer_resources/runtime_ami_builder/dist/
developer_resources/runtime_ami_builder/node_modules
developer_resources/runtime_ami_builder/.idea
developer_resources/runtime_ami_builder/cdk.out
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

## F2 FPGA Developer Kit Documentation on ReadTheDocs

The documentation for the F2 FPGA Developer Kit including our User Guide, tutorials, code snippets, and more can now be found on [our ReadTheDocs webstie](https://awsdocs-fpga-f2.readthedocs-hosted.com).
The documentation for the F2 FPGA Developer Kit including our User Guide, tutorials, code snippets, and more can now be found on [our ReadTheDocs website](https://awsdocs-fpga-f2.readthedocs-hosted.com).

**Please note that the documentation and assets provided on this branch and others prefixed with `f2` are relevant to F2 instances only!**

Expand Down
12 changes: 12 additions & 0 deletions RELEASE_NOTES.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# F2 Developer Kit Release Notes

## v2.2.2

* Introducing the AWS EC2 F2 Runtime AMI Builder (RAB)
* The RAB is a customizable and extensible tool based on [the AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/home.html) that easily automates building production-ready AMIs tailored to each accelerator application's needs
* [To get started building a runtime AMI, see the README here](./developer_resources/runtime_ami_builder/README.md)
* Default components are provided to modularly install specific features such as Vivado Lab Edition, the AWS CLI, the AWS FPGA SDK, and more
* [To learn how to integrate the RAB into existing AWS CDK flows, see the code example here](./developer_resources/runtime_ami_builder/lib/exampleLibraryUsage.ts)
* [Updated Rocky FPGA Developer AMI](https://aws.amazon.com/marketplace/pp/prodview-7mukkbz7l2uvu) name and description to match Marketplace info
* Added F2 [AFI Manifest specification](./hdk/docs/AFI_Manifest.md) for the version number, ID, and clock parameters
* Added new "--no-encrypt" build option to the HDK flow to facilitate source code debugging
* Updated [fpga_clkgen_util](./sdk/userspace/fpga_libs/fpga_clkgen/fpga_clkgen_utils.c) and [sde_examples](./hdk/cl/examples/cl_sde/software/src/README.md) with better error handling procedures, addressing stability issues found on Rocky Linux.

## v2.2.1

* [Release of FPGA Developer AMI 1.18.0 (Rocky Linux 8.10)](http://aws.amazon.com/marketplace/pp/prodview-7mukkbz7l2uvu) with Vivado/Vitis 2025.1 tools pre-installed
Expand Down
5 changes: 4 additions & 1 deletion User_Guide_AWS_EC2_FPGA_Development_Kit.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,14 +217,17 @@ A free-to-use FPGA developer AMI is available for on-cloud F2 development with A

| FPGA Developer AMI Version | FPGA Developer AMI ID (us-east-1) | Vivado/Vitis Version Supported | Operating System Version |
|----------------------------|-----------------------------------|--------------------------------|-----------------------------|
| 1.18.0 | [ami-04b57de2833b499b1](http://aws.amazon.com/marketplace/pp/prodview-7mukkbz7l2uvu) | 2025.1 | Rocky Linux 8.10 (4.18.0-553.36.1.el8_10.x86_64)|
| 1.18.0 | [ami-0cb1b6ae2ff99f8bf](http://aws.amazon.com/marketplace/pp/prodview-7mukkbz7l2uvu) | 2025.1 | Rocky Linux 8.10 (4.18.0-553.36.1.el8_10.x86_64)|
| 1.18.0 | [ami-098b2ed4c92602975](http://aws.amazon.com/marketplace/pp/prodview-tcl7sjgreh6bq) | 2025.1 | Ubuntu 24.04 (kernel 6.8.0-1021-aws)|
| 1.16.1 | [ami-092fc5deb8f3c0f7d](https://aws.amazon.com/marketplace/pp/prodview-f5kjsenkfkz5u) | 2024.1 | Ubuntu 20.04.6 (kernel 5.15)|

Given the large size of the FPGA used for F2, AMD tools work best with at least 4 vCPU’s and 32GiB Memory. We recommend [Compute Optimized and Memory Optimized instance types](https://aws.amazon.com/ec2/instance-types/) to successfully run the synthesis of acceleration code. Developers may start coding and run simulations on low-cost `General Purpose` [instances types](https://aws.amazon.com/ec2/instance-types/).

Note that the tools used by the HDK are only supported on x86-based EC2 instances (Graviton-based instances are not compatible with the tools).

For long-term cost savings when evaluating or debugging an accelerator in hardware, we recommend [creating a runtime AMI using the Runtime AMI Builder (RAB)](./developer_resources/runtime_ami_builder/README.md).
The RAB is a customizable and extensible tool based on [the AWS CDK](https://docs.aws.amazon.com/cdk/v2/guide/home.html) that easily automates building production-ready AMIs tailored to each accelerator application's needs.

### Getting Familiar with AWS

If you have never used AWS before, we recommend you start with [AWS getting started training](https://aws.amazon.com/getting-started/), focusing on the basics of the [AWS EC2](https://aws.amazon.com/ec2/) and [AWS S3](https://aws.amazon.com/s3/) services. Understanding the fundamentals of these services will further enhance the developer experience with AWS F2 instances and the FPGA Developer Kit.
Expand Down
2 changes: 0 additions & 2 deletions developer_resources/Amazon_DCV_Setup_Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,8 +102,6 @@ Enter the password you set in [Post-Installation Checks](#post-installation-chec

At this point, you should see your session begin and a virtual desktop displayed after a brief delay.

Any popups about not having a license may be safely ignored. This is a known issue with DCV.

Now, open a terminal and run the following command: `source /etc/profile.d/default_module.sh`. You're now ready to use your GUI-enabled EC2 Instance.

``` bash
Expand Down
Loading