Selection Details Widget
The Selection Details Widget presents details on each of the gates, nets and modules within the current selection. Its main features are a hierarchical tree of elements that are currently selected in the GUI and a details section delivering additional information on a single element of that selection.
The Selection Details Widget mainly consists of two large sections: a hierarchical tree of all selected netlist components as well as detailed information on a single element of the selection that can be chosen by the user by navigating to an element in the tree. The detailed information is organized as tabbed view with and has common tabs as well as special tabs for module, gate, and net items. Additionally, the widget comes with a toolbar and offers a right-click context menu.
The hierarchical tree on the left hand side of the widget shows all elements of the current selection. Gates, nets and modules are identifiable by the icons to the left of the name of the element. Besides the name, the tree displays the elements ID and type if existing. As usual in tree widgets there are triangular arrows next to the module icon to toggle between an expanded or collapsed representation. When expanded the content of a module which might comprise submodules, gates, and nets is shown as well.
Selecting or navigating to an element in the tree updates the right hand side of the Selection Details Widget to show element details for the current element. It also gets highlighted in cyan in the Graph View.
The context menu from the hierarchical tree in selection details is the same as the context menu in module widget, please refer to that page for details.
The toolbar comprises the actions
Opens a dialog to select an existing grouping or create a new one. The entire selection gets assigned to that grouping. In case an element of the selection is already part of a grouping, this existing grouping assignment is overwritten by the new one.
Opens a dialog to select an existing module or create a new one. The entire selection gets moved to that module if the operation is logically permitted, e.g. a parent module must not be moved to its child.
The icon showing a magnifying glass in the toolbar enables interactively filtering the displayed tree by name, ID, or type. Note that this does not affect the selection and may solely be used to find a desired element within the selection. The magnifying glass in the toolbar changes to a green color to indicate that the filter is active.
The details shown for the current tree elements are organized as tabbed view. Some tabs are always present:
- General (4) showing general information like name and ID.
- Groupings (5) showing the grouping an item is assigned to.
- Data (11) showing data container associated to item. Other tabs are specific for modules, gates, and nets.
Specific tabs for modules are:
- Pins (6) showing the module pins and pin groups.
- Elements (7) showing the content of a module.
- Comments (12) showing comments annotated for a module.
Specific tabs for gates are:
- Pins (6) showing the gate pins and pin groups.
- Flip-Flop (8) showing FF parameter only if the gate is a flip-flop.
- Boolean Functions (9) showing the boolean functions for the gate.
- Comments (12) showing comments annotated for a gate.
Specific tab for net is:
- Src/Dst (10) lists net source(s) and destination(s).
Finally, all data that is associated with the net is shown in the data fields section, which may also be extracted as Python code using the right-click context menu.
The general information tab comprises always name, ID and parent module. For modules and gates the type is shown as well. Additionally item specific statistical information is displayed in this tab like number of sources and destinations for nets and number of gates and pins for modules. For modules it is also stated whether it is the top module or not. The value from any field can be copied to clipboard by context menu, either as plaintext value or as python code which would retrieve that information at runtime.
This tab shows the grouping an item is assigned to or an empty list if the item is not assigned to any grouping. A context menu in this tab allows the user to change group properties like name or color or to remove the item from the grouping.
This tab lists the input and output pins of a module or gate as a tree where each pin must be member of a pin group. While gate pins are defined in the gate library and cannot be modified for a gate instance the user can interactively rearrange module pins by drag'n drop. A module pin group can also be deleted by context menu in which case each pin gets reassigned to a group of its own.
This tab lists the content of a module as hierarchical tree in the same way as in module widget. Please refer to that page for details like context menu.
This tab is only shown for flip-flop gates. It shows the clock pin, the boolean function for the next state as well as for the internal state and negated internal state. Values from the fields can be copied to clipboard by context menu, either as plaintext or python code.
This tab shows the boolean functions for a gate. As usual the function can be copied to clipboard by context menu, either as plaintext or python code.
This tab lists the source gate (or all sources if multi driven) and destination gates for a net item. For each connected gate a lot of actions are offered by context menu, like adding to selection, isolating in new view or to zoom in on that gate in graphics view.
This tab lists all additional data which is associated with the item. Each data entry has the fields 'Category', 'Key', 'Type', and 'Value' which may contain any string. An example for such data could be the physical location of the gate on a chip if that information got parsed from Verilog.
This tab lists comments the user added to a module or gate item. A speech bubble in graphics view indicates that comments for the node exist. Within the tab comments can be added, edited, or deleted.