Product Documentation
Virtuoso Layout Suite SKILL Reference
Product Version IC23.1, November 2023

vfpAutoPin

vfpAutoPin(
d_refView
?mode { cellview | selected }
[ ?validRoutingLayer g_shapesOnRoutingLayersOnly ] 
[ ?purpose t_shapesOnSpecificPurpose ] 
[ ?schematicCheck g_schematicCheck ] 
[ ?deleteMode { auto | all } ] 
[ ?checkDuplicatePin g_checkDuplicatePin ]
[ ?boundarySignalMode { single | multiple } ] 
[ ?buriedSignalMode { single | multiple } ]
[ ?boundaryMultipleMode { topLayer | useLayer } ]
[ ?buriedMultipleMode { topLayer | useLayer } ]
[ ?boundarySignalPinLayers t_boundarySignalPinLayers ]
[ ?buriedSignalPinLayers t_buriedSignalPinLayers ]
[ ?boundaryPowerPinLayers t_boundaryPowerPinLayers ] 
[ ?buriedPowerPinLayers t_buriedPowerPinLayers ] 
[ ?boundaryPinSize t_boundaryPinSize ]
[ ?buriedPinSize t_buriedPinSize ]
[ ?targetLPP t_targetLPP ] 
[ ?pinConnectivity t_pinConnectivity ] 
[ ?createLabel g_createLabel ] 
[ ?enableColoring g_enableColoring ]
[ ?createMetalShape g_createMetalShape ]
[ ?metalShapeType { path | rectangle } ]
[ ?hDepthCheck g_hDepthCheck ]
[ ?startLevelValue x_startLevelValue ]
[ ?createDeleteMode t_createDeleteMode ]
[ ?preview g_preview ]
[ ?customLengthsBoundaryShapePin t_customLengthsBoundaryShapePin ]
[ ?customLengthsBuriedShapePin t_customLengthsBuriedShapePin ]
)
=> t / nil

Description

Searches for net shapes in the specified window or cellview and automatically creates boundary and buried pins on these net shapes.

Arguments

d_refView

Specifies the cellView ID in which pins are to be created.

?mode { cellview | selected }

Specifies the mode in which the command must be run.

?validRoutingLayer g_shapesOnRoutingLayersOnly

  

Restricts the search for net shapes to the routing layers. The default value is nil, where all layers are searched.

?purpose t_shapesOnSpecificPurpose

  

Filters the net shapes based on the specified purpose. The default value is "".

?schematicCheck g_schematicCheck

  

Specifies whether the tool must search for corresponding shapes in the schematic view before creating pins. The default value is nil.

?deleteMode { auto | all }

  

Specifies the mode in which existing pins must be deleted before new ones are created. The valid values are:

  • auto: Specifies that only those pins that were created automatically by using the Auto Pin tool are to be deleted.
  • all: Specifies that all pins in the current cellview are to be deleted.

?checkDuplicatePin g_checkDuplicatePin

Checks for the presence of any similar pins in the design. If a similar pin is found, then a duplicate pin is not created.

?boundarySignalMode { single | multiple }

  

Specifies the way in which boundary pins are created on shapes that are abutted to the PR boundary. The valid values are:

  • single: Creates a single boundary pin on the highest metal layer.
  • multiple: Creates as many boundary pins as the number of boundary shapes, in the same layers as the shapes.

The default value is "", which indicates that boundary signal pins are not created.

?buriedSignalMode { single | multiple }

  

Specifies the way in which buried pins are created on shapes that are completely inside the PR boundary, without any contact with the edges. The valid values are:

  • single: Creates a single buried pin on the highest metal layer.
  • multiple: Creates as many buried pins as the number of buried shapes, in the same layers as the shapes.

The default value is "", which indicates that buried signal pins are not created.

?boundaryMultipleMode { topLayer | useLayer }

Specifies the following layer selection options:

  • topLayer: Creates multiple boundary pins on the highest metal layer.
  • useLayer: Lets you specify the layers on which boundary pins are to be created. Use the ?boundarySignalPinLayers argument to specify the layers.

The default value is toplayer when boundarySignalMode is set to multiple.

?buriedMultipleMode { topLayer | useLayer }

Specifies the following layer selection options:

  • topLayer: Creates multiple buried pins on the highest metal layer.
  • useLayer: Lets you specify the layers on which buried pins are to be created. Use the ?buriedSignalPinLayers argument to specify the layers.

The default value is toplayer when buriedSignalMode is set to multiple.

?boundarySignalPinLayers t_boundarySignalPinLayers

Specifies the layers on which boundary signal pins must be generated when ?boundaryMultipleMode is set to useLayer.

?buriedSignalPinLayers t_buriedSignalPinLayers

Specifies the layers on which buried signal pins must be generated when ?buriedMultipleMode is set to useLayer.

?boundaryPowerPinLayers t_boundaryPowerPinLayers

  

Specifies the names of layers on which the boundary power pins can be created.

The default value is "", which indicates that no layers are specified, and therefore no pins are to be created on the boundary power net shape.

?buriedPowerPinLayers t_buriedPowerPinLayers

  

Specifies the names of layers on which the buried power pins can be created.

The default value is "", which indicates that no layers are specified, and therefore no pins are to be created on the buried power net shape.

?boundaryPinSize t_boundaryPinSize

  

Specifies the boundary pin size. The valid values are:

  • Square (Default): Creates square pins. Only rectangular and square path, pathsegs, and polygonal shapes are recognized for pin creation.
  • Whole Shape: Creates pins of the same shape as the corresponding net shapes. For example, square, rectangle, L-shaped, and path pin shapes are supported.
  • Honor Min Length: Honors the minLength constraint specified in the technology file. If the pin length is less than the minimum length specified in the constraint, the pin is resized to match minLength value during pin creation.
  • Custom Length: Specifies a custom length value for a pin.

?buriedPinSize t_buriedPinSize

Specifies the buried pin size. The valid values are:

  • Square (Default): Creates square pins. Only rectangular and square path, pathsegs, and polygonal shapes are recognized for pin creation.
  • Whole Shape: Creates pins of the same shape as the corresponding net shapes. For example, square, rectangle, L-shaped, and path pin shapes are supported.
  • Honor Min Length: Honors the minLength constraint specified in the technology file. If the pin length is less than the minimum length specified in the constraint, the pin is resized to match minLength value during pin creation.
  • Custom Length: Specifies a custom length value for a pin.

?targetLPP t_targetLPP

  

Specifies the LPP on which pins must be generated. The valid values are:

  • sameLPP (Default): Creates pins on the same LPPs as the original net shapes.
  • customPurpose: Lets you specify a different purpose for the same layer.
  • customLPP: Lets you specify a different LPP on which pins must be created.

?pinConnectivity t_pinConnectivity

  

Specifies the following pin connectivity options:

  • stronglyConnected (Default): Specifies that the router must connect the pins internally within the device.
  • mustJoin: Specifies that the router must connect the pins externally at a higher level.

?createLabel g_createLabel

  

Specifies whether text labels are created for pins. The default value is nil.

?enableColoring g_enableColoring

Specifies that the multiple patterning coloring engine be used to assign colors to the new pins based on their positions relative to the WSP tracks.

?createMetalShape g_createMetalShape

Creates a metal shape under each auto-created level-1 (soft block) pin. The metal shapes are assigned to the same layers as the parent pin and to the drawing purpose.

?metalShapeType { path | rectangle }

Specifies the dimensions of the metal shapes that are created under automatically created pins when ?createMetalShape is set to t.

?hDepthCheck g_hDepthCheck

Enables hierarchical pin creation and pin promotion from a lower level to the top level.

?startLevelValue x_startLevelValue

Specifies the start level from which the tool has to start hierarchical pin creation and promotion.

?createDeleteMode t_createDeleteMode

Deletes all pins that were created by the Auto-Create Pins tool, creates pins hierarchically, and promotes them from a lower level to a higher level.

?preview g_preview

  

Displays a preview of how the settings would be applied to the design. The default value is nil.

?customLengthsBoundaryShapePin t_customLengthsBoundaryShapePin

Specifies a custom length value for a boundary shape pin.

?customLengthsBuriedShapePin t_customLengthsBuriedShapePin

Specifies a custom length value for a buried shape pin.

Value Returned

t

Pins were created as specified.

nil

Pins were not created.

Examples

The following examples show how vfpAutoPin can be used with different argument combinations.

Searches for net shapes in the selected nets and creates a single boundary signal pin on the highest metal layer.

vfpAutoPin(cvId "selected" ?boundarySignalMode "single")

Searches for net shapes with purpose drawing in the selected nets and creates multiple must-join boundary signal pins of the same shapes as the original net shapes.

vfpAutoPin(cvId "selected" ?purpose "drawing" ?boundarySignalMode "multiple" ?boundaryPinSize "whole" ?pinConnectivity "mustJoin" ?preview t)

Searches for net shapes on routing layers in the selected nets. Pins that were created using the auto pin tool are deleted before new ones are generated on the canvas. New boundary signal pins, boundary power pins, and buried power pins as per the specified arguments.

vfpAutoPin(cvId "selected" ?validRoutingLayer t ?deleteMode "auto" ?boundarySignalMode "multiple" ?buriedSignalMode "single" ?boundaryPowerPinLayers "Metal1 Metal2" ?buriedPowerPinLayers "Meta1 Metal2" ?targetLPP "sameLPP" ?createLabel t)

Searches for net shapes in the current cellview and creates boundary power pins on the specified layers. Existing pins that were created using the auto pin tool are deleted before generating new pins on the canvas.

vfpAutoPin(cvId "selected" ?boundaryPowerPinLayers "Metal1 Metal2" ?deleteMode "auto")

Return to top
 ⠀
X