Using SHUTCOM  10:14 AM 7/25/97 Dave Wright

Shutcom is a utility program that can be uploaded to an OASIS can to
allow manual control of the shutters. Shutcom is specifically designed to be
used over the packet radio link. As a result, the interaction with the shutter
is a series of one line commands and responses. If realtime readout and
control is desired, the utility shutcal can be used when connected to OASIS 
by cable.


In SHUTCOM each input command line executes one operation, and provides a one line response.

The command line:

shutcom shutter0 ccw 200

Causes shutter number 0 to move in the counterclockwise direction for
two hundred "ticks", a tick being 0.01 second. Note that there is no space between
"shutter" and "0". That is because shutter0 is a "name" that is searched for,
and if found will point to the one we want.

The response line would look like:

shutter 0 arrived at 345 Inter   

          -or-

shutter 0 overload at 473 Open

The numeric value being the position, and the string being one of 
Closed, Inter, Open, representing the state of the paddles relative 
to the closed or home position. 

In the case of the ccw and cw commands, the "tick" value will be set to
100 if no value is given, or if the given value falls outside the 0 to 3000
range (0 to 30 seconds).

The available command options are:

  ccw nnn Move in CCW direction for nnn ticks.

  cw nnn  Move in CW direction for nnn ticks.

  set     Set the current position as closed and update the drv_parms.

  open    Call the shutter open routine with the current drv_parms.

  close   Call the shutter close routine with the current drv_parms.

  where   Read the current position of the paddles.

 

Shutcom must be uploaded to OASIS before use. It exists as a .HEX file
and is uploaded as ASCII using any generic terminal program. Note that
there is a specific version of the .HEX file for each OASIS ROM, and they 
are NOT interchangeable. See BobH for the version appropriate to the
can you are working with. If you are not sure DO NOT proceed. It is
possible to corrupt OASIS if the upload is not done correctly!

Shutcom.hex can be found in \\Typhoon\Dropbox\Oasis\src\patch

	Uploading "Shutcom" to OASIS

1.  Connect to OASIS via packet radio.

2.  At "OASIS>" prompt, type "load"

3.  At your terminal program (pcomm if on workstation), type your upload command.
    In pcomm, it's ^A followed by the up arrow.

4.  Choose the "ASCII" option for upload, and give it file name
    "SHUTCOM.HEX".  The upload will take a couple of minutes.

5.  When you get the "OASIS>" prompt again, type
    "cmdadd shutcom a270" NOTE: This value will change depending on the OASIS ROM.

6.  OASIS will prompt you three times for parameter types.
    Respond with 1, 1, 3.

At this point you should be able to use the shutcom command.


                               END