When you open a project in Sigasi Studio, a number of views are presented in the user interface. Here is a typical screenshot, with the views highlighted.
The views provide alternative ways to access the information in a project. They permit efficient navigation, inspection and editing.
This chapter lists and explains the most important views in Sigasi Studio. Some views are not covered here, more specifically some views that are either inherited from Eclipse, or views that are provided by third-party plugins. Please refer to the Eclipse documentation or to the specific plugin documentation for further information on those views.
You can open a View in several different ways:
- By typing the view name in the Quick Access field
- Via Window > Show View. If the view is not in the visible list, choose Other... and select the view in the selection dialog.
- By right clicking in the editor and selecting Show in > ....
Some Views also support to open the current selection (e.g. the Block Diagram View). This selects the element in the view that corresponds to the current selection in the editor.
Project Explorer View
This view shows the directory structure of all files in all projects. You can use it to navigate to a particular file in your project and select it. When you double click on a file, the file opens in the Editor view. If you right-click a file, you see the context menu which offers extra commands.
You can customize the behavior of the Project Explorer view in ways that can be particularly handy for large projects. For example, if you click the Link with Editor icon , the Project Explorer will be linked to the Editor view. Now, the active file in the editor view will always be selected in the Project Explorer.
You can apply filters to choose which files are shown. Select the icon View Menu and then Customize view. You can then select a filter whose matching files will be hidden in the view. For example, you can filter out all non-VHDL or non-Verilog files.
The Editor view shows the content of files, and allows you to edit files. It is a tabbed view so that multiple files can be open for editing simultaneously. The currently selected file is the active file.
The Outline view displays the contents of the active file, in terms of the HDL objects that it contains.
You can sort the elements in the outline alphabetically, by enabling the sort button .
You can also filter all concurrent signal assignments from the outline by enabling the Hide Signal Assignments button . Double-click in the Outline view to navigate to the corresponding location in the editor.
If you enable the Link with Editor icon and you click an element in the outline view, the corresponding code will be selected in the editor.
The Hierarchy view shows the design hierarchy starting at a selected top level object. To choose a top level, open a file and right-click on an
module). Then click Set as Top Level. Alternatively you can click the Set Top button in the hierarchy view to open a hierarchy top level selection dialog. You can use the filter field to quickly search for a certain top level.
The hierarchy view automatically refreshes itself when you save your design files. If you have a really large design this could slow you down. You can turn the automatic refresh on and off by toggling the refresh button .
To highlight the current selection of the HDL editor in the hierarchy view, enable the Link with Editor button . If the editor selection is part of the evaluated hierarchy tree, the corresponding hierarchy tree node will be selected.
The hierarchy view also shows the generic and constants values of VHDL components in the hierarchy. The internal compiler computes the generics and constants, even if they are passed down through the hierarchy, and even if arithmetic operations are used to define new values. If the value cannot be computed for some reason, the Hierarchy View will report the value to be unknown.
When you double-click an object in the hierarchy, the Editor view is updated accordingly, possibly by displaying the contents of a different file.
Use the instantiations filter , to hide everything except instantiations and structural statements are shown.
You can launch a simulation with the button, if you first set up an Launch simulator.
The Hierarchy View also offers an action Select required files, which selects all design files that are part of the current hierarchy, in the project explorer. This allows you to easily perform the same action on all files in the hierarchy. E.g. team commands, ... [Only in Sigasi Studio XL]
You can also export a CSV-file with all dependencies of the selected element via the context menu: right click and select Export Dependencies to CSV file.
The Problems view shows problems (errors and warnings) related to your code. These problems were reported either by the internal compiler or by an external compiler tool. You can navigate to the source of the problem by double clicking on a given problem. Problems can be sorted by clicking the column headers. The content of this view can be customized via the View Menu . Possible customizations are scope (workspace, project, selection), type, maximum number of problems, …
The libraries view shows the library mapping of the design units in all projects. You can use it to navigate to a particular design unit in your project. When you double click on a file, the file opens in the Editor view. If you right-click a file, you see the context menu which offers extra commands for libraries-mapping and for setting the top level.
If you enable the Link with Editor button , the Library view will be linked to the Editor view. Now, active file in the editor view will always be selected in the Library view.
It is common practice to add TODO and FIXME comments in your code. Sigasi Studio automatically scans your comments for TODO and FIXME tags and clearly highlights these comments with Task Tags. You can get a nice overview of all task markers in your workspace in the Task View (Windows > Show View > Tasks).
You can configure extra tags in the Task Tag preference page: Preferences > Sigasi > VHDL > Task Tags
Block Diagram View
The Block Diagram View displays a graphical (block diagram) view of all architectures, modules and their instantiations in your current VHDL or SystemVerilog editor.
This viewer automatically updates when you save your code and gives a convenient way to visually inspect and navigate your code, even when your code is still unfinished or broken.
You can open the block diagram view by right clicking in the editor and selecting Show In > Block Diagram. Alternatively you can open the view via Window > Show View > Other… > Sigasi > Block Diagram.
You can also double click blocks, ports or wires to navigate to the corresponding HDL code. If you want to go into a block, you have to select it, right click and click Open Entity Declaration, Open Architecture or Open Module.
You can export the block diagram view to an image with the save button. Both SVG and PNG are supported. Choose a the *.svg filename for SVG export or a *.png filename for PNG export.
You can also export all block diagrams of an entire project at once: Click Project > Export... > Sigasi > Block Diagrams export and select your project. All SVGs will be created in diagrams/blockdiagrams/ in your project.
State Machine View
The State Machine View displays a graphical (bubble diagram) view of all state machines in your current VHDL or SystemVerilog editor. This viewer automatically updates while you are editing your code and gives a convenient way to visually inspect and navigate your code, even when your code is still unfinished or broken.
You can open the state machine view by right clicking in the editor and selecting Show In > State Machines. Alternatively you can open the view via Window > Show View > Other… > Sigasi > State Machines.
If you have documented your state transitions (i.e. the assignments), the comments will be added as text to the transitions in the view.
You can also double-click nodes or transitions to navigate to the corresponding HDL code.
With the button, you can toggle the display of edge labels. These labels show the code comments of the transition statements. You also have to option to Zoom In, Zoom Out or Zoom to Fit.
You can export the state machine view to an image with the save button. Both SVG and PNG are supported. Choose a the *.svg filename for SVG export or a *.png filename for PNG export.
You can also export all state machines of an entire project at once: Click Project > Export... > Sigasi > State Machine Diagrams export and select your project. All SVGs will be created in diagrams/statemachines/ in your project.
You can watch a screencast at State Machine Viewer
The Dependencies View visualizes the dependencies of your VHDL, SystemVerilog or mixed language projects. This view shows the relationships between your source files and makes it easy to see top levels and important packages. The Dependencies View also makes it easy to detect orphaned files.
The view is automatically updated each time you save your files.
The dependencies view has following options:
- show dependencies of entire projct. Uncheck to focus on the dependencies of the active editor only.
- Group design files per library
- Show design units inside design files. The design units are prefixed with an abbreviation of their kind (architecture, module, package, ...)
The dependencies view can help you navigate too. Double click a file name in the diagram to open the corresponding editor.
The dependencies View can also be pinned. This prevents the diagram from changing when you switch editors.
You can export this diagram for documentation by clicking the save icon.
The Documentation view gives you a live preview of the automatic documentation Sigasi Studio can generate for your project.
Net Search View
With Net search, you can you to find loads and drivers of a net. A net is defined as a signal or port and all other signals and ports that are directly connected to it. The loads are where you read the value of the net and the drivers are where you write to this net.
To find the entire net of a signal or port, place your cursor on the identifier and right-click. Now select Find Net. Alternatively, you can press CTRL+SHIFT+H.
The Net Search view will appear. For big designs, it might take a while before the results appear.
From the Net Search view, you can navigate to the VHDL code by double-clicking the search results.
In the preprocessor view you can preview the expanded text of Verilog macros. This view automatically synchronizes with the active editor. When you select text in the (System)Verilog editor, the expanded text will be highlighted in the Preprocessor view. This also works the other way: when you select text in the Preprocessor view, the corresponding, original source will be selected in the editor.
Class Hierarchy View
The Class Hierarchy view displays more information of the hierarchy of a class. It consists of a hierarchy tree and a list of the class members. To open the Class Hierarchy of a class, click the class name, right-click and select Open Class in Hierarchy (or press F4).
Class Hierarchy tree
The class hierarchy tree displays either the superclasses, subclasses or both.
|Class Hierarchy||Displays all superclasses and subclasses.|
|Superclass Hierarchy||Displays all superclasses and implemented interface classes.|
|Subclass Hierarchy||Displays all subclasses that extend or implement the selected (interface) class.|
|Show Qualified Class Names||Shows the qualified name next to each class.|
The member list shows all members of the class that is currently selected in the class hierarchy tree.
|Show Inherited Members||Shows or hides all members inherited from superclasses.|
|Sort By Defining Class||Sorts members by the class in which they are defined.|
|Hide Fields||Hides all fields in the members list.|
When Sigasi Studio launches external tools (e.g. external compiler, documentation generation,...) the output is logged to the console view. This is a generic Eclipse view [Documentation].
Different tools can open different consoles. You can switch between different consoles by clicking the -icon.