Pin

Specifies a space-separated list of hierarchical pin names for promotion. Pin mode supports regular expressions. For example, I0/in_* indicates pins with names that start with in_ and are in the I0 instance, while I0/.* indicates all pins in the I0 instance. You can promote bus pins by specifying the collapsed bus name. For example, I0/in<0:3> can be specified to promote bus pins in<0>, in<1>, in<2>, and in<3> from the I0 instance.

Environment variables: promotePinNetChoice, promotePinNetList

Net

Specifies a space-separated list of top-level net names. Alternatively, you can select the required nets in the Navigator assistant and then click Pick to populate the net names in the adjacent text box. All the lower-level pins that are specified in Find Pins on Net at depth and connected to a top-level net are promoted. Net mode does not support regular expressions.

Instance

Specifies a space-separated list of hierarchical instance names. Alternatively, you can select the required instances in the Navigator assistant and then click Pick to populate these names in the adjacent text box. All the pins inside the instance are promoted to a higher level.

Promote Pins for Selected Nets on Selected Instances

Filters the pins further by selecting one or more instances with the required nets specified. Only those pins in the specified nets that belong to the selected instances are selected for promotion. It is applicable only in Net mode.

If selected and there are no instances selected in the Navigator assistant or on the canvas, no pins are promoted.

Environment variable: promotePinOnNetForSelInsts

Find Pins on Net at depth

Specifies the depth to which the tool must traverse to search for pins. For example, if the mode is set to Net, the net name is set to gnd, and Find Pins on Net at depth is set to 2, the command traverses the design hierarchy to find pins on net gnd at level 2 to find pins for promotion.

This option is available only in Net mode.

Environment variable: promotePinOnNetPickLevel

Promote To

Sets the depth as the level specified in Current Level or to the depth specified in Specified Depth. The specified depth must be at a lower level than the current level and must be in the editable mode so that the selected pins can be copied to it.

Environment variables: promoteToLevel, promoteToChoice

Schematic awareness

Promotes only those pins that have a corresponding schematic counterpart at the top level.

Environment variable: promoteSchematicAware

Create labels on promoted pins

Creates pin labels for promoted pins. The text of the promoted pin labels are derived from their terminal names.

Environment variable: promoteCreateLabelsOnPins

Promote only top layer of pin shapes

Promotes only those pin figures that are available on the top layer.

Environment variable: promoteTopLayerFig

Promote pins considering connectivity

Honors any existing connectivity of pins to top-level nets during the promotion of these pins. The connections are retained in the promoted pins. This option is available only in the Pin and Instance modes.

When not selected, the promoted pins are connected to new nets that have the same net names as that of the lower level pin. It is recommended that you select this option to avoid any potential violations in Layout XL.

Environment variable: promotePinConnectivity

Select promoted pins in layout canvas

Selects the promoted pins on the canvas automatically. This option is available only when either Promote To is set to Current Level or Find Pins on Net at depth is set to 0.

Environment variable: promoteSelectInCanvas

Promotion Options

This sections lets you enable the promotion options.

Delete promoted pins from previous run(s)

Deletes the pins that were promoted in the previous runs of the command.

Environment variable: promoteDeleteOldPins

Promote visible shapes

Promotes pins from only those layers for which visibility has been turned on in the Palette assistant.

Environment variable: promoteVisibleLPPs

Promote selective bus bits

Specifies whether Odd or Even bus pins must be promoted. When a bus is selected for promotion, by default, all its constituent bus pins are promoted. Use this option to restrict promotion to specific bus pins.

This option is available only in Pin mode.

Environment variables: promoteSelectiveBusBits, promoteOddEvenChoice

Add Suffix/Prefix

Specifies the required Suffix String, Prefix String, or both. The specified prefix and suffix are added to the promoted pin names.

Environment variables:promoteSuffixString, promotePrefixString

Prefix Instance Name

Adds the pin source paths as prefix to the promoted pin names. For example, when you promote pinA from I6/I2/pinA, the new pin is named as I6_I2_pinA.

In Net mode, the suffix and prefix are added only to the promoted pin names, and not to the constituent net or term names.

Environment variables: promotePrefixChoice, promoteSuffixChoice

Pin Layer

This section lets you select one of the following options to specify the LPP to which the pins must be promoted:

• Same as Shape LPP (Default): Promotes pins to the LPP on which the source pins are located.
• Same Layer.Custom Purpose: Uses the same layer as the source pins, but lets you specify the purpose.
• Custom LPP: Lets you specify both the layer and purpose to which pins must be promoted.

Environment variables: promoteLayerChoice, promoteCustomPurpose, promoteCustomLPP