get_clock_info (::quartus::sta)
The following table displays information for the get_clock_info Tcl command:
Tcl Package and Version |
Belongs to ::quartus::sta 1.0 |
|||
Syntax | get_clock_info [-h | -help] [-long_help] [-child_clocks] [-divide_by] [-duty_cycle] [-edge_shifts] [-edges] [-fall] [-is_inverted] [-latency] [-master_clock] [-master_clock_pin] [-max] [-min] [-multiply_by] [-name] [-nreg_neg] [-nreg_pos] [-offset] [-period] [-phase] [-rise] [-targets] [-type] [-waveform] <clk_object> | |||
Arguments | -h | -help | Short help | ||
-long_help | Long help with examples and possible return values | |||
-child_clocks | Returns a list of child clock names | |||
-divide_by | Return the frequency divider (to the base clock) | |||
-duty_cycle | Return the duty cycle | |||
-edge_shifts | Return a list of edge shifts that the specified edges are to undergo to yield the final generated clock waveform | |||
-edges | Return a list of integer representing edges from the source clock that are to form edges of the generated clock | |||
-fall | Return clock fall latency | |||
-is_inverted | Return a boolean value to indicate if the generated clock is inverted | |||
-latency | Return clock latency | |||
-master_clock | Return the master clock name | |||
-master_clock_pin | Return the master clock source pin | |||
-max | Return max clock latency | |||
-min | Return min clock latency | |||
-multiply_by | Return the frequency multiplier (to the base clock) | |||
-name | Return the clock name | |||
-nreg_neg | Return number of registers negatively clocked by clock | |||
-nreg_pos | Return number of registers positively clocked by clock | |||
-offset | Return the clock offset | |||
-period | Return the clock period | |||
-phase | Return the clock phase | |||
-rise | Return clock rise latency | |||
-targets | Return the clock targets collection | |||
-type | Return the clock type | |||
-waveform | Return the waveform (rise time and fall time) | |||
<clk_object> | Clock object | |||
Description |
Returns information about the specified clock (referenced by clock ID). Clock IDs can be obtained by Tcl commands such as get_clocks. The "-type" option returns "clk". Options "-name", "-type", "-period", "-duty_cycle", "-waveform", "-edges", "-edge_shifts", "-multiply_by", "-divide_by", "-is_inverted", "-latency", "-master_clock", and "-targets" are mutually exclusive. The "-latency" option requires a specified "-max" or "-min" option as well as a "-rise" or "-fall" option. |
|||
Example Usage |
project_open chiptrip create_timing_netlist set clocks [get_clocks] foreach_in_collection clk $clocks { puts "[get_clock_info $clk -name]: [get_clock_info $clk -period]" } delete_timing_netlist project_close |
|||
Return Value | Code Name | Code | String Return | |
TCL_OK | 0 | INFO: Operation successful | ||
TCL_ERROR | 1 | ERROR: Options are mutually exclusive: <string>. Specify only one of the these options. | ||
TCL_ERROR | 1 | ERROR: Object with ID <string> is not an object of type <string>. Specify the ID of an object with the correct type. | ||
TCL_ERROR | 1 | ERROR: Cannot find object of ID <string>. Specify an existing object ID. | ||
TCL_ERROR | 1 | ERROR: Unsupported object type: <string>. Specify a supported object type. |