report_legal_locations (::quartus::eco)

The following table displays information for the report_legal_locations Tcl command:

Tcl Package and Version

Belongs to ::quartus::eco 1.0

Syntax report_legal_locations [-h | -help] [-long_help] [-check_routing] -location <location> [-name <node_name> ] [-node <node_id> ] [-patient] [-report_illegal] [-return_result]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-check_routing Try to legalize the location by checking routing
-location <location> Region to search for legal locations
-name <node_name> Name of node to check legal locations for
-node <node_id> Node ID
-patient Override restriction on search region size
-report_illegal Report illegal locations and reasons within the search region
-return_result Return the result in a tcl object
Description 
The report_legal_locations command will search for all legal locations within the 
region specified by -location for the specified node to be placed.
The command can be used on nodes that have or have not been placed.
Specify -patient to override the restriction on the search region size.
Specify -report_illegal to report illegal location reasons.
In command-line mode, the result will be posted as info messages to the console.
If -return_result is specified then the result will also be returned as a
tcl object.
If -check_routing is specified then a location will be determined illegal if the 
legalization step fails and slacks will be reported for legal locations. 
Otherwise the legalization step will be skipped. Note that the -check_routing option 
is only supported when all nodes but the target have been placed.
The report_legal_locations command does not work in "quartus_fit --eco" mode.
Example Usage 
report_legal_locations -name node -location "X136 Y63 X145 Y72"
report_legal_locations -name node -location "X5 Y10 X5 Y10"
report_legal_locations -name node -location "X5 Y10 X5 Y10" -report_illegal
report_legal_locations -name node -location "X5 Y10 X5 Y10" -return_result
report_legal_locations -name node -location "X5 Y10 X5 Y10" -check_routing
report_legal_locations -name node -location "X136 Y63 X149 Y82" -patient
report_legal_locations -name node -location "X136 Y63 X149 Y82" -patient -return_result

# check legal locations of multiple FFs in a specified region
project_open top
eco_load_design
set nodes [get_netlist_nodes -type FF]
foreach_in_collection i $nodes {
    report_legal_locations -node $i -location "X136 Y63 X145 Y72"
}
project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful