21.8.11 get_cells

Description

Returns a collection of instance (cell) objects in the current design that match a specified search pattern. You can use this command only as part of a -from, -to argument in the following Tcl commands: set_max delay, set_multicycle_path, and set_false_path. Wildcards can be used to select multiple cells at once. If no objects match the criteria, the empty string is returned.

get_cells pattern

Arguments

ParameterTypeDescription
patternstringSpecifies the pattern to match the instances to return. For example, get_cells U18* returns all instances starting with the characters U18, where * is a wild card character that represents any character string. This is mandatory.
Return TypeDescription
objectReturns an object representing the cells (instances) that match those specified in the pattern argument.

Error Codes

Error CodeDescription
NoneRequired parameter _AtclParam0_ is missing.

Supported Families

PolarFire®
PolarFire SoC
SmartFusion® 2
IGLOO® 2
RTG4

Example

The following example sets maximum delay constraining all paths from reg* cells to out ports with a delay less than 2 ns.

set_max_delay 2 -from [get_cells {reg*}] -to [get_ports {out}]

Related Examples on GitHub

See Also