Demos and Examples

Instructions on how to use the demos and examples provided

If you have any questions or difficulties, please e-mail webmaster@cspi.com, or call your support representative at 1-800-325-3110 ext. 1309.

Following are some of the sample programs and demos shipped with your ITS-860 system which may be of use in your application development. Each indicated directory has a README file containing information on running the application. Many of the applications under the "examples" subdirectory are presented in the ITS-860 User Manual; they are intended for the novice user. The applications under the "demo" directory are more involved. Below are the source directories and the features demonstrated.
 

Demo File	Features Demonstrated
vmedemo	Demonstrates Xremedy
dmademo	Asynchronous VME DMA
loader	Single executable/multiple PEs
cssend	Accelerated multiprocessor IPC
cattest	displays the changes needed to run the Copycat simulator.
ffttest	Calling an SSL
inttest	User-written Interrupt Service Routines
ledtest	Programming the LEDs.
nfstest **	Input from a file on the host disk
rpctest	Using remote procedure calls
p100test	p100 transfers on SC-3
tcptest	Using sockets
timtest	Timing an SSL using new clock routines.
tsktest	How to use tasks and queues.
vinttest	Using the VMEbus Interrupt.
vmetest	Asynchronous VME transfer
vsbtest	Executing a VSB transfer using the VSB clock.

^** When running $MTI_DIR/examples/nfstest, be sure the remote directory has global read/write permission. If nfstest is unsuccessful at opening nfs:/datafile, check the User and Group IDs. The following chart lists the number of processors each sample program requires and any restrictions that apply.
 

Number of Processors/Program

Source Directory	No. of PE's	Restrictions
dmademo	2	---
vmedemo	4	---
loader	(any number)	Special config.c and loader
cssend	2	Special config.c; uses VSB
cattest	0	---
ffttest	1	---
inttest	2	---
ledtest	1	SC-3/XL, SC-4/XL only
nfstest	1	---
rpctest	1	Host and SC executables
p100test	2	SC-3/XL only; P100 required
tcptest	1	Host and SC executables
timtest	1	FORCE only, 2 SC-3s or 2 SC-4s (not PEs)
tsktest	1	---
vinttest	2	---
vmetest	2	---
vsbtest	2	Uses VSB

Most examples and demos can be run on different types of SuperCards by modifying and then rebuilding the makefiles. The demos and examples use the configuration macros (see New Features and Enhancements on page 6 of this document). Only the makefile environment variables CS_DEVx and CS_TYPEx, where x is the node number, need to be changed. CS_DEVx is the SuperCard Unit Number in hex (0,1,..,F for a SuperCard-2 or SuperCard-3, and 10,11..,3F for a SuperCard-4 PE). CS_TYPEx is the type of SuperCard (sc2, sc3 or sc4). Each SuperCard or PE must have a CS_DEVx and CS_TYPEx associated with it. For more information on SuperCard Unit Numbers, refer to the ITS-860 Installation Manual.

For example, if $MTI_DIR/examples/ffttest is currently set up for one SuperCard-2 at VME address 0xde000000 (unit number 0x0), then CS_DEV1 and CS_TYPE1 are set in the makefile as follows:

CS_DEV1 = 0
CS_TYPE1 = sc2

CS_DEV1 = 10
CS_TYPE1 = sc4

Now execute the make, and ffttest is ready to run on the SuperCard-4.

Contacting Customer Support

If there are any problems installing or using this software, or if any bugs or possible enhancements are noticed, contact the CSPI Customer Support Department.

• tel: 1-800-325-3110 / 978-663-7598 ext. 1309
• fax: 978-663-0150
• e-mail: support@cspi.com

Although the information contained herein is believed to be accurate and up-to-date, CSPI assumes no responsibility for inaccuracies or omissions.