Update variables.yaml to match FlowVariables.md changes

- Add FOOTPRINT variable for ICeWall-based floorplan initialization
- Add FOOTPRINT_TCL variable for custom footprint commands
- Update FLOORPLAN_DEF description to note mutual exclusivity

Signed-off-by: kcaisley <[email protected]>

Author: kcaisley

docs/user/FlowVariables.md

@@ -138,7 +138,6 @@ configuration file.
 | <a name="FLOW_VARIANT"></a>FLOW_VARIANT| Flow variant to use, used in the flow variant directory name.| base|
 | <a name="FOOTPRINT"></a>FOOTPRINT| Custom footprint definition file for ICeWall-based floorplan initialization. Mutually exclusive with FLOORPLAN_DEF or DIE_AREA/CORE_AREA or CORE_UTILIZATION.| |
 | <a name="FOOTPRINT_TCL"></a>FOOTPRINT_TCL| Specifies a Tcl script with custom footprint-related commands for floorplan setup.| |
-| <a name="FLOW_VARIANT"></a>FLOW_VARIANT| Flow variant to use, used in the flow variant directory name.| base|
 | <a name="GDS_ALLOW_EMPTY"></a>GDS_ALLOW_EMPTY| Regular expression of module names of macros that have no .gds file| |
 | <a name="GDS_FILES"></a>GDS_FILES| Path to platform GDS files.| |
 | <a name="GENERATE_ARTIFACTS_ON_FAILURE"></a>GENERATE_ARTIFACTS_ON_FAILURE| For instance Bazel needs artifacts (.odb and .rpt files) on a failure to allow the user to save hours on re-running the failed step locally, but when working with a Makefile flow, it is more natural to fail the step and leave the user to manually inspect the logs and artifacts directly via the file system. Set to 1 to change the behavior to generate artifacts upon failure to e.g. do a global route. The exit code will still be non-zero on all other failures that aren't covered by the "useful to inspect the artifacts on failure" use-case. Example: just like detailed routing, a global route that fails with congestion, is not a build failure(as in exit code non-zero), it is a successful(as in zero exit code) global route that produce reports detailing the problem. Detailed route will not proceed, if there is global routing congestion This allows build systems, such as bazel, to create artifacts for global and detailed route, even if the operation had problems, without having know about the semantics between global and detailed route. Considering that global and detailed route can run for a long time and use a lot of memory, this allows inspecting results on a laptop for a build that ran on a server.| 0|

flow/scripts/floorplan.tcl

@@ -61,7 +61,7 @@ if { $methods_defined > 1 } {
 # Method 1: Use existing DEF file with floorplan data
 if { $use_floorplan_def } {
   log_cmd read_def -floorplan_initialize $env(FLOORPLAN_DEF)
-# Method 2: Use ICeWall footprint file (platform-specific extension)
+  # Method 2: Use ICeWall footprint file (platform-specific extension)
 } elseif { $use_footprint } {
   ICeWall load_footprint $env(FOOTPRINT)
 
@@ -71,13 +71,13 @@ if { $use_floorplan_def } {
     -site $::env(PLACE_SITE)
 
   ICeWall init_footprint $env(SIG_MAP_FILE)
-# Method 3: Use explicit die and core area coordinates
+  # Method 3: Use explicit die and core area coordinates
 } elseif { $use_die_and_core_area } {
   initialize_floorplan -die_area $::env(DIE_AREA) \
     -core_area $::env(CORE_AREA) \
     -site $::env(PLACE_SITE) \
     {*}$additional_args
-# Method 4: Calculate core area from utilization, aspect ratio, and margins
+  # Method 4: Calculate core area from utilization, aspect ratio, and margins
 } elseif { $use_core_utilization } {
   initialize_floorplan -utilization $::env(CORE_UTILIZATION) \
     -aspect_ratio $::env(CORE_ASPECT_RATIO) \

flow/scripts/variables.yaml

@@ -305,7 +305,7 @@ SWAP_ARITH_OPERATORS:
     - All stages
 FLOORPLAN_DEF:
   description: |
-    Use the DEF file to initialize floorplan.
+    Use the DEF file to initialize floorplan. Mutually exclusive with FOOTPRINT or DIE_AREA/CORE_AREA or CORE_UTILIZATION.
   stages:
     - floorplan
     - place
@@ -1019,6 +1019,16 @@ YOSYS_FLAGS:
   stages:
     - synth
   default: -v 3
+FOOTPRINT:
+  description: |
+    Custom footprint definition file for ICeWall-based floorplan initialization. Mutually exclusive with FLOORPLAN_DEF or DIE_AREA/CORE_AREA or CORE_UTILIZATION.
+  stages:
+    - floorplan
+FOOTPRINT_TCL:
+  description: |
+    Specifies a Tcl script with custom footprint-related commands for floorplan setup.
+  stages:
+    - floorplan
 FLOW_VARIANT:
   description: >
     Flow variant to use, used in the flow variant directory name.