Merge pull request #756 from aws/rc/2.2.2

Release v2.2.2

Author: mjthimm

.gitignore

@@ -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

README.md

@@ -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!**
 

RELEASE_NOTES.md

@@ -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

User_Guide_AWS_EC2_FPGA_Development_Kit.md

@@ -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.

developer_resources/Amazon_DCV_Setup_Guide.md

@@ -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