From ddc7b4360d921f630f89d01c2ba734a1b539b45e Mon Sep 17 00:00:00 2001 From: Arthur Koucher Date: Thu, 10 Sep 2026 17:41:02 +0000 Subject: [PATCH 1/2] improve MACRO_PLACEMENT_TCL variable documentation Signed-off-by: Arthur Koucher --- docs/user/FlowVariables.md | 2 +- flow/scripts/variables.yaml | 7 ++++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/docs/user/FlowVariables.md b/docs/user/FlowVariables.md index 2eabff74f3..2bc47e843c 100644 --- a/docs/user/FlowVariables.md +++ b/docs/user/FlowVariables.md @@ -183,7 +183,7 @@ configuration file. | LIB_MODEL| Selects between NLDM and CCS timing models for the ASAP7 platform. Valid values: NLDM (default), CCS. Used in flow/platforms/asap7/config.mk to pick the LIB_DIR subdirectory and accumulate the corresponding $(CORNER)_$(LIB_MODEL)_LIB_FILES list, and in flow/scripts/load.tcl to gate CCS-specific Tcl branches.| NLDM| | MACRO_BLOCKAGE_HALO| Distance beyond the edges of a macro that will also be covered by the blockage generated for that macro. Note that the default macro blockage halo comes from the largest of the specified MACRO_PLACE_HALO x or y values. This variable overrides that calculation.| | | MACRO_EXTENSION| Sets the number of GCells added to the blockages boundaries from macros.| | -| MACRO_PLACEMENT_TCL| Specifies the path of a TCL file on how to place macros manually. The user may choose to place just some of the macros in the design. The macro placer will handle the remaining unplaced macros.| | +| MACRO_PLACEMENT_TCL| Specifies the path of a TCL file on how to place macros manually. The user may choose to place just some of the macros in the design. The macro placer will handle the remaining unplaced macros. Note that using the macro placement file generated by the macro placer will not result in the same global placement as actually running the macro placer: the macro placement file does not contain the locations that the macro placer generates for the standard cells, and those locations impact global placement.| | | MACRO_PLACE_HALO| Horizontal/vertical halo around macros (microns). Used by automatic macro placement.| | | MACRO_ROWS_HALO_X| Horizontal distance between the edge of the macro and the beginning of the rows created by tapcell. Only available for ASAP7 PDK and GF180/uart-blocks design.| | | MACRO_ROWS_HALO_Y| Vertical distance between the edge of the macro and the beginning of the rows created by tapcell. Only available for ASAP7 PDK and GF180/uart-blocks design.| | diff --git a/flow/scripts/variables.yaml b/flow/scripts/variables.yaml index 1b6abe4c83..8908cc64c8 100644 --- a/flow/scripts/variables.yaml +++ b/flow/scripts/variables.yaml @@ -543,7 +543,12 @@ MACRO_PLACEMENT_TCL: description: | Specifies the path of a TCL file on how to place macros manually. The user may choose to place just some of the macros in the design. - The macro placer will handle the remaining unplaced macros. + The macro placer will handle the remaining unplaced macros. Note + that using the macro placement file generated by the macro placer + will not result in the same global placement as actually running + the macro placer: the macro placement file does not contain the + locations that the macro placer generates for the standard cells, + and those locations impact global placement. stages: - floorplan MACRO_PLACE_HALO: From 461f84f5d059a19d943b107a96c01695e5720c2b Mon Sep 17 00:00:00 2001 From: Arthur Koucher Date: Thu, 10 Sep 2026 18:17:34 +0000 Subject: [PATCH 2/2] update variables.json Signed-off-by: Arthur Koucher --- flow/scripts/variables.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/flow/scripts/variables.json b/flow/scripts/variables.json index d2725ce668..2aa9a59ac5 100644 --- a/flow/scripts/variables.json +++ b/flow/scripts/variables.json @@ -542,7 +542,7 @@ "description": "Sets the number of GCells added to the blockages boundaries from macros.\n" }, "MACRO_PLACEMENT_TCL": { - "description": "Specifies the path of a TCL file on how to place macros manually.\nThe user may choose to place just some of the macros in the design.\nThe macro placer will handle the remaining unplaced macros.\n", + "description": "Specifies the path of a TCL file on how to place macros manually.\nThe user may choose to place just some of the macros in the design.\nThe macro placer will handle the remaining unplaced macros. Note\nthat using the macro placement file generated by the macro placer\nwill not result in the same global placement as actually running\nthe macro placer: the macro placement file does not contain the\nlocations that the macro placer generates for the standard cells,\nand those locations impact global placement.\n", "stages": [ "floorplan" ]