home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / rc85_prg / rc85prg.doc < prev    next >
Text File  |  1989-10-31  |  5KB  |  138 lines
  1. NAME
  2.      rc85prg - program an RC-85 repeater controller.
  3.  
  4. SYNOPSIS
  5.      rc85prg  [options]  prgfile
  6.  
  7. DESCRIPTION
  8.      RC85PRG will, using a Hayes-compatible modem with a PC running
  9. MS-DOS, dial up an A.C.C. RC-85 controller and program it.  The modem
  10. is capable of sending digits 0 through 9, * and #.  RC85PRG has been
  11. compiled with default sequences for the owner unlock code, the control
  12. operator code, the user autodialer programming codes, and the controller
  13. phone number.  Each of these sequences can be redefined by command-line
  14. options.  The input file contains the programming commands.  If not
  15. specified on the command line, stdin is used.  Hence pipes (|) or
  16. redirection (<) may be used to provide programming commands.  The
  17. MBBIOS interrupt-driven I/O package by AA4RE must be loaded prior
  18. to invoking RC85PRG.  Contact your local packet BBS sysop if you need
  19. help in obtaining AA4RE's excellent package.
  20.  
  21.  
  22. OPTIONS
  23.      If RC85PRG is invoked improperly, it will display a usage
  24. summary, and indicate the current value of all settable options.
  25. Options include:
  26.  
  27. -v             enable verbose mode.
  28. -t            enable test mode (simulate operation).
  29. -u            indicate autodialer is kept unlocked.
  30. -w N            wait N secs after dialing the RC85, to permit
  31.             the phone answer message to finish.
  32. -p N            pause N secs after each command, to permit the
  33.             response message to finish.
  34. -m COMn:baud,8N1    select a modem port and parameters.  Any COM
  35.             port supported by MBBIOS is permitted.
  36. -d phonenumber        override the default phone number of the con-
  37.             troller.  Include any exchange access and pause
  38.             for dialtone characters in this string.
  39. -o owner_code        override the default owner unlock code.
  40. -c ctrlop_code        override the default control op code.
  41. -2 code            override the default 2-digit slot programming
  42.             code.
  43. -3 code            override the default 3-digit slot programming
  44.             code.
  45.  
  46. PRGFILE FORMAT
  47.      This file is an ASCII file containing one command per line.
  48. Comments may be placed anywhere, and are indicated by a '#' and
  49. continue to the end of the line.  Although a '#' can be used in
  50. control sequences sent via radio, the '#' must be used to terminate a
  51. programming sequence sent via the telephone.  Hence its use as a
  52. comment delimiter is not ambiguous.  Commands consist of two characters
  53. beginning in column 2.  Case is not significant.  Commands are:
  54.  
  55. CU            unlock the controller lock, to permit
  56.             message programming (for example).
  57.  
  58. CL            lock the controller (after a CU command).
  59.  
  60. CS string        send <string> to the controller.  Permits an
  61.             arbitrary RC85 command to be issued.  <string>
  62.             should contain only one controller command.
  63.  
  64. CO string        send the control-operator prefix followed by
  65.             <string> to the controller.  <string> should
  66.             contain only one controller command.
  67.  
  68. S n s p            program the autodialer slot number <n>, identified
  69.             by string <s>, to dial the phone number <p>. 
  70.             string <s> may be used to record the callsign
  71.             or any other text; no spaces are permitted, and
  72.             this information is otherwise ignored.  The S
  73.             command is equivalent to a sequence of CS commands
  74.             to enter unlocked mode (if slots 0 through 9 are
  75.             selected), to unlock the autodialer (if needed, see
  76.             -u), to clear the current slot contents, and
  77.             to program a new phone number.  If the slot number
  78.             <n> is negative, the slot is programmed to speak
  79.             the number being dialed.
  80.  
  81. MP            program the previously-sent message.  Equivalent
  82.             to CS *0.
  83.  
  84. MR            readback the message being programmed.  Equivalent
  85.             to CS *2.
  86.  
  87. MA            abort the message being programmed.  Equivalent
  88.             to CS *4.
  89.  
  90. EXAMPLE PRGFILE
  91. # Program phone numbers into three slots
  92. S3    Fire    268-5501
  93. S4    LPSO    232-9211
  94. S11    N5KNX    555-1234
  95. # Program emergency msgs
  96. cu
  97. cs *1113    #slot 3 = Fire
  98. cs *634
  99. mp
  100. cs *1114    #slot 4 = LPSO
  101. cs 53 71 73 63
  102. mp
  103. cl
  104. co 75 #Select stardust courtesy tone
  105.  
  106.  
  107. THEORY OF OPERATION
  108.      Rc85prg first validates its command-line arguments, then dials the
  109. RC85 controller.  It waits (see -w) a while for the dialing and rc85
  110. greeting message to complete.  Rc85prg will then read the input file
  111. looking for programming commands.  Each line of the input file
  112. constitutes one command.  Each command is sent to the RC85 (suffixed
  113. automatically by the required # tone) and then the program pauses (see
  114. -p) for the spoken acknowlegement.
  115.  
  116.      Commands should be given in the proper sequence, that is,
  117. unlocked-mode commands should not be mixed with control-operator commands.
  118. Autodialer slot programming does not require explicit unlocking;
  119. the RC85 is unlocked automatically if slots 0 through 9 are selected.
  120. After end-of-file is encountered, the appropriate lock and hangup commands
  121. are sent to the RC85, and then the modem is told to hang up the phone line.
  122.  
  123.  
  124. EXAMPLE
  125. rc85prg -o 1989082344 -c 654 -d 121,9,5551212  setimers.r85
  126.      dials 555-1212 and programs the controller from the file
  127.      named setimers.r85.
  128.  
  129. grep ^S11 autodial.r85 | rc85prg -o 1989082344 -c 654 -d 121,9,5551212
  130.      uses the grep program to find the line beginning with S11
  131.      in the file named autodial.r85, and provides this line to
  132.      rc85prg for programming.
  133.  
  134.  
  135. AUTHOR
  136.      James Dugal, N5KNX @ W5DDL (packet) jpd@usl.edu (Internet)
  137. P.O. Box 44844,  Lafayette, LA  70504
  138.