aws · TrahStevAmz · Jul 1, 2025 · Jun 30, 2025
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -1,5 +1,13 @@
 # F2 Developer Kit Release Notes
 
+## v2.1.1
+
+* Added global register offset for the SDE IP. See [CL_SDE software examples](./hdk/cl/examples/cl_sde/software/src/README.md).
+* Added [CL_SDE software exmaple](./hdk/cl/examples/cl_sde/software/src/sde_c2h_user_buffers.c) for a user allocated DMA buffer.
+* [Documentation](./hdk/docs/List_AFI_on_Marketplace.md) to assist F2 customers with releasing AFIs and AMIs on the AWS Marketplace.
+* [Documentation](./developer_resources/Amazon_DCV_Setup_Guide.md) to assist in creating a virtual desktop based on the FPGA Developer AMI running graphics-intensive applications remotely on Amazon EC2 instances.
+* Fixed the BW calculation and tolerance calculation in the test_hbm_perf_random in the [cl_mem_perf](./hdk/cl/examples/cl_mem_perf/verif/README.md#test_hbm_perf_randomsv).
+
 ## v2.1.0
 
 * Support for Vivado and Vitis 2024.2 tools.

diff --git a/developer_resources/Amazon_DCV_Setup_Guide.md b/developer_resources/Amazon_DCV_Setup_Guide.md
@@ -0,0 +1,112 @@
+# Using EC2 Instances with a GUI
+
+## Table of Contents
+
+- [What is Amazon DCV?](#what-is-amazon-dcv)
+- [Installing the Amazon DCV Server on an Amazon EC2 Instance](#installing-the-amazon-dcv-server-on-an-amazon-ec2-instance)
+  - [Prerequisites](#prerequisites)
+  - [Amazon DCV Server Installation](#amazon-dcv-server-installation)
+  - [Post-Installation Checks](#post-installation-checks)
+  - [Setting a Password for Your Sessions](#setting-a-password-for-your-sessions)
+  - [Setting Security Rules to Allow Traffic on Port 8443](#setting-security-rules-to-allow-traffic-on-port-8443)
+- [Amazon DCV Client Installation](#amazon-dcv-client-installation)
+- [Basic Session Management](#basic-session-management)
+  - [Quick Session Startup](#quick-session-startup)
+
+## What is Amazon DCV?
+
+[Amazon DCV](https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html) is a high-performance remote
+display protocol that provides customers with a secure way to deliver remote desktops and application streaming
+from any cloud or data center to any device, over varying network conditions. With Amazon DCV and Amazon EC2,
+customers can run graphics-intensive applications remotely on EC2 instances and stream the results to simpler
+client machines, eliminating the need for expensive dedicated workstations.
+
+This guide helps customers developing for AWS F2 instances create a virtual desktop running on EC2 instances
+based on the [FPGA Developer AMI](../User_Guide_AWS_EC2_FPGA_Development_Kit.md#fpga-developer-ami).
+The FPGA Developer AMI has pre-installed tools which are license free. Combined with DCV, this enables
+development using Vivado or Vitis' graphical Integrated Design Environment (IDE), which provides an intuitive
+graphical user interface (GUI) to visualize FPGA development in the cloud.
+
+## Installing the Amazon DCV Server on an Amazon EC2 Instance
+
+### Prerequisites
+
+1. [Depenency Installation](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-gui)
+    * :warning: DO NOT PERFORM STEP 3! Upgrading may impact the stability of development kit software!
+2. [Protocol Setup](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-wayland)
+3. [Driver Installation](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-nongpu)
+
+### Amazon DCV Server Installation
+
+In the [install procedure described here](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-server.html#linux-server-install), follow steps 1 through 5, 7, and 8.
+When you get to step 9, do the following:
+
+``` bash
+    sudo apt --fix-broken install
+    sudo apt install -y mesa-utils
+    sudo dpkg -i nice-dcv-gl_2024.0.1096-1_amd64.ubuntu<2404 or 2004>.deb
+```
+
+### Post-Installation Checks
+
+[This section of the post-installation check](https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-checks.html#checks-xserver) should be run to ensure that all aspects of the setup are working as expected.
+
+### Setting a Password for Your Sessions
+
+In order to connect to an Amazon DCV session, you must have a password set for your user on the EC2 instance.
+This can be done with this command:
+
+``` bash
+sudo passwd $USER
+```
+
+### Setting Security Rules to Allow Traffic on Port 8443
+
+In order for Amazon DCV to communicate with your EC2 instance, TCP and UDP traffic must be allowed on port 8443.
+This can be accomplished by updating the security group you used to launch your instance.
+
+## Amazon DCV Client Installation
+
+The [Amazon DCV client](https://www.amazondcv.com/) should be installed on your local machine and is used to view your virtual desktop on your EC2 instance.
+
+## Basic Session Management
+
+To begin, run the following two commands:
+
+``` bash
+sudo systemctl isolate multi-user.target (Ubuntu 20.04 only)
+sudo systemctl restart dcvserver.service
+sudo systemctl restart dcvsessionlauncher.service
+```
+
+Next, refer to the [session management user guide here](https://docs.aws.amazon.com/dcv/latest/adminguide/managing-sessions.html). This guide will provide you with all of the information you need to customize and manage your Amazon DCV sessions.
+
+### Quick Session Startup
+
+To start a session, use the following command:
+
+``` bash
+dcv create-session $your_session_number
+dcv list-sessions
+Session: '1' (owner:ubuntu type:virtual)
+```
+
+You may give your session any number you like, but no two sessions may have the same number.
+
+From this point, you can access your session using the Amazon DCV client on your local machine or via the [DCV console in your web browser](https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting-browser-connect.html).
+
+Enter `https://user@ec2_instance_ip_address:8443` into the `Hostname or IP Address` box and click `Connect`. Next, click "Trust and Connect".
+
+Enter the password you set in [Post-Installation Checks](#post-installation-checks) in the `Password` box and click `Login`.
+
+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
+ubuntu@ip-1-2-3-4:~$ source /etc/profile.d/default_module.sh
+ubuntu@ip-1-2-3-4:~$ vivado -version
+vivado v2024.1 (64-bit)
+```
diff --git a/developer_resources/DCV.md b/developer_resources/DCV.md
diff --git a/docs-rtd/source/RELEASE-NOTES.rst b/docs-rtd/source/RELEASE-NOTES.rst
@@ -1,6 +1,17 @@
 F2 Developer Kit Release Notes
 ==============================
 
+.. _v211:
+
+v2.1.1
+------
+
+- Added global register offset for the SDE IP. See `CL_SDE software examples <./hdk/cl/examples/cl-sde/software/src/README.html>`__.
+- Added `CL_SDE software exmaple <https://github.com/aws/aws-fpga/blob/f2/hdk/cl/examples/cl_sde/software/src/sde_c2h_user_buffers.c>`__ for a user allocated DMA buffer.
+- `Documentation <./hdk/docs/List-AFI-on-Marketplace.html>`__` to assist F2 customers with releasing AFIs and AMIs on the AWS Marketplace.
+- `Documentation <./developer-resources/Amazon-DCV-Setup-Guide.html>`__ to assist in creating a virtual desktop based on the FPGA Developer AMI running graphics-intensive applications remotely on Amazon EC2 instances.
+- Fixed the BW calculation and tolerance calculation in the test_hbm_perf_random in the `cl_mem_perf <./hdk/cl/examples/cl-mem-perf/verif/README.html#test-hbm-perf-randomsv-mem>`__.
+
 .. _v210:
 
 v2.1.0

diff --git a/docs-rtd/source/all-links.rst b/docs-rtd/source/all-links.rst
@@ -70,6 +70,7 @@ General Documentation
   hdk/docs/AWS-Shell-ERRATA
   hdk/docs/AWS-Shell-Interface-Specification
   hdk/docs/Clock-Recipes-User-Guide
+  hdk/docs/List-AFI-on-Marketplace
   hdk/docs/on-premise-licensing-help
   hdk/docs/RTL-Simulation-Guide-for-HDK-Design-Flow
   hdk/docs/shell-floorplan

diff --git a/docs-rtd/source/developer-resources/Amazon-DCV-Setup-Guide.rst b/docs-rtd/source/developer-resources/Amazon-DCV-Setup-Guide.rst
@@ -0,0 +1,165 @@
+Using EC2 Instances with a GUI
+==============================
+
+Table of Contents
+-----------------
+
+- `What is Amazon DCV? <#what-is-amazon-dcv>`__
+- `Installing the Amazon DCV Server on an Amazon EC2
+  Instance <#installing-the-amazon-dcv-server-on-an-amazon-ec2-instance>`__
+
+  - `Prerequisites <#prerequisites>`__
+  - `Amazon DCV Server Installation <#amazon-dcv-server-installation>`__
+  - `Post-Installation Checks <#post-installation-checks>`__
+  - `Setting a Password for Your
+    Sessions <#setting-a-password-for-your-sessions>`__
+  - `Setting Security Rules to Allow Traffic on Port
+    8443 <#setting-security-rules-to-allow-traffic-on-port-8443>`__
+
+- `Amazon DCV Client Installation <#amazon-dcv-client-installation>`__
+- `Basic Session Management <#basic-session-management>`__
+
+  - `Quick Session Startup <#quick-session-startup>`__
+
+What is Amazon DCV?
+-------------------
+
+`Amazon
+DCV <https://docs.aws.amazon.com/dcv/latest/adminguide/what-is-dcv.html>`__
+is a high-performance remote display protocol that provides customers
+with a secure way to deliver remote desktops and application streaming
+from any cloud or data center to any device, over varying network
+conditions. With Amazon DCV and Amazon EC2, customers can run
+graphics-intensive applications remotely on EC2 instances and stream the
+results to simpler client machines, eliminating the need for expensive
+dedicated workstations.
+
+This guide helps customers developing for AWS F2 instances create a
+virtual desktop running on EC2 instances based on the `FPGA Developer
+AMI <../User-Guide-AWS-EC2-FPGA-Development-Kit.html#fpga-developer-ami>`__.
+The FPGA Developer AMI has pre-installed tools which are license free.
+Combined with DCV, this enables development using Vivado or Vitis'
+graphical Integrated Design Environment (IDE), which provides an
+intuitive graphical user interface (GUI) to visualize FPGA development
+in the cloud.
+
+Installing the Amazon DCV Server on an Amazon EC2 Instance
+----------------------------------------------------------
+
+Prerequisites
+~~~~~~~~~~~~~
+
+1. `Depenency
+   Installation <https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-gui>`__
+
+   - ⚠️ DO NOT PERFORM STEP 3! Upgrading may impact the stability of
+     development kit software!
+
+2. `Protocol
+   Setup <https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-wayland>`__
+3. `Driver
+   Installation <https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-prereq.html#linux-prereq-nongpu>`__
+
+Amazon DCV Server Installation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In the `install procedure described
+here <https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-server.html#linux-server-install>`__,
+follow steps 1 through 5, 7, and 8. When you get to step 9, do the
+following:
+
+.. code:: bash
+
+       sudo apt --fix-broken install
+       sudo apt install -y mesa-utils
+       sudo dpkg -i nice-dcv-gl_2024.0.1096-1_amd64.ubuntu<2404 or 2004>.deb
+
+Post-Installation Checks
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+`This section of the post-installation
+check <https://docs.aws.amazon.com/dcv/latest/adminguide/setting-up-installing-linux-checks.html#checks-xserver>`__
+should be run to ensure that all aspects of the setup are working as
+expected.
+
+Setting a Password for Your Sessions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order to connect to an Amazon DCV session, you must have a password
+set for your user on the EC2 instance. This can be done with this
+command:
+
+.. code:: bash
+
+   sudo passwd $USER
+
+Setting Security Rules to Allow Traffic on Port 8443
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In order for Amazon DCV to communicate with your EC2 instance, TCP and
+UDP traffic must be allowed on port 8443. This can be accomplished by
+updating the security group you used to launch your instance.
+
+Amazon DCV Client Installation
+------------------------------
+
+The `Amazon DCV client <https://www.amazondcv.com/>`__ should be
+installed on your local machine and is used to view your virtual
+desktop on your EC2 instance.
+
+Basic Session Management
+------------------------
+
+To begin, run the following two commands:
+
+.. code:: bash
+
+   sudo systemctl isolate multi-user.target (Ubuntu 20.04 only)
+   sudo systemctl restart dcvserver.service
+   sudo systemctl restart dcvsessionlauncher.service
+
+Next, refer to the `session management user guide
+here <https://docs.aws.amazon.com/dcv/latest/adminguide/managing-sessions.html>`__.
+This guide will provide you with all of the information you need to
+customize and manage your Amazon DCV sessions.
+
+Quick Session Startup
+~~~~~~~~~~~~~~~~~~~~~
+
+To start a session, use the following command:
+
+.. code:: bash
+
+   dcv create-session $your_session_number
+   dcv list-sessions
+   Session: '1' (owner:ubuntu type:virtual)
+
+You may give your session any number you like, but no two sessions may
+have the same number.
+
+From this point, you can access your session using the Amazon DCV client
+on your local machine or via the `DCV console in your web browser <https://docs.aws.amazon.com/dcv/latest/userguide/using-connecting-browser-connect.html>`__.
+
+Enter ``https://user@ec2_instance_ip_address:8443`` into the
+``Hostname or IP Address`` box and click ``Connect``. Next, click "Trust
+and Connect".
+
+Enter the password you set in `Post-Installation
+Checks <#post-installation-checks>`__ in the ``Password`` box and click
+``Login``.
+
+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.
+
+.. code:: bash
+
+   ubuntu@ip-1-2-3-4:~$ source /etc/profile.d/default_module.sh
+   ubuntu@ip-1-2-3-4:~$ vivado -version
+   vivado v2024.1 (64-bit)
diff --git a/docs-rtd/source/developer-resources/DCV.rst b/docs-rtd/source/developer-resources/DCV.rst
diff --git a/docs-rtd/source/hdk/README.rst b/docs-rtd/source/hdk/README.rst
@@ -809,6 +809,7 @@ Additional HDK Documentation
   docs/shell-floorplan
   docs/AWS-Fpga-Pcie-Memory-Map
   docs/RTL-Simulation-Guide-for-HDK-Design-Flow
+  docs/List-AFI-on-Marketplace
   docs/on-premise-licensing-help
   docs/Supported-DDR-Modes
   docs/Virtual-JTAG-XVC