Product Version 5.0
September 2002
Trademarks: Trademarks and service marks of Cadence Design Systems, Inc. (Cadence) contained in this
document are attributed to Cadence with the appropriate symbol. For queries regarding Cadence’s trademarks, contact the corporate legal department at the address shown above or call 1-800-862-4522.
All other trademarks are the property of their respective holders.
Restricted Print Permission: This publication is protected by copyright and any unauthorized use of this
publication may violate copyright, trademark, and other laws. Except as specified in this permission statement, this publication may not be copied, reproduced, modified, published, uploaded, posted, transmitted, or
distributed in any way, without prior written permission from Cadence. This statement grants you permission to print one (1) hard copy of this publication subject to the following conditions:
1. The publication may be used solely for personal, informational, and noncommercial purposes; 2. The publication may not be modified in any way;
3. Any copy of the publication or portion thereof must include all original copyright, trademark, and other proprietary notices and this permission statement; and
4. Cadence reserves the right to revoke this authorization at any time, and any such use shall be discontinued immediately upon written notice from Cadence.
Disclaimer: Information in this publication is subject to change without notice and does not represent a
commitment on the part of Cadence. The information contained herein is the proprietary and confidential information of Cadence or its licensors, and is supplied subject to, and may be used only by Cadence’s customer in accordance with, a written agreement between Cadence and its customer. Except as may be explicitly set forth in such agreement, Cadence does not make, and expressly disclaims, any representations or warranties as to the completeness, accuracy or usefulness of the information contained in this document. Cadence does not warrant that use of such information will not infringe any third party rights, nor does Cadence assume any liability for damages or costs of any kind that may result from use of such information.
Restricted Rights: Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
Preface
. . . 7Related Documents . . . 7
Typographic and Syntax Conventions . . . 7
1
Cadence Hierarchy Editor Overview
. . . 9What You Can Do with the Hierarchy Editor . . . 11
Opening the Hierarchy Editor . . . 11
About the Hierarchy Editor Menus . . . 13
Using the Toolbar . . . 16
Top Cell Section . . . 16
Global Bindings Section . . . 17
Cell Bindings Table . . . 17
Instance Bindings Table . . . 18
Messages . . . 18
Status Bar . . . 18
Setting Command-Line Options . . . 20
Customizing Hierarchy Editor Columns . . . 22
Specifying Attributes to Display in the Columns . . . 22
About the Options Form . . . 24
Changing Column Order . . . 25
Resizing Columns . . . 25
Updating the Configuration Automatically . . . 26
Expanding and Collapsing Branches of Your Design . . . 26
Displaying the Tree Structure . . . 26
Filtering Cellviews . . . 28
About the View Filters Form . . . 29
Contents
Viewing the Legend . . . 31
Changing the Hierarchy Editor Fonts . . . 32
Saving Custom Settings . . . 32
Exiting the Hierarchy Editor . . . 33
2
Creating Configurations
. . . 35About the Configuration View of a Design Hierarchy . . . 37
Opening Configurations . . . 37
Opening Configurations in Read-Only Mode . . . 39
About the Open Form . . . 39
Filtering the Configurations in the Open Form . . . 40
About the Browser Filters Form . . . 41
Creating a New Configuration . . . 43
About the New Configuration Form . . . 45
About the Choose the Top Cell Form . . . 46
Editing Configurations . . . 46
Editing the Cell Bindings and Instance Bindings Tables . . . 47
Verifying Configuration Data . . . 50
Viewing the Description File . . . 50
Verifying Cell Binding Rules . . . 51
About the Explain Form for a Selected Cell . . . 52
Verifying Instance Binding Rules . . . 53
About the Explain Form for a Selected Instance . . . 53
Verifying Occurrence Binding Rules . . . 54
About the Explain Form for a Selected Occurrence . . . 55
Working with Templates . . . 56
Using Templates . . . 56
About the Use Template Form . . . 57
Creating Templates . . . 57
Copying Your Created Template to Another Location . . . 58
Saving Configurations . . . 59
Saving a Configuration . . . 59
About the Save As Form . . . 60
About the Save As VHDL Form . . . 62
Saving Verilog Configurations . . . 62
About the Save As Verilog Form . . . 64
Updating a Virtuoso Schematic Composer Configuration Using the Hierarchy Editor Interface . . . 64
3
Changing Design Components
. . . 67Overview . . . 69
Global Bindings . . . 69
Cell Bindings . . . 69
Instance Bindings . . . 70
Occurrence Bindings . . . 71
How a Library Is Selected for an Object . . . 71
How a View Is Selected for an Object . . . 72
Defining Rules at the Global Level . . . 72
Defining a View List at the Global Level . . . 73
Defining a Library List at the Global Level . . . 74
Defining a Stop List at the Global Level . . . 75
Defining Rules at the Cell Level . . . 77
Changing Library Bindings on a Per-Cell Basis . . . 77
Changing View Bindings on a Per-Cell Basis . . . 78
Defining Stop Points on a Per-Cell Basis . . . 79
Defining Bind-to-Open on a Per-Cell Basis . . . 80
Defining Rules at the Instance Level . . . 82
Changing View Bindings on a Per-Instance Basis . . . 82
Changing Library Bindings on a Per-Instance Basis . . . 84
Defining Stop Points on a Per-Instance Basis . . . 85
Defining Bind-to-Open on a Per-Instance Basis . . . 87
Changing Instance Bindings Inside a Block . . . 89
Changing Instance Bindings Created by a Generate Statement . . . 91
Defining Rules at the Occurrence Level . . . 92
About Occurrences . . . 92
How Occurrences Are Different from Instances . . . 93
Defining Occurrence Stop Points . . . 102
Defining Occurrence-Level Bind-to-Open . . . 103
Changing Binding Data Color Definitions . . . 105
Using Constants . . . 106
Creating Constants . . . 106
Editing Constants . . . 108
About the Edit Constants Form . . . 109
Changing the Views in the View Choices List Box . . . 110
Using Constants . . . 110
4
Using Plug-Ins
. . . 111About Plug-Ins . . . 112
Loading Plug-In Applications . . . 113
Removing Plug-In Applications . . . 115
A
The hierEditor.env File
. . . 117Preface
The Cadence Hierarchy Editor User Guide describes the Cadence® Hierarchy Editor, which lets you browse a design hierarchy and create and edit design configurations. The preface discusses the following:
■ Related Documents
■ Typographic and Syntax Conventions
Related Documents
To find information about other Cadence products that are used with the hierarchy editor, refer to the following manuals:
■ Virtuoso Schematic Composer User Guide describes how to use the schematic
capture product.
■ Cadence Design Framework II User Guide describes terms and how to start your
system.
■ Cadence AMS Environment User Guide describes the analog mixed signal
environment.
Typographic and Syntax Conventions
This section describes typographic and syntax conventions used in this manual. text Indicates text you must type exactly as it is presented.
variable Indicates text that you must replace with an appropriate value. [ ] Denotes optional arguments. When used with vertical bars, they
enclose a list of choices from which you can choose one. { } Used with vertical bars and encloses a list of choices from which
| Separates a choice of options.
… Indicates that you can repeat the previous argument.
text Indicates names of manuals, menu commands, form buttons, and form fields.
1
Cadence Hierarchy Editor Overview
This chapter covers the following topics:
■ What You Can Do with the Hierarchy Editor on page 11 ■ Opening the Hierarchy Editor on page 11
❑ About the Hierarchy Editor Menus on page 13 ❑ Using the Toolbar on page 16
❑ Top Cell Section on page 16
❑ Global Bindings Section on page 17
❑ Cell Bindings Table on page 17 ❑ Instance Bindings Table on page 18
❑ Messages on page 18 ❑ Status Bar on page 18
■ Setting Command-Line Options on page 20
■ Customizing Hierarchy Editor Columns on page 22
❑ Specifying Attributes to Display in the Columns on page 22 ❑ About the Options Form on page 24
❑ Changing Column Order on page 25 ❑ Resizing Columns on page 25
■ Updating the Configuration Automatically on page 26
■ Expanding and Collapsing Branches of Your Design on page 26
❑ Displaying the Tree Structure on page 26 ■ Filtering Cellviews on page 28
❑ About the View Filters Form on page 29
■ Viewing the Legend on page 31
■ Changing the Hierarchy Editor Fonts on page 32
■ Saving Custom Settings on page 32 ■ Exiting the Hierarchy Editor on page 33
What You Can Do with the Hierarchy Editor
The Cadence®Hierarchy Editor lets you view many levels of a single design using either a table view or a tree view. The hierarchy editor also lets you create a configuration file that provides expansion information for mixed-signal partitioning. A configuration file is the expand.cfg file, which specifies how a design is to be expanded.
You can use the hierarchy editor to
■ Display the configuration file in order to traverse the hierarchy of your design ■ Display default cell and instance bindings
■ Change global library, view, and stop lists ■ Change cell and instance bindings
■ Change the inherited view list and library list for cells and instances ■ Specify occurrence bindings
■ Create new configurations
Opening the Hierarchy Editor
You can open the hierarchy editor from your Cadence application or from a UNIX shell.
➤ To open the hierarchy editor from a UNIX shell, type
cdsHierEditor &
The Cadence hierarchy editor window appears.
Note: When you start the hierarchy editor, you can also specify various options with the
“Setting Command-Line Options” on page 20. Toolbar Viewing area Status bar Message area Menu bar Top cell information Global bindings section Cell bindings section
About the Hierarchy Editor Menus
The menu bar displays the hierarchy editor menus.
File Menu
File – New creates a new configuration.
File – Open opens an existing configuration for editing. File – Open (Read-Only) opens a configuration for viewing. File – Save (Needed) saves the opened configuration.
File – Save As saves the opened configuration under a new name. File – Save As VHDL saves the opened configuration as a VHDL file. File – Save As Verilog saves the opened configuration as a Verilog® file.
File – Save Defaults saves your settings. Exit closes the hierarchy editor.
Edit Menu
Edit – Undo removes the last action. You can undo an unlimited number of actions. Edit – Redo redoes the previously undone action.
Edit – Constants opens the Constants form to let you create or edit constants.
Edit – Description opens the Edit Description form to let you edit the description of the
configuration.
View Menu
View menu commands let you set the display options for the hierarchy editor. You can hide
the table, tree, top cell, global bindings, toolbar, message area, and status bar in the hierarchy editor window.
View – Update recomputes the hierarchy based on the rules you entered. This command is
unavailable until you have opened a configuration.
Note: You can also select the Automatic Update option, which is available in the
Options form, to automatically update your configuration every time you make a change.
View – Tree displays cell or instance bindings in a tree structure. View – Table displays cell or instance bindings in a table structure.
View – Instance Table displays the instance table. This option is not available when View – Tree is selected.
View – Top Cell shows or hides the top cell information.
View – Global Bindings shows or hides the global library, view, and stop lists. View – Toolbar shows or hides the toolbar.
View – Message Area shows or hides the message area. View – Status Bar shows or hides the status bar.
View – Filters opens the View Filters form to let you set or edit display filters.
View – Options opens the Options form to let you select the columns you want to display in
the hierarchy editor. The Options form also lets you set the Automatic Update option. You can save the display options to use when you restart the hierarchy editor. See “Saving Custom Settings” on page 32 for more information.
Using the Toolbar
You can access frequently used commands by clicking the icons on the toolbar (open, update, explain, undo, redo, and display the table or tree structure). You can move the toolbar to a separate window for easy access.
To undock the toolbar,
➤ Click and drag the left edge of the toolbar to the location you want. A window appears with the toolbar in it.
To dock the toolbar,
➤ Click and drag the left edge of the toolbar to any edge of the hierarchy editor window.
Note: If you dock the toolbar outside the hierarchy editor window, it becomes a floating
toolbar on your desktop.
Top Cell Section
The Top Cell section contains the library, cell, and view names of the top cellview of the configuration you opened. This is the root cellview of your hierarchy.
Click here and drag the mouse to dock and undock the toolbar Open a config Save a config Create a new config Open a cellview for editing Open a cellview for viewing Update Tree view Explain
Show/hide instance table Table view
Redo Undo
Global Bindings Section
The values in the library, view, and stop lists in the Global Bindings section are the default values from the configuration.
■ Library List is a list of libraries from which cells are selected. Libraries are listed in order
of preference.
■ View List is the list of views or default rules specified in order of preference. For
example, if the view list contains the viewstbench_1, schematic, anddataflow in this order, the netlister first looks for atbench_1 view. If none is found, it looks for a schematic view. Again, if none is found, the netlister looks for adataflow view.
■ Stop List is the list of views used to determine when the hierarchy expansion will stop
and when a cell should be considered a leaf node in the hierarchy.
Cell Bindings Table
The Cell Bindings table displays the views that are bound to a cell. Icon indicating
Instance Bindings Table
The Instance Bindings table displays all the instances in the block you selected and their bindings. Instances are described in a library-cell-view format.
Use the maximize button to expand the Instance Bindings table and the minimize button to contract the table.
Messages
The message area near the bottom of the window displays error and warning messages and information for hierarchy editor actions. Scroll bars appear if the window is not large enough to display the full message.
Status Bar
The status bar at the bottom of the window displays the state of the hierarchy editor, whether Maximize button
cursor over a menu item or toolbar icon, the status bar tells you what will happen if you click on the item or icon.
Setting Command-Line Options
When you run the hierarchy editor from the command line, you can specify the following options. Syntax cdsHierEditor [-h[elp]] [-lib libname] [-cell cellname] [-view viewname] [-mode {r|w|a}] [-namespace nmpName] [-cdslib filepath] [-log filename] [-mpshost host] [-mpsession session] [-restore dirname] [-tree] [-version] [-ignoreRootConfig]
[-plugin pluginName [pluginOptions ...]]
Note: If you use the-pluginoption, you must specify it as the last argument. The hierarchy editor ignores all arguments after-plugin, except another-plugin argument.
Arguments
-h[elp] Prints a list and a brief description of the command-line options.
-lib libname Specifies the library name of the configuration to be opened.
-cell cellname Specifies the cell name of the configuration to be opened.
-view viewname Specifies the view name of the configuration to be opened. You must specify all three parts of the-lib, -cell, and-view options for the command to be complete.
-mode {r|w|a} Specifies the mode (read, write, or append) the hierarchy editor uses to open the configuration. The default mode is append.
Note: The-mode w(write) option erases all data in the configuration file you specify and opens the empty configuration file.
-namespace nmpName Specifies the name space to operate in, for example, Verilog,VHDL, orCDBA. All names are then
displayed in that name space, regardless of the source description that is used.
The default name space isCDBA.
-cdslib filepath Specifies the cds.lib file to load. Thecds.lib file specifies the libraries to use.
-log filename Specifies the path and name of a log file in which commands and messages are recorded. If you do not specify this option, no log file is created.
-mpshost host Specifies the Message Passing System (MPS) host on which the cdsNameServer is running and to which you want to connect. If the host is not specified, the
hierarchy editor connects to the local host. -mpssession session Specifies which MPS session to join.
-restore dirname Loads the hierEditor.env file from the specified directory after other hierarchy editor files (found with the Cadence File Search facility) have been loaded. -tree Indicates that the tree view is to be displayed at
startup. If this argument is not specified, the table view is displayed.
-version Prints the version and copyright information and exits. -ignoreRootConfig Ignores the root configuration in select and highlight
messages between the hierarchy editor and Cadence® Design Framework II (DFII) applications.
By default, if you are not editing the same root
configuration in your DFII application and the hierarchy editor, select and highlight messages between the two applications are ignored. If you set the
-ignoreRootConfig option, the hierarchy editor ignores the root configuration.
Customizing Hierarchy Editor Columns
The hierarchy editor lets you specify the attributes you want to display in the columns, change the column order, and resize the columns.
Specifying Attributes to Display in the Columns
To specify the attributes you want to display in the columns,
1. From the main menu, choose View – Options.
-plugin pluginName [pluginOptions ...]
Loads the plug-ins you specify. You can specify command-line options for the plug-ins. To load more than one plug-in, type-plugin before each plug-in name.
If you use the-plugin option, you must specify it as the last argument. The hierarchy editor ignores all arguments after-plugin, except another-plugin argument.
For more information about plug-ins, see Chapter 4, “Using Plug-Ins.”
Note: The plug-ins you specify must be installed in the
your_install_dir/share/cdssetup/
The Options form appears.
2. Click a tab for displaying a specific set of related attributes.
For example, to select the attributes you want to display in the tree structure, click the
Tree tab.
3. Select the attributes you want to display. To select the default attributes, click Defaults. 4. Click OK to apply your changes and close the form.
About the Options Form
The Options form lets you specify the attributes you want to display in the cell table, instance table, and tree view of the hierarchy editor. It also lets you specify the automatic update option.
The Cell Table tab lets you select the columns that appear in the cell table.
Show Cell Columns
Info displays information about the cellview.
For example, a triangle in this column indicates the top-level cell view. For a complete list of icons that can be displayed in this column and their meanings, choose Help – Legend to display the Legend dialog box.
View to Use displays a field in which you can type a specific view to use for the cell. Inherited View List displays a field in which you can modify the inherited view list
for the cell. The default inherited view list is the global view list.
Inherited Lib List displays a field in which you can modify the inherited library list
for the cell. The default inherited library list is the global library list.
The Instance Table tab lets you select the columns that appear in the instance table.
Show Instance Columns
Info displays information about the instance.
For example, a triangle in this column indicates the top-level cell view. For a complete list of icons that can be displayed in this column and their meanings, choose Help – Legend to display the Legend dialog box.
View to Use displays a field in which you can type a specific view to use for the
instance.
Inherited View List displays a field in which you can modify the inherited view list
for the instance.
Inherited Lib List displays a field in which you can modify the inherited library list
for the instance.
The Tree tab lets you select the columns that appear in the tree structure.
Inherited View List displays a field in which you can modify the inherited view list. Inherited Lib List displays a field in which you can modify the inherited library list. Expand Mode
By Instance displays all the instances for the selected cell when you expand a
branch.
By Instance Grouping displays similar instances grouped together when you
expand a branch. The number of instances is displayed. The General tab lets you set the following option:
Automatic Update updates the configuration automatically every time you make a
change. If this option is selected, you do not have to click the Update icon in the toolbar or choose View – Update to recompute the hierarchy or view your changes.
OK applies your selections and closes the form.
Cancel closes the form without applying your selections. Defaults resets the values to their defaults.
Help opens this manual.
Changing Column Order
You can change the order of the columns in the table view or tree view. For example, you can have the Cell column appear before the Library column.
To move a column,
➤ Drag the column heading to where you want the column to appear, then release the mouse.
Resizing Columns
You can change the width of any column by dragging the inside edge of its heading. To resize a column,
1. Click on the right edge of the column heading border.
2. Drag the border to the right to widen the column or drag the border to the left to narrow
Updating the Configuration Automatically
You can set an option to update the configuration automatically whenever you make a change. For example, if you open a configuration and add a view to the global view list, the hierarchy editor will automatically recompute the hierarchy and display the updated bindings. If you do not set the automatic update option, you need to click the Update icon or choose
View – Update to view the changes you make.
The default setting of the automatic update option is off. To update configurations automatically,
1. From the menu bar, choose View – Options.
The Options form appears.
2. Select the General tab. 3. Select Automatic Update. 4. Click OK.
The Options form closes.
Expanding and Collapsing Branches of Your Design
You can use the expansion icon to view the hierarchy of a design. The expansion icon is one of the following:
Displaying the Tree Structure
The tree view displays the hierarchy of your design.
UNIX NT Meaning
[+] Item contains instances not shown. The substructure is hidden (collapsed or locked).
[-] Item contains instances that are shown. The substructure is displayed (expanded or unlocked).
➤ From the menu bar, choose View – Tree, or from the toolbar, select the Tree View icon. To expand the structure for a collapsed cellview, do one of the following:
❑ Click the expansion icon for the item. ❑ Double-click on the item.
To collapse the structure for an expanded cellview, do one of the following:
❑ Click the expansion button for the item. ❑ Double-click on the item.
The following example illustrates the expansion of thepoa poa sch_1cellview in the tree structure.
Filtering Cellviews
You can find cellviews quickly by using filters. To filter cellviews,
1. Choose View – Filters.
The View Filters form appears.
2. In the Library, Cell, and View fields, specify whole words or character strings to narrow
your cellview search.
You can use the following wildcards:
Character Match Criteria
? Matches any single character
[list] Matches any single character inlist
[lower-upper] Matches any character in the range betweenlower and
For example, to find all the libraries that begin withp, in the Library field, typep*. Pattern matching is case sensitive. You can also specify multiple patterns by separating the patterns with spaces.
3. Select the type of data (for example, items at the leaf level or unbound items) you want
to see by selecting one or more of the following options:
❑ Show leaf instances and cellviews
❑ Show instances and cellviews that are not bound
❑ Only show entries that have an explicit rule
4. Click Apply.
The status bar displays Filters ON.
5. Click OK.
The changes you made are saved. The View Filters form closes and the hierarchy editor uses the selected filter criteria until you turn off the filters.
Note: The filter setting returns to the default setting when you start another hierarchy
editor session. You must save your settings using the File – Save Defaults command to save the filter settings for future sessions.
About the View Filters Form
Library lets you specify the search criteria for library names. Cell lets you specify the search criteria for cell names.
View lets you specify the search criteria for view names.
For the Library, Cell, and View fields, you can:
❑ Specify whole words or character strings
❑ Specify multiple patterns; separate the patterns with spaces ❑ Use the following wildcards:
? Matches any single character
Note: Pattern matching is case sensitive.
Show leaf instances and cellviews lets you specify whether you want to display instances
and cellviews that are at the leaf level.
Show instances and cellviews that are not bound lets you specify whether you want to
display unbound instances and cellviews.
Only show entries that have an explicit rule lets you specify whether you want to display
all entries or only those entries that have an explicit rule.
OK applies your settings and closes the form. Cancel closes the form without saving any settings. Apply applies your settings and leaves the form open.
Defaults restores the default match criteria and turns the filter off. The hierarchy editor
displays all cellviews and instances. The status bar displays Filters OFF.
Help opens this manual.
[lower-upper] Matches any character in the range betweenlower and
upper
Viewing the Legend
The Legend dialog box provides information about the icons and colors that are used in the hierarchy editor user interface.
To display the Legend dialog box,
➤ From the menu bar, choose Help – Legend.
You can customize the text colors. For more information, see “Changing Binding Data Color Definitions” on page 105.
Changing the Hierarchy Editor Fonts
The hierarchy editor’s fonts are determined by the settings in the cdsresource.properties file. The default fonts are defined in the
cdsresource.properties file in theyour_install_dir/share/cdssetup/
symphony/resources directory.
You can have multiplecdsresource.properties files. The hierarchy editor determines which file to use based on the search order defined in the setup.loc file.
To change the hierarchy editor fonts,
1. Copy the following file to a directory that is in yoursetup.loc file (for example, your $HOME directory or current working directory):
your_install_dir/share/cdssetup/symphony/resources/cdsresource.properties
2. Modify the font settings in the new cdsresource.properties file.
The font settings are defined by theCDS.textFont property, which has the following format:
CDS.textFont=fontName fontStyle fontSize
For example:
CDS.textFont=courier plain 12
3. Restart the hierarchy editor.
For more information about how the hierarchy editor determines which
cdsresource.properties file to use, see Chapter 3, "Cadence Setup Search File: setup.loc," of the Cadence Application Infrastructure User Guide.
Saving Custom Settings
When you exit the hierarchy editor, your settings are not automatically saved. You can save your settings with the Save Defaults form.
You can save and restore the following settings:
■ The height and width of the hierarchy editor window
■ The location of the hierarchy editor window on the screen ■ The filter settings
■ The view options to show or hide the toolbar, status bar, message area, or the Global Bindings, Cell Bindings, and Instance Bindings sections
■ The size of the instance table, tree structure, and message area ■ The columns that are displayed
■ The hierarchy editor form values ■ Plug-in settings
To save your current settings,
1. Choose File – Save Defaults.
The Save Defaults form appears:
2. Type the path to the directory in which you want to save the settings. 3. Click OK.
The information is saved in thehierEditor.env file in the directory you specified. The next time you start the hierarchy editor, it loads thehierEditor.env file. If the hierEditor.env file is not in a directory that is found by the Cadence search mechanism, you can load the file by starting the hierarchy editor with the-restore
dirname command. For more information about the hierEditor.env file, see Appendix A, “The hierEditor.env File.”
Exiting the Hierarchy Editor
To close the hierarchy editor,
1. Choose File – Exit or press Control-q.
If you have not saved the configuration changes you have made, a Warning form asks you whether you want to save your changes.
2. On the Warning form, click one of the following:
❑ Yes to save your changes and exit
❑ No to discard your changes and exit ❑ Cancel to dismiss the form without exiting
Note: The Exit command closes only the hierarchy editor. It does not close other applications
2
Creating Configurations
This chapter covers the following topics:
■ About the Configuration View of a Design Hierarchy on page 37 ❑ Opening Configurations on page 37
❑ Opening Configurations in Read-Only Mode on page 39 ❑ About the Open Form on page 39
❑ Filtering the Configurations in the Open Form on page 40 ❑ About the Browser Filters Form on page 41
■ Creating a New Configuration on page 43
❑ About the New Configuration Form on page 45
❑ About the Choose the Top Cell Form on page 46 ■ Editing Configurations on page 46
❑ Editing the Cell Bindings and Instance Bindings Tables on page 47 ■ Verifying Configuration Data on page 50
❑ Viewing the Description File on page 50 ❑ Verifying Cell Binding Rules on page 51
❑ About the Explain Form for a Selected Cell on page 52 ❑ Verifying Instance Binding Rules on page 53
❑ About the Explain Form for a Selected Instance on page 53 ❑ Verifying Occurrence Binding Rules on page 54
❑ About the Explain Form for a Selected Occurrence on page 55 ■ Working with Templates on page 56
❑ Using Templates on page 56
❑ Creating Templates on page 57
❑ Copying Your Created Template to Another Location on page 58
■ Saving Configurations on page 59 ❑ Saving a Configuration on page 59
❑ Saving VHDL Configurations on page 61 ❑ Saving Verilog Configurations on page 62
❑ Updating a Virtuoso Schematic Composer Configuration Using the Hierarchy Editor
About the Configuration View of a Design Hierarchy
The configuration view of a design is the definition that the hierarchy editor understands and can open. It is a cellview that stores a configuration file that contains the libraries, cells, and views of a design. You can browse
■ The library directory, which contains a collection of cells that correspond to a specific
process technology
■ The cell directory, which contains the design object that forms an individual building block of a chip or system
■ The view, which is a defined representation of a cell such as layout or a schematic
The main components of a configuration are the top cellview, which is the root of the design and the configuration rules.
In the above example, thedesignLiblibrary contains two configuration definitions identified by the view namesmixedConfig andlogicConfig. You can use the hierarchy editor to open themixedConfig or thelogicConfig configuration.
Opening Configurations
To open an existing configuration when you start the hierarchy editor,
➤ In a UNIX window, type
cdsHierEditor -lib libname -cell cellname -view viewname
All of the above options must be specified for the hierarchy editor to open a configuration and load the data.
designLib
logicConfig schematic mixedConfig
pulsegen Top cell name
layout
View name Library name
If you do not specify a cellview (library, cell, and view names) when you run the cdsHierEditor command, the hierarchy editor opens without loading a configuration.
Note: A cellview is the library, cell, and view names.
To open a configuration from the hierarchy editor,
1. From the menu bar, choose File – Open or press Control-o. The Open form appears.
2. If you want the Browse section of the form to display only a specific set of libraries, cells,
and views, click Filters and type your search criteria in the Browser Filters form.
3. In the Browse section, select the name of the library where your design is located, or
type the name in the Library field.
The libraries are displayed in outline form. Thecds.lib file is at the top of the design hierarchy. The libraries defined in thecds.lib file are at the next level, the cells are a level below the libraries, and the views are a level below the cells. For more information about Cadence® library structures, refer to the Cadence Application Infrastructure
4. Click the expansion icon for the library, then select the cell you want.
The selected cell name appears in the Cell field.
5. Click the expansion icon of the cell, then select the view you want.
Note: The browser displays only configuration views and expands only those cells that
contain configuration views.
The selected view name appears in the View field.
6. When all the fields in the form are filled, click OK.
The hierarchy editor displays your data in the Top Cell, Global, and Cell Bindings sections.
Note: Cadence Design Framework II (DFII) users can use the libSelect application to
open configurations in the hierarchy editor. You must enable libSelect by setting the compatibility mode in thehierEditor.env file. For more information on the
hierEditor.env file, refer to Appendix A, “The hierEditor.env File.”
Opening Configurations in Read-Only Mode
To open a configuration in read-only mode from the hierarchy editor,
1. From the menu bar, choose File – Open (Read-Only).
The Open (Read-Only) form appears.
2. Refer to the steps in “Opening Configurations” on page 37.
The configuration is opened but cannot be edited. If the hierarchy editor cannot open a configuration, an Open Error dialog box appears.
About the Open Form
Configuration
Library lets you type the name of a library specified in yourcds.libfile. You can also fill in this field by selecting a library in the Browse section.
Cell lets you type the name of the cell you want to open. You can also fill in this field by
selecting a cell in the Browse section.
View lets you type the name of the configuration view you want to open. You can also fill
Browse lets you select the library, cell, and view. The library, cell, and view that you select
are displayed in the Library, Cell, and View text fields in the Configuration section. Note that the browser displays only configuration views and expands only those cells that contain configuration views.
You can set filters to display only a specific set of libraries, cells, and views in the Browse section. See “Filtering the Configurations in the Open Form” on page 40 for more information.
OK opens the configuration you selected and closes the form. Cancel cancels the selections and closes the form.
Filters opens the Browser Filters form that lets you specify search criteria to display only
parts of the library structure that match your filter criteria.
Help opens this manual.
Filtering the Configurations in the Open Form
You can set filters to display only a specific set of libraries, cells, and views in the Browse section of the Open form.
1. In the Open form, click Filters.
The Browser Filters form appears.
2. In the Library, Cell, and View fields, specify whole words or character strings to narrow
You can use the following wildcard characters:
For example, to find all the libraries that begin withp, in the Library field, typep*. Pattern matching is case sensitive. You can also specify multiple patterns by separating the patterns with spaces.
3. Click OK.
The changes you made are applied and the Browser Filters form closes.
The hierarchy editor refreshes the display in the Browse section of the Open form, based on the filters you set.
Note: To return to the default filter settings, in the Browser Filters form, click Defaults.
About the Browser Filters Form
Library lets you specify the search criteria for library names. Cell lets you specify the search criteria for cell names.
View lets you specify the search criteria for view names.
For the Library, Cell, and View fields, you can:
❑ Specify whole words or character strings
❑ Specify multiple patterns; separate the patterns with spaces ❑ Use the following wildcards:
Character Match Criteria
? Matches any single character
[list] Matches any single character inlist
[lower-upper] Matches any character in the range betweenlower and
upper
* Matches any pattern
Note: Pattern matching is case sensitive.
OK sets the search criteria and closes the Browser Filters form. Cancel closes the form without saving your selections.
Apply sets the search criteria for libraries, cells, views, and views but does not close the
form.
Defaults restores the default settings. Help opens this manual.
[list] Matches any single character inlist
[lower-upper] Matches any character in the range betweenlower and
upper
Creating a New Configuration
Use these steps to create and use a configuration with the hierarchy editor:
To create a new configuration,
1. Open the hierarchy editor.
The hierarchy editor window appears.
2. Choose File – New or press Control-n.
Define a global stop list Define a global view list
Specify cell bindings
Specify instance bindings
Save the configuration cellview file Update the configuration cellview
Run your application
Quit the hierarchy editor Yes No Check results Verify the configuration cellview optional required Define a global library list
Open a new configuration file
Open or reopen the application where the design was generated
The New Configuration form appears.
3. In the Top Cell section, do one of the following:
❑ In the Library, Cell, and View fields, type the name of the library, cell, and view that
you want to use as the top cellview of your design.
❑ Click Browse and select the top cellview from the Choose the Top Cell form.
4. In the Global Bindings section, do one of the following:
❑ In the Library List, View List, and Stop List fields, type a library list, view list, and stop list to specify the default bindings for the entire design.
The global library list is a list of libraries that determines the libraries from which each cell is obtained. The global view list is a list of views that determines which view is selected for each object in the design. The global stop list specifies a list of views that are to be treated as leaf nodes, that is, they are not to be expanded.
You can use constants in the view list and stop list. A constant is a symbolic name used to represent a set of views. For more information on creating and using constants, refer to “Using Constants” on page 106.
The Stop List field can be empty.
❑ Click Use Template to select a template that is compatible with the simulator you are running. Templates for simulators provide lists of views that are most often used for those simulators.
Refer to “Working with Templates” on page 56 to use prepared templates or to create your own templates.
Note: If the template you selected has filled in the Top Cell section of the New
Configuration form, replace the names in the Library, Cell, and View fields with the top cellview you want to use.
5. (Optional) In the Description field, type a brief statement describing the new
configuration.
6. Click OK.
The New Configuration form closes. The hierarchy editor displays the new configuration. See “Saving Configurations” on page 59 for information about saving your new configuration.
About the New Configuration Form
Top Cell specifies the cell at the highest level of the configuration, the top cellview. Library specifies the name of the library that contains the top cellview.
Cell specifies the cell name of the top cellview. View specifies the view name of the top cellview.
Browse opens the Choose the Top Cell form for selecting the top cellview of the
configuration.
Global Bindings specify default bindings for the entire design.
Library List lets you specify libraries for cells that do not have library bindings. List the
libraries in the order you want them searched.
View List lets you specify the views you want in your configuration in order of
view is selected for every object in the design, unless overridden by a cell or instance binding.
Stop List lets you specify cellviews that are to be treated as leaf nodes, that is, they are
not to be expanded. This field can be empty.
Description lets you enter a brief statement describing the configuration. OK sets the values you entered and closes the form.
Cancel closes the New Configuration form without applying your values. Use Template lets you select a template from a list of predefined templates. Help opens this manual.
About the Choose the Top Cell Form
Top Cell
Library lets you specify the name of the library that contains the cell at the highest level
of the configuration, the top cellview.
Cell lets you specify the cell name of the top cellview of the configuration. View lets you specify the view name of the top cellview of the configuration.
Browse lets you select the top cellview of the configuration. The library, cell, and view you
select are displayed in the Library, Cell, and View text fields in the Top Cell section.
OK sets the values you entered and closes the form. Cancel cancels your selections and closes the form.
Filters displays the Browser Filters form that lets you specify search criteria to display only
parts of the library structure.
Help opens this manual.
Editing Configurations
This section provides an overview of how to edit a configuration. For a more detailed description on how to make changes and specify rules for configurations, see Chapter 3,
Note: You cannot edit sub-configurations—a sub-configuration is a configuration that is
contained within a configuration. To edit a sub-configuration, you must open it separately as a configuration in the hierarchy editor.
To edit a configuration using the hierarchy editor,
1. Open the configuration you want to edit. 2. Edit the configuration.
❑ In the Top Cell section, edit the library name, cell name, or view name of the top
cellview of the configuration.
❑ In the Global Bindings section, edit the library list, view list, and stop list. Separate the entries in the lists with spaces.
Note: Library bindings in CDBA are fixed and cannot be overridden. If your data is
CDBA (DFII only), the hierarchy editor ignores any library list you enter in the Global
Bindings section.
Note: The view list that applies to the root cellview of the design cannot be edited.
In the Cell Bindings table, the root cellview is identified with a green triangle in the
Info column, if the Info column is displayed.
❑ Edit the Cell Bindings and Instance Bindings sections.
3. Choose View – Update to see the results of your changes in the Cell Bindings or
Instance Bindings sections.
If you selected the Automatic Update option in the Options form, this step is not required because your configuration is automatically updated.
Note: Updating the display is optional, but you must save the information to be able to
use the edited configuration.
4. Click File – Save or pressControl-s.
Note: Other Cadence software tools cannot access new or changed configuration files
until they have been saved.
Editing the Cell Bindings and Instance Bindings Tables
Changing Cell or Instance View Bindings
1. In the Cell Bindings or Instance Bindings section, select the cell or instance you want
2. Do one of the following:
❑ Click in the View to Use column of the cell or instance, type the new view, then
press Return.
❑ Right-click anywhere in the row of the cell or instance you want to change and select a view from the list of views in the pop-up menu.
The new view appears in the View to Use column in the color used to display user bindings.
3. Choose View – Update to see the results of your changes.
If you selected the Automatic Update option in the Options form, this step is not required because your configuration is automatically updated.
4. To save the changes, choose File – Save or press Control-s.
Adding Views to Cell or Instance Bindings
To add a new view,
1. In the Cell Bindings or Instance Bindings section, click in the Inherited View List
column and move the cursor to the end of the list.
2. Type the name of the view you want to use.
Separate entries with spaces.
3. Press Return.
The modified view list appears in the Inherited View List column in the color used to display user bindings.
4. To view your changes, choose View – Update.
If you selected the Automatic Update option in the Options form, this step is not required because your configuration is automatically updated.
5. To save the changes, choose File – Save or press Control-s.
Deleting Views from Cell or Instance Bindings
You can remove any views from the cell or instance bindings. To remove a view,
1. In the Cell Bindings or Instance Bindings section, select the cell or instance you want
to change.
2. In the Inherited View List column, double-click on the view you want to remove.
The view becomes highlighted.
3. Press Delete.
4. To view your changes, choose View – Update.
If you selected the Automatic Update option in the Options form, this step is not required because your configuration is automatically updated.
5. To save the changes, choose File – Save or press Control-s.
Viewing Instances Contained by Other Instances
To see instances contained by other instances,
1. Choose View – Tree to display the tree view of the hierarchy editor. 2. Right-click on the instance you want to browse.
A pop-up menu appears.
3. Select Expand Instance.
The hierarchy below the instance is displayed. To collapse an expanded instance,
1. Right-click on the name of the expanded instance.
A pop-up menu appears.
2. Select UnExpand Instance.
The hierarchy below the instance is collapsed.
Performing a Global Change on a Group of Instances
To perform a global view change on a group of instances, you can display all instances that share the same rules,
1. Choose View – Options.
2. Select the Tree tab.
3. In the Expand Mode section, select By instance grouping. 4. Click OK.
5. Choose View – Tree to display the tree view of the hierarchy editor. 6. Select the group of instances that you want to change.
7. Click in the View to Use column and type the name of the new view for the group of
instances.
8. Press Return.
The view you selected is applied to all the instances and appears in the color used to display user bindings.
9. To see the results of your changes, choose View – Update.
If you selected the Automatic Update option in the Options form, this step is not required because your configuration is automatically updated.
10. To save the changes, choose File – Save or pressControl-s.
Verifying Configuration Data
You can check the configuration data of your design in the following ways:
■ Viewing the Description File
■ Seeing what binding rules were used to select any view in the hierarchy. You can do this
by
❑ Verifying Cell Binding Rules
❑ Verifying Instance Binding Rules ❑ Verifying Occurrence Binding Rules
■ Looking at the structure of the hierarchy using the table or the tree structure.
Viewing the Description File
The Edit Description form appears.
Description displays a description of the configuration, which you can edit. OK applies the changes you made and closes the form.
Cancel cancels the changes you made and closes the form. Help opens this manual.
To edit the description of your configuration,
1. In the Edit Description form, edit the description in the Description field. 2. Click OK.
The hierarchy editor saves the edited description.
Verifying Cell Binding Rules
To see which binding rules were used for a cell, do one of the following:
■ In the Cell Bindings table, right-click on a cellview and, from the pop-up menu, select
Explain.
The Explain form appears.
About the Explain Form for a Selected Cell
Selection displays the master cellview for the selected cell Library specifies the master library of the cell.
Cell specifies the master cell of the cell. View specifies the master view of the cell.
Note: If the Library, Cell, or View fields display **UNBOUND**, the cell has a bind-to-open attribute.
Instantiations lists all the cellviews where the selected cell is used. Explanation describes the bindings for the selected cell.
Help opens this manual.
Verifying Instance Binding Rules
To see which binding rules were used for an instance, do one of the following:
■ In the Instance Bindings table, right-click on the instance whose rules you want to
check and, from the pop-up menu, select Explain.
■ In the Instance Bindings table, select the instance and, from the toolbar, click the
Explain icon.
The Explain form appears.
About the Explain Form for a Selected Instance
Selection displays the cellview that contains the selected instance
Library specifies the library of the cellview that contains the selected instance. Cell specifies the cell that contains the selected instance.
View specifies the view of the cellview that contains the selected instance. Instance specifies the name of the instance in the cellview that contains it. Bound To displays the results of the rules that are used by the selected instance.
Library specifies the master library of the selected instance. Cell specifies the master cell of the selected instance.
View specifies the master view of the selected instance.
Note: If the Library, Cell, or View fields display**UNBOUND**, the instance has a bind-to-open attribute.
Explanation describes the bindings for the selected instance. Close closes the form.
Help opens this manual.
Verifying Occurrence Binding Rules
To see which binding rules were used for an occurrence,
1. In the tree view of the hierarchy editor, in the Tree View section, right-click on the
occurrence.
The Explain form appears.
About the Explain Form for a Selected Occurrence
Selection specifies the full path from the top cellview to the occurrence.
Bound To displays the library, cell, and view to which the occurrence is bound. Library specifies the library of the selected occurrence.
Cell specifies the cell of the selected occurrence. View specifies the view of the selected occurrence.
Note: If the Library, Cell, or View fields display**UNBOUND**, the occurrence has a bind-to-open attribute.
Explanation describes the bindings for the selected occurrence. Close closes the form.
Help opens this manual.
Working with Templates
Templates let you build configurations using pre-defined view lists and stop lists. The hierarchy editor includes templates for some simulators that are compatible with Cadence software. You can also create your own templates.
Using Templates
To use a template,
1. Choose File – New or press Control-n. The New Configuration form appears.
2. In the New Configuration form, click Use Template.
The Use Template form appears.
3. Do one of the following:
❑ If you want to use a pre-defined template, or a template that you have created and
placed in theyour_install_dir/share/cdssetup/hierEditor/
templates directory, select the template from the Name listbox.
❑ If you want to use a template that is not in theyour_install_dir/share/
cdssetup/hierEditor/templates directory,
4. Click OK.
The Use Template form closes. The New Configuration form is filled in with the view list and stop list data from the template.
Note: If there is already information in the Top Cell section, selecting a template does
not overwrite that information. If the Top Cell fields are empty when you select a template, the hierarchy editor fills them in with the default values.
5. In the New Configuration form, click OK.
The hierarchy editor displays the new data.
About the Use Template Form
Template
Name lets you select a template from a list of pre-defined templates for simulators that
are compatible with Cadence software. The listbox also lists any other templates that you placed in theyour_install_dir/share/cdssetup/hierEditor/templates/
directory. If you want to use a template that is not in this directory, select <Other> and specify the path in the From File field.
From File lets you type the path to the template you want to use. OK applies your settings and closes the form.
Cancel closes the form without applying your settings. Apply sets your selections and leaves the form open. Help opens this manual.
Creating Templates
You can create your own template using your own view lists and stop lists for your simulator or other design-specific requirements.
To create your own template,
1. In the hierarchy editor, choose File – New or press Control-n.
Note: If you have made changes to the current hierarchy, the hierarchy editor prompts
you to save your changes.
2. In the Top Cell section, type the library, cell, and view name of the root of your hierarchy. 3. In the Global Bindings section, specify the library list, view list and stop list.
Separate entries with spaces.
You can use constants in the view list and stop list. Refer to “Using Constants” on page 106.
4. (Optional) In the Description field, type a brief statement about the new template. 5. Click OK.
The New Configuration form closes.
The hierarchy editor displays the new configuration.
6. Choose File – Save As to save your new configuration.
The Save As form appears.
7. In the Browse section, select the library in which you want to save the new configuration.
The library is displayed in the Library field in the Configuration section.
8. In the Cell field, type the name of the cell. 9. In the View field, type the name of the view.
Note: The name you give to the cell and view of the configuration do not have to match
the name of the cell and view of the top-level cell.
10. Click OK.
Copying Your Created Template to Another Location
You can copy the templates you create to another location and access them from the Use
Template button on the New Configuration form.
By default, configurations are saved in theexpand.cfg file, which is located in your
library/cell/configuration_view directory. To copy your template to another location,
1. Change directories to the /library/cell/view directory in which you saved the template.
3. Copy the configuration file to the templates directory with the following command:
cp expand.cfg your_install_dir/share/cdssetup/hierEditor/templates/
yourtemplatename
4. Restart the hierarchy editor.
Your new template is available from the Use Template button on the New
Configuration form.
Saving Configurations
When you save a configuration in the hierarchy editor, it is saved in theexpand.cfg file in the configuration view. The configuration view directory also contains anexpand.cfg%file, which is the previously-saved version of the expand.cfg file.
You can also save VHDL and Verilog® configurations. See the following topics for more information:
■ “Saving VHDL Configurations” on page 61 ■ “Saving Verilog Configurations” on page 62
If you are a Virtuoso® Schematic Composer user, see “Updating a Virtuoso Schematic Composer Configuration Using the Hierarchy Editor Interface” on page 64.
Note: Other applications cannot access changed configuration files until they have been
saved in the hierarchy editor.
Saving a Configuration
To save a configuration,
➤ Choose File – Save or pressControl-s. The hierarchy editor saves the configuration.
To save a configuration using the File – Save As command,
The Save As form appears.
(For details about the Save As form, see “About the Save As Form” on page 60.)
2. Specify the library in which you want to save the configuration by typing the name in the
Library field or selecting the library from the Browse section.
3. Specify the cell in which you want to save the configuration by typing the name in the
Cell field or selecting the cell from the Browse section.
4. In the View field, type the name of the new configuration view.
Note: The name you give to the cell and view of the configuration do not have to match
the name of the cell and view of the top-level cellview.
5. Click OK.
The next time you want to use this configuration, you can access it from the Open Browse section by selecting the library, cell, and view.
About the Save As Form
Configuration
Library lets you specify the name of the library in which you want to save a copy of the
View lets you specify the name of the new configuration view. OK saves the file you selected.
Cancel cancels your selections and closes the form.
Browse lets you select the library, cell, and view for the new configuration. The library, cell,
and view you select are displayed in the Library, Cell, and View text fields in the
Configuration section. Note that the browser displays only configuration views and expands
only those cells that contain configuration views.
Filters lets you narrow your search by displaying a subset of libraries and cells that match
your search criteria.
Help opens this manual.
Saving VHDL Configurations
The hierarchy editor provides the File – Save As VHDL command to save a configuration in VHDL syntax that can be read by VHDL tools. A VHDL configuration is always saved in a view calledconfiguration.
To save a configuration for VHDL applications,
1. Choose File – Save As VHDL.
2. Specify the name of the library and cell in which you want to save the VHDL configuration
by doing one of the following:
❑ Type the names in the Library and Cell fields. ❑ Select the library and cell from the Browse section. The View field is automatically set toconfiguration.
3. Click OK.
Note: Saving a VHDL configuration does not save it in a format that can be read and
edited by the hierarchy editor. You must also save the configuration with the File – Save or File – Save As command in order for it to be read by the hierarchy editor.
About the Save As VHDL Form
Configuration
Library specifies the name of the library in which you want to save the configuration. Cell specifies the name of the cell in which you want to save the configuration.
View specifies the name of the configuration view. For VHDL configurations, the view
name is always configuration.
OK saves the configuration.
Cancel discards your selections and closes the form.
Filters lets you narrow your search by displaying a subset of libraries and cells that match
your search criteria.
Help opens this manual.
Saving Verilog Configurations
The hierarchy editor provides the File – Save As Verilog command to save a configuration in Verilog syntax that can be read by Verilog tools.
To save a configuration for Verilog applications,
The Save As Verilog form appears.
2. Specify the file in which you want to save the Verilog configuration by doing one of the
following:
a. In the Look in field, type the path to the directory in which you want to save the
configuration.
b. In the File field, type the name of the file.
The default value of this field isverilog.f. or
a. Select the file in which you want to save the Verilog configuration from the file
browser.
Note: You can also type a filter expression in the Filters field to narrow your search for
the directory to which you want to save your Verilog file.
