report_legal_locations (::quartus::eco)

Tcl Package and Version

Syntax

report_legal_locations [-h | -help] [-long_help] [-check_routing] -location <location> -name <node_name> [-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

-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

Return Value

Code Name

Code

String Return

TCL_OK

0

INFO: Operation successful

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> `[-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
	`-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
Return Value	Code Name	Code	String Return
TCL_OK	0	INFO: Operation successful