Changed envar names.

Changed the separator from space to comma.
Added documentation.

Signed-off-by: Jaehyun Kim <[email protected]>

Author: jhkim-pii

docs/user/FlowVariables.md

@@ -241,6 +241,8 @@ configuration file.
 | <a name="SYNTH_NETLIST_FILES"></a>SYNTH_NETLIST_FILES| Skips synthesis and uses the supplied netlist files. If the netlist files contains duplicate modules, which can happen when using hierarchical synthesis on indvidual netlist files and combining here, subsequent modules are silently ignored and only the first module is used.| |
 | <a name="SYNTH_OPT_HIER"></a>SYNTH_OPT_HIER| Optimize constants across hierarchical boundaries.| |
 | <a name="SYNTH_RETIME_MODULES"></a>SYNTH_RETIME_MODULES| *This is an experimental option and may cause adverse effects.* *No effort has been made to check if the retimed RTL is logically equivalent to the non-retimed RTL.* List of modules to apply automatic retiming to. These modules must not get dissolved and as such they should either be the top module or be included in SYNTH_KEEP_MODULES. The main use case is to quickly identify if performance can be improved by manually retiming the input RTL. Retiming will treat module ports like register endpoints/startpoints. The objective function of retiming isn't informed by SDC, even the clock period is ignored. As such, retiming will optimize for best delay at potentially high register number cost. Automatic retiming can produce suboptimal results as its timing model is crude and it doesn't find the optimal distribution of registers on long pipelines. See OR discussion #8080.| |
+| <a name="SYNTH_WRAPPED_ADDERS"></a>SYNTH_WRAPPED_ADDERS| Specify the adder modules that can be used for synthesis, separated by commas. The default adder module is determined by the first element of this variable.| |
+| <a name="SYNTH_WRAPPED_MULTIPLIERS"></a>SYNTH_WRAPPED_MULTIPLIERS| Specify the multiplier modules that can be used for synthesis, separated by commas. The default multiplier module is determined by the first element of this variable.| |
 | <a name="SYNTH_WRAPPED_OPERATORS"></a>SYNTH_WRAPPED_OPERATORS| Synthesize multiple architectural options for each arithmetic operator in the design. These options are available for switching among in later stages of the flow.| |
 | <a name="TAPCELL_TCL"></a>TAPCELL_TCL| Path to Endcap and Welltie cells file.| |
 | <a name="TAP_CELL_NAME"></a>TAP_CELL_NAME| Name of the cell to use in tap cell insertion.| |
@@ -450,6 +452,8 @@ configuration file.
 
 - [OPENROAD_HIERARCHICAL](#OPENROAD_HIERARCHICAL)
 - [SWAP_ARITH_OPERATORS](#SWAP_ARITH_OPERATORS)
+- [SYNTH_WRAPPED_ADDERS](#SYNTH_WRAPPED_ADDERS)
+- [SYNTH_WRAPPED_MULTIPLIERS](#SYNTH_WRAPPED_MULTIPLIERS)
 - [SYNTH_WRAPPED_OPERATORS](#SYNTH_WRAPPED_OPERATORS)
 
 ## generate_abstract variables

flow/scripts/synth_wrap_operators.tcl

@@ -34,7 +34,7 @@ proc reorder_deferred_cells { deferred_cells_var index env_var } {
 
   # Build new choices
   set new_choices {}
-  foreach name [split $::env($env_var)] {
+  foreach name [split $::env($env_var) ","] {
     if { [dict exists $choice_map $name] } {
       lappend new_choices [dict get $choice_map $name]
     } else {
@@ -47,8 +47,8 @@ proc reorder_deferred_cells { deferred_cells_var index env_var } {
 }
 
 # Apply custom orders
-reorder_deferred_cells deferred_cells 0 SYNTH_WRAPPED_REORDER_ADDER
-reorder_deferred_cells deferred_cells 1 SYNTH_WRAPPED_REORDER_MULTIPLIER
+reorder_deferred_cells deferred_cells 0 SYNTH_WRAPPED_ADDERS
+reorder_deferred_cells deferred_cells 1 SYNTH_WRAPPED_MULTIPLIERS
 
 techmap {*}[join [lmap cell $deferred_cells { string cat "-dont_map [lindex $cell 0]" }] " "]
 

flow/scripts/variables.yaml

@@ -298,6 +298,18 @@ SYNTH_WRAPPED_OPERATORS:
     the flow.
   stages:
     - All stages
+SYNTH_WRAPPED_ADDERS:
+  description: >
+    Specify the adder modules that can be used for synthesis, separated by commas.
+    The default adder module is determined by the first element of this variable.
+  stages:
+    - All stages
+SYNTH_WRAPPED_MULTIPLIERS:
+  description: >
+    Specify the multiplier modules that can be used for synthesis, separated by commas.
+    The default multiplier module is determined by the first element of this variable.
+  stages:
+    - All stages
 SWAP_ARITH_OPERATORS:
   description: >
     Improve timing QoR by swapping ALU and MULT arithmetic operators.