To create a new project, use New Project ... command from the Project Menu. A standard file selection dialog box will be displayed. To create a project file, simply type in the name and click Save.
Opening a Project
To open an existing project, you can double-click on its icon from the File Manager (Windows) or Finder (Macintosh) or you can use the Open Project... command in the Project Menu. A standard file selection dialog box will be displayed.
Note: You can have only one project document open at a time.
Closing a Project
Use the Close Project command in the Project Menu to close the project document. Any text documents that are open will remain open.
Adding Files to a Project
There are two methods for adding files to a project. If you are editing an opened text document that is not included in the project window, use the AddWindow command in the Project Menu. This will allow you to add the file in the current edit window to the project. If it is a new file, you must save it with Save before you can add it to the project.
To add an unopened text document to a project, chose the Add File... command in the Project Menu. Only one file at a time may be selected to be added to the project. Click on the file you wish to add and choose Open.
Removing Files from a Project
To remove a file from a project, select a file in the project window and choose Remove File command from the Project Menu. This command will remove the file from the project and does not delete the file from your disk. If you remove a file accidentally, you can add it back into the project.
Creating a Text File
To create a new file, choose New from the File Menu. An untitled edit window will appear. The cursor appears in the top left corner ready for typing.
Opening a Text File
There are two methods for opening previously saved files. The Open... command in the File Menu opens any text document. A dialog box displays the names of all text files in the current folder. The file selected will appear in its own edit window.
A second way to open a text file that is already in your project is to double-click on its name in the project window. If the file is already open, then double-clicking on its name will bring the file's edit window to the front for editing. Under the Window Menu is a list of all opened text files and projects.
Closing a Text File
To close a file, click on the window's close box or choose the Close command from the File Menu. If you have made any changes since the file was last saved, a dialog box asks you if you wish to save the changes, discard them, or cancel the Close command.
The Close All command under the File Menu closes all the opened text files. If the file has not been saved, the editor will ask you if you wish to save it before closing.
Changing Project Preferences
To change any of the preferences for an opened project, you can select Preference->Project from the Edit Menu. The project preference dialog box will be displayed.
The font type and size for the project list can be changed. To change the font, click the font name and select a font from the pop-up menu that appears. To change the font size, click the size and choose a number from the pop-up menu that appears. Click OK to set the font and size for the current file
To enable tracing, check the Trace On check box. When the simulation is run, every statement executed will produce a text output showing the file name and line number containing it.
To enable a synopsis checking, check the Synopsis Checking check box.
To pause for input before running the simulation, check the Prompt Before Running check box.
To enable a key file, check the Key file check box. When running a simulation, every command entered will be written into the key file. The default key file is VeriWell.key. To specify a key file, type the path name into the text box or use the Select button to choose a key file by using a file selection dialog box.
To enable a log file, check the Log file check box. When the simulation is running, output from the console window will be appended to the log file. The default log file is VeriWell.log. To specify a log file, type the path name into the text box or use the Select button to choose a log file using a file selection dialog box.
The Output Directory specifies the default folder where the VeriWell simulator will create output files. If the default folder is not specified, output files will be created in the folder containing the currently opened project file. To specify an output directory, use the Select button to choose a folder. You can also type the path name directly in the text box.
Extra Switches allows optional VeriWell command line switches to be specified.
If you check the Open on startup box, VeriWell will reopen any project that are not closed when you last quit from VeriWell.
When a project is run, if any project files have not been saved, a dialog box will prompt you to bring these file up to date. With the Prompt On Save box checked, a dialog box will appear. With the Prompt On Save box not checked, the project files will automatically be saved before running.
The Use Defaults button will set all the project preferences to match the VeriWell application defaults.
The Set Defaults button will set the VeriWell application defaults to match those currently displayed in the dialog box.
The Cancel button will discard any changes made in the project preference window.
The OK button will change the project preferences.
Changing Editor Preferences
To change any of the editor window settings, select Preferences->Editor under the Edit Menu. The editor preference dialog box will be displayed.
The font type and size for the editor window can be changed. To change the font, click the font name and select a font from the pop-up menu that appears. To change the font size, click the size and choose a number from the pop-up menu that appears. Click OK to set the font and size.
The Tab Spacing can be changed by typing in a new number in the Tab Spacing text box.
Undo Depth allows you to set the limit for how many operations can be undone. As in tab spacing, a new number can be typed in the Undo Depth text box.
If you check the Show Line Numbers box, line numbers will be shown in the editor windows.
In the editor window, you can choose different colors to highlight the Keywords, Comments, Strings, Systasks, and Line Numbers. Next to Keywords, Comments, Strings, Systasks, and Line Numbers are color boxes. By double-clicking on box, a color wheel will be displayed. You can then choose any color to use for highlighting.
The OK button will change the console preferences.
The Cancel button will discard any changes made in the console preference window.
The Use Defaults button will set all the editor preferences to match the VeriWell application defaults.
The Set Defaults button will set the VeriWell application defaults to match those currently displayed in the dialog box.
Changing Console Preferences
To change the preferences of the console window, you can choose Preferences- >Console from the Edit Menu. The console preferences dialog box will be displayed.
The font type and size for the console window can be changed. To change the font, click the font name and select a font from the pop-up menu that appears. To change the font size, click the size and choose a number from the pop-up menu that appears. Click OK to set the font and size.
If you want the console to clear before beginning the run, check the Clear On Run check box.
The console window keeps a history of the output data. VeriWell allows you to scroll back to view this data, but this amount data is limited. When it has reached its limit, characters at the beginning of the window are deleted. In this preference window, you can set the Console Buffer Size (bytes).
The OK button will change the console preferences.
The Cancel button will discard any changes made in the console preference window.
The Use Defaults button will set all the console preferences to match the VeriWell application defaults.
The Set Defaults button will set the VeriWell application defaults to match those currently displayed in the dialog box.
Changing Wave Preferences
To change the preferences of the wave window, you can choose Preferences- >Waves from the Edit Menu. The wave preferences dialog box will be displayed.
The font type and size for the wave window can be changed. To change the font, click the font name and select a font from the pop-up menu that appears. To change the font size, click the size and choose a number from the pop-up menu that appears. Click OK to set the font and size.
To enable the group file, check the Group file check box. When the waveform window is opened, the group file will be loaded, setting up an initial set of groups. Any changes to the group lists will be saved when the waveform window is closed. To specify a group file, type the path name into the text box or use the Select button to choose a group file using a file selection dialog box.
Colors for various aspects of the wave display may be changed by clicking on the displayed colors in the dialog box.
The OK button will change the wave preferences.
The Cancel button will discard any changes made in the wave preference window.
The Use Defaults button will set all the wave preferences to match the VeriWell application defaults.
The Set Defaults button will set the VeriWell application defaults to match those currently displayed in the dialog box.
Running a Simulation
When the Run command is chosen the program will begin running the files in the project. If there are any files that have not been saved, a prompt box will appear. If you select Yes, the modified files will be saved before the run is started. If you choose No, the files will not be saved, but the current displayed versions of the files will be compiled. If you choose Cancel, no simulation will be run. You will have this option for each modified file.
If the Prompt On Save option in the Preference->Project from the Edit Menu is not checked, the project files will automatically be saved before running.
Adding a Search Path
Additional directories can be added by selecting the Add button in the upper left of the Search List Window. The Search List ... Window can be found under the Edit Menu. When the Add button is clicked, a dialog window will be presented allowing a new folder to be selected and to be added to the list. To select a new folder, navigate to the folder to be added and then click on the Search Here button. This new folder will always be added to the end of the list.
Removing a Search Path
Directories may be removed from the Search List Window by selecting the folder in the list using the mouse and then clicking on the Remove button. The Search List ... Window can be found under the Edit Menu.
Reordering the Search Path
The Search List Window can be used to change the order that the directories are searched. A entry in the list may be dragged to the desired location in the list by selecting the entry with the mouse, holding the button down and dragging the item to the desired location in the list. When the button is released this item will be moved to the highlighted location and the rest of the list will be moved down. The Search List ... Window can be found under the Edit Menu.
Using the Waveform Viewer
The Waveform Window is used to display a set of signals graphically. The waveform window may be opened in one of three ways: during simulation via the $vw_dumpvar system task, via the Open Wave File menu item, or via the Convert DumpVar menu item.
The $vw_dumpvar system task is used during simulation to specify a set of signals to monitor. The execution of this task will cause a waveform window to open.
The Open Wavefile menu item is used to open a previously saved Wavefile.
The Convert DumpVar menu item is used to convert a Verilog dumpvar file into a VeriWell Wavefile and view it.
When the Waveform window is open, display groups may be set up by either loading an existing group file via the Load Group menu command or by clicking on the Browse button. The Browse button will open the signal browser window which will allow the signal hierarchy to be traversed and a set of signals to be selected for viewing.
Displayed signals may be reordered by selecting a signal name and dragging it to the desired location.
The display radix for vectors may be changed by selecting the vector name and using the Set Radix menu item. A dialog box will be displayed allowing a choice of radix to be selected.
The value of a given signal at each of the cursors may be displayed by double-clicking on the signal name in the waveform window.
The units for displaying time may be changed by using the Set Time Unit menu item. A dialog box will appear allowing the display units to be altered.
Double-clicking on a signal name displays a dialog box displaying the current signal values at each of the cursors.
Signals may be moved by clicking and dragging the signal name.
There are two cursors to mark positions. The first cursor is moved by clicking in the waveform window. The second cursor is moved by holding down the option key (Macintosh) or control key (Windows) and clicking in the waveform window.