home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / rc85pr15 / rc85prg.doc < prev    next >
Encoding:
Text File  |  1990-05-16  |  9.1 KB  |  215 lines
  1. NAME
  2.      rc85prg - program an RC-85 repeater controller.
  3.  
  4. SYNOPSIS
  5.      rc85prg  [options]  prgfile
  6.  
  7. DESCRIPTION
  8.      RC85PRG will program an A.C.C. RC-85 controller, using a telephone
  9. modem with a PC running MS-DOS.  Both dialup and control receiver access
  10. methods are supported.  The modem must be capable of sending digits 0
  11. through 9, * and #.  The Hayes (TM) modem is supported by default.  RC85PRG
  12. has been compiled with default sequences for the owner unlock code, the control
  13. operator code, the user autodialer programming codes, and the controller
  14. phone number.  Each of these sequences can be redefined by command-line
  15. options.  <prgfile> is an input file containing the programming commands.
  16. If not specified on the command line, stdin is used.  Hence pipes (|) or
  17. redirection (<) may be used to provide programming commands.  The
  18. MBBIOS interrupt-driven I/O package by AA4RE must be loaded prior
  19. to invoking RC85PRG.  Contact your local packet BBS sysop if you need
  20. help in obtaining AA4RE's excellent package.
  21.  
  22.  
  23. OPTIONS
  24.      If RC85PRG is invoked improperly, it will display a usage
  25. summary, and indicate the current value of all settable options.
  26. Options include:
  27.  
  28. -v             enable verbose mode.
  29. -t            enable test mode (simulate operation, no delays).
  30. -u            indicate autodialer is kept unlocked.
  31. -w N            wait N secs after dialing the RC85, to permit
  32.             the phone answer message to finish.
  33. -p N            pause N secs after each command, to permit the
  34.             response message to finish.
  35. -m COMn:baud,8N1    select a modem port and parameters.  Any COM
  36.             port supported by MBBIOS is permitted.
  37. -d phonenumber        override the default phone number of the con-
  38.             troller.  Include any exchange access and pause
  39.             for dialtone characters in this string.
  40. -o owner_code        override the default owner unlock code.
  41. -c ctrlop_code        override the default control op code.
  42. -2 code            override the default 2-digit slot programming
  43.             code.
  44. -3 code            override the default 3-digit slot programming
  45.             code.
  46. -r            indicate the modem audio drives a radio transmitter.
  47. -i STRING        specifies a modem initialization string.
  48. -i0 STRING        overrides the default modem command-prefix.
  49. -i1 STRING        overrides the default modem command-suffix.
  50. -s            enter an interective phrase-to-code translation
  51.             mode (see SPEECH, below).
  52. -sd            display all the speech vocabulary words.
  53. -s FILE            load a file of words and their translations.
  54.  
  55.  
  56. MODEM REQUIREMENTS
  57.      RC85PRG will default to the appropriate sequences used by Hayes(TM)-
  58. compatible modems.  This sequence differs, depending on whether a phone
  59. or radio connection is used (see the -r option).  For telephone access to
  60. the RC85 controller, commands are prefixed by "ATDT", and suffixed by ";".
  61. For radio access, commands are prefixed by "ATH1DT" and suffixed by ";H0".
  62. This permits the off-hook LED to be wired to PTT, and modem audio output
  63. wired into the mike audio input with appropriate padding resistors.
  64.  
  65. These sequences can be changed with the -i options.  An initialization
  66. string is specified by the -i option, while the prefix and suffix strings
  67. are set by the -i0 and -i1 options.
  68.  
  69.  
  70. PRGFILE FORMAT
  71.      This file is an ASCII file containing one command per line.
  72. Comments may be placed anywhere, and are indicated by a '#' and
  73. continue to the end of the line.  Although a '#' can be used in
  74. control sequences sent via radio, the '#' must be used to terminate a
  75. programming sequence sent via the telephone.  Hence its use as a
  76. comment delimiter is not ambiguous.  Commands consist of two characters
  77. beginning in column 2.  Case is not significant.  Commands are:
  78.  
  79. CU            unlock the controller lock, to permit
  80.             message programming (for example).
  81.  
  82. CL            lock the controller (after a CU command).
  83.  
  84. CS string        send <string> to the controller, permitting an
  85.             arbitrary RC85 command to be issued.  <string>
  86.             is composed of words separated by spaces or tabs.
  87.             Each word is looked up in the vocabulary tables,
  88.             and its value, if found, replaces the word in <string>.
  89.  
  90. CO string        send the control-operator prefix followed by
  91.             <string> to the controller.  <string> is expanded
  92.             in the same fashion as for the CS command.
  93.  
  94. S n s p            program the autodialer slot number <n>, identified
  95.             by string <s>, to dial the phone number <p>. 
  96.             string <s> may be used to record the callsign
  97.             or any other text; no spaces are permitted, and
  98.             this information is otherwise ignored.  The S
  99.             command is equivalent to a sequence of CS commands
  100.             to enter unlocked mode (if slots 0 through 9 are
  101.             selected), to unlock the autodialer (if needed, see
  102.             -u), to clear the current slot contents, and
  103.             to program a new phone number.  If the slot number
  104.             <n> is negative, the slot is programmed to speak
  105.             the number being dialed.  If phone number <p> is
  106.             omitted, then the slot <n> is cleared, thereby erasing
  107.             any previous phone number.
  108.  
  109.  
  110. MP            program the previously-sent message.  Equivalent
  111.             to CS *0.
  112.  
  113. MR            readback the message being programmed.  Equivalent
  114.             to CS *2.
  115.  
  116. MA            abort the message being programmed.  Equivalent
  117.             to CS *4.
  118.  
  119. ID dots/dashes        causes a Hayes-compatible modem to send a Morse
  120.             code identification string.  This command is func-
  121.             tional only when radio access (-r option) is set.
  122.             The ID command should be used as often as needed
  123.             in the PRGFILE so as to identify your station every
  124.             10 minutes.
  125.  
  126. EXAMPLE PRGFILE
  127. # Program phone numbers into three slots
  128. S3    Fire    268-5501
  129. S4    LPSO    232-9211
  130. S11    N5KNX    555-1234
  131. # Program emergency msgs
  132. cu
  133. cs *1113    #slot 3 = Fire
  134. cs fire        #equivalent to code *634
  135. mp
  136. cs *1114    #slot 4 = LPSO
  137. cs L P S O    #equivalent to codes 53 71 73 63
  138. mp
  139. cl
  140. co 75 #Select stardust courtesy tone
  141. id -./...../-.-/-./-..-    # send N5KNX in morse (ignored unless -r option set)
  142.  
  143.  
  144. THEORY OF OPERATION
  145.      Rc85prg first validates its command-line arguments. It then dials the
  146. RC85 controller, if telephone access was selected, and waits (see -w) a while
  147. for the dialing and rc85 greeting message to complete.  Rc85prg will then read
  148. the input file looking for programming commands.  Each line of the input file
  149. constitutes one command.  If the command is CS, CO or ID, each following word
  150. (words are separated by blanks or tabs) is replaced by its translation, if
  151. any, from the vocabulary tables.  This is most useful for speech-related
  152. commands.  Each command is then sent to the RC85 (suffixed automatically
  153. by the required # tone) and then the program pauses (see -p) for the spoken
  154. acknowlegement.
  155.  
  156.      Commands should be given in the proper sequence, that is,
  157. unlocked-mode commands should not be mixed with control-operator commands.
  158. Autodialer slot programming does not require explicit unlocking;
  159. the RC85 is unlocked automatically if slots 0 through 9 are selected.
  160. After end-of-file is encountered, the appropriate lock and hangup commands
  161. are sent to the RC85, and then the modem is told to hang up the phone line.
  162. If the program is interrupted by ctrl-C, it will attempt to terminate the
  163. session gracefully.
  164.  
  165.  
  166. SPEECH
  167.      Since the speech vocabulary is so limited, an option exists (-s) to
  168. permit various word combinations to be tried until a sentence is perfected.
  169. The -s option enters an interective mode, in which each input line is
  170. translated and displayed as a sequence of speech codes, where possible.  The
  171. byte count is also displayed, to help the user keep messages within their
  172. length limits.  A list of words beginning with a desired letter(s) is obtained
  173. by beginning a line with '?' followed by the letter(s) desired.  A '?' by
  174. itself will display all words in the vocabulary.
  175.  
  176. The entire vocabulary can also be displayed by using the -sd option.  RC85PRG
  177. will halt after the display is completed.
  178.  
  179. The vocabulary can be augmented by using the -s option followed by a file name.
  180. This file consists of one pair of words per line.  The first word of the
  181. pair will be translated into the second word when encountered in a CS, CO or
  182. ID command.  Comments may be inserted in the file by placing a "#" in column
  183. one.
  184.  
  185.  
  186. EXAMPLE
  187. rc85prg -o 1989082344 -c 654 -d 121,9,5551212  setimers.r85
  188.      dials 555-1212 and programs the controller from the file
  189.      named setimers.r85.
  190.  
  191. grep ^S11 autodial.r85 | rc85prg -o 1989082344 -c 654 -d 121,9,5551212
  192.      uses the grep program to find the line beginning with S11
  193.      in the file named autodial.r85, and provides this line to
  194.      rc85prg for programming.
  195.  
  196. rc85prg -sd > vocab.85
  197.      dumps the speech vocabulary into the file named vocab.85.
  198.  
  199.  
  200. LIMITATIONS
  201.      RC85PRG makes a one-pass translation of CO, CS and ID commands.
  202. Also, the wait and pause timers may be inaccurate if a multitasker is
  203. used.  The usual times required by the RC85 to execute commands can be
  204. lengthened if it needs to ID the repeater.  I tried disabling the repeater
  205. (CO 01) before I started a programming session, but this seemed to
  206. break some programming commands, despite documentation to the contrary.
  207.  
  208.  
  209. AUTHOR
  210.      James Dugal, N5KNX @ W5DDL (packet) jpd@usl.edu (Internet)
  211. P.O. Box 44844,  Lafayette, LA  70504
  212.  
  213. Latest version available by anonymous FTP from PC.USL.EDU; look in
  214. the pub/ham directory.
  215.