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

lxCheckAndUpdate

lxCheckAndUpdate(
t_libNameOrLayCV
[ ?schCV d_schematicCellview  ]
[ ?update g_update ]
[ ?app t_appName ]
[ ?layoutComplete g_layoutComplete ]
[ ?binder t_binderValue ]
[ ?svdbPath t_lvsSvdbPath ]
[ ?svdbScale n_lvsScale ]
[ ?extract g_Extract ] 
[ ?extractStopLevel n_stoplevel) }  ]
[ ?onlyCheckUpdate g_onlyCheckUpdate  ]
[ ?allCellsInDesign g_allCellsInDesign  ]
[ ?allCellsInLibrary g_allCellsInLibrary ]
[ ?excludeCells t_excludeCells  ]
[ ?includeCells t_includeCells  ]
[ ?leafCells t_leafCells  ]
[ ?withoutSchematic g_cellsWithoutSchematic  ]
[ ?filterMessage l_filterMessage ]
[ ?createHTML g_createHTMLReport ]
[ ?openHTML g_openHTMLReport ]
[ ?logFile g_logFile  ]
[ ?logFileDirectory t_logFileDirectoryPath  ]
[ ?detailedReturn g_detailedReturn  ]
[ ?report { t | nil }   ]
[ ?reportOptions { t| nil }  ]
[ ?graphical { t| nil }   ]
[ ?targetWindow { w_windowId | nil }  ]
)
=> nil | l_testResult | n_percentageClean

Description

Runs the application readiness check and updates the specified cellviews for the specified applications.

Arguments

t_libNameOrLayCV

Name of the target library or layout cellview to check and update.

?schCV d_schematicCellview

Specifies the schematic cellview to use as the layout connectivity reference.

?update g_update

Specifies whether to check or update the specified application.

?app t_appName

Name of the application to check and update.

?layoutComplete t_layoutComplete

When set to t, performs hierarchical rebinding and clears logical connectivity. Unbound or ungenerated instances, terminals, or nets are not updated.

LVS binding is only allowed when ?layoutComplete is t.

The default is nil.

?binder t_binderValue

Specifies the type of binding to perform during application update.

Valid values are:

Current - Use the existing binding.

Rebind - Update using the Update Binding command.

LVS - Rebind using the binding information in the svdb directory.

The default is Rebind.

?svdbPath t_lvsSvdbPath

Specifies the path to the PVS svdb directory containing:

xyz.ixf instance cross-reference file.

xyz.net extracted layout CDL netlist file.

?svdbScale n_lvsScale

Input scale. The PVS rules file input_scale is required only if input_scale is different from the layout DBUPerUU.

?extract g_Extract

Specifies whether the layout needs to be extracted.

The default is nil.

?extractStopLevel n_stoplevel

Specifies the hierarchy depth for extraction.

The default is -1.

?onlyCheckUpdate g_onlyCheckUpdate

Specifies a check or update criteria to ensure only those checks or updates that match the path are performed.

Example:

list("Unbound") or list("Unbound" "Instances")

?allCellsInDesign g_allCellsInDesign

Checks and updates all cells in the specified cellview.

?allCellsInLibrary g_allCellsInLibrary

Checks and updates all cells in the specified library.

?excludeCells t_excludeCells

List of cells to be excluded when the ?allCellsInDesign or ?allCellsInLibrary option is specified.

Example:

(\\*pdk\\* via\\* layout) (STD\\* \\*FILLER\\* layout\\*)

?includeCells t_includeCells

List of cells to be included when the ?allCellsInDesign or ?allCellsInLibrary option is specified.

Example:

(DESLIB TOP layout) (DES\\* \\*MYCELL\\* layout\\*)

?leafCells t_leafCells

List of cells to be treated as leaf cells. Only the terminals of leaf cells are checked when ?allCellsInDesign or ?allCellsInLibrary option is specified.

?withoutSchematic g_cellsWithoutSchematic

Checks and updates layout cells without a schematic connectivity reference.

The default is nil.

?filterMessage l_filterMessage

List of messages to be filtered from the Check and Update report.

Example

LX-1946 BND-1105

?createHTML g_createHTMLReport

Specifies whether to create an HTML report.

The default is t.

?openHTML g_openHTMLReport

Specifies whether to open the HTML report in the default browser.

The default is nil.

?logFile g_logFile

Specifies whether to save the report to a text log file.

The default is nil.

?logFileDirectory t_logFileDirectoryPath

Specifies a directory for the log file.

?detailedReturn g_detailedReturn

Specifies whether the return value should provide a detailed list of checks including information such as Passes, Failed, and Needs attention.

Example:

list(list("Direction"   "Passed") 
list("Name - Nets" "Passed")
list("Parameter"   "Needs attention")
list("Signal type" "Passed")) 

?report { t | nil }

Specifies whether the check and update report is output to the CIW or HTML report.

The default is t.

?reportOptions { t| nil }

Specify whether options are output to the CIW or an HTML report.

The default is t.

?graphical { t| nil }

When set to t, extra checks for read-only layout or schematic extraction are run that might also display a dialog box.

The default is nil.

?targetWindow { w_windowId | nil }

Specifies whether to display a progress bar.

The default is nil.

Value Returned

l_testResult

List of checks, Passed, Failed, and Needs attention, if a single cell and single application is tested.

Example

list(list("Direction"   "Passed") 
list("Name - Nets" "Passed")
list("Parameter"   "Needs attention")
list("Signal type" "Passed")) 

n_percentageClean

Pass percentage for the tests:

%Clean 0-100

nil

The operation failed.

Examples

Checks schematic versus layout. This is the default check.

lxCheckAndUpdate(lcv) 
Checks schematic versus layout and updates the layout. 
lxCheckAndUpdate(lcv ?update t)

Checks the Design Planner application.

lxCheckAndUpdate(lcv ?app "Design Planner")

Checks and updates the schematic v layout application and checks the Design Planner application.

lxCheckAndUpdate(lcv ?app list(list("Schematic v Layout" t) list("Design Planner" nil)) 

Checks all cellviews in the design.

lxCheckAndUpdate(lcv ?allCellsInDesign t)

Checks all cells in the library.

lxCheckAndUpdate("DESIGN_LIB")

Return to top
 ⠀
X