home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
HAM Radio 1
/
HamRadio.cdr
/
misc
/
rc85pr15
/
rc85prg.doc
< prev
next >
Wrap
Text File
|
1990-05-16
|
9KB
|
215 lines
NAME
rc85prg - program an RC-85 repeater controller.
SYNOPSIS
rc85prg [options] prgfile
DESCRIPTION
RC85PRG will program an A.C.C. RC-85 controller, using a telephone
modem with a PC running MS-DOS. Both dialup and control receiver access
methods are supported. The modem must be capable of sending digits 0
through 9, * and #. The Hayes (TM) modem is supported by default. RC85PRG
has been compiled with default sequences for the owner unlock code, the control
operator code, the user autodialer programming codes, and the controller
phone number. Each of these sequences can be redefined by command-line
options. <prgfile> is an input file containing the programming commands.
If not specified on the command line, stdin is used. Hence pipes (|) or
redirection (<) may be used to provide programming commands. The
MBBIOS interrupt-driven I/O package by AA4RE must be loaded prior
to invoking RC85PRG. Contact your local packet BBS sysop if you need
help in obtaining AA4RE's excellent package.
OPTIONS
If RC85PRG is invoked improperly, it will display a usage
summary, and indicate the current value of all settable options.
Options include:
-v enable verbose mode.
-t enable test mode (simulate operation, no delays).
-u indicate autodialer is kept unlocked.
-w N wait N secs after dialing the RC85, to permit
the phone answer message to finish.
-p N pause N secs after each command, to permit the
response message to finish.
-m COMn:baud,8N1 select a modem port and parameters. Any COM
port supported by MBBIOS is permitted.
-d phonenumber override the default phone number of the con-
troller. Include any exchange access and pause
for dialtone characters in this string.
-o owner_code override the default owner unlock code.
-c ctrlop_code override the default control op code.
-2 code override the default 2-digit slot programming
code.
-3 code override the default 3-digit slot programming
code.
-r indicate the modem audio drives a radio transmitter.
-i STRING specifies a modem initialization string.
-i0 STRING overrides the default modem command-prefix.
-i1 STRING overrides the default modem command-suffix.
-s enter an interective phrase-to-code translation
mode (see SPEECH, below).
-sd display all the speech vocabulary words.
-s FILE load a file of words and their translations.
MODEM REQUIREMENTS
RC85PRG will default to the appropriate sequences used by Hayes(TM)-
compatible modems. This sequence differs, depending on whether a phone
or radio connection is used (see the -r option). For telephone access to
the RC85 controller, commands are prefixed by "ATDT", and suffixed by ";".
For radio access, commands are prefixed by "ATH1DT" and suffixed by ";H0".
This permits the off-hook LED to be wired to PTT, and modem audio output
wired into the mike audio input with appropriate padding resistors.
These sequences can be changed with the -i options. An initialization
string is specified by the -i option, while the prefix and suffix strings
are set by the -i0 and -i1 options.
PRGFILE FORMAT
This file is an ASCII file containing one command per line.
Comments may be placed anywhere, and are indicated by a '#' and
continue to the end of the line. Although a '#' can be used in
control sequences sent via radio, the '#' must be used to terminate a
programming sequence sent via the telephone. Hence its use as a
comment delimiter is not ambiguous. Commands consist of two characters
beginning in column 2. Case is not significant. Commands are:
CU unlock the controller lock, to permit
message programming (for example).
CL lock the controller (after a CU command).
CS string send <string> to the controller, permitting an
arbitrary RC85 command to be issued. <string>
is composed of words separated by spaces or tabs.
Each word is looked up in the vocabulary tables,
and its value, if found, replaces the word in <string>.
CO string send the control-operator prefix followed by
<string> to the controller. <string> is expanded
in the same fashion as for the CS command.
S n s p program the autodialer slot number <n>, identified
by string <s>, to dial the phone number <p>.
string <s> may be used to record the callsign
or any other text; no spaces are permitted, and
this information is otherwise ignored. The S
command is equivalent to a sequence of CS commands
to enter unlocked mode (if slots 0 through 9 are
selected), to unlock the autodialer (if needed, see
-u), to clear the current slot contents, and
to program a new phone number. If the slot number
<n> is negative, the slot is programmed to speak
the number being dialed. If phone number <p> is
omitted, then the slot <n> is cleared, thereby erasing
any previous phone number.
MP program the previously-sent message. Equivalent
to CS *0.
MR readback the message being programmed. Equivalent
to CS *2.
MA abort the message being programmed. Equivalent
to CS *4.
ID dots/dashes causes a Hayes-compatible modem to send a Morse
code identification string. This command is func-
tional only when radio access (-r option) is set.
The ID command should be used as often as needed
in the PRGFILE so as to identify your station every
10 minutes.
EXAMPLE PRGFILE
# Program phone numbers into three slots
S3 Fire 268-5501
S4 LPSO 232-9211
S11 N5KNX 555-1234
# Program emergency msgs
cu
cs *1113 #slot 3 = Fire
cs fire #equivalent to code *634
mp
cs *1114 #slot 4 = LPSO
cs L P S O #equivalent to codes 53 71 73 63
mp
cl
co 75 #Select stardust courtesy tone
id -./...../-.-/-./-..- # send N5KNX in morse (ignored unless -r option set)
THEORY OF OPERATION
Rc85prg first validates its command-line arguments. It then dials the
RC85 controller, if telephone access was selected, and waits (see -w) a while
for the dialing and rc85 greeting message to complete. Rc85prg will then read
the input file looking for programming commands. Each line of the input file
constitutes one command. If the command is CS, CO or ID, each following word
(words are separated by blanks or tabs) is replaced by its translation, if
any, from the vocabulary tables. This is most useful for speech-related
commands. Each command is then sent to the RC85 (suffixed automatically
by the required # tone) and then the program pauses (see -p) for the spoken
acknowlegement.
Commands should be given in the proper sequence, that is,
unlocked-mode commands should not be mixed with control-operator commands.
Autodialer slot programming does not require explicit unlocking;
the RC85 is unlocked automatically if slots 0 through 9 are selected.
After end-of-file is encountered, the appropriate lock and hangup commands
are sent to the RC85, and then the modem is told to hang up the phone line.
If the program is interrupted by ctrl-C, it will attempt to terminate the
session gracefully.
SPEECH
Since the speech vocabulary is so limited, an option exists (-s) to
permit various word combinations to be tried until a sentence is perfected.
The -s option enters an interective mode, in which each input line is
translated and displayed as a sequence of speech codes, where possible. The
byte count is also displayed, to help the user keep messages within their
length limits. A list of words beginning with a desired letter(s) is obtained
by beginning a line with '?' followed by the letter(s) desired. A '?' by
itself will display all words in the vocabulary.
The entire vocabulary can also be displayed by using the -sd option. RC85PRG
will halt after the display is completed.
The vocabulary can be augmented by using the -s option followed by a file name.
This file consists of one pair of words per line. The first word of the
pair will be translated into the second word when encountered in a CS, CO or
ID command. Comments may be inserted in the file by placing a "#" in column
one.
EXAMPLE
rc85prg -o 1989082344 -c 654 -d 121,9,5551212 setimers.r85
dials 555-1212 and programs the controller from the file
named setimers.r85.
grep ^S11 autodial.r85 | rc85prg -o 1989082344 -c 654 -d 121,9,5551212
uses the grep program to find the line beginning with S11
in the file named autodial.r85, and provides this line to
rc85prg for programming.
rc85prg -sd > vocab.85
dumps the speech vocabulary into the file named vocab.85.
LIMITATIONS
RC85PRG makes a one-pass translation of CO, CS and ID commands.
Also, the wait and pause timers may be inaccurate if a multitasker is
used. The usual times required by the RC85 to execute commands can be
lengthened if it needs to ID the repeater. I tried disabling the repeater
(CO 01) before I started a programming session, but this seemed to
break some programming commands, despite documentation to the contrary.
AUTHOR
James Dugal, N5KNX @ W5DDL (packet) jpd@usl.edu (Internet)
P.O. Box 44844, Lafayette, LA 70504
Latest version available by anonymous FTP from PC.USL.EDU; look in
the pub/ham directory.