Add --package-only to aws_build_dcp_from_cl.py to package an existing DCP

docs-rtd/source/hdk/README.rst

@@ -186,6 +186,10 @@ A few more notes on
   source code and DCPs. Encryption, enabled by default, may impede
   debugging as errors from encrypted envelope do not provide meaningful
   information.
+- Use ``--package-only -t <YYYY_MM_DD-HHMMSS>`` to skip Vivado and
+  package an existing post-route DCP. The tag must match the checkpoint
+  filename (``<cl>.<tag>.post_route.dcp`` in
+  ``$CL_DIR/build/checkpoints``).
 - The script also allows developers to pass different Vivado directives
   as shown below:
 

hdk/README.md

@@ -109,6 +109,7 @@ A few more notes on [aws_build_dcp_from_cl.py](https://github.com/aws/aws-fpga/b
 - Use `--cl <CL name>` option to build a different CL design. This is default to `cl_dram_hbm_dma`.
 - Use `--aws_clk_gen` option to annotate the use of [AWS clock generation block](./docs/AWS_CLK_GEN_spec.md) and [customer clock recipes](./docs/Clock_Recipes_User_Guide.md).
 - Use `--no-encrypt` option to disable encryption of the design's source code and DCPs. Encryption, enabled by default, may impede debugging as errors from encrypted envelope do not provide meaningful information.
+- Use `--package-only -t <YYYY_MM_DD-HHMMSS>` to skip Vivado and package an existing post-route DCP. The tag must match the checkpoint filename (`<cl>.<tag>.post_route.dcp` in `$CL_DIR/build/checkpoints`).
 - The script also allows developers to pass different Vivado directives as shown below:
   - `--place <directive>`: Default to `SSI_SpreadLogic_high` placement strategy. Please refer to [Vivado User Guide](https://docs.amd.com/r/en-US/ug904-vivado-implementation/Available-Directives) for supported directives.
   - `--phy_opt <directive>` : Default to `AggressiveExplore` physical optimization strategy. Please refer to [Vivado User Guide](https://docs.amd.com/r/en-US/ug904-vivado-implementation/Using-Directives?tocId=9xJiGeSV35ApxUsX7pAVDg) for supported directives

hdk/common/shell_stable/build/scripts/aws_build_dcp_from_cl.py

@@ -256,6 +256,14 @@ def main():
         default=True,
     )
 
+    parser.add_option(
+        "--package-only",
+        dest="package_only",
+        action="store_true",
+        default=False,
+        help="Skip Vivado and package an existing post-route DCP. Requires --tag matching the checkpoint timestamp.",
+    )
+
     (options, args) = parser.parse_args()
 
     print("==================================================")
@@ -323,18 +331,21 @@ def main():
 
             Custom `clock_recipe` arguments were detected, please add `--aws_clk_gen` to continue.""")
 
-    # Run the Vivado job
-    cmd = (
-        f"vivado -mode batch -source build_all.tcl -log {build_tag}.vivado.log "
-        + f"-tclargs {options.place_direct} {options.phy_opt_direct} {options.route_direct} "
-        + f"{options.clock_recipe_a} {options.clock_recipe_b} {options.clock_recipe_c} {options.clock_recipe_hbm} "
-    )
-
     start_time = datetime.datetime.now()
     print(f"\nAWS FPGA: {start_time.strftime(TIMESTAMP_LOG_FORMAT)} - Build starts\n")
-
     sys.stdout.flush()
-    os.system(cmd)
+
+    if options.package_only:
+        if not options.build_tag:
+            print_error("--package-only requires --tag matching an existing post-route DCP (for example -t YYYY_MM_DD-HHMMSS)")
+        print(f"AWS FPGA: --package-only set, skipping Vivado and packaging tag {build_tag}\n")
+    else:
+        cmd = (
+            f"vivado -mode batch -source build_all.tcl -log {build_tag}.vivado.log "
+            + f"-tclargs {options.place_direct} {options.phy_opt_direct} {options.route_direct} "
+            + f"{options.clock_recipe_a} {options.clock_recipe_b} {options.clock_recipe_c} {options.clock_recipe_hbm} "
+        )
+        os.system(cmd)
 
     if options.flow == "BuildAll":
         generate_dcp_tarball(