The WRspice Interface Control Panel

This panel appears when the user presses the spcmd button in the electrical side menu, and either gives no command at the prompt, or enters ``setup''. It provides entry areas for setting the variables which control the interprocess communication channel to the WRspice circuit simulator, and other simulation settings. Most users will probably never need to use this panel or set the associated variables as the defaults suffice in most installations.

The WRspice Interface Control Panel contains the following entry objects.

List all devices and subcircuits
This check box corresponds to the SpiceListAll variable. When checked, all devices and subcircuits in the schematic will be included in SPICE output. Otherwise, only devices and subcircuits that are ``connected'' will be included, as explained in the deck and run command descriptions.

Check and report solitary connections
This check box corresponds to the CheckSolitary variable. If checked, warning messages will be issued when electrical netlists are generated for nodes having only one connection. This affects the run and deck commands, and the Dump Elec Netlist command in the Extract Menu.

Don't show WRspice Tool Control panel
This check box corresponds to the NoSpiceTools variable. When running WRspice from Xic, by default the WRspice toolbar is shown, if WRspice is running on the local machine. This gives the user much greater flexibility and control over WRspice. If this check box is checked, before the connection to WRspice is established, the toolbar will not be visible.

This check box will also control toolbar visibility if the wrspiced daemon is used. However, this requires wrspiced distributed with wrspice-3.0.7 or later. If this variable is set with an earlier wrspiced release, the WRspice connection will not work!

Spice device prefix aliases
This group consists of a check box and a text entry area. When the box is checked, the text in the entry area will be used to set the SpiceAlias variable. This can be set to a string which will modify the printing of device names in SPICE output. The aliasing operates on the first token of device lines. The format of the string is

prefix1=newprefix1 prefix2=newprefix2 ...

This will cause lines beginning with prefix to have prefix replaced with newprefix. If the ``=newprefix'' is omitted, that line will not be printed. For example, to map all devices that begin with `B' to `J', and to suppress all `G' devices, the string is

B=J G

Note that there can be no space around the `='. With the text entered and the box checked, the indicated mappings will be performed as SPICE text is produced.

Remote WRspice server host name
This group consists of a check box and a text entry area. When the box is checked, the SpiceHost variable is set to the text in the text area.

The text should be the name of the host which maintains a server for remote WRspice runs. If set, this will override the value of the SPICE_HOST environment variable. The host name specified in the SPICE_HOST environment variable and the SpiceHost !set variable can have a suffix ``:portnum'', i.e., a colon followed by a port number. The port number is the port used by the wrspiced program on the specified server, which defaults to 6114, the IANA registered port for this service. If the server uses a non-standard port, and the wrspice/tcp service has not been registered (usually in the /etc/services file) on this port, the port number must be provided.

Remote WRspice server host display name
This group consists of a check box and a text entry area. When the box is checked, the SpiceHostDisplay variable is set to the text in the text area.

This text can be set to the X display string to use on a remote host for running WRspice through a wrspiced daemon, from Xic in electrical mode. This is intended to facilitate use of ssh X forwarding to take care of setting up permission for the remote host to draw on the local display. See the description of the piceHostDisplay variable for complete details.

Path to local WRspice executable
This group consists of a check box and a text entry area. When the box is checked, the SpiceProg variable is set to the text in the text area.

The text is the full path name of the WRspice executable. This is useful if there are multiple versions of WRspice available, or the binary has been renamed, or is not located in the standard location. If given, the value supersedes the values from environment variables or other variables (and corresponding entries) which also set a path to the SPICE executable.

Path to local directory containing WRspice executable
This group consists of a check box and a text entry area. When the box is checked, the SpiceExecDir variable is set to the text in the text area.

The text is a path to the directory to search for the WRspice executable. If given, the value overrides the SPICE_EXEC_DIR environment variable. The default search location is ``/usr/local/xictools/bin'', or, if the XT_PREFIX environment variable has been set, its value will replace ``/usr/local''.

Assumed WRspice program executable name
This group consists of a check box and a text entry area. When the box is checked, the SpiceExecName variable is set to the text in the text area.

The text will give the expected name of the WRspice binary. If given, the value overrides the SPICE_EXEC_NAME environment variable. The default name is ``wrspice''.

Assumed WRspice subcircuit concatenation character
This group consists of a check box and a text entry area. When the box is checked, the SpiceSubcCatchar variable is set to the text in the text area. See the description of the variable for information about this setting.

Assumed WRspice subcircuit expansion mode
This group consists of a check box and a menu. When the box is checked, the SpiceSubcCatmode variable is set to the current menu selection. See the description of the variable for information about this setting.