
















			  SimWave





		      Class Exercises




















		    Systems Science Inc.
	      1860 Embarcadero Rd., Suite 260
		Palo Alto, California 94303
		       (415) 812-1800





















Systems	Science	Inc.	   - 2 - SimWave 2.3 Class Exercises


		       SimWave CLASS

			  OUTLINE







		Preparation


		Exercise #1: Basic SimWave features


		Exercise #2: Additional	SimWave	features














































Systems	Science	Inc.	   - 3 - SimWave 2.3 Class Exercises


			Preparation




Please read the	"GETTING STARTED"  section  of	the  SimWave
User's Manual before running the exercises in this document.

1.  Setting up your environment


Start X	Windows	on your	local workstation.

If SimWave is installed	on a remote  system  (a	 workstation
other than your	local workstation), login to the remote	sys-
tem and, unless	otherwise specified, run all commands on the
remote system.

Add $SIMWAVEHOME/BIN to	your command search path.

The stand-alone	version	of SimWave is  normally	 invoked  by
the  wd	 image in $SIMWAVEHOME/BIN. However, if	your copy of
SimWave	is encapsulated	by another  tool,  you	may  not  be
licensed  to  run  the	stand-alone version.  If this is the
case, you should invoke	wddemo instead of  wd  when  running
the  following	exercises.  wddemo  allows you to run an un-
licensed demonstration version of SimWave.

If SimWave will	be run remotely, set the  environment  vari-
able DISPLAY to	"hostname:0.0" where hostname is the name of
your local workstation.	 For example:

	setenv DISPLAY pluto:0.0


If SimWave will	be run remotely, you  may  need	 to  disable
access	control	by running this	command	on your	local works-
tation:

	xhost  +



2.  Make a local copy of the SimWave SAMPLES directory


The directory $SIMWAVEHOME/SAMPLES contains sample  circuits
to be used in the following exercises.

Copy the $SIMWAVEHOME/SAMPLES directory	to your	home  direc-
tory.












Systems	Science	Inc.	   - 4 - SimWave 2.3 Class Exercises


		SimWave	CLASS -- EXERCISE #1

		   BASIC SimWave FEATURES



1.  Start SimWave


"cd" to	your private copy of the SAMPLES directory.

Use SimWave to view the	data in	the  gem.wd  file  with	 the
command:

	wd gem.wd &


A SimWave window should	be created on your workstation.	 See
the  SUB-WINDOWS  section of the SimWave User's	manual for a
description of the window and its subwindows.

What file contains the attributes  of  the  SimWave  window?
________  ( Hint, see the CUSTOMIZING section of the SimWave
User's Manual )

List all commands by typing "help" in the  footnote  subwin-
dow.

List all signals by typing "list *" in the footnote  subwin-
dow.

Display	all signals by typing  "display	*" in  the  footnote
subwindow.

Clear all signals by typing  "clear" in	the footnote subwin-
dow.

Redisplay all signals.


2.  Practice manipulating traces and time boundaries


For the	following please refer to the MOUSE OPERATIONS	sec-
tion of	the SimWave User's Manual.

Using the leftside scroll bar, scroll up and down  thru	 the
traces.

Using the bottom scroll	bar,  scroll  back  and	 forth	thru
time.

Click on the time boundaries and set them to 1900 and 2100










Systems	Science	Inc.	   - 5 - SimWave 2.3 Class Exercises


Increase the height of the SimWave window so that all traces
are viewable.

Increase the width of the SimWave window so that  the  names
of the signals are completely viewable.

Move  the  trace  for  "polyg_st"  next	 to  the  trace	 for
"shift_im"

Move the traces	for "clk1" and "clk2" below  the  trace	 for
"shift_im"

Delete the "polyg_st" trace from the display.


3.  Practice creating buses


For the	following please refer to the TEXT COMMANDS  section
of the SimWave User's Manual.

Using the "bus"	command	define a bus named "ptrbus" consist-
ing  of	 all  traces  with  names  ending in "ptr".  Display
"ptrbus".

Hit <CTRL> <left button> on the	"ptrbus" name to change	 the
base of	the "ptrbus" trace to octal.

Hit <CTRL> <left button> on the	"ptrbus" name to change	 the
color of the trace for "ptrbus"	to green.


4.  Practice with menu features


For the	following please refer to "Zoom", "Base", and  "Tim-
ing"  in  the  PULL-DOWN MENU section of the SimWave  User's
Manual.

Using the Zoom Menu, zoom in and out.

Click on the time boundaries and set them to 1900 and 2100

Move the cursor	to time	 1900.	The  cursor  is	 dragged  by
pressing the left button in the	trace portion of the SimWave
window.

Using the Timing Menu "delta time" feature,  find  the	time
difference  between  the  rising  edge of "clk1" around	time
1930 and the rising edge of "video_cntrl/mask"	around	time
2020.

Select the "ptrbus" name with the pointer, and then use	 the
Base Menu change the base of the "ptrbus" trace	to binary.









Systems	Science	Inc.	   - 6 - SimWave 2.3 Class Exercises


5.  Practice creating PostScript dumps


For the	following please refer to "Hardcopy Output"  in	 the
PULL-DOWN MENU section of the SimWave User's Manual.

Click on the time boundaries and set them to 1900 and 2100

Using the Print	Menu, make a single page PostScript file for
the  current  SimWave  display.	 Print	the  file  you	just
created.

Using the Print	Menu, make a multi-page	PostScript file	from
time  1900 to time 2300. Because the SimWave display is	2000
time units wide	( 2100 - 1900 ), SimWave will break  up	 the
PostScript  dump  into	two  pages,  one  page for time	1900
through	2100 and one page for time 2100	through	2300.  Print
the file you just created.


6.  Practice setting the time grid


For the	following please refer to "Changing the	 Time  Grid"
in the TEXT COMMANDS section of	the SimWave User's Manual.

Using the Setup	Menu, toggle the time grid on.	The grid  is
most likely in "autosize" mode.	As you shrink or stretch the
time interval, the grid	lines will automatically adjust.

To display a fixed grid, enter the command "grid 0 100".

To set the grid	back to	"autosize", enter the command  "grid
-auto"


7.  Practice with Triggers


For the	following please refer to "Triggers"  in  the  PULL-
DOWN MENU section of the SimWave User's	Manual.

Move the cursor	to time	0.

Define	a  trigger  named  "pixhigh"  that  is	 true	when
"pix_addr_on" is rising	to a one.

Using the Triggers Menus, search for instances of "pixhigh"

Move the "pix_addr_on" trace next to the  "video_cntrl/wait"
trace.

Define	a  trigger  named   "diff"   that   is	 true	when
"pix_addr_on" is not equal to "video_cntrl/wait"









Systems	Science	Inc.	   - 7 - SimWave 2.3 Class Exercises


Using the Triggers Menus, disable the "pixhigh"	trigger.

Search for instances of	the trigger "diff".

What is	difference between "next"  and	"next  end"  in	 the
triggers's menu	?________



8.  SimWave command scripts


For the	following please refer to "Command Scripts"  in	 the
TEXT COMMANDS section of the SimWave User's Manual.

Create a SimWave command script	 named	"showbus.wav"  which
defines	 a  bus	 named	"currbus"  consisting  of all traces
starting with the string "curr"	and displays that bus.

Execute	the showbus script.

Quit SimWave by	typing "quit" in the footnote subwindow.









































Systems	Science	Inc.	   - 8 - SimWave 2.3 Class Exercises


		SimWave	CLASS -- EXERCISE #2

		ADDITIONAL SimWave FEATURES




Please run EXERCISE #1 before running this exercise.

1.  Start SimWave


The SAMPLES directory created  in  EXERCISE  #1	 contains  a
SimWave	 data file named "test.wd".  This file contains	data
for  analog  signals,  digital	signals	  and	signals	  of
enumerated type.

Use SimWave to view the	data in	the test.wd  file  with	 the
command:

	wd test.wd &


Click on the time boundaries and set them to 0.0 and 10.0

Display	all signals.

Increase the height of the SimWave window so that all traces
are viewable.


2.  Using the Setup Menu



For the	following please refer	to  "Setup  Window"  in	 the
PULL-DOWN MENU section of the SimWave User's Manual.

Using the Setup	Menu, turn on violations.   Violations	will
appear	as  tiny  crosses.   How  many	violations are visi-
ble?________

What is	the violation on trace "sb2" at	time 6.5?________  (
Hint, see "Show	Violations" in the PULL-DOWN MENU section of
the SimWave User's Manual )

Using the Setup	Menu, turn on spikes.  Spikes will appear as
up   arrows   and   down   arrows.   How  many	traces	have
spikes?________

Using the Setup	Menu, turn  on	strengths.   Strengths	will
appear	as  different  colors  on color	monitors and as	dif-
ferent line styles on monochrome monitors.  How	many signals
have strength information?________









Systems	Science	Inc.	   - 9 - SimWave 2.3 Class Exercises


Move the cursor	to time	6.0. The right border of  the  trace
subwindow  will	show the values	and strengths of the signals
at time	6.0.


3.  Multiple windows



For the	following please refer to "Multiple Windows" in	 the
PULL-DOWN menu section of the SimWave User's Manual.

Using the "open" feature of the	Window	Menu,  open  another
SimWave	window.

Select the "colors" and	"bit.3"	 traces	 from  the  original
SimWave	window and drag	them to	the new	window.

What does the "plot" feature of	the Window Menu	do?________

Using the "plot" feature of the	Window Menu, open a  SimWave
plot window.

Select the "I(vdd3)" and "I(vdd2)" traces from the  original
SimWave	window and drag	them to	the new	plot window.

Quit the SimWave plot window by	typing CTRL-C  in  the	plot
window's footnote subwindow.

Quit SimWave by	typing "quit" in the main window's  footnote
subwindow.





























