Vega Guide

Draft 7/5/99
Chapter 1 VEGA 3.0 Browser description
VEGA 3.0 Browser description 1.1 Introduction 1.2 General view of the browser 1.2.1 Menu Schematic 1.2.2 Menu Edit 1.2.3 Menu View 1.3 Schematic Samples 1.4 TCL interface 1.4.1 browser 1.4.2 function applied on object <browser> 1.4.3 configuration options
1 1 4 10 21 23 24 24 26 32
1.1 Introduction
This Chapter describes the implementation of the Vega Schematic Browser. The purpose of the interface is to:
Show how to use the schematic browser Give a short description of how to use the TCL interface to program
user functions with the schematic browser
Vega Schematic Browsers Guide

March 1998 - Rel. 1.0 Copyright 1998 by LSI Logic Corporation. All rights reserved.
1-1
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2 General view of the browser

The main window is divided into 3 parts:
the menu-bar, the schematic view, the status-bar.
The status-bar contains the name of the design, the hierarchical name of the displayed instance (vega is instance based), the number of pages, and the type and name of the object below the mouse cursor while moving. Page 1 of 5 for example, if the design is split into 5 pages, and the first one is currently shown.

1-2
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Pages are created on demand, so more than x is printed if not all pages are created yet. Un-setting the re-usable check-button allows the user to open a new browser window, while diving into a cell, extracting a logic cone, going up to the parent of the current design, ...
To dive into an instance, double-click the object with the left mouse
button.
To go up to the parent, press the left mouse button, drag the mouse
toward north-west to see a line with go up , then release the mouse button.
To select an object, single-click the object with the left mouse button . To add an object to the current selection, single-click the object with
the left mouse button while pressing key [Control].
To move an object, press the left mouse button to select the object,
drag the mouse, then release the mouse button while pressing key [Shift].
To zoom out, press the left mouse button, drag the mouse toward
north-est to see a line with zoom out <number> , then release the mouse button. The zoom factor depends on the length of the line.
To zoom in, press the left mouse button, drag the mouse toward
south-est to see a rectangle with zoom in , then release the mouse button.
To fit in the page, press the left mouse button, drag the mouse
toward south-west to see a line with zoom fit, then release the mouse button.
To move the schematic, press the middle mouse button, drag the
mouse, then release the button.
Pressing on right mouse button will open a popup-menu. A double-click with the left mouse button on a symbol -> or <(PageConnector) allows to jump to another page, when a net is split.

1-3
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Its possible to jump from a port to a hpin and vice-versa, by selecting

this object and then pressing j. This functionality should be replaced by double-click in the future.
The selection is copied in text (type and hierarchical name) to the X

copy-paste buffer.
Shortcuts are available for most functions.
1.2.1 Menu Schematic

1-4
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.1.1 Sub-menu Open

1-5
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
The design selected in this dialog, will be displayed in the browser window. The Open dialog checks whether the re-usable check-button is selected or not. First it will try to use the current browser windows if allowed (re-usable selected), then it will try to re-use the last opened browser window, finally it creates a new window and opens the design in it. The Vega database is instance based, this allows to display each instance of a design separately. When a design is opened the second time in the same browser window, it takes less time than the first time as the browser data gets cached. Each browser window has its own data and may behave differently.

1-6
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.1.2 Sub-menu Print
The dialog is used to print the design. all pages : every split page of the design is printed on a new sheet of paper. current page : only the current page which is shown in the browser will be printed. current view : only the current view is printed, and gets stretched on the paper.

1-7
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Paper size can be :
A4 A3 A2 A1 A B C D
Orientation can be :
auto landscape portrait.
Color can be :
"black & white", "full colors", "full colors (white background)", "inverted colors", "inverted colors (white background)"
Border width unit can be :
mm cm inch.
Printer is a unix printer command like lpr -Ptest Use file to create a PostScript file.

1-8
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.1.3 Sub-menu Preferences
show page frame : a grey frame is drawn around the schematic. Sheet size can be changed to match with paper size. It can be A4, A3, A2, A1, A0, A, B, C, D or E. Select an entry in the list to modify its color.

1-9
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.1.4 Sub-menu Close This button will destroy the window.
1.2.2 Menu Edit

1-10
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.1 Sub-menu Search
It is possible to search an object by specifying its hierarchical name (starting from the top-level). If use glob pattern is selected, the last part of the hierarchical name (name of the object itself) will be treated as a glob expression. For example, searching for /a/b/c/p[0-9]* will search for objects in design /a/b/c with a name p[0-9]*. e.g p1ab, or p5 will match. Using the right mouse button a popup menu can be opened which provides a direct link to other dialog boxes, or an action in the browser. The selection is copied in text (type and hierarchical name) to the X copy-paste buffer.

1-11
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.2 Sub-menu Information
This dialog shows information about stored attributes in the database for the selected object.

1-12
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.3 Sub-menu Database Explorer
This dialog consists of 4 different parts :
the list of objects which can be used as a starting point for searching, the object type to be searched, the filter, the result.
The popup in the Selected list allows to remove the selection with Clear. Clear All will delete all objects but global scope. Object type specifies which type of object to search for and depends on the type of the selected object. Filter can be case sensitive or insensitive depending on the status of the check-button. It contains also a AND and a OR button to choose if the result is reported if one of the filter matches (OR) or if every filter must match (AND).

1-13
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
A filter line is <attribute name> <operation> <value>, where <attribute name> depends on the object type searched, and operation can be :
== != glob > <
if <attribute> is equal to <value> if <attribute> is different from <value> <value> is a glob expression using []*? as special characters
regexp <value> is a regular expression

if <attribute> is greater than <value> if <attribute> is less than <value>
longer if size(<attribute>) is greater than <value> shorter if size(<attribute>) is less than <value>
There is a maximum of 5 filter lines
1.2.2.4 Sub-menu Expand The schematic browser is implemented in a way which allows to display different instances at different levels in the hierarchy on the same page. This operating mode is called flat hierarchy mode. In addition flat hierarchy mode allows to add (expand), or remove (collapse) parts of logic in the current view. Expand can be applied to pins, ports, nets, busses. It will expand the net connected to pins/ports and displays ALL connections of this net.
1.2.2.5 Sub-menu Collapse Collapse is valid only in flat hierarchy mode and removes all selected objects from the current view.

1-14
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.6 Sub-menu Clean-up
This dialog helps the user to remove objects from the current view. It does an automatic collapse of objects which are unloaded (floating output) or undriven (floating input). The list of objects are not removed, even if they are unloaded or undriven. This function is processing intensive and may be therefore slow.

1-15
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.7 Sub-menu Remove Highlight Remove all highlights previously set on selected objects.
1.2.2.8 Sub-menu Highlight The color chosen in the sub-menu is assigned to selected objects. Different colors can be assigned to the same object, but only one is displayed. A short-cut is available for highlighting : 1, 2, 3, 4, ..., 8. where each one is a different color which can be changed in the preferences dialog.
1.2.2.9 Sub-menu Select This function is made to select a previously highlighted set of objects. 1.2.2.10 Sub-menu Clear Clear will remove the highlight on all objects of the specified color.

1-16
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.11 Sub-menu Trace

1-17
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Trace backward follows enabled and transparent COMBINATORIAL arcs, from OUT / INOUT to IN / INOUT direction. Trace forward follows these arcs from IN / INOUT to OUT / INOUT direction. If follow transparent only is selected, the function will not cross enabled arcs. Maximum depth is the number of level of logic the function should cross through. The polarity can be invert., non-invert. or unknown. The return value of the trace function is a list of objects which may be further filtered by the following selections.
nets
only nets without successor are added to the list.
all_nets
if this option is specified, all nets encountered are added.
clock_pins
found lpins with a clock arc are added to the result list.
data_pins
found lpins with a data arc are added to the result list.
async_pins
found lpins with a async arc are added to the result list.
tristate_pins
found lpins with a tristate arc are added to the result list.
tracing_pins
lpins jumped over during trace
end_pins
all pins connected to all nets involved in the trace which are not tracing_pins
ports
top-level ports found on nets
1-18
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
In the popup, clicking on the button Extract will display all selected objects in flat hierarchy mode in a browser window. Take care to unset the re-usable button to keep the browser window.

1-19
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.2.12 Sub-menu Connections
This dialog reports all connections from a net, pin, port, .... It returns a list of drivers, loads, and sub-nets ( part of the hierarchical net ).

1-20
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.3 Menu View
1.2.3.1 Sub-menu Zoom In Make the view bigger.
1.2.3.2 Sub-menu Zoom Out Make the view smaller
1.2.3.3 Sub-menu Zoom Fit Show the entire picture to fit in the page.
1.2.3.4 Sub-menu Zoom All Show the entire sheet including the frame.

1-21
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.2.3.5 Sub-menu Redraw For redrawing the page, use this button.
1.2.3.6 Sub-menu Previous Page Open the previous split page
1.2.3.7 Sub-menu Next Page Open the next split page
1.2.3.8 Sub-menu Grey Mode All objects except highlighted ones are displayed in grey (dimmed)
1.2.3.9 Sub-menu Split Busses All busses are expanded to single bits. This function is processing intensive and may be therefore slow.

1-22
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.3 Schematic Samples
First sample showing Split busses mode, with Grey mode set to on. Objects are highlighted with different colors.

1-23
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Second sample showing flat hierarchical mode.
1.4 TCL interface

1.4.1 browser
Those functions manage the creation and destruction of browser objects. 1.4.1.1 browser list Syntax browser list

1-24
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Description Returns the list of created browser objects. Example 1.4.1.2 browser use Syntax browser use ?<browser>? Description Tries to get a browser object which is re-usable. If <browser> is given as an argument, it first checks if this object is re-usable. If no browser object is re-usable, it creates and returns a new one. Example 1.4.1.3 browser get Syntax browser get ?<browser>? Description If <browser> is given as an argument, it first checks if this object still exists, and returns it, else it searches for an existing browser object. If none is available, it creates and returns a new one. Example 1.4.1.4 browser delete Syntax browser delete <browser> Description Destroys the browser object given as an argument.

1-25
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Example
1.4.2 function applied on object <browser>

1.4.2.1 activate Syntax <browser> activate Description This is a standard itk function to open the window corresponding with this object. Example 1.4.2.2 deactivate Syntax <browser> deactivate Description This is a standard itk function to close the window of this object. Example 1.4.2.3 display Syntax <browser> display <type> <window> Description <type> is lower or raise <window> is the reference window The browser window is opened just below <window> if <type> is lower, and just above if <type> is raise. Example
1-26
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.4.2.4 get_current_design Syntax <browser> get_current_design Description Returns incremental (in flat hierarchy mode), else the current design handle. Example 1.4.2.5 open Syntax <browser> open <design handle> Description Opens a design (instance based) and creates the schematic. Example 1.4.2.6 extract Syntax <browser> extract ?-noupdate? ?-top? ?-append? -list <handle list> ?-filter <tcl code>? <browser> extract ?-noupdate? ?-top? ?-append? -trace <trace result> ?-filter <tcl code>? <browser> extract ?-noupdate? -remove -list <handle list> <browser> extract ?-noupdate? -remove -trace <trace result> Description This function opens a hierarchical mode view and shows a list of objects in it.

1-27
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
-append add objects to the current view. -list takes a list of vega handles. -trace takes the result of a trace function -filter is a piece of tcl code which will be applied on each lpin, hpin, port of the nets. The corresponding pin or port is shown in the view if the result of the filter is 1. -noupdate means that the schematic will not be updated at the end of the call to this function. It allows to call more extract -noupdate ..., for example in a loop. Then, the function <browser> update must be called. -top means that the top-level is always expanded. Else, just designs with objects in them are shown. -remove is used to remove a list of objects from the current view. This works only in flat hierarchy mode. Example 1.4.2.7 update Syntax <browser> update ?-zoom <zoom value>? Description This function is used after <browser> extract -noupdate ... -zoom change the zoom factor before drawing the picture (see <browser> zoom). Example 1.4.2.8 cleanup Syntax <browser> cleanup ?-undriven? ?-unloaded? ?-exclude <list of handles>?

1-28
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
Description This function remove objects in flat hierarchy mode. -undriven removes all objects with no driver (floating input) -unloaded removes all objects with no loads (floating output) -exclude is the list of objects which should not be removed, even if they are unloaded or undriven. Example 1.4.2.9 center_to Syntax <browser> center_to <handle> Description Opens the parent of the object and shows it in the center of the browser window. Example 1.4.2.10 zoom Syntax <browser> zoom <browser> zoom fit <browser> zoom all <browser> zoom <number> <browser> zoom +<number> <browser> zoom -<number> Description 1. Returns the current zoom factor. 2. Shows the schematic in the current window.
1-29
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
3. Shows the entire page in the current windows (fit to sheet size). 4. Changes the zoom factor to the given value. 5. Adds the given value to the current zoom factor. 6. Subtracts the given value to the current zoom factor. Example 1.4.2.11 greymode Syntax <browser> greymode on | off Description Sets or unsets the grey mode. Example 1.4.2.12 redraw Syntax <browser> redraw Description Call this function to fix redrawing problems. Example 1.4.2.13 selection Syntax <browser> selection clear <browser> selection get <browser> selection set <handle list> Description

1-30
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1. Clears the selection. 2. Returns the selection (list of handles). 3. Sets the new selection to the given list. Example 1.4.2.14 highlight Syntax <browser> highlight clear ?-color <color>? <browser> highlight get ?-color <color>? <browser> highlight set -color <color> <handle list> Description 1. Clears highlights. Only <color> is cleared if -color is used. If not, all colors are removed. 2. Returns a list of handles of objects with the given color. If -color is not used, it returns all highlighted objects. 3. Highlights a list of objects with the given color. Example 1.4.2.15 print Syntax <browser> print -file <filename> <option> <option> ... <browser> print -printer <printer-command> <option> <option> ... Description Prints to a PostScript file. Prints with a command (can be lpr, ghostview, ...) where options are :

1-31
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
-mode module | page | view (default : module) -orientation auto | landscape | portrait (default : auto) -size A4 | A3 | A2 | A1 | A | B | C | D (default : A4) -color mono | color | inverted (default : mono) -white_bg -border (default : 10) -unit mm | cm | inch (default : mm) Example 1.4.2.16 re_usable Syntax <browser> re_usable ?1 | 0? Description Gets or sets the re-usable status of the browser object. Example
1.4.3 configuration options

1.4.3.1 -sheet_config Syntax <browser> configure -sheet_config {<use-frame> <sheetsize> } Description <use-frame> is 1 or 0 : show a frame around the schematic <sheet-size> is A4, A3, A2, A1, A0, A, B, C, D or E. Example

1-32
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
1.4.3.2 -colors Syntax <browser> configure -colors { <option> <color> <option> <color> ... } Description <option> is : -objecthighlight0, -objecthighlight1, -objecthighlight2, -objecthighlight3, -objecthighlight4, -objecthighlight5, -objecthighlight6, -objecthighlight7, -background, -portcolor, -netcolor, -buscolor, -rippercolor, -boxpincolor, -boxcolor0, -boxinstcolor, -objectgrey, -rubberbandcolor.
<color> is #RRRRGGGGBBBB RRRR is between 0000 and ffff (red) GGGG is between 0000 and ffff (green)

1-33
Quit
Help
Top Menu
Book Menu
First Page
Go Back
Draft 7/5/99
BBBB is between 0000 and ffff (blue) Example

1-34
Quit
Help
Top Menu
Book Menu
First Page
Go Back

Vega Guide

Hochgeladen von

Dokumentinformationen

Originalbeschreibung:

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Vega Guide

Hochgeladen von

Copyright:

Verfügbare Formate

Draft 7/5/99

Chapter 1 VEGA 3.0 Browser description

Vega Schematic Browsers Guide

1.2 General view of the browser

the menu-bar, the schematic view, the status-bar.

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

Its possible to jump from a port to a hpin and vice-versa, by selecting

The selection is copied in text (type and hierarchical name) to the X

Shortcuts are available for most functions.

1.2.1 Menu Schematic

Vega Schematic Browsers Guide

1.2.1.1 Sub-menu Open

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

1.2.1.2 Sub-menu Print

Vega Schematic Browsers Guide

Paper size can be :

auto landscape portrait.

Vega Schematic Browsers Guide

1.2.1.3 Sub-menu Preferences

Vega Schematic Browsers Guide

1.2.1.4 Sub-menu Close This button will destroy the window.

1.2.2 Menu Edit

Vega Schematic Browsers Guide

1.2.2.1 Sub-menu Search

Vega Schematic Browsers Guide

1.2.2.2 Sub-menu Information

Vega Schematic Browsers Guide

1.2.2.3 Sub-menu Database Explorer

This dialog consists of 4 different parts :

Vega Schematic Browsers Guide

== != glob > <

regexp <value> is a regular expression

There is a maximum of 5 filter lines

Vega Schematic Browsers Guide

1.2.2.6 Sub-menu Clean-up

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

1.2.2.11 Sub-menu Trace

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

1.2.2.12 Sub-menu Connections

Vega Schematic Browsers Guide

1.2.3 Menu View

1.2.3.1 Sub-menu Zoom In Make the view bigger.

1.2.3.2 Sub-menu Zoom Out Make the view smaller

Vega Schematic Browsers Guide

1.2.3.6 Sub-menu Previous Page Open the previous split page

1.2.3.7 Sub-menu Next Page Open the next split page

Vega Schematic Browsers Guide

1.3 Schematic Samples

Vega Schematic Browsers Guide

Second sample showing flat hierarchical mode.

1.4 TCL interface

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

1.4.2 function applied on object <browser>

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

Vega Schematic Browsers Guide

1.4.3 configuration options